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 ‐
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 plus d'informations, consultez la section Path-style Demandes.
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 plus d'informations sur les requêtes de type hébergé virtuel, consultez la section Demandes. Path-style
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 Path-style demande
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 plus d'informations sur les requêtes de type chemin, consultez Path-style la section requêtes.
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 plus d’informations, consultez 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 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.
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 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.
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 l'envoi de requêtes à l'aide de l'API REST, consultez les rubriques suivantes.
