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

UpdateLocationHdfs

Met à jour certains paramètres d'un emplacement créé précédemment pour un cluster de systèmes de fichiers distribués Hadoop.

Syntaxe de la demande

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

AuthenticationType

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

Type : Chaîne

Valeurs valides : SIMPLE | KERBEROS

Obligatoire Non

BlockSize

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

Type : Integer

Plage valide : Valeur minimale est de 1048576. Valeur maximale fixée à 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 le pluginAWS CLI, il effectue un encodage base64 pour vous. Dans le cas contraire, indiquez le texte codé en base64.

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.

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.

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

LocationArn

ARN (Amazon Resource Name) de l'emplacement du cluster HDFS source.

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

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 : Grappe deHdfsNameNodeobjets

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

Obligatoire Non

QopConfiguration

La configuration Quality of Protection (QOP) spécifie les paramètres de confidentialité de l'appel de procédure à distance (RPC) et du transfert de données configurés sur le cluster HDFS (Hadoop Distributed File System).

Type : objet QopConfiguration

Obligatoire Non

ReplicationFactor

Nombre de DataNodes vers lesquels répliquer les données lors de l'écriture sur le cluster HDFS.

Type : Integer

Plage valide : Valeur minimale est 1. Valeur maximale fixée à 512.

Obligatoire Non

SimpleUser

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

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 à partir du cluster HDFS ou y écrire des données.

Type : Chaîne

Contraintes de longueur : Longueur maximum de 4096.

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

Obligatoire Non

Eléments de réponse

Si l'action aboutit, le service renvoie une réponse HTTP 200 avec un corps HTTP vide.

Erreurs

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

InternalException

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

HTTP Status Code : 500

InvalidRequestException

Cette exception est renvoyée lorsque le client envoie 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 :