本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
从 API Gateway 导出 REST API
使用 API Gateway 控制台或其他方式在 API Gateway 中创建和配置 REST API 后，您可以使用 API Gateway 导出 API（该 API 是 Amazon API Gateway 控制服务的一部分）将其导出到 OpenAPI 文件。要使用 API Gateway 导出 API，您需要签署您的 API 请求。有关签署请求的更多信息，请参阅《IAM 用户指南》中的签署 Amazon API 请求。您可以在导出的 OpenAPI 定义文件中包含 API Gateway 集成扩展以及 Postman
注意
使用 Amazon CLI 导出 API 时，请务必包含扩展参数，如以下示例所示，以确保包含 x-amazon-apigateway-request-validator 扩展：
aws apigateway get-export --parameters extensions='apigateway' --rest-api-id abcdefg123 --stage-name dev --export-type swagger latestswagger2.json
如果 API 的负载并非 application/json 类型，则您无法将其导出。如果尝试导出，您将收到一条错误响应，指出未找到 JSON 正文模型。
请求导出 REST API
借助 Export API，您可以提交 GET 请求，将要导出的 REST 指定为 URL 路径的一部分，以此来导出现有 REST API。请求 URL 的格式如下：
您可以附加 extensions 查询字符串，以指定是否要包含 API Gateway 扩展（含 integration 值）或 Postman 扩展（含 postman 值）。
此外，您还可以将 Accept 标头设置为 application/json 或 application/yaml，以分别接收 JSON 格式或 YAML 格式的 API 定义输出。
有关使用 API Gateway 导出 API 提交 GET 请求的更多信息，请参阅 GetExport。
注意
如果您在 API 中定义模型，那么这些模型的内容类型必须为“application/json”，这样 API Gateway 才能将其导出。否则，API Gateway 会引发异常，并显示“仅找到适用于……的非 JSON 正文模型”的错误消息。
模型必须包含属性或者被定义为特定 JSONSchema 类型。
下载 JSON 格式的 REST API OpenAPI 定义
要下载 JSON 格式的 REST API OpenAPI 定义，请执行以下操作：
这里的 <region>us-east-1。有关提供 API Gateway 的所有区域，请参阅区域和终端节点
下载 YAML 格式的 REST API OpenAPI 定义
要下载 YAML 格式的 REST API OpenAPI 定义，请执行以下操作：
借助 Postman 扩展下载 JSON 格式的 REST API OpenAPI 定义
借助 Postman 导出并下载 JSON 格式的 REST API OpenAPI 定义，请执行以下操作：
借助 API Gateway 集成下载 YAML 格式的 REST API OpenAPI 定义
要借助 API Gateway 集成导出并下载 YAML 格式的 REST API OpenAPI 定义，请执行以下操作：
使用 API Gateway 控制台导出 REST API
将 REST API 部署到一个阶段之后，您可以使用 API Gateway 控制台将此阶段中的 API 导出到 OpenAPI 文件。
在 API Gateway 控制台的阶段窗格中，选择阶段操作，然后选择导出。
指定 API 规范类型、格式和扩展以下载您 API 的 OpenAPI 定义。