REST API を使用したリクエストの実行
このセクションでは、REST API を使用して Amazon S3 のエンドポイントにリクエストを生成する方法について説明します。Amazon S3 エンドポイントのリストは、AWS 全般のリファレンス の「リージョンとエンドポイント」を参照してください。
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 リージョンとエンドポイントの完全なリストについては、Amazon Web Services 全般のリファレンス の「Amazon S3 エンドポイントとクォータ」を参照してください。
仮想ホスティング形式およびパス形式のリクエスト
REST API を使用してリクエストを生成すると、Amazon S3 のエンドポイントに仮想ホスティング形式またはパス形式の URI を使用できます。詳細については、「バケットの仮想ホスティング」を参照してください。
例 仮想ホスティング形式のリクエスト
米国西部 (オレゴン) リージョンにある puppy.jpg ファイルを examplebucket という名前のバケットから削除する仮想ホスティング形式のリクエストの例を次に示します。仮想ホスト形式のリクエストの詳細については、「仮想ホスト形式のリクエスト」を参照してください。
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 では、すべての AWS リージョン で仮想ホスト形式の URL とパス形式の URL の両方をサポートしています。ただし、パス形式の URL は将来廃止される予定です。詳細については、次の重要な注記を参照してください。
パス形式のリクエストの詳細については、「パス形式のリクエスト」を参照してください。
重要
更新 (2020 年 9 月 23 日) – お客様が仮想ホスティング形式の URL への移行に必要な時間を確保できるように、パス形式 URL の非推奨化を延期することが決定しました。詳細については、AWS ニュースブログの Amazon S3 Path Deprecation Plan – The Rest of the Story
REST API を使用したデュアルスタックのエンドポイントへのリクエストの実行
REST API を使用すると、仮想ホスティング形式やパス形式のエンドポイント名 (URI) を使用してデュアルスタックのエンドポイントに直接アクセスできます。すべての Amazon S3 デュアルスタックのエンドポイント名は名前にリージョンが含まれます。標準の IPv4 のみのエンドポイントとは異なり、仮想ホスティング形式とパス形式のエンドポイントではリージョン固有のエンドポイント名を使用します。
例 仮想ホスティング形式のデュアルスタックのエンドポイントのリクエスト
米国西部 (オレゴン) リージョンにある puppy.jpg という名前のバケットから examplebucket オブジェクトを取得する次の例に示すように、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 デュアルスタックのエンドポイントの使用」を参照してください。
REST API を使用したリクエストの詳細については、以下のトピックをご参照ください。
