# 导出APIG的API
APIG支持把已创建的API按照OAS标准定义的格式导出，方便用户用于迁移、备份、共享等场景。
#### 约束与限制
- API网关参数限制：
  - 暂不支持formData和body位置的请求参数定义。
  
  - 暂不支持consumes和produces定义。
  
  - header位置的参数名称，不区分大小写。
   
- 后端策略限制：
  - 默认后端类型为HTTP时，策略后端支持HTTP、HTTP-VPC。
  
  - 默认后端类型为HTTP-VPC时，策略后端支持HTTP、HTTP-VPC。
  
  - 默认后端类型为function时，策略后端支持function。
  
  - 默认后端类型为mock时，策略后端支持mock。
   
- 如果存在路径相同但匹配模式不同的API，导出的Swagger中，使用前缀匹配的API路径将带有"default_swa_path"变量的后缀，并且其匹配模式将被替换为绝对匹配。
- 当前仅能导出API的前端配置和后端配置信息。
- 暂不支持导出GRPC API。
 
#### 导出API
1. 进入[API网关控制台](https://console.huaweicloud.com/apig2/#/overview)页面。
2. 根据实际业务在左侧导航栏上方选择实例。

3. 在左侧导航栏选择"API管理 \> API分组"。单击分组名称然后单击"导出"*。*
   
   或在左侧导航栏选择"API管理 \> API列表"，单击"导出API"。
   
   
4. 根据下表参数说明，设置导出参数。 
   表1导出API 
   | 参数        | 说明                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   |:---|:---|
   | API分组     | 选择待导出API所在的API分组。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   | 运行环境      | 选择待导出API所在的环境。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
   | API       | 默认导出API分组所在环境的所有的API，如果需要导出个别API，单击"自定义导出API"，勾选需要导出的API名称。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   | API定义范围   | 选择API定义导出的范围，当前支持四种定义范围。 - 全量定义：包括API前端请求定义、后端服务定义和响应定义。适用于将API定义备份为Swagger或OpenAPI文件。  - 扩展定义：包括API前端请求定义、后端服务定义和响应定义，还包括API关联的流量控制策略、访问控制策略、插件策略的定义和绑定关系的导出。  - 基础定义：包括API前端请求定义和响应定义，不包括后端服务定义。其中API前端请求定义除了Swagger规范定义项外，还包括API网关的一些Swagger扩展字段。适用于生成Swagger或OpenAPI格式的API文档定义。  - 开发定义：在全量定义基础上增加未发布的API的前后端定义。   |
   | 导出格式      | 选择JSON、YAML或YML。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
   | 自定义版本     | 为导出的API自定义版本号，如果没有指定版本号，默认使用当前时间。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
   | OpenAPI版本 | 选择导出Swagger 2.0或OpenAPI 3.0定义的API。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
      
   
   
5. 单击"导出"，右侧显示导出结果，并自动下载文件。
 
#### 相关文档
如果您希望通过API导出API，请参考[导出API](https://support.huaweicloud.com/api-apig/ExportApiDefinitionsV2.html)。