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.
UpdateLocationSmb
Ändert die folgenden Konfigurationsparameter des SMB-Übertragungsorts (Server Message Block), den Sie mit verwenden. AWS DataSync
Weitere Informationen finden Sie unter Konfiguration von DataSync Übertragungen mit einem SMB-Dateiserver.
Anforderungssyntax
{
"AgentArns": [ "string
" ],
"AuthenticationType": "string
",
"DnsIpAddresses": [ "string
" ],
"Domain": "string
",
"KerberosKeytab": blob
,
"KerberosKrb5Conf": blob
,
"KerberosPrincipal": "string
",
"LocationArn": "string
",
"MountOptions": {
"Version": "string
"
},
"Password": "string
",
"Subdirectory": "string
",
"User": "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.
- AgentArns
-
Gibt den DataSync Agenten (oder die Agenten) an, der eine Verbindung zu Ihrem SMB-Dateiserver herstellen kann. Sie geben einen Agenten anhand seines Amazon-Ressourcennamens (ARN) an.
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}$
Erforderlich: Nein
- AuthenticationType
-
Gibt das Authentifizierungsprotokoll an, das für die Verbindung mit Ihrem SMB-Dateiserver DataSync verwendet wird. DataSync unterstützt
NTLM
(Standard) undKERBEROS
Authentifizierung.Weitere Informationen finden Sie unter Bereitstellen des DataSync Zugriffs auf SMB-Dateiserver.
Typ: Zeichenfolge
Zulässige Werte:
NTLM | KERBEROS
Erforderlich: Nein
- DnsIpAddresses
-
Gibt die IPv4 Adressen für die DNS-Server an, zu denen Ihr SMB-Dateiserver gehört. Dieser Parameter gilt nur, wenn er auf
KERBEROS
gesetztAuthenticationType
ist.Wenn Sie mehrere Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen SMB-Dateiserver hergestellt wird.
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
Erforderlich: Nein
- Domain
-
Gibt den Windows-Domain-Namen an, zu dem SMB-Dateiserver gehört. Dieser Parameter gilt nur, wenn er auf
NTLM
gesetztAuthenticationType
ist.Wenn Sie mehrere Domänen in Ihrer Umgebung haben, wird durch die Konfiguration dieses Parameters sichergestellt, dass DataSync eine Verbindung zum richtigen Dateiserver hergestellt wird.
Typ: Zeichenfolge
Längenbeschränkungen: Die maximale Länge beträgt 253.
Pattern:
^[A-Za-z0-9]((\.|-+)?[A-Za-z0-9]){0,252}$
Erforderlich: Nein
- KerberosKeytab
-
Gibt Ihre Kerberos-Schlüsseltabellendatei (Keytab) an, die Zuordnungen zwischen Ihrem Kerberos-Prinzipal und den Verschlüsselungsschlüsseln enthält.
Die Datei muss Base64-codiert sein. Wenn Sie das verwenden AWS CLI, ist die Kodierung für Sie erledigt.
Um Fehler bei der Ausführung von Aufgaben zu vermeiden, stellen Sie sicher, dass der Kerberos-Prinzipal, den Sie zum Erstellen der Keytab-Datei verwenden, genau dem entspricht, wofür Sie es angegeben haben.
KerberosPrincipal
Typ: Base64-kodiertes Binärdatenobjekt
Längenbeschränkungen: Die maximale Länge beträgt 65536.
Erforderlich: Nein
- KerberosKrb5Conf
-
Gibt eine Kerberos-Konfigurationsdatei (
krb5.conf
) an, die Ihre Kerberos-Realm-Konfiguration definiert.Die Datei muss base64-codiert sein. Wenn Sie das verwenden AWS CLI, ist die Kodierung für Sie erledigt.
Typ: Base64-kodiertes Binärdatenobjekt
Längenbeschränkungen: Die maximale Länge beträgt 131072.
Erforderlich: Nein
- KerberosPrincipal
-
Gibt einen Kerberos-Principal an. Dabei handelt es sich um eine Identität in Ihrem Kerberos-Bereich, die berechtigt ist, auf die Dateien, Ordner und Dateimetadaten auf Ihrem SMB-Dateiserver zuzugreifen.
Ein Kerberos-Prinzipal könnte wie folgt aussehen.
HOST/kerberosuser@MYDOMAIN.ORG
Bei Prinzipalnamen wird Groß- und Kleinschreibung beachtet. Ihre DataSync Aufgabenausführung schlägt fehl, wenn der Prinzipal, den Sie für diesen Parameter angeben, nicht exakt dem Prinzipal entspricht, den Sie zum Erstellen der Keytab-Datei verwenden.
Typ: Zeichenfolge
Längenbeschränkungen: Minimale Länge beträgt 1 Zeichen. Maximale Länge beträgt 256 Zeichen.
Pattern:
^.+$
Erforderlich: Nein
- LocationArn
-
Gibt den ARN des SMB-Standorts an, den Sie aktualisieren möchten.
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
- MountOptions
-
Gibt die Version des SMB-Protokolls (Server Message Block) an, das für den Zugriff auf einen SMB-Dateiserver AWS DataSync verwendet wird.
Typ: SmbMountOptions Objekt
Erforderlich: Nein
- Password
-
Gibt das Kennwort des Benutzers an, der Ihren SMB-Dateiserver bereitstellen kann und über Zugriffsrechte auf die Dateien und Ordner verfügt, die an Ihrer Übertragung beteiligt sind. Dieser Parameter gilt nur, wenn er auf
NTLM
gesetztAuthenticationType
ist.Typ: Zeichenfolge
Längenbeschränkungen: Die maximale Länge beträgt 104.
Pattern:
^.{0,104}$
Erforderlich: Nein
- 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 Freigabepfad aufnehmen (z. B.
/path/to/subdirectory
). Stellen Sie sicher, dass andere SMB-Clients in Ihrem Netzwerk diesen Pfad ebenfalls bereitstellen können.Um alle Daten im angegebenen Unterverzeichnis zu kopieren, DataSync müssen Sie in der Lage sein, die SMB-Freigabe zu mounten und auf alle zugehörigen Daten zuzugreifen. Weitere Informationen finden Sie unter DataSync Zugriff auf SMB-Dateiserver bereitstellen.
Typ: Zeichenfolge
Längenbeschränkungen: Die maximale Länge beträgt 4096.
Pattern:
^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$
Erforderlich: Nein
- User
-
Gibt den Benutzernamen an, der Ihren SMB-Dateiserver mounten kann und der Zugriff auf die Dateien und Ordner hat, die an Ihrer Übertragung beteiligt sind. Dieser Parameter gilt nur, wenn er auf
NTLM
gesetztAuthenticationType
ist.Informationen zur Auswahl eines Benutzers mit der richtigen Zugriffsebene für Ihre Übertragung finden Sie unter DataSync Zugriff auf SMB-Dateiserver bereitstellen.
Typ: Zeichenfolge
Längenbeschränkungen: Die maximale Länge beträgt 104.
Pattern:
^[^\x22\x5B\x5D/\\:;|=,+*?\x3C\x3E]{1,104}$
Erforderlich: Nein
Antwortelemente
Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.
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
Weitere Informationen finden Sie unter:
Weitere Informationen zur Verwendung dieser API in einer der sprachspezifischen Sprachen finden Sie im Folgenden AWS SDKs: