CreateLocationEfs - AWS DataSync

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 point de terminaison pour un système de fichiers Amazon EFS quiAWS DataSyncpeuvent y accéder pour un transfert. Pour de plus amples informations, veuillez consulterCréation d'un emplacement pour Amazon EFS.

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 communs à toutes les actions, consultezParamètres courants.

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

AccessPointArn

Spécifie l'Amazon Resource Name (ARN) du point d'accès qui DataSync pour accéder au 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-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]+:[0-9]{12}:access-point/fsap-[0-9a-f]{8,40}$

Obligatoire : Non

Ec2Config

Spécifie le sous-réseau et les groupes de sécurité DataSync pour accéder à votre système de fichiers Amazon EFS.

Type : objet Ec2Config

Obligatoire : Oui

EfsFilesystemArn

Spécifie l'ARN du 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-iso|aws-iso-b):elasticfilesystem:[a-z\-0-9]*:[0-9]{12}:file-system/fs-.*$

Obligatoire : Oui

FileSystemAccessRoleArn

Spécifie unAWS Identity and Access Management(IAM) qui DataSyncsuppose lors du montage du système de fichiers Amazon EFS.

Type : Chaîne

Contraintes de longueur Longueur maximale de 2048.

Modèle : ^arn:(aws|aws-cn|aws-us-gov|aws-iso|aws-iso-b):iam::[0-9]{12}:role/.*$

Obligatoire : Non

InTransitEncryption

Indique si vous souhaitez DataSync pour utiliser le chiffrement TLS (Transport Layer Security) 1.2 lorsqu'il copie des données à partir ou à partir du système de fichiers Amazon EFS.

Si vous spécifiez un point d'accès en utilisantAccessPointArnou un rôle IAM à l'aideFileSystemAccessRoleArn, vous devez définir ce paramètre surTLS1_2.

Type : Chaîne

Valeurs valides : NONE | TLS1_2

Obligatoire : Non

Subdirectory

Spécifie un chemin de montage pour votre système de fichiers Amazon EFS. C'est là que DataSync lit ou écrit des données (selon qu'il s'agit d'un emplacement source ou de destination). Par défaut, DataSync utilise le répertoire racine, mais vous pouvez également inclure des sous-répertoires.

Note

Vous devez spécifier une valeur avec des barres obliques (par exemple,/path/to/folder).

Type : Chaîne

Contraintes de longueur Longueur maximum de 4096.

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

Obligatoire : Non

Tags

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 deTagListEntryobjets

Membres de tableau : Nombre minimal de 0 éléments. 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

Amazon Resource Name (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-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 communes à toutes les actions, consultezErreurs courantes.

InternalException

Cette exception est renvoyée lorsqu'une erreur se produit dans leAWS DataSyncservice.

Code d'état HTTP : 500

InvalidRequestException

Cette exception est renvoyé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 pourAccessPointArn,FileSystemAccessRoleArn, etInTransitEncryptiondans 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 kits SDK AWS spécifiques au langage, consultez les ressources suivantes :