チュートリアル: REST API を Amazon S3 のプロキシとして作成する

AWS Management Console にサインインして、IAM コンソール (https://console.aws.amazon.com/iam/) を開きます。

[ロール] を選択します。

[ロールの作成] を選択します。

[信頼されたエンティティの種類を選択] で [AWS のサービス] を選択し、[API Gateway]、[API Gateway が CloudWatch Logs にログをプッシュすることを許可] の順に選択します。

[次へ] を選択し、さらに [次へ] を選択します。

[ロール名] に「APIGatewayS3ProxyPolicy」と入力し、[ロールの作成] を選択します。

[ロール] リストで、作成したロールを選択します。ロールを検索するには、必要に応じてスクロールするか、検索バーを使用します。

選択したロールの [アクセス許可を追加] タブを選択します。

ドロップダウンリストから [ポリシーをアタッチ] を選択します。

検索バーに「AmazonS3FullAccess」と入力し、[アクセス許可を追加] を選択します。

新しく作成したロール ARN をメモしておきます。これは後で使用します。

Amazon S3 バケットを作成したのと同じ AWS リージョンで、MyS3 という名前の API を作成します。この API のルートリソース (/) は Amazon S3 サービスを表します。このステップでは、/{folder} と /{item} という 2 つの追加のリソースを作成します。

[リソースの作成] を選択します。

[プロキシのリソース] はオフのままにします。

[リソースパス] で、[/] を選択します。

[リソース名] に「{folder}」と入力します。

[CORS (Cross Origin Resource Sharing)] はオフのままにします。

[リソースの作成] を選択します。

/{folder} リソースを選択し、[リソースを作成] を選択します。

前のステップを使用して、/{folder} の子リソースを {item} という名前で作成します。

最終的な API は次のようになります。

/ リソースを選択し、[メソッドを作成] を選択します。

メソッドタイプとして、[GET] を選択します。

[統合タイプ] で、[AWS のサービス] を選択します。

[AWS リージョン] で、Amazon S3 バケットを作成した AWS リージョンを選択します。

[AWS のサービス] で、[Amazon Simple Storage Service] を選択します。

[AWS サブドメイン] は空白のままにします。

[HTTP メソッド] で、[GET] を選択します。

[アクションタイプ] で、[パスオーバーライドを使用] を選択します。

パスの上書きを使用すると、API Gateway はクライアントのリクエストを対応する Amazon S3 の REST API のパス形式のリクエストとして Amazon S3 に転送します。このリクエストでは、Amazon S3 のリソースは s3-host-name/bucket/key 形式のリソースパスで表されます。API Gateway は s3-host-name を設定し、クライアントが指定した bucket と key をクライアントから Amazon S3 に渡します。

[パスオーバーライド]] に「/」と入力します。

[実行ロール] に、APIGatewayS3ProxyPolicy のロール ARN を入力します。

[メソッドリクエストの設定] を選択します。

メソッドリクエストの設定を使用して、この API メソッドを誰が呼び出せるかを制御します。

[認可] で、ドロップダウンメニューから [AWS_IAM] を選択します。

[メソッドの作成] を選択します。

[メソッドレスポンス] タブの [レスポンス 200] で、[編集] を選択します。

[ヘッダーを追加] を選択し、次の操作を行います。

1. [ヘッダー名] に「Content-Type」と入力します。

2. [ヘッダーの追加] を選択します。

次の手順を繰り返して、Timestamp ヘッダーと Content-Length ヘッダーを作成します。

[Save] を選択します。

[メソッドレスポンス] タブの [メソッドレスポンス] で、[レスポンスを作成] を選択します。

[HTTP ステータスコード] に「400」と入力します。

このレスポンスにはヘッダーを設定しません。

[Save] を選択します。

次の手順を繰り返して 500 レスポンスを作成します。

このレスポンスにはヘッダーを設定しません。

[統合レスポンス] タブの [デフォルト - レスポンス] で、[編集] を選択します。

Content-Length ヘッダーに、マッピング値として「integration.response.header.Content-Length」と入力します。

Content-Type ヘッダーに、マッピング値として「integration.response.header.Content-Type」と入力します。

Timestamp ヘッダーに、マッピング値として「integration.response.header.Date」と入力します。

[Save] を選択します。結果は次のようになります。

[統合レスポンス] タブの [統合レスポンス] で、[レスポンスを作成] を選択します。

[HTTP status regex (HTTP ステータスの正規表現)]に「4\d{2}」と入力します。これにより、すべての 4xx HTTP レスポンスのステータスコードがメソッドレスポンスにマッピングされます。

