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
Modifie les paramètres de configuration suivants de l'emplacement de transfert du système de fichiers distribué Hadoop (HDFS) que vous utilisez avec. AWS DataSync
Pour plus d'informations, consultez la section Configuration des DataSync transferts avec un cluster HDFS.
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 courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- AgentArns
-
Les Amazon Resource Names (ARNs) des DataSync agents qui peuvent se connecter à votre cluster HDFS.
Type : tableau de chaînes
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 4 articles.
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 | KERBEROSObligatoire : non
- BlockSize
-
Taille des blocs de données à écrire dans le cluster HDFS.
Type : entier
Plage valide : valeur minimale de 1048576. Valeur maximale de 1073741824.
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 le AWS CLI, il exécute le codage 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 maximale de 65536.
Obligatoire : non
- KerberosKrb5Conf
-
Le fichier
krb5.confqui contient les informations de configuration Kerberos. Vous pouvez charger lekrb5.conffichier en fournissant son adresse. Si vous utilisez le AWS CLI, il exécute le codage 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 maximale de 131072.
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
-
Le nom de ressource Amazon (ARN) de l'emplacement du cluster HDFS source.
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
-
Celui NameNode qui gère l'espace de noms HDFS. Il NameNode effectue des opérations telles que l'ouverture, la fermeture et le changement de nom de fichiers et de répertoires. Le NameNode contient les informations permettant de mapper des blocs de données au DataNodes. Vous ne pouvez en utiliser qu'un seul NameNode.
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 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 de 512.
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 maximale de 4096.
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 courantes pour toutes les actions, consultez Erreurs 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
consultez aussi
Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
