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 *emplacement* de transfert pour un système de fichiers distribué Hadoop (HDFS). AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données.
Avant de commencer, assurez-vous de bien comprendre comment DataSync [accéder aux clusters HDFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-hdfs-location.html#accessing-hdfs).
## 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",
"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 courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).
Cette demande accepte les données suivantes au format JSON.
** [AgentArns](#API_CreateLocationHdfs_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 : oui
** [AuthenticationType](#API_CreateLocationHdfs_RequestSyntax) **
Type d'authentification utilisé pour déterminer l'identité de l'utilisateur.
Type : Chaîne
Valeurs valides : `SIMPLE | KERBEROS`
Obligatoire : oui
** [BlockSize](#API_CreateLocationHdfs_RequestSyntax) **
La taille des blocs de données à écrire dans le cluster HDFS. La taille des blocs doit être un multiple de 512 octets. La taille des blocs par défaut est de 128 mégaoctets (Mio).
Type : Integer
Plage valide : valeur minimale de 1048576. Valeur maximale de 1073741824.
Obligatoire : non
** [CmkSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **
Spécifie les informations de configuration pour un secret DataSync géré, notamment le keytab Kerberos qui permet d'accéder à un emplacement de DataSync stockage Hadoop Distributed File System (HDFS) spécifique, avec un emplacement géré par le client. AWS KMS key
Lorsque vous incluez ce paramètre dans le cadre d'une `CreateLocationHdfs` demande, vous fournissez uniquement l'ARN de la clé KMS. DataSync utilise cette clé KMS avec celle `KerberosKeytab` que vous spécifiez pour créer un secret DataSync géré afin de stocker les informations d'accès à la localisation.
Assurez-vous qu'il DataSync est autorisé à accéder à la clé KMS que vous spécifiez. Pour plus d'informations, consultez la section [Utilisation d'un secret géré par un service chiffré avec un code personnalisé](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#service-secret-custom-key). AWS KMS key
Vous pouvez utiliser `CmkSecretConfig` (avec`KerberosKeytab`) ou `CustomSecretConfig` (sans`KerberosKeytab`) pour fournir des informations d'identification pour une `CreateLocationHdfs` demande. Ne fournissez pas les deux paramètres pour la même demande.
Type : objet [CmkSecretConfig](API_CmkSecretConfig.md)
Obligatoire : non
** [CustomSecretConfig](#API_CreateLocationHdfs_RequestSyntax) **
Spécifie les informations de configuration pour un secret du Gestionnaire de secrets géré par le client dans lequel le keytab Kerberos pour l'emplacement de stockage HDFS est stocké en binaire, dans Secrets Manager. Cette configuration inclut l'ARN secret et l'ARN d'un rôle IAM qui donne accès au secret. Pour plus d'informations, consultez la section [Utilisation d'un secret que vous gérez](https://docs.aws.amazon.com/datasync/latest/userguide/location-credentials.html#custom-secret-custom-key).
Vous pouvez utiliser `CmkSecretConfig` (avec`KerberosKeytab`) ou `CustomSecretConfig` (sans`KerberosKeytab`) pour fournir des informations d'identification pour une `CreateLocationHdfs` demande. Ne fournissez pas les deux paramètres pour la même demande.
Type : objet [CustomSecretConfig](API_CustomSecretConfig.md)
Obligatoire : non
** [KerberosKeytab](#API_CreateLocationHdfs_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.
Ce paramètre est requis si `KERBEROS` est spécifié pour `AuthenticationType`.
Type : objet de données binaires encodées en base64
Contraintes de longueur : longueur maximale de 65536.
Obligatoire : non
** [KerberosKrb5Conf](#API_CreateLocationHdfs_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. Sinon, fournissez le texte codé en base64.
Ce paramètre est requis si `KERBEROS` est spécifié pour `AuthenticationType`.
Type : objet de données binaires encodées en base64
Contraintes de longueur : longueur maximale de 131072.
Obligatoire : non
** [KerberosPrincipal](#API_CreateLocationHdfs_RequestSyntax) **
Le principal Kerberos ayant accès aux fichiers et dossiers du cluster HDFS.
Ce paramètre est requis si `KERBEROS` est spécifié pour `AuthenticationType`.
Type : Chaîne
Contraintes de longueur : longueur minimum de 1. Longueur maximum de 256.
Modèle : `^.+$`
Obligatoire : non
** [KmsKeyProviderUri](#API_CreateLocationHdfs_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
** [NameNodes](#API_CreateLocationHdfs_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 : oui
** [QopConfiguration](#API_CreateLocationHdfs_RequestSyntax) **
La configuration de la qualité de protection (QOP) spécifie les paramètres RPC (Remote Procedure Call) et de protection du transfert de données configurés sur le cluster de système de fichiers distribué Hadoop (HDFS). Si la valeur `QopConfiguration` n'est pas spécifiée, les valeurs `RpcProtection` et `DataTransferProtection` par défaut sont `PRIVACY`. Si vous définissez `RpcProtection` ou `DataTransferProtection`, l'autre paramètre suppose la même valeur.
Type : objet [QopConfiguration](API_QopConfiguration.md)
Obligatoire : non
** [ReplicationFactor](#API_CreateLocationHdfs_RequestSyntax) **
Le nombre de DataNodes vers lesquels répliquer les données lors de l'écriture dans le cluster HDFS. Par défaut, les données sont répliquées sur trois DataNodes.
Type : entier
Plage valide : valeur minimum de 1. Valeur maximale de 512.
Obligatoire : non
** [SimpleUser](#API_CreateLocationHdfs_RequestSyntax) **
Le nom d'utilisateur servant à identifier le client sur le système d'exploitation hôte.
Ce paramètre est requis si `SIMPLE` est spécifié pour `AuthenticationType`.
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_CreateLocationHdfs_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. Si le sous-répertoire n'est pas spécifié, la valeur par défaut est `/`.
Type : Chaîne
Contraintes de longueur : longueur maximale de 4096.
Modèle : `^[a-zA-Z0-9_\-\+\./\(\)\$\p{Zs}]+$`
Obligatoire : non
** [Tags](#API_CreateLocationHdfs_RequestSyntax) **
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 d’objets [TagListEntry](API_TagListEntry.md)
Membres du tableau : nombre minimum de 0 élément. 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](#API_CreateLocationHdfs_ResponseSyntax) **
L'ARN de l'emplacement du cluster HDFS source que vous créez.
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}$`
## 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/CreateLocationHdfs)
+ [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationHdfs)
+ [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationHdfs)
+ [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationHdfs)
+ [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationHdfs)
+ [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationHdfs)
+ [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationHdfs)
+ [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationHdfs)
+ [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationHdfs)
+ [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationHdfs)