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 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 (double pile ‐
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 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 de plus amples informations, veuillez consulter Hébergement virtuel de compartiments.
Exemple 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 en savoir plus sur les demandes d'hébergement virtuel, consultez Demandes de type hébergement virtuel.
DELETE /puppy.jpg HTTP/1.1 Host: examplebucket.s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:
authorization string
Exemple Demande de type chemin
Voici un exemple d'une version de type chemin de la même demande.
DELETE /examplebucket/puppy.jpg HTTP/1.1 Host: s3.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT 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 de plus amples informations sur les demandes de type chemin, veuillez consulter Demandes de type chemin d'accès.
Important
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 de plus amples informations, veuillez consulter Amazon S3 Path Deprecation Plan – The Rest of the Story
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 terminaison IPv4 standard, les points de terminaison de type hébergement virtuel ou chemin ont tous des noms spécifiques aux Régions.
Exemple 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).
GET /puppy.jpg HTTP/1.1 Host: examplebucket.s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT Authorization:
authorization string
Exemple Demande de point de terminaison Dual-Stack de type chemin
Vous pouvez également utiliser un point de terminaison de type chemin dans votre demande, comme indiqué dans l'exemple ci-dessous.
GET /examplebucket/puppy.jpg HTTP/1.1 Host: s3.dualstack.us-west-2.amazonaws.com Date: Mon, 11 Apr 2016 12:00:00 GMT x-amz-date: Mon, 11 Apr 2016 12:00:00 GMT 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.
Pour plus d'informations sur la procédure permettant d'envoyer des demandes à l'aide de l'API REST, consultez les rubriques ci-dessous.