DescribeLocationHdfs - AWS DataSync
Syntaxe de la requêteParamètres de demandeSyntaxe de la réponseEléments de réponseErreursVoir aussi

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

DescribeLocationHdfs

Retourne les métadonnées, par exemple les informations d'authentification sur l'emplacement du système de fichiers distribué Hadoop (HDFS).

Syntaxe de la requête

{
   "LocationArn": "string"
}

Paramètres de demande

Pour plus d'informations sur les paramètres communs à toutes les actions, consultezParamètres courants.

Cette demande accepte les données suivantes au format JSON.

LocationArn

Amazon Resource Name (ARN) de l'emplacement du cluster HDFS à décrire.

Type : Chaîne

Contraintes de longueur Longueur maximum de 128.

Modèle : ^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}$

Obligatoire : Oui

Syntaxe de la réponse

{
   "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"
}

Eléments de réponse

Si l’action aboutit, le service renvoie une réponse HTTP 200.

Les données suivantes sont renvoyées au format JSON par le service.

AgentArns

ARN des agents utilisés pour se connecter au cluster HDFS.

Type : Tableau de chaînes

Membres du tableau : Nombre minimal de 1 élément. Nombre maximal de 4 éléments.

Contraintes de longueur Longueur maximum de 128.

Modèle : ^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

Type d'authentification utilisé pour déterminer l'identité de l'utilisateur.

Type : Chaîne

Valeurs valides : SIMPLE | KERBEROS

BlockSize

Taille des blocs de données à écrire dans le cluster HDFS.

Type : Entier

Plage valide : La valeur minimale est 1 048 576. Valeur maximale de 1073741824.

CreationTime

Heure à laquelle l'emplacement HDFS a été créé.

Type : Horodatage

KerberosPrincipal

Principal Kerberos ayant accès aux fichiers et dossiers du cluster HDFS. Ce paramètre est utilisé siAuthenticationTypeest défini commeKERBEROS.

Type : Chaîne

Contraintes de longueur Longueur minimale de 1. Longueur maximum de 256.

Modèle : ^.+$

KmsKeyProviderUri

URI du serveur de gestion des clés (KMS) du cluster HDFS.

Type : Chaîne

Contraintes de longueur Longueur minimale de 1. Longueur maximale de 255.

Modèle : ^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

ARN de l'emplacement du cluster HDFS.

Type : Chaîne

Contraintes de longueur Longueur maximum de 128.

Modèle : ^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

URI de l'emplacement du cluster HDFS.

Type : Chaîne

Contraintes de longueur Longueur maximale de 4 360.

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

NameNodes

Le NameNode qui gèrent l'espace de noms HDFS.

Type : TableauHdfsNameNodeobjets

Membres du tableau : Nombre minimal de 1 élément.

QopConfiguration

La configuration de la qualité de protection (QOP) spécifie les paramètres de protection des appels de procédure distante (RPC) et du transfert de données configurés sur le cluster HDFS (Hadoop Distributed File System).

Type : objet QopConfiguration

ReplicationFactor

Nombre d' DataNodes pour répliquer les données lors de l'écriture dans le cluster HDFS.

Type : Entier

Plage valide : Valeur minimale est 1. Valeur maximale de 512.

SimpleUser

Nom d'utilisateur utilisé pour identifier le client sur le système d'exploitation hôte. Ce paramètre est utilisé siAuthenticationTypeest défini commeSIMPLE.

Type : Chaîne

Contraintes de longueur Longueur minimale de 1. Longueur maximum de 256.

Modèle : ^[_.A-Za-z0-9][-_.A-Za-z0-9]*$

Erreurs

Pour plus d'informations sur les erreurs communes à toutes les actions, consultezErreurs courantes.

InternalException

Cette exception est renvoyée lorsqu'une erreur se produit dans leAWS DataSyncservice.

Code d'état HTTP : 500

InvalidRequestException

Cette exception est renvoyée lorsque le client soumet une demande non conforme.

Code d'état HTTP : 400

Voir aussi

Pour plus d’informations sur l’utilisation de cette API dans l’un des kits SDK AWS spécifiques au langage, consultez les ressources suivantes :