DescribeLocationEfs - 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.

DescribeLocationEfs

Renvoie les métadonnées relatives à votreAWS DataSyncemplacement d'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, consultezParamètres courants.

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 : 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}$

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

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}$

CreationTime

L'heure à laquelle le lieu a été créé.

Type : Horodatage

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

LeAWS Identity and Access Management(IAM) qui DataSync suppose 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/.*$

InTransitEncryption

Décrit si DataSync utilise le chiffrement TLS (Transport Layer Security) lors de la copie de données vers ou depuis le système de fichiers Amazon EFS.

Type : Chaîne

Valeurs valides : NONE | TLS1_2

LocationArn

ARN de l'emplacement 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):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 : Chaîne

Contraintes de longueur Longueur maximale de 4360.

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, consultezErreurs courantes.

InternalException

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

HTTP Status Code : 500

InvalidRequestException

Cette exception est renvoyée lorsque le client soumet une demande mal formée.

HTTP Status Code : 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 les détails d'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 : Décrire l'emplacement d'un système de fichiers Amazon EFS restreint

L'exemple suivant montre comment afficher les détails d'emplacement d'un système de fichiers Amazon EFS avec un accès restreint, notamment lesAccessPointArn,FileSystemAccessRoleArn, etInTransitEncryptionéléments.

{ "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 :