通过API设计文件导入API

前提条件

• 导入API前，您需要在导入的API定义文件中补全API的Swagger扩展定义。
• 导入API前，请确保API和API分组的配额满足需求。
• 如果导入API时选择“生成新的分组”，则会使用API定义文件中的“info.title”字段值作为API分组名称。在导入API前，不能手动修改API定义文件中的“info.title”字段值。

导入API

1. 登录ROMA Connect控制台，在左侧导航栏选择“资源管理”，在实例页面单击实例，进入实例控制台。
2. 在左侧的导航栏选择“服务集成 APIC > API列表”，在页面右上角单击“导入API”。

   您也可以在“服务集成 APIC > API分组”页面中，单击“创建API分组 > 导入API设计文件”，导入API。

3. 在弹窗中选择本地要导入的YAML或JSON格式Swagger文件。
4. 在导入Swagger文件页面中，配置API导入相关信息。

   表1 导入API

   参数	说明
   导入方式	选择API的导入方式。 生成新的分组：将API导入到一个新的API分组，导入过程中系统会自动创建一个新的API分组，并将导入的API归属到该分组。 选择已有分组：选择一个已有API分组，并将导入的API添加到该分组。
   可见范围	仅当“导入方式”选择“生成新的分组”时需要配置。 选择API分组的可见范围。 集成应用：API分组归属某个集成应用，仅拥有该集成应用权限的用户可查看和操作该API分组。 全局：当前实例的所有用户都可查看和操作该API分组。
   集成应用	仅当“可见范围”选择“集成应用”时需要配置。 选择API分组所属的集成应用。
   是否覆盖	仅当“导入方式”选择“选择已有分组”时需要配置。 当导入的API与API分组中已有的API定义冲突时，是否使用导入的API覆盖已有的API。
   扩展覆盖	当导入的API中定义的扩展信息（如自定义认证、流控策略、访问控制策略等）与ROMA Connect中已有的扩展信息冲突时，是否使用导入的信息覆盖已有信息。 勾选：使用导入文件中定义的扩展信息覆盖掉系统已有信息。 不勾选：使用系统已有扩展信息，不使用导入文件中的扩展信息。
   导入参数	检查导入的文件内容。 单击“检查”，可检查导入文件的内容格式是否符合规范要求。 单击“格式化”，可对导入文件的内容进行格式化。 单击“下载”，可把导入的文件内容下载到本地。 是否启用Mock后端，表示是否使用Mock服务作为导入API的后端服务。

5. 单击“立即导入”。

   如果您需要在导入前，对导入API的请求信息、后端服务信息进行统一配置，您可以单击“全局配置(可选)”，并根据页面向导配置API的信息。完成后单击“提交”，导入API。

6. 在弹窗中选择是否现在发布，若选择“现在发布”，则需要选择API要发布的环境。
7. 单击“确定”，导入API。