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.
DescribeLocationEfs
Renvoie des métadonnées sur votre AWS DataSync emplacement vers un système de fichiers Amazon EFS.
Syntaxe de la requête
{
"LocationArn": "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.
- LocationArn
-
Amazon Resource Name (ARN) de l'emplacement du système de fichiers Amazon EFS sur lequel vous souhaitez obtenir des informations.
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}$Obligatoire : oui
Syntaxe de la réponse
{
"AccessPointArn": "string",
"CreationTime": number,
"Ec2Config": {
"SecurityGroupArns": [ "string" ],
"SubnetArn": "string"
},
"FileSystemAccessRoleArn": "string",
"InTransitEncryption": "string",
"LocationArn": "string",
"LocationUri": "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.
- AccessPointArn
-
L'ARN EFS du point d'accès qui DataSync permet d'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}$ - CreationTime
-
Heure à laquelle l'emplacement a été créé.
Type : Timestamp
- Ec2Config
-
Le sous-réseau et les groupes de sécurité utilisés par AWS DataSync pour accéder à votre système de fichiers Amazon EFS.
Type : objet Ec2Config
- FileSystemAccessRoleArn
-
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/.*$ - InTransitEncryption
-
Spécifie si DataSync le chiffrement par protocole TLS (Transport Layer Security) lors de la copie de données vers ou depuis le système de fichiers Amazon EFS.
Type : String
Valeurs valides :
NONE | TLS1_2 - LocationArn
-
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):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$ - LocationUri
-
URL de l'emplacement du système de fichiers Amazon EFS.
Type : String
Contraintes de longueur : longueur maximum de 4 360.
Modèle :
^(efs|nfs|s3|smb|hdfs|fsx[a-z0-9-]+)://[a-zA-Z0-9.:/\-]+$
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 montre comment obtenir des informations sur un emplacement spécifique du système de fichiers Amazon EFS.
{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" }
Exemple de réponse
L'exemple suivant renvoie des informations sur l'emplacement d'un système de fichiers Amazon EFS.
{ "CreationTime": 1653319021.353, "Ec2Config": { "SubnetArn": "arn:aws:ec2:us-east-2:111222333444:subnet/subnet-1234567890abcdef1", "SecurityGroupArns": [ "arn:aws:ec2:us-east-2:111222333444:security-group/sg-1234567890abcdef2" ] }, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-abcdef01234567890", "LocationUri": "efs://us-east-2.fs-021345abcdef6789/" }
Exemple de réponse : description de l'emplacement d'un système de fichiers Amazon EFS restreint
L'exemple suivant renvoie les détails de localisation d'un système de fichiers Amazon EFS à accès restreint, y compris les AccessPointArn InTransitEncryption élémentsFileSystemAccessRoleArn, et.
{ "CreationTime": 1653319021.353, "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" }] }
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 :
