DescribeLocationHdfs - AWS DataSync
AnforderungssyntaxAnfrageparameterAntwortsyntaxAntwortelementeFehlerWeitere 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.

DescribeLocationHdfs

Gibt Metadaten zurück, wie die Authentifizierungsinformationen zum Hadoop Distributed File System (HDFS).

Anforderungssyntax

{
   "LocationArn": "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.

LocationArn

Der Amazon-Ressourcenname (ARN) des zu beschreibenden 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

Antwortsyntax

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

AgentArns

Die ARNs der Agents, die für die Verbindung zum HDFS-Cluster verwendet werden.

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

AuthenticationType

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

Typ: Zeichenfolge

Zulässige Werte: SIMPLE | KERBEROS

BlockSize

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

Typ: Ganzzahl

Gültiger Bereich: Der

CreationTime

Der Zeitpunkt, zu dem der HDFS-Standort erstellt wurde.

Typ: Zeitstempel

KerberosPrincipal

Das Kerberos-Prinzipal mit Zugriff auf die Dateien und Ordner im HDFS-Cluster. Dieser Parameter wird verwendet, wenn der definiert AuthenticationType ist alsKERBEROS.

Typ: Zeichenfolge

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

Pattern: ^.+$

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$

LocationArn

Der ARN des HDFS-Cluster-Standorts.

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

LocationUri

Die URI des HDFS-Cluster-Standorts.

Typ: Zeichenfolge

Längenbeschränkungen:

Pattern: ^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$

NameNodes

DieNameNode, die den HDFS-Namespace verwalten.

Typ: Array von HdfsNameNode-Objekten

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

QopConfiguration

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

Typ: QopConfiguration Objekt

ReplicationFactor

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

Typ: Ganzzahl

Gültiger Bereich: Mindestwert 1. Der

SimpleUser

Der zur Identifizierung des Clients auf dem Host-Betriebssystem verwendete Benutzername. Dieser Parameter wird verwendet, wenn der definiert AuthenticationType ist alsSIMPLE.

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]*$

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: