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 auquel AWS DataSync peut accéder pour un transfert. Pour plus d'informations, consultez Cré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, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- AccessPointArn
-
Spécifie l'Amazon Resource Name (ARN) du point d'accès DataSync utilisé par pour accéder au 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}: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 par 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 : 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) qu'DataSyncendosse le système de fichiers Amazon EFS.
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 par protocole TLS (Transport Layer Security) 1.2 lorsqu'il copie des données vers ou depuis le 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 DataSync lit ou écrit les 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 : String
Contraintes de longueur : longueur maximum de 4 096.
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
-
Amazon Resource Name (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 communes à toutes les actions, reportez-vous à la sectionErreurs 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 avec 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 de localisation 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 :
