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. # CreateLocationEfs Crée un *emplacement* de transfert pour un système de fichiers Amazon EFS. AWS DataSync peut utiliser cet emplacement comme source ou destination pour le transfert de données. Avant de commencer, assurez-vous de comprendre comment DataSync [accéder aux systèmes de fichiers Amazon EFS](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-access). ## Syntaxe de la requête ``` { "AccessPointArn": "string", "Ec2Config": { "SecurityGroupArns": [ "string" ], "SubnetArn": "string" }, "EfsFilesystemArn": "string", "FileSystemAccessRoleArn": "string", "InTransitEncryption": "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. ** [AccessPointArn](#API_CreateLocationEfs_RequestSyntax) ** Spécifie le nom de ressource Amazon (ARN) du point d'accès DataSync utilisé pour monter votre système de fichiers Amazon EFS. Pour plus d'informations, consultez la section [Accès aux systèmes de fichiers restreints](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam). 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):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$` Obligatoire : non ** [Ec2Config](#API_CreateLocationEfs_RequestSyntax) ** Spécifie le sous-réseau et les groupes de sécurité DataSync utilisés pour se connecter à l'une des [cibles de montage](https://docs.aws.amazon.com/efs/latest/ug/accessing-fs.html) de votre système de fichiers Amazon EFS. Type : objet [Ec2Config](API_Ec2Config.md) Obligatoire : oui ** [EfsFilesystemArn](#API_CreateLocationEfs_RequestSyntax) ** Spécifie l'ARN de votre système de fichiers Amazon EFS. 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):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:file-system/fs-[0-9a-f]{8,40}$` Obligatoire : oui ** [FileSystemAccessRoleArn](#API_CreateLocationEfs_RequestSyntax) ** Spécifie un rôle Gestion des identités et des accès AWS (IAM) qui permet d'accéder DataSync à votre système de fichiers Amazon EFS. Pour plus d'informations sur la création de ce rôle, voir [Création d'un rôle DataSync IAM pour l'accès au système de fichiers](https://docs.aws.amazon.com/datasync/latest/userguide/create-efs-location.html#create-efs-location-iam-role). Type : Chaîne Contraintes de longueur : longueur maximale de 2048. Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$` Obligatoire : non ** [InTransitEncryption](#API_CreateLocationEfs_RequestSyntax) ** Spécifie si vous DataSync souhaitez utiliser le chiffrement TLS (Transport Layer Security) 1.2 lors du transfert de données vers ou depuis votre système de fichiers Amazon EFS. Si vous spécifiez un point d'accès en utilisant `AccessPointArn` ou un rôle IAM avec `FileSystemAccessRoleArn`, vous devez définir ce paramètre sur `TLS1_2`. Type : Chaîne Valeurs valides : `NONE | TLS1_2` Obligatoire : non ** [Subdirectory](#API_CreateLocationEfs_RequestSyntax) ** Spécifie un chemin de montage pour votre système de fichiers Amazon EFS. C'est là que les données sont DataSync lues ou écrites sur votre système de fichiers (selon qu'il s'agit d'un emplacement source ou de destination). Par défaut, DataSync utilise le répertoire racine (ou le [point d'accès](https://docs.aws.amazon.com/efs/latest/ug/efs-access-points.html) si vous en fournissez un en utilisant`AccessPointArn`). Vous pouvez également inclure des sous-répertoires à l'aide de barres obliques (par exemple,). `/path/to/folder` Type : Chaîne Contraintes de longueur : longueur maximale de 4096. Modèle : `^[a-zA-Z0-9_\-\+\./\(\)\p{Zs}]*$` Obligatoire : non ** [Tags](#API_CreateLocationEfs_RequestSyntax) ** Spécifie la paire clé-valeur qui représente une balise que vous souhaitez ajouter à la ressource. La valeur peut être une chaîne vide. Cette valeur vous aide à gérer, filtrer et rechercher vos ressources. Nous vous recommandons de créer une balise de nom pour votre emplacement. 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_CreateLocationEfs_ResponseSyntax) ** Le nom de ressource Amazon (ARN) de l'emplacement du système de fichiers Amazon EFS 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 ## Exemples ### Exemple de demande L'exemple suivant crée un emplacement pour un système de fichiers Amazon EFS. ``` { "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:11122233344:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:11122233344:security-group/sg-1234567890abcdef2" ] }, "EfsFilesystemArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:file-system/fs-021345abcdef6789", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### Exemple de demande : création d'un emplacement pour un système de fichiers Amazon EFS restreint L'exemple suivant crée un emplacement pour un système de fichiers Amazon EFS à accès restreint. Dans ce type de scénario, vous devrez peut-être spécifier des valeurs pour `AccessPointArn``FileSystemAccessRoleArn`, et `InTransitEncryption` dans votre demande. ``` { "AccessPointArn": "arn:aws:elasticfilesystem:us-east-2:111222333444:access-point/fsap-1234567890abcdef0", "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "FileSystemAccessRoleArn": "arn:aws:iam::111222333444:role/AwsDataSyncFullAccessNew", "InTransitEncryption": "TLS1_2", "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/", "Subdirectory": "/mount/path", "Tags": [{ "Key": "Name", "Value": "ElasticFileSystem-1" }] } ``` ### Exemple de réponse Une réponse renvoie l'ARN d'emplacement du système de fichiers Amazon EFS. ``` { "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" } ``` ## 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/CreateLocationEfs) + [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/CreateLocationEfs) + [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/CreateLocationEfs)