CreateLocationHdfs - 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.

CreateLocationHdfs

Crée un point de terminaison pour un système de fichiers distribué Hadoop (HDFS).

Syntaxe de la requête

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

AgentArns

Les noms Amazon Resource Name (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 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}$

Obligatoire : oui

AuthenticationType

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

Type : String

Valeurs valides : SIMPLE | KERBEROS

Obligatoire : oui

BlockSize

La taille des blocs de données à écrire dans le cluster HDFS. La taille des blocs doit être un multiple de 512 octets. La taille des blocs par défaut est de 128 mégaoctets (Mio).

Type : entier

Plage valide : Valeur : Valeur minimale de 10 48576. La valeur maximale est 1 037 824.

Obligatoire : non

KerberosKeytab

La table de clés Kerberos (keytab) qui contient les mappages entre le principal Kerberos défini et les clés chiffrées. Vous pouvez charger le keytab à partir d'un fichier en fournissant l'adresse du fichier. Si vous utilisez leAWS CLI, il effectue l'encodage base64 pour vous. Dans le cas contraire, fournissez le texte codé en base64.

Note

Ce paramètre est requis si KERBEROS est spécifié pour AuthenticationType.

Type : objet de données binaires encodées en base64

Contraintes de longueur : longueur : longueur : longueur : longueur : Longueur : Longueur : Longueur : Longueur :

Obligatoire : non

KerberosKrb5Conf

Le fichier krb5.conf qui contient les informations de configuration Kerberos. Vous pouvez charger le krb5.conf fichier en fournissant l'adresse du fichier. Si vous utilisez leAWS CLI, il effectue l'encodage base64 pour vous. Dans le cas contraire, fournissez le texte codé en base64.

Note

Ce paramètre est requis si KERBEROS est spécifié pour AuthenticationType.

Type : objet de données binaires encodées en base64

Contraintes de longueur : longueur : longueur : longueur : longueur : longueur : longueur : longueur : longueur :

Obligatoire : non

KerberosPrincipal

Le principal Kerberos ayant accès aux fichiers et dossiers du cluster HDFS.

Note

Ce paramètre est requis si KERBEROS est spécifié pour AuthenticationType.

Type : String

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

Modèle : ^.+$

Obligatoire : non

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$

Obligatoire : non

NameNodes

Le NameNode qui gère l'espace de noms HDFS. NameNodeeffectue des opérations telles que l'ouverture, la fermeture et le renommage de fichiers et de répertoires. NameNodecontient les informations permettant de mapper des blocs de données auDataNodes. Vous ne pouvez utiliser qu'unNameNode.

Type : tableau d’objets HdfsNameNode

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

Obligatoire : oui

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). Si la valeur QopConfiguration n'est pas spécifiée, les valeurs RpcProtection et DataTransferProtection par défaut sont PRIVACY. Si vous définissez RpcProtection ou DataTransferProtection, l'autre paramètre suppose la même valeur.

Type : objet QopConfiguration

Obligatoire : non

ReplicationFactor

Le nombre DataNodes vers lesquels répliquer les données lors de l'écriture dans le cluster HDFS. Par défaut, les données sont répliquées dans troisDataNodes.

Type : entier

Plage valide : valeur minimum de 1. La valeur maximale est 512.

Obligatoire : non

SimpleUser

Le nom d'utilisateur servant à identifier le client sur le système d'exploitation hôte.

Note

Ce paramètre est requis si SIMPLE est spécifié pour AuthenticationType.

Type : String

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

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

Obligatoire : non

Subdirectory

Un sous-répertoire du cluster HDFS. Ce sous-répertoire est utilisé pour lire des données à partir du cluster HDFS ou y écrire des données. Si le sous-répertoire n'est pas spécifié, la valeur par défaut est /.

Type : String

Contraintes de longueur : longueur : longueur : longueur : longueur : longueur : longueur : longueur :

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

Obligatoire : non

Tags

Paire clé-valeur qui représente la balise que vous souhaitez ajouter à l'emplacement. La valeur peut être une chaîne vide. Nous vous recommandons d'utiliser des balises pour nommer vos ressources.

Type : tableau d’objets TagListEntry

Membres du tableau : nombre minimum de 0 élément. Nombre maximal de 50 éléments.

Obligatoire : non

Syntaxe de la réponse

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

LocationArn

ARN de l'emplacement du cluster HDFS source qui a été créé.

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

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 :