REST API を使用したリクエストの実行 - Amazon Simple Storage Service

REST API を使用したリクエストの実行

このセクションでは、REST API を使用して Amazon S3 のエンドポイントにリクエストを生成する方法について説明します。Amazon S3 エンドポイントのリストについては、『AWS General Reference』の「リージョンとエンドポイント」を参照してください。

REST API リクエスト用の S3 ホスト名の生成

Amazon S3 エンドポイントは、以下の構造に従います。

s3.Region.amazonaws.com

Amazon S3 アクセスポイントエンドポイントおよびデュアルスタックエンドポイントも標準構造に従います。

  • Amazon S3 アクセスポイントs3-accesspoint.Region.amazonaws.com

  • デュアルスタックs3.dualstack.Region.amazonaws.com

Amazon S3 のリージョンとエンドポイントの詳細なリストについては、AWS AWS 全般リファレンスの「Amazon S3リージョンとエンドポイント」を参照してください。

仮想ホスティング形式およびパス形式のリクエスト

REST API を使用してリクエストを生成すると、Amazon S3 のエンドポイントに仮想ホスティング形式またはパス形式の URI を使用できます。詳細については、「バケットの仮想ホスティング」を参照してください。

例 仮想ホスティング形式のリクエスト

米国西部 (オレゴン) リージョンにある examplebucket という名前のバケットから puppy.jpg ファイルを削除する仮想ホスティング形式のリクエストの例を次に示します。仮想ホスト形式のリクエストの詳細については、「仮想ホスティング形式のリクエスト」を参照してください。

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

例 パス形式のリクエスト

同じリクエストのパス形式バージョンの例を次に示します。

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 は、すべてのリージョンで仮想ホスト形式アクセスおよびパス形式アクセスをサポートしていますが、変更されます(以下の 重要事項 メモを参照)。

パス形式のリクエストの詳細については、「パス形式のリクエスト」を参照してください。

重要

2020年9月30日以降に作成されたバケットは、仮想ホスト形式のリクエストのみをサポートします。パス形式のリクエストは、この日以前に作成されたバケットを継続的にサポートします。詳細情報については、 Amazon S3 パスの非推奨プラン – 続き を参照してください。

REST API を使用したデュアルスタックのエンドポイントへのリクエストの実行

REST API を使用すると、仮想ホスティング形式やパス形式のエンドポイント名 (URI) を使用してデュアルスタックのエンドポイントに直接アクセスできます。すべての Amazon S3 デュアルスタックのエンドポイント名は名前にリージョンが含まれます。標準の IPv4 のみのエンドポイントとは異なり、仮想ホスティング形式とパス形式のエンドポイントではリージョン固有のエンドポイント名を使用します。

例 仮想ホスティング形式のデュアルスタックのエンドポイントのリクエスト

米国西部 (オレゴン) リージョンにある examplebucket という名前のバケットから puppy.jpg オブジェクトを取得する次の例に示すように、REST リクエストで仮想ホスティング形式のエンドポイントを使用できます。

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

例 パス形式のデュアルスタックのエンドポイントのリクエスト

または次の例に示すように、リクエストでパス形式のエンドポイントを使用することができます。

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

デュアルスタックのエンドポイントの詳細については、「Amazon S3 デュアルスタックのエンドポイントの使用」を参照してください。