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

新しい Amazon S3 ユーザーガイドにようこそ! Amazon S3 ユーザーガイドは、使用中止された 3 つのガイド (Amazon S3 開発者ガイドAmazon S3 コンソールユーザーガイドAmazon S3 入門ガイド) の情報と手順をまとめたものです。

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

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

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

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

s3.Region.amazonaws.com

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

  • Amazon S3 Access Pointss3-accesspoint.Region.amazonaws.com

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

Amazon S3 リージョンとエンドポイントの完全なリストについては、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 月 23 日) – パス形式 URL の非推奨化を延期し、お客様が仮想ホスティング形式の URL への移行に必要な時間を確保できるようにすることを決定しました。詳細については、AWS News Blog の 「Amazon S3 Path Deprecation Plan – The Rest of the Story」を参照してください。

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 デュアルスタックのエンドポイントの使用」を参照してください。

REST API を使用したリクエストの詳細については、以下のトピックをご参照ください。