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
Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert pour 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 courants pour toutes les actions, consultez Paramètres courants.
Cette demande accepte les données suivantes au format JSON.
- LocationArn
-
Le nom de ressource Amazon (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 du point d'accès DataSync utilisé pour accéder au 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}$ - CreationTime
-
Heure à laquelle le lieu a été créé.
Type : Timestamp
- Ec2Config
-
Sous-réseau et groupes de sécurité AWS DataSync utilisés pour se connecter à l'une des cibles de montage de votre système de fichiers Amazon EFS.
Type : objet Ec2Config
- FileSystemAccessRoleArn
-
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, voir 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/.*$ - InTransitEncryption
-
Indique si le chiffrement TLS (Transport Layer Security) est DataSync utilisé lors du transfert de données vers ou depuis le système de fichiers Amazon EFS.
Type : String
Valeurs valides :
NONE | TLS1_2 - LocationArn
-
L'ARN de l'emplacement 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 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 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 montre comment obtenir des informations sur l'emplacement d'un système de fichiers Amazon EFS spécifique.
{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-12abcdef012345678" }
Exemple de réponse
L'exemple suivant renvoie les détails de localisation 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 restreintAccessPointArn, notamment les 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" }] }
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 :
