UpdateLocationHdfs - AWS DataSync
Syntaxe de la requêteParamètres de demandeÉlé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.

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 requête

{
   "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, voir Paramètres communs.

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

AgentArns

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

Valeurs valides : SIMPLE | KERBEROS

Obligatoire : non

BlockSize

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

Type : entier

Plage valide : La valeur minimale est 1 24. La valeur maximale est 1 24.

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.

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

Contraintes de longueur : Longueur : Longueur maximum de 6 000.

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.

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

Contraintes de longueur : Longueur maximum de 1 24.

Obligatoire : non

KerberosPrincipal

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

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

LocationArn

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

Obligatoire : oui

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. Le NameNode contient les informations permettant de mapper des blocs de données auDataNodes. Vous pouvez en utiliser unNameNode.

Type : tableau d’objets HdfsNameNode

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

Obligatoire : non

QopConfiguration

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

Type : objet QopConfiguration

Obligatoire : non

ReplicationFactor

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

Type : entier

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

Obligatoire : non

SimpleUser

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

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.

Type : String

Contraintes de longueur : Longueur : Longueur : Longueur.

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

Obligatoire : non

Élé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, 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 :