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
<a name="API_DescribeLocationS3"></a>

Fournit des informations sur la configuration d'un emplacement de AWS DataSync transfert pour un compartiment S3.

## Syntaxe de la requête
<a name="API_DescribeLocationS3_RequestSyntax"></a>

```
{
   "LocationArn": "string"
}
```

## Paramètres de demande
<a name="API_DescribeLocationS3_RequestParameters"></a>

Pour plus d'informations sur les paramètres courants pour toutes les actions, consultez [Paramètres courants](CommonParameters.md).

Cette demande accepte les données suivantes au format JSON.

 ** [LocationArn](#API_DescribeLocationS3_RequestSyntax) **   <a name="DataSync-DescribeLocationS3-request-LocationArn"></a>
Spécifie le nom de ressource Amazon (ARN) de l'emplacement Amazon S3.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|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
<a name="API_DescribeLocationS3_ResponseSyntax"></a>

```
{
   "AgentArns": [ "string" ],
   "CreationTime": number,
   "LocationArn": "string",
   "LocationUri": "string",
   "S3Config": { 
      "BucketAccessRoleArn": "string"
   },
   "S3StorageClass": "string"
}
```

## Eléments de réponse
<a name="API_DescribeLocationS3_ResponseElements"></a>

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](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-AgentArns"></a>
Le ARNs nombre d' DataSync agents déployés sur votre Outpost lorsque vous utilisez Amazon S3 on Outposts.  
Pour plus d'informations, consultez la section [Déployer votre DataSync agent sur AWS Outposts](https://docs.aws.amazon.com/datasync/latest/userguide/deploy-agents.html#outposts-agent).  
Type : tableau de chaînes  
Membres du tableau : Nombre minimum de 1 élément. Nombre maximum de 8 articles.  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:agent/agent-[0-9a-z]{17}$` 

 ** [CreationTime](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-CreationTime"></a>
Heure à laquelle l'emplacement Amazon S3 a été créé.  
Type : Timestamp

 ** [LocationArn](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationArn"></a>
L'ARN de l'emplacement Amazon S3.  
Type : Chaîne  
Contraintes de longueur : Longueur maximum de 128.  
Modèle : `^arn:(aws|aws-cn|aws-us-gov|aws-eusc|aws-iso|aws-iso-b):datasync:[a-z\-0-9]+:[0-9]{12}:location/loc-[0-9a-z]{17}$` 

 ** [LocationUri](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-LocationUri"></a>
URL de l'emplacement Amazon S3 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](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3Config"></a>
Spécifie le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) DataSync utilisé pour accéder à votre compartiment S3.  
Pour plus d'informations, consultez la section [Fournir DataSync un accès aux compartiments S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#create-s3-location-access).  
Type : objet [S3Config](API_S3Config.md)

 ** [S3StorageClass](#API_DescribeLocationS3_ResponseSyntax) **   <a name="DataSync-DescribeLocationS3-response-S3StorageClass"></a>
Lorsque Amazon S3 est un emplacement de destination, il s'agit de la classe de stockage que vous avez choisie pour vos objets.  
Certaines classes de stockage ont des comportements qui peuvent avoir une incidence sur les coûts de stockage de votre Amazon S3. Pour plus d'informations, consultez la section [Considérations relatives aux classes de stockage associées aux transferts Amazon S3](https://docs.aws.amazon.com/datasync/latest/userguide/create-s3-location.html#using-storage-classes).  
Type : Chaîne  
Valeurs valides : `STANDARD | STANDARD_IA | ONEZONE_IA | INTELLIGENT_TIERING | GLACIER | DEEP_ARCHIVE | OUTPOSTS | GLACIER_INSTANT_RETRIEVAL` 

## Erreurs
<a name="API_DescribeLocationS3_Errors"></a>

Pour plus d'informations sur les erreurs courantes pour toutes les actions, consultez [Erreurs courantes](CommonErrors.md).

 ** 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
<a name="API_DescribeLocationS3_Examples"></a>

### Exemple
<a name="API_DescribeLocationS3_Example_1"></a>

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

#### Exemple de demande
<a name="API_DescribeLocationS3_Example_1_Request"></a>

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

### Exemple
<a name="API_DescribeLocationS3_Example_2"></a>

Cet exemple illustre une utilisation de DescribeLocation S3.

#### Exemple de réponse
<a name="API_DescribeLocationS3_Example_2_Response"></a>

```
{
   "CreationTime": 1532660733.39,
   "LocationArn": "arn:aws:datasync:us-east-2:111222333444:location/loc-07db7abfc326c50s3",
   "LocationUri": "s3://amzn-s3-demo-bucket",
   "S3Config": { 
      "BucketAccessRoleArn": "arn:aws:iam::111222333444:role/amzn-s3-demo-bucket-access-role",
   }
    "S3StorageClass": "STANDARD"
}
```

## consultez aussi
<a name="API_DescribeLocationS3_SeeAlso"></a>

Pour plus d'informations sur l'utilisation de cette API dans l'un des langages spécifiques AWS SDKs, consultez ce qui suit :
+  [AWS Interface de ligne de commande V2](https://docs.aws.amazon.com/goto/cli2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour .NET V4](https://docs.aws.amazon.com/goto/DotNetSDKV4/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour C\$1\$1](https://docs.aws.amazon.com/goto/SdkForCpp/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour Go v2](https://docs.aws.amazon.com/goto/SdkForGoV2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour Java V2](https://docs.aws.amazon.com/goto/SdkForJavaV2/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour V3 JavaScript ](https://docs.aws.amazon.com/goto/SdkForJavaScriptV3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour Kotlin](https://docs.aws.amazon.com/goto/SdkForKotlin/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour PHP V3](https://docs.aws.amazon.com/goto/SdkForPHPV3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour Python](https://docs.aws.amazon.com/goto/boto3/datasync-2018-11-09/DescribeLocationS3) 
+  [AWS SDK pour Ruby V3](https://docs.aws.amazon.com/goto/SdkForRubyV3/datasync-2018-11-09/DescribeLocationS3)