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 bien comprendre comment DataSync accéder aux systèmes de fichiers 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 courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- AccessPointArn
-
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.
Type : String
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 utilisés pour se connecter à l'une des cibles de montage de votre système de fichiers Amazon EFS.
Type : objet Ec2Config
Obligatoire : oui
- EfsFilesystemArn
-
Spécifie l'ARN de votre système de fichiers Amazon EFS.
Type : String
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 un rôle AWS Identity and Access Management (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, consultez la section Création d'un rôle DataSync IAM pour l'accès au système de fichiers.
Type : String
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
-
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
AccessPointArnou un rôle IAM avecFileSystemAccessRoleArn, vous devez définir ce paramètre surTLS1_2.Type : String
Valeurs valides :
NONE | TLS1_2Obligatoire : non
- Subdirectory
-
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 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/folderType : String
Contraintes de longueur : longueur maximale 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 d’objets TagListEntry
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
-
Le nom de ressource Amazon (ARN) de l'emplacement du système de fichiers Amazon EFS que vous créez.
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}$
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
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 AccessPointArnFileSystemAccessRoleArn, 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" }
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 :
