「翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。」
API Gateway から REST API をエクスポートする
API Gateway で REST API を作成および設定したら、API Gateway コンソールなどから API Gateway Export API (Amazon
API Gateway Control Service の一部です) を使用して、API を OpenAPI ファイルにエクスポートできます。エクスポートされた OpenAPI
定義ファイルに、API Gateway 統合の拡張機能と、Postman
AWS CLI を使用して API をエクスポートする場合、次の例に示すように extensions パラメータを必ず含めて、x-amazon-apigateway-request-validator
拡張子が含まれるようにします。
aws apigateway get-export --parameters extensions='apigateway' --rest-api-id abcdefg123 --stage-name dev --export-type swagger latestswagger2.json
ペイロードが application/json
型でない場合、API をエクスポートすることはできません。エクスポートを試みると、JSON 本文モデルが見つからないことを示すエラーレスポンスが返されます。
REST API をエクスポートするリクエスト
Export API を使用すると、GET リクエストを送信し、URL パスの一部としてエクスポートされる API を指定することにより、既存の REST API をエクスポートします。リクエストの URL は次の形式です。
extensions
クエリ文字列を追加して、(値 integration
を使用) API Gateway 拡張を含めるか、(値 postman
を使用) Postman 拡張を含めるかを指定できます。
さらに、Accept
ヘッダーを application/json
または application/yaml
に設定して、それぞれ JSON 形式または YAML 形式で API 定義の出力を受け取ることができます。
API Gateway Export API を使用して GET リクエストを送信する詳細については、「Making HTTP Requests」を参照してください。
API でモデルを定義する場合、モデルをエクスポートする API Gateway の "application/json" のコンテンツタイプである必要があります。それ以外の場合、API Gateway は「Only found non-JSON body models for ...」というエラーメッセージとともに例外をスローします。
モデルはプロパティを含むか、特定の JSONSchema 型として定義される必要があります。
REST API OpenAPI 定義を JSON でダウンロードする
OpenAPI 定義を JSON 形式にして REST API をエクスポートおよびダウンロードするには、以下のようにします。
ここで、
はたとえば <region>
us-east-1
にできます。API Gateway が利用可能なすべてのリージョンのリストについては、「リージョンとエンドポイント」を参照してください。
REST API OpenAPI 定義を YAML でダウンロードする
OpenAPI 定義を YAML 形式にして REST API をエクスポートおよびダウンロードするには、以下のようにします。
Postman 拡張機能を使用して REST API OpenAPI 定義を JSON でダウンロードする
Postman を使用して OpenAPI 定義を JSON 形式にして REST API をエクスポートおよびダウンロードするには、以下のようにします。
API Gateway 統合を使用して REST API OpenAPI 定義ファイルを YAML でダウンロードする
OpenAPI 定義を YAML 形式にして API Gateway 統合を使用して REST API をエクスポートおよびダウンロードするには、以下のようにします。
API Gateway コンソールを使用して REST API をエクスポートする
REST API をステージにデプロイしたら、次に API Gateway コンソールを使用してステージ内の API を OpenAPI ファイルにエクスポートすることができます。
API Gateway コンソールの [ステージ設定] ページで、[エクスポート] タブを選択し、利用可能なオプション ([OpenAPI としてエクスポート]、[OpenAPI としてエクスポート + API Gateway 統合]、および [Postman としてエクスポート]) の 1 つを選択して API の OpenAPI 定義をダウンロードします。
