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

DescribeLocationS3

Renvoie les métadonnées, telles que le nom du compartiment, sur l'emplacement d'un compartiment Amazon S3.

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 compartiment Amazon S3 à décrire.

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

{ "AgentArns": [ "string" ], "CreationTime": number, "LocationArn": "string", "LocationUri": "string", "S3Config": { "BucketAccessRoleArn": "string" }, "S3StorageClass": "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.

AgentArns

Si vous utilisez DataSync sur unAWSOutpost, le nom de ressource Amazon (ARN) des agents EC2 déployés sur votre Outpost. Pour plus d'informations sur le lancement d'un DataSync Agent sur unAWSOutpost, voirDéployer votre DataSync Agent surAWS Outposts.

Type : Tableau de chaînes

Membres du tableau : Nombre minimum de 1 élément. Nombre maximal de 4 éléments.

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}:agent/agent-[0-9a-z]{17}$

CreationTime

Heure de création de l'emplacement du compartiment Amazon S3.

Type : Horodatage

LocationArn

Amazon Resource Name (ARN) du compartiment Amazon S3.

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 Amazon S3 qui a été décrit.

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.:/\-]+$

S3Config

Amazon Resource Name (ARN) deAWS Identity and Access Management(IAM) utilisé pour accéder à un compartiment Amazon S3.

Pour plus d'informations sur l'utilisation d'un tel rôle, consultezCréation d'un emplacement pour Amazon S3dans le AWS DataSyncGuide de l'utilisateur.

Type : objet S3Config

S3StorageClass

Classe de stockage Amazon S3 dans laquelle vous avez choisi de stocker vos fichiers lorsque cet emplacement est utilisé comme destination de tâche. Pour de plus amples informations sur les classes de stockage S3, veuillez consulter Classes de stockage Amazon S3. Certaines classes de stockage ont des comportements qui peuvent avoir un impact sur votre coût de stockage S3. Pour plus d'informations, consultezRemarques sur l'utilisation des classes de stockage S3 dans DataSync.

Type : Chaîne

Valeurs valides : STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS

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 le moduleAWS DataSyncservice.

Code d'état HTTP : 500

InvalidRequestException

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

Code d'état HTTP : 400

Exemples

Exemple

L'exemple suivant renvoie les informations suivantes sur l'emplacement S3 spécifié dans l'exemple de demande.

Exemple de demande

{ "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3" }

Exemple

Cet exemple illustre une utilisation de DescribeLocationS3.

Exemple de réponse

{ "CreationTime": 1532660733.39, "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3", "LocationUri": "MyBucket.", "S3Config": { "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/MyBucketAccessRole", } "S3StorageClass": "STANDARD" }

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 :