CreateLocationHdfs - AWS DataSync

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 demande

{ "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, voirParamètres courants.

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

AgentArns

ARN (Amazon Resource Names) 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 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}$

Obligatoire Oui

AuthenticationType

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

Type : Chaîne

Valeurs valides : SIMPLE | KERBEROS

Obligatoire Oui

BlockSize

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

Type : Integer

Plage valide : Valeur minimale est de 1048576. Valeur maximale de 1073741824.

Obligatoire Non

KerberosKeytab

Table de clés Kerberos (keytab) qui contient des 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 un encodage base64 pour vous. Dans le cas contraire, indiquez le texte codé en base64.

Note

SiKERBEROSest spécifié pourAuthenticationType, ce paramètre est obligatoire.

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

Contraintes de longueur : Longueur maximale de 65536.

Obligatoire Non

KerberosKrb5Conf

Lekrb5.confqui contient les informations de configuration Kerberos. Vous pouvez charger lekrb5.confen fournissant l'adresse du fichier. Si vous utilisez leAWS CLI, il effectue l'encodage base64 pour vous. Dans le cas contraire, indiquez le texte codé en base64.

Note

SiKERBEROSest spécifié pourAuthenticationType, ce paramètre est obligatoire.

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

Contraintes de longueur : Longueur maximale de 131072.

Obligatoire Non

KerberosPrincipal

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

Note

SiKERBEROSest spécifié pourAuthenticationType, ce paramètre est obligatoire.

Type : Chaîne

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

Modèle : ^.+$

Obligatoire Non

KmsKeyProviderUri

URI du serveur KMS (Key Management Server) 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$

Obligatoire Non

NameNodes

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

Type : Tableau deHdfsNameNodeobjets

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

Obligatoire Oui

QopConfiguration

La configuration Quality of Protection (QOP) spécifie les paramètres de protection RPC (Remote Procedure Call) et de protection contre le transfert de données configurés sur le cluster HDFS (Hadoop Distributed File System). SiQopConfigurationn'est pas précisé,RpcProtectionetDataTransferProtectionpar défaut surPRIVACY. Si vous définissezRpcProtectionouDataTransferProtection, l'autre paramètre prend la même valeur.

Type : objet QopConfiguration

Obligatoire Non

ReplicationFactor

Nombre de DataNodes vers lesquels répliquer les données lors de l'écriture sur le cluster HDFS. Par défaut, les données sont répliquées sur trois DataNodes.

Type : Integer

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

Obligatoire Non

SimpleUser

Nom d'utilisateur utilisé pour identifier le client sur le système d'exploitation hôte.

Note

SiSIMPLEest spécifié pourAuthenticationType, ce paramètre est obligatoire.

Type : Chaîne

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

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

Obligatoire Non

Subdirectory

Sous-répertoire dans le cluster HDFS. Ce sous-répertoire est utilisé pour lire des données depuis le 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 : Chaîne

Contraintes de longueur : Longueur maximum de 4096.

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 deTagListEntryobjets

Membres du tableau : Nombre minimal de 0 éléments. 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 créé.

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

Erreurs

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

InternalException

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

HTTP Status Code : 500

InvalidRequestException

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

HTTP Status Code : 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 :