API Gateway コンソールを使用したバイナリサポートの有効化

このセクションでは、API Gateway コンソールを使用してバイナリサポートを有効にする方法ついて説明します。例として、Amazon S3 と統合された API を使用します。サポートされるメディアタイプを設定するタスクと、ペイロードの処理方法を指定する方法に焦点を当てます。Amazon S3 と統合された API を作成する方法の詳細については、「Amazon S3 プロキシとして API を作成する」を参照してください。

API Gateway コンソールを使用してバイナリサポートを有効にするには

API のバイナリメディアタイプの設定
1. 新しい API を作成するか、既存の API を選択します。この例では、API に FileMan という名前を付けます。
2. プライマリナビゲーションパネルの選択した API で、[Settings] を選択します。
3. [Settings] ペインで、[Binary Media Types] セクションの [Add Binary Media] を選択します。
4. 必要なメディアタイプ (例: image/png) を入力テキストフィールドに入力します。必要に応じて、このステップを繰り返して他のメディアタイプを追加します。
5. [Save Changes] を選択します。
API メソッドのメッセージペイロードを処理する方法を設定します。
1. API で新しいリソースを作成するか、既存のリソースを選択します。この例では、/{folder}/{item} リソースを使用します。
2. リソースで新しいメソッドを作成するか、既存のメソッドを選択します。例として、Amazon S3 で Object GET アクションと統合された GET /{folder}/{item} メソッドを使用します。
3. [Content Handling] で、オプションを選択します。
  
  クライアントとバックエンドが同じバイナリ形式を受け入れるときに本文を変換しない場合は、[Passthrough] を選択します。たとえば、バイナリリクエストペイロードを JSON プロパティとして渡すことがバックエンドで要求される場合などに、バイナリ本文を Base64 でエンコードされた文字列に変換するには、[Convert to text (if needed)] を選択します。また、クライアントが Base64 でエンコードされた文字列を送信してバックエンドが元のバイナリ形式を要求する場合や、エンドポイントが Base64 でエンコードされた文字列を返してクライアントがバイナリ出力のみ受け入れる場合は、[Convert to binary (if needed)] を選択します。
4. 統合リクエストで、受信リクエストの Accept ヘッダーを保持します。これは、contentHandling を passthrough に設定し、実行時にその設定を上書きする場合に行う必要があります。
5. リクエストボディでパススルー動作を有効にします。
6. テキストに変換する場合は、Base64 でエンコードされたバイナリデータを必要な形式にするマッピングテンプレートを定義します。
  
  このマッピングテンプレートの形式は、入力のエンドポイント要件によって異なります。

ブラウザで JavaScript が無効になっているか、または使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。詳細については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

« 前次 »