[メソッドレスポンスのステータスコード] で [400] を選択します。

[Create] (作成) を選択します。

次の手順を繰り返して、500 メソッドレスポンスの統合レスポンスを作成します。[HTTP status regex (HTTP ステータスの正規表現)]に「5\d{2}」と入力します。

[テスト] タブを選択します。タブを表示するには、右矢印ボタンを選択する必要がある場合があります。

[テスト] を選択します。結果は次の図のようになります。

/{folder} リソースを選択し、[メソッドを作成] を選択します。

メソッドタイプとして、[GET] を選択します。

[統合タイプ] で、[AWS のサービス] を選択します。

[AWS リージョン] で、Amazon S3 バケットを作成した AWS リージョンを選択します。

[AWS のサービス] で、[Amazon Simple Storage Service] を選択します。

[AWS サブドメイン] は空白のままにします。

[HTTP メソッド] で、[GET] を選択します。

[アクションタイプ] で、[パスオーバーライドを使用] を選択します。

[パスオーバーライド] に「{bucket}」と入力します。

[実行ロール] に、APIGatewayS3ProxyPolicy のロール ARN を入力します。

[メソッドの作成] を選択します。

[統合リクエスト] タブの [統合リクエストの設定] で [編集] を選択します。

[URL パスパラメータ]、[パスパラメータを追加] を選択します。

[名前] にbucketと入力します。

[マッピング元] として「method.request.path.folder」と入力します。

[Save] を選択します。

[テスト] タブを選択します。タブを表示するには、右矢印ボタンを選択する必要がある場合があります。

[パス] の [folder] に、バケットの名前を入力します。

[テスト] を選択します。

テスト結果には、バケット内のオブジェクトのリストが含まれます。

/{item} リソースを選択し、[メソッドを作成] を選択します。

メソッドタイプとして、[GET] を選択します。

[統合タイプ] で、[AWS のサービス] を選択します。

[AWS リージョン] で、Amazon S3 バケットを作成した AWS リージョンを選択します。

[AWS のサービス] で、[Amazon Simple Storage Service] を選択します。

[AWS サブドメイン] は空白のままにします。

[HTTP メソッド] で、[GET] を選択します。

[アクションタイプ] で、[パスオーバーライドを使用] を選択します。

[パスオーバーライド] に、「{bucket}/{object}」と入力します。

[実行ロール] に、APIGatewayS3ProxyPolicy のロール ARN を入力します。

[メソッドの作成] を選択します。

[統合リクエスト] タブの [統合リクエストの設定] で、[編集] を選択します。

[URL パスパラメータ] を選択します。

[パスパラメータを追加] を選択します。

[名前] にbucketと入力します。

[マッピング元] として「method.request.path.folder」と入力します。

[パスパラメータを追加] を選択します。

[名前] にobjectと入力します。

[マッピング元] として「method.request.path.item」と入力します。

[Save] を選択します。

[テスト] タブを選択します。タブを表示するには、右矢印ボタンを選択する必要がある場合があります。

[パス] の [folder] に、バケットの名前を入力します。

[パス] の [item] に、項目の名前を入力します。

[テスト] を選択します。

レスポンス本文に項目の内容が含まれます。

リクエストは、指定した Amazon S3 バケット (amzn-s3-demo-bucket) の指定したファイル (test.txt) のコンテンツとして、プレーンテキストの (「Hello world」) を正しく返します。

影響を受けるファイルのメディアの種類を API の binaryMediaTypes に登録します。これは、コンソールで登録できます。

1. API の [API 設定] を選択します。

2. [バイナリメディアタイプ] で、[メディアタイプを管理] を選択します。

3. [バイナリメディアタイプを追加] を選択し、必要なメディアタイプ (例: image/png) を入力します。

4. [Save changes] (変更の保存) を選択して設定を保存します。

Content-Type ヘッダー (アップロードの場合) と Accept ヘッダー (ダウンロードの場合) をメソッドリクエストに追加し、必要なバイナリメディアタイプを指定するようにクライアントに要求して、統合リクエストにマッピングします。

登録リクエスト (アップロードの場合) および 統合レスポンス (ダウンロードの場合) で、[コンテンツの処理] を [Passthrough] に設定します。影響のあるコンテンツタイプで定義されているマッピングテンプレートがないことを確認します。詳細については、「統合パススルーの動作」と「VTL マッピングテンプレートを選択する」を参照してください。