UpdateLocationSmb - AWS DataSync

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) und KERBEROS 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 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

Domain

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

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

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: