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

Renvoie les métadonnées, telles que les informations d'authentification concernant 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, voir Paramètres communs.

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

LocationArn

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

Type : String

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

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

Type : tableau de chaînes

Membres du tableau : Nombre minimum de 1 élément. Nombre maximum maximum maximum maximum de 4 4 4 4 4 4 4

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

Valeurs valides : SIMPLE | KERBEROS

BlockSize

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

Type : entier

Plage valide : Valeur minimale de 10 048 576. La maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale maximale

CreationTime

Heure à laquelle l'emplacement HDFS.

Type : Timestamp

KerberosPrincipal

Le principal Kerberos ayant accès aux fichiers et dossiers du cluster HDFS. Ce paramètre est utilisé si le AuthenticationType est défini commeKERBEROS.

Type : String

Contraintes de longueur : Longueur minimum de 1. Longueur maximum de 256.

Modèle : ^.+$

KmsKeyProviderUri

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

Type : String

Contraintes de longueur : Longueur minimum 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

L'ARN de l'emplacement du cluster HDFS.

Type : String

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

L'URI de l'emplacement du cluster HDFS.

Type : String

Contraintes de longueur : Longueur maximale de 4 360 4 360.

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

NameNodes

Les NameNode qui gèrent l'espace de base HDFS.

Type : tableau d’objets HdfsNameNode

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

QopConfiguration

La configuration de la qualité de protection (QOP) spécifie les paramètres RPC (Remote Procedure Call) et de protection du transfert de données configurés sur le cluster de système de fichiers distribué Hadoop (HDFS).

Type : objet QopConfiguration

ReplicationFactor

Le nombre de 8 DataNodes vers lesquels répliquer les données lors de l'écriture dans le cluster HDFS.

Type : entier

Plage valide : valeur minimum de 1. Valeur maximale maximale maximale de 12 12 12 12 12 12

SimpleUser

Le nom d'utilisateur servant à identifier le client sur le système d'exploitation hôte. Ce paramètre est utilisé si le AuthenticationType est défini commeSIMPLE.

Type : String

Contraintes de longueur : Longueur minimum 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, reportez-vous à la sectionErreurs courantes.

InternalException

Cette exception est levée lorsqu'une erreur se produit dans le AWS DataSync service.

Code d'état HTTP : 500

InvalidRequestException

Cette exception est levée lorsque le client soumet une demande mal formée.

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 :