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, relatives à un emplacement de stockage 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, voir Paramètres communs.
Cette demande accepte les données suivantes au format JSON.
- LocationArn
-
L'Amazon Resource Name (ARN) de l'emplacement du compartiment Amazon S3 à décrire.
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
{
"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 un AWS Outpost, 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 un AWS Outpost, voir Déployer votre DataSync agent sur AWS 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 du compartiment Amazon S3.
Type : Timestamp
- LocationArn
-
L'Amazon Resource Name (ARN) du compartiment ou point d'accès Amazon S3.
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 Amazon S3 qui a été décrit.
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.:/\-]+$ - S3Config
-
Amazon Resource Name (ARN) du rôle AWS 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, veuillez consulter la rubrique Création d'un emplacement pour Amazon S3 dans le Guide de l'utilisateur AWS DataSync.
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, consultez la rubrique Considérations relatives à l'utilisation des classes de stockage S3 dans DataSync. Type : String
Valeurs valides :
STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL
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
L'exemple suivant renvoie des informations relatives à 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 DescribeLocation S3.
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 :
