UpdateLocationSmb

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

Gibt das Authentifizierungsprotokoll an, das für die Verbindung mit Ihrem SMB-Dateiserver DataSync verwendet wird. DataSync unterstützt NTLM (Standard) und KERBEROS Authentifizierung.

Weitere Informationen finden Sie unter Bereitstellen des DataSync Zugriffs auf SMB-Dateiserver.

Typ: Zeichenfolge

Zulässige Werte: NTLM | KERBEROS

Erforderlich: Nein

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 gesetzt AuthenticationType 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

Gibt den Windows-Domain-Namen an, zu dem SMB-Dateiserver gehört. Dieser Parameter gilt nur, wenn er auf NTLM gesetzt AuthenticationType 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

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

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

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

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

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

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 gesetzt AuthenticationType ist.

Typ: Zeichenfolge

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

Pattern: ^.{0,104}$

Erforderlich: Nein

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

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 gesetzt AuthenticationType 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

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

HTTP Status Code: 500

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

HTTP Status Code: 400