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, voir [Configuration des DataSync transferts avec un cluster HDFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html).
## Syntaxe de la requête
```
{
"AgentArns": [ "string" ],
"AuthenticationType": "string",
"BlockSize": number,
"CmkSecretConfig": {
"KmsKeyArn": "string",
"SecretArn": "string"
},
"CustomSecretConfig": {
"SecretAccessRoleArn": "string",
"SecretArn": "string"
},
"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](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [AgentArns](#API_UpdateLocationHdfs_RequestSyntax) **
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 8 articles.
Contraintes de longueur : Longueur maximum de 128.
Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$`
Obligatoire : non
** [AuthenticationType](#API_UpdateLocationHdfs_RequestSyntax) **
Type d'authentification utilisé pour déterminer l'identité de l'utilisateur.
Type : Chaîne
Valeurs valides : `SIMPLE | KERBEROS`
Obligatoire : non
** [BlockSize](#API_UpdateLocationHdfs_RequestSyntax) **
Taille des blocs de données à écrire dans le cluster HDFS.
Type : Integer
Plage valide : valeur minimale de 1048576. Valeur maximale de 1073741824.
Obligatoire : non
** [CmkSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **
Spécifie les informations de configuration pour un secret DataSync géré, tel qu'un `KerberosKeytab` ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un secret géré par le client AWS KMS key.
Type : objet [CmkSecretConfig](API_CmkSecretConfig.md)
Obligatoire : non
** [CustomSecretConfig](#API_UpdateLocationHdfs_RequestSyntax) **
Spécifie les informations de configuration pour un secret géré par le client, comme un `KerberosKeytab` ou un ensemble d'informations d'identification DataSync utilisé pour accéder à un lieu de transfert spécifique, et un rôle géré par le client Gestion des identités et des accès AWS (IAM) qui fournit l'accès au secret.
Type : objet [CustomSecretConfig](API_CustomSecretConfig.md)
Obligatoire : non
** [KerberosKeytab](#API_UpdateLocationHdfs_RequestSyntax) **
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.
Type : objet de données binaires encodées en base64
Contraintes de longueur : longueur maximale de 65536.
Obligatoire : non
** [KerberosKrb5Conf](#API_UpdateLocationHdfs_RequestSyntax) **
Le fichier `krb5.conf` qui contient les informations de configuration Kerberos. Vous pouvez charger le `krb5.conf` fichier 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](#API_UpdateLocationHdfs_RequestSyntax) **
Le principal Kerberos ayant accès aux fichiers et dossiers du cluster HDFS.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle : `^.+$`
Obligatoire : non
** [KmsKeyProviderUri](#API_UpdateLocationHdfs_RequestSyntax) **
L'URI du serveur de gestion de clés (KMS) du cluster HDFS.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximale de 255 caractères.
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](#API_UpdateLocationHdfs_RequestSyntax) **
Le nom de ressource Amazon (ARN) 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-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$`
Obligatoire : oui
** [NameNodes](#API_UpdateLocationHdfs_RequestSyntax) **
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](API_HdfsNameNode.md)
Membres du tableau : Nombre minimum de 1 élément.
Obligatoire : non
** [QopConfiguration](#API_UpdateLocationHdfs_RequestSyntax) **
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](API_QopConfiguration.md)
Obligatoire : non
** [ReplicationFactor](#API_UpdateLocationHdfs_RequestSyntax) **
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](#API_UpdateLocationHdfs_RequestSyntax) **
Le nom d'utilisateur servant à identifier le client sur le système d'exploitation hôte.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle : `^[_.A-Za-z0-9][-_.A-Za-z0-9]*$`
Obligatoire : non
** [Subdirectory](#API_UpdateLocationHdfs_RequestSyntax) **
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 : Chaîne
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](CommonErrors.md).
** 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 langages spécifiques AWS SDKs, consultez ce qui suit :
+ [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/UpdateLocationHdfs)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/UpdateLocationHdfs)