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.
# Demandes à l'aide de l'API REST
Cette section contient des informations expliquant comment envoyer des demandes à des points de terminaison Amazon S3 à l'aide de l'API REST. Pour obtenir la liste des points de terminaison Amazon S3, consultez [Régions et points de terminaison](https://docs.aws.amazon.com/general/latest/gr/s3.html) dans la *Références générales AWS*.
## Construction de noms d'hôte S3 pour les demandes d'API REST
Les points de terminaison Amazon S3 suivent la structure indiquée ci-dessous :
```
s3.{{Region}}.amazonaws.com
```
Les points de terminaison de points d'accès Amazon S3 et les points de terminaison Dual-Stack (double pile) suivent également la structure standard :
+ **Points d'accès Amazon S** ‐`s3-accesspoint.{{Region}}.amazonaws.com`
+ **Dual-stack** ‐ `s3.dualstack.{{Region}}.amazonaws.com`
Pour obtenir la liste complète des régions et points de terminaison Amazon S3, consultez [Points de terminaison et quotas Amazon S3](https://docs.aws.amazon.com/general/latest/gr/s3.html) dans le *Référence générale d'Amazon Web Services*.
## Demandes de type hébergement virtuel et de type chemin
Lorsque vous envoyez des demandes à l'aide de l'API REST, vous pouvez utiliser des URI de types hébergement virtuel ou chemin pour les points de terminaison Amazon S3. Pour plus d'informations, consultez la section [ Path-style Demandes](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access).
**Example Demande de type hébergement virtuel**
Voici un exemple de demande de type hébergement virtuel visant à supprimer le fichier `puppy.jpg` du compartiment `examplebucket` dans la Région USA Ouest (Oregon). Pour plus d'informations sur les requêtes de type hébergé virtuel, consultez la section Demandes. [ Path-style ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#virtual-hosted-style-access)
```
1. DELETE /puppy.jpg HTTP/1.1
2. Host: examplebucket.s3.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```
**Example Path-style demande**
Voici un exemple d'une version de type chemin de la même demande.
```
1. DELETE /examplebucket/puppy.jpg HTTP/1.1
2. Host: s3.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```
Amazon S3 prend actuellement en charge l'accès aux URL de type hébergement virtuel et chemin d'accès dans toutes les Régions AWS. Toutefois, les URL de type chemin d’accès seront abandonnées à l’avenir. Pour plus d’informations, consultez la **remarque importante** suivante.
Pour plus d'informations sur les requêtes de type chemin, consultez [ Path-style la section requêtes. ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/VirtualHosting.html#path-style-access)
Mise à jour (23 septembre 2020) – Pour laisser aux clients le temps nécessaire pour passer à des URL de type hébergement virtuel, nous avons décidé de retarder l’obsolescence des URL de type chemin d’accès. Pour plus d’informations, consultez [Amazon S3 Path Deprecation Plan – The Rest of the Story](https://aws.amazon.com/blogs/aws/amazon-s3-path-deprecation-plan-the-rest-of-the-story/) dans le *blog dédié aux actualités d’AWS *.
## Envoi de demandes à des points de terminaison Dual-Stack à l'aide de l'API REST
Lorsque vous utilisez l'API REST, vous pouvez accéder directement à un point de terminaison Dual-Stack (double pile) si vous utilisez un nom de point de terminaison (URI) de type hébergement virtuel ou chemin. Tous les noms de points de terminaison Dual-Stack (double pile) Amazon S3 incluent la Région concernée. Contrairement aux points de IPv4-only terminaison standard, les points de terminaison de style hébergé virtuel et de type chemin utilisent des noms de points de terminaison spécifiques à la région.
**Example Demande de point de terminaison Dual-Stack (double pile) de type hébergement virtuel**
Vous pouvez utiliser un point de terminaison de type hébergement virtuel dans votre demande REST, comme indiqué dans l'exemple suivant, qui permet de récupérer l'objet `puppy.jpg` à partir du compartiment `examplebucket` dans la Région USA Ouest (Oregon).
```
1. GET /puppy.jpg HTTP/1.1
2. Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```
**Example Path-style demande de point de terminaison à double pile**
Vous pouvez également utiliser un point de terminaison de type chemin dans votre demande, comme indiqué dans l'exemple ci-dessous.
```
1. GET /examplebucket/puppy.jpg HTTP/1.1
2. Host: s3.dualstack.us-west-2.amazonaws.com
3. Date: Mon, 11 Apr 2016 12:00:00 GMT
4. x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT
5. Authorization: {{authorization string}}
```
Pour de plus amples informations sur les points de terminaison Dual-Stack, consultez la section [Utilisation des points de terminaison Dual-Stack Amazon S3](dual-stack-endpoints.md).
Pour plus d'informations sur l'envoi de requêtes à l'aide de l'API REST, consultez les rubriques suivantes.
**Topics**
+ [Construction de noms d'hôte S3 pour les demandes d'API REST](#constructing-hostname-rest-api-requests)
+ [Demandes de type hébergement virtuel et de type chemin](#virtual-hosted-path-style-requests)
+ [Envoi de demandes à des points de terminaison Dual-Stack à l'aide de l'API REST](#rest-api-dual-stack)
+ [Redirection de demande et API REST](RESTRedirect.md)
+ [Demande de routage](UsingRouting.md)