UpdateLocationHdfs - AWS DataSync
AnforderungssyntaxAnfrageparameterAntwortelementeFehlerWeitere 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.

UpdateLocationHdfs

Aktualisiert einige Parameter eines zuvor erstellten Standorts für einen Hadoop Distributed File System-Cluster.

Anforderungssyntax

{
   "AgentArns": [ "string" ],
   "AuthenticationType": "string",
   "BlockSize": number,
   "KerberosKeytab": blob,
   "KerberosKrb5Conf": blob,
   "KerberosPrincipal": "string",
   "KmsKeyProviderUri": "string",
   "LocationArn": "string",
   "NameNodes": [ 
      { 
         "Hostname": "string",
         "Port": number
      }
   ],
   "QopConfiguration": { 
      "DataTransferProtection": "string",
      "RpcProtection": "string"
   },
   "ReplicationFactor": number,
   "SimpleUser": "string",
   "Subdirectory": "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

Die ARNs der Agents, die zur Verbindung mit dem HDFS-Cluster verwendet werden.

Typ: Zeichenfolge-Array

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element. Die maximale Anzahl beträgt 4 Elemente.

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: Nein

AuthenticationType

Die Art der Authentifizierung, die verwendet wird, um die Identität des Benutzers zu ermitteln.

Typ: Zeichenfolge

Zulässige Werte: SIMPLE | KERBEROS

Required: No

BlockSize

Die Größe der Datenblöcke, die in den HDFS-Cluster geschrieben werden sollen.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1048576. Maximaler Wert von 1 07.7.41824.

Required: No

KerberosKeytab

Die Kerberos-Schlüsseltabelle (keytab), die Zuweisungen zwischen dem definierten Kerberos-Prinzipal und den verschlüsselten Schlüsseln enthält. Sie können den Keytab aus einer Datei laden, indem Sie die Adresse der Datei angeben. Wenn Sie das verwendenAWS CLI, führt es die Base64-Codierung für Sie durch. Geben Sie den base64-kodierten Text an.

Typ: Base64-kodiertes Binärdatenobjekt

Längenbeschränkungen: Maximale Länge von 65536.

Required: No

KerberosKrb5Conf

Die krb5.conf-Datei, die die Kerberos-Konfigurationsinformationen enthält. Sie können die krb5.conf Datei laden, indem Sie die Adresse der Datei angeben. Wenn Sie das verwendenAWS CLI, führt es die Base64-Codierung für Sie durch. Geben Sie den base64-kodierten Text an.

Typ: Base64-kodiertes Binärdatenobjekt

Längenbeschränkungen: Maximale Länge von 131072.

Required: No

KerberosPrincipal

Das Kerberos-Prinzipal mit Zugriff auf die Dateien und Ordner im HDFS-Cluster.

Typ: Zeichenfolge

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

Pattern: ^.+$

Erforderlich: Nein

KmsKeyProviderUri

Die URI des Key Management Servers (KMS) des HDFS-Clusters.

Typ: Zeichenfolge

Längenbeschränkungen: Minimale Länge von 1. Höchstlänge = 255 Zeichen.

Pattern: ^kms:\/\/http[s]?@(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9])(;(([a-zA-Z0-9\-]*[a-zA-Z0-9])\.)*([A-Za-z0-9\-]*[A-Za-z0-9]))*:[0-9]{1,5}\/kms$

Erforderlich: Nein

LocationArn

Der Amazon-Ressourcenname (ARN) des Quell-HDFS-Cluster-Speicherorts.

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}$

Erforderlich: Ja

NameNodes

DerNameNode, der den HDFS-Namespace verwaltet. Der NameNode führt Vorgänge wie das Öffnen, Schließen und Umbenennen von Dateien und Verzeichnissen durch. Der NameNode enthält die Informationen, um Datenblöcke dem zuzuordnenDataNodes. Sie können nur einen verwendenNameNode.

Typ: Array von HdfsNameNode-Objekten

Array-Mitglieder: Die Mindestanzahl beträgt 1 Element.

Required: No

QopConfiguration

Die Konfiguration der Quality of Protection (QOP, Schutzqualität) legt den Remote Procedure Call (RPC, Remoteprozeduraufruf) und die Datenschutzeinstellungen für die Datenübertragung fest, die auf dem Hadoop Distributed File System (HDFS)-Cluster konfiguriert sind.

Typ: QopConfiguration Objekt

Required: No

ReplicationFactor

Die NummerDataNodes, auf die die Daten repliziert werden sollen, wenn in den HDFS-Cluster geschrieben wird.

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Maximaler Wert von 512.

Required: No

SimpleUser

Der zur Identifizierung des Clients auf dem Host-Betriebssystem verwendete Benutzername.

Typ: Zeichenfolge

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

Pattern: ^[_.A-Za-z0-9][-_.A-Za-z0-9]*$

Erforderlich: Nein

Subdirectory

Ein Unterverzeichnis im HDFS-Cluster. Dieses Unterverzeichnis wird verwendet, um Daten vom HDFS-Cluster zu lesen oder zu schreiben.

Typ: Zeichenfolge

Längenbeschränkungen: Maximale Länge von 4096.

Pattern: ^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$

Erforderlich: Nein

Antwortelemente

Wenn die Aktion erfolgreich ist, gibt der Dienst eine HTTP 200-Antwort mit leerem HTTP-Textinhalt zurück.

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

Weitere Informationen finden Sie unter:

Weitere Informationen zur Verwendung dieser API in einem der sprachspezifischen AWS-SDKs finden Sie unter: