DescribeLocationSmb - AWS DataSync
AnforderungssyntaxAnforderungsparameterAntwortsyntaxAntwortelementeFehlerBeispieleWeitere Informationen finden Sie unter:

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

DescribeLocationSmb

Enthält Einzelheiten zur Konfiguration eines AWS DataSync Übertragungsorts für einen SMB-Dateiserver (Server Message Block).

Anforderungssyntax

{
   "LocationArn": "string"
}

Anforderungsparameter

Informationen zu den Parametern, die alle Aktionen gemeinsam haben, finden Sie unter Allgemeine Parameter.

Die Anforderung akzeptiert die folgenden Daten im JSON-Format.

LocationArn

Gibt den Amazon-Ressourcennamen (ARN) des SMB-Standorts an, über den Sie Informationen benötigen.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

Erforderlich: Ja

Antwortsyntax

{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "CreationTime": number,
   "DnsIpAddresses": [ "string" ],
   "Domain": "string",
   "KerberosPrincipal": "string",
   "LocationArn": "string",
   "LocationUri": "string",
   "MountOptions": { 
      "Version": "string"
   },
   "User": "string"
}

Antwortelemente

Wenn die Aktion erfolgreich ist, sendet der Service eine HTTP 200-Antwort zurück.

Die folgenden Daten werden vom Service im JSON-Format zurückgegeben.

AgentArns

Die DataSync Agenten, ARNs die eine Verbindung zu Ihrem SMB-Dateiserver herstellen können.

Typ: Zeichenfolgen-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Maximale Anzahl von 4 Artikeln.

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$

AuthenticationType

Das Authentifizierungsprotokoll, das für die Verbindung mit Ihrem SMB-Dateiserver DataSync verwendet wird.

Typ: Zeichenfolge

Zulässige Werte: NTLM | KERBEROS

CreationTime

Der Zeitpunkt, zu dem der SMB-Standort erstellt wurde.

Typ: Zeitstempel

DnsIpAddresses

Die IPv4 Adressen für die DNS-Server, zu denen Ihr SMB-Dateiserver gehört. Dieses Element gilt nur, wenn AuthenticationType es auf KERBEROS gesetzt ist.

Typ: Zeichenfolgen-Array

Array-Mitglieder: Maximale Anzahl von 2 Elementen.

Längenbeschränkungen: Minimale Länge beträgt 7 Zeichen. Maximale Länge beträgt 15 Zeichen.

Pattern: \A(25[0-5]|2[0-4]\d|[0-1]?\d?\d)(\.(25[0-5]|2[0-4]\d|[0-1]?\d?\d)){3}\z

Domain

Der Name der Windows-Domäne, zu der der SMB-Dateiserver gehört. Dieses Element gilt nur, wenn AuthenticationType es auf NTLM gesetzt ist.

Typ: Zeichenfolge

Längenbeschränkungen: Die maximale Länge beträgt 253.

Pattern: ^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$

KerberosPrincipal

Der Kerberos-Prinzipal, der berechtigt ist, auf die Dateien, Ordner und Dateimetadaten auf Ihrem SMB-Dateiserver zuzugreifen.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.

Pattern: ^.+$

LocationArn

Der ARN des SMB-Standorts.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge beträgt 128 Zeichen.

Pattern: ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$

LocationUri

Die URI des SMB-Standorts.

Typ: Zeichenfolge

Längenbeschränkungen: Die maximale Länge beträgt 4360.

Pattern: ^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$

MountOptions

Die SMB-Protokollversion, die für den Zugriff auf Ihren SMB-Dateiserver DataSync verwendet wird.

Typ: SmbMountOptions Objekt

User

Der Benutzer, der die Dateien, Ordner und Dateimetadaten auf Ihrem SMB-Dateiserver bereitstellen und darauf zugreifen kann. Dieses Element gilt nur, wenn AuthenticationType es auf NTLM gesetzt ist.

Typ: Zeichenfolge

Längenbeschränkungen: Die maximale Länge beträgt 104.

Pattern: ^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$

Fehler

Weitere Informationen zu den allgemeinen Fehlern, die bei allen Aktionen zurückgegeben werden, finden Sie unter Häufige Fehler.

InternalException

Diese Ausnahme wird ausgelöst, wenn im AWS DataSync Dienst ein Fehler auftritt.

HTTP Status Code: 500

InvalidRequestException

Diese Ausnahme wird ausgelöst, wenn der Client eine falsch formatierte Anfrage sendet.

HTTP Status Code: 400

Beispiele

Beispiel

Dieses Beispiel veranschaulicht eine Verwendung von. DescribeLocationSmb

Beispielanforderung

{
  "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49"
}

Beispiel

Dieses Beispiel veranschaulicht eine Verwendung von DescribeLocationSmb.

Beispielantwort

{
   "AgentArns":[
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-0bc3b3dc9bbc15145",
      "arn:aws:datasync:us-east-2:111222333444:agent/agent-04b3fe3d261a18c8f"
   ],
   "CreationTime":"1532660733.39",
   "Domain":"AMAZON",
   "LocationArn":"arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49",
   "LocationUri":"smb://hostname.amazon.com/share",
   "MountOptions":{
      "Version":"SMB3"
   },
   "User":"user-1"
}

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen AWS SDKs finden Sie im Folgenden: