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.
CreateLocationSmb
Erzeugt einen Endpunkt für einen SMB-Dateiserver, auf den AWS DataSync die Berechtigung zum Zugriff hat. Weitere Informationen finden Sie unter Einen SMB-Standort.
Anforderungssyntax
{
"AgentArns": [ "string" ],
"Domain": "string",
"MountOptions": {
"Version": "string"
},
"Password": "string",
"ServerHostname": "string",
"Subdirectory": "string",
"Tags": [
{
"Key": "string",
"Value": "string"
}
],
"User": "string"
}Anfrageparameter
Informationen zu den Parametern, die allen Aktionen gemeinsam sind, finden Sie unter Allgemeine Parameter.
Die Anforderung akzeptiert die folgenden Daten im JSON-Format.
- AgentArns
-
Gibt den DataSync Agenten (oder die Agenten) an, den Sie mit Ihrem SMB-Dateiserver verbinden möchten. Sie geben einen Agenten an, indem Sie seinen Amazon-Ressourcennamen (ARN) verwenden.
Typ: Zeichenfolge-Array
Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die
Längenbeschränkungen: Maximale Länge von 128.
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}$Erforderlich: Ja
- Domain
-
Gibt den Windows-Domain-Namen an, zu dem SMB-Dateiserver gehört.
Weitere Informationen finden Sie unter Erforderliche Berechtigungen für SMB-Standorte.
Typ: Zeichenfolge
beschränkungen beschränkungen.
Pattern:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$Erforderlich: Nein
- MountOptions
-
Gibt die Version des SMB-Protokolls an, der für den Zugriff auf Ihren SMB-Dateiserver DataSync verwendet.
Typ: SmbMountOptions Objekt
Required: No
- Password
-
Gibt das Passwort des Benutzers an, der Ihren SMB-Dateiserver mounten kann und die Berechtigung zum Zugriff auf die Berechtigung zum Zugriff auf die Dateien und Ordner hat, der die Berechtigung zum Zugriff auf die Berechtigung zum Zugriff auf die Berechtigung zum Zugriff auf die
Weitere Informationen finden Sie unter Erforderliche Berechtigungen für SMB-Standorte.
Typ: Zeichenfolge
beschränkungen beschränkungen.
Pattern:
^.{0,104}$Erforderlich: Ja
- ServerHostname
-
Gibt den IP-Adresse des SMB-Dateiservers an, den Ihr DataSync Agent bereitstellt.
Anmerkung
Sie können keine IP-Adresse Version 6 (IPv6) angeben.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 255.
Pattern:
^(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])$Erforderlich: Ja
- Subdirectory
-
Gibt den Namen der von Ihrem SMB-Dateiserver exportierten Freigabe an, auf der Daten gelesen oder geschrieben DataSync werden. Sie können ein Unterverzeichnis in den Share-Pfad aufnehmen (z. B.
/path/to/subdirectory). Stellen Sie sicher, dass andere SMB-Clients in Ihrem Netzwerk diesen Pfad mounten können.Um alle Daten in das angegebene Unterverzeichnis zu kopieren, DataSync müssen Sie in der Lage sein, den SMB-Share zu mounten und auf alle zugehörigen Daten zuzugreifen. Weitere Informationen finden Sie unter Erforderliche Berechtigungen für SMB-Standorte.
Typ: Zeichenfolge
beschränkungen beschränkungen.
Pattern:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$Erforderlich: Ja
- Tags
-
Gibt Bezeichnungen an, mit denen Sie Ihre AWS-Ressourcen kategorisieren, filtern und suchen können. Wir empfehlen, zumindest ein Namensschild für Ihren Standort zu erstellen.
Typ: Array von TagListEntry-Objekten
Array-Mitglieder: Die Mindestanzahl beträgt 0 Elemente. Die maximale Anzahl beträgt 50 Elemente.
Required: No
- User
-
Gibt den Benutzernamen an, der Ihren SMB-Dateiserver mounten kann und der berechtigt ist, auf die an Ihrer Übertragung beteiligten Dateien und Ordner zuzugreifen.
Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter Erforderliche Berechtigungen für SMB-Standorte.
Typ: Zeichenfolge
beschränkungen beschränkungen.
Pattern:
^[^\x5B\x5D\\/:;|=,+*?]{1,104}$Erforderlich: Ja
Antwortsyntax
{
"LocationArn": "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.
- LocationArn
-
Der ARN des SMB-Speicherorts, den Sie erstellt.
Typ: Zeichenfolge
Längenbeschränkungen: Maximale Länge von 128.
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}$
Fehler
Hinweise zu den Fehlern, die allen Aktionen gemeinsam sind, finden Sie unterHäufige Fehler.
- InternalException
-
Diese Ausnahme wird ausgelöst, wenn ein Fehler im AWS DataSync Dienst auftritt.
HTTP Status Code: 500
- InvalidRequestException
-
Diese Ausnahme wird ausgelöst, wenn der Client eine fehlerhafte Anfrage sendet.
HTTP Status Code: 400
Beispiele
Beispielanforderung
Im folgenden Beispiel wird ein -Standort für einen SMB-Dateiserver erstellt.
{ "AgentArns":[ "arn:aws:datasync:us-east-2:111222333444:agent/agent-0b0addbeef44b3nfs", "arn:aws:datasync:us-east-2:111222333444:agent/agent-2345noo35nnee1123ovo3" ], "Domain":"AMAZON", "MountOptions":{ "Version":"SMB3" }, "Password":"string", "ServerHostname":"MyServer.amazon.com", "Subdirectory":"share", "Tags":[ { "Key":"department", "Value":"finance" } ], "User":"user-1" }
Beispielantwort
Eine Antwort gibt den Standort-ARN Ihres SMB-Dateiservers zurück.
{ "LocationArn": "arn:aws:datasync:us-east-1:111222333444:location/loc-0f01451b140b2af49" }
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter:
