更新时间:2023-05-30 GMT+08:00
分享

导入导出API

概述

ROMA Connect支持通过文件的方式导入导出API。

  • 导入API:支持导入YAML和JSON格式API定义文件,且文件内容应满足Swagger 2.0规范。
  • 导出API:支持导出YAML和JSON格式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列表”页签上方单击“更多 > 导入API”。
  3. 在导入API页面中,配置API导入相关信息。
    表1 导入API

    参数

    配置说明

    导入方式

    选择API的导入方式。

    • 生成新的分组:将API导入到一个新的API分组,导入过程中系统会自动创建一个新的API分组,并将导入的API归属到该分组。
    • 选择已有分组:选择一个已有API分组,并将导入的API添加到该分组。

    类型

    仅当“导入方式”选择“生成新的分组”时需要配置。

    选择API分组的类型。

    • 集成应用:API分组归属某个集成应用,仅拥有该集成应用权限的用户可查看和操作该API分组。
    • 全局:所有用户都可查看和操作该API分组。

    集成应用

    仅当“类型”选择“集成应用”时需要配置。

    选择API分组所属的集成应用。

    是否覆盖

    仅当“导入方式”选择“选择已有分组”时需要配置。

    当导入的API与API分组中已有的API定义冲突时,是否使用导入的API覆盖已有的API。

    扩展覆盖

    当导入的API中定义的扩展信息(如自定义认证、流控策略、访问控制策略等)与ROMA Connect中已有的扩展信息冲突时,是否使用导入的信息覆盖已有信息。

    • 勾选:使用导入文件中定义的扩展信息覆盖掉系统已有信息。
    • 不勾选:使用系统已有扩展信息,不使用导入文件中的扩展信息。

    导入参数

    选择并检查导入文件。

    • 单击“文件”,选择本地要导入的YAML或JSON格式API定义文件。
    • 导入文件后,单击“检查”,可检查导入文件的内容格式是否符合规范要求。
    • 单击“格式化”,可对导入文件的内容进行格式化。
    • 单击“下载”,可把导入的文件内容下载到本地。
    • 是否启用Mock后端,表示是否使用Mock服务作为导入API的后端服务。
  4. 单击“快速导入”,导入API。

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

    导入的API未发布到环境,您需要手动发布API。

导出API

  1. 登录ROMA Connect控制台,在“实例”页面单击实例上的“查看控制台”,进入实例控制台。
  2. 在左侧的导航栏选择“服务集成 APIC > API管理”,在“API列表”页签上方单击“更多 > 导出API”。
  3. 在导出API页面中,配置API导出相关信息。
    表2 导出API

    参数

    配置说明

    API分组

    选择要导出API所在的API分组。

    运行环境

    选择要导出API所在的发布环境。

    API

    自定义选择要导出的API。若不配置,则默认导出API分组在所选环境下的所有的API。

    API定义范围

    选择要导出的API定义信息范围。

    • 基础定义:仅导出API前端请求信息,不包括后端服务信息。其中API前端信息除了Swagger 2.0规范定义项外,还包括ROMA Connect的一些Swagger扩展字段。
    • 全量定义:包括API前端请求信息和后端服务信息。
    • 扩展定义:包括API前端请求信息、后端服务信息,以及API关联的流量控制策略、访问控制策略信息。

    导出格式

    选择导出的API定义文件格式,可选择“YAML”和“JSON”。

    自定义版本

    填写导出的API定义文件版本号,如果没有指定版本号,默认使用当前时间作为版本号。

  4. 单击“导出”,导出API定义文件到本地,界面右侧显示导出的文件内容结果。
    • 若导出API所在的API分组未绑定独立域名,则导出API分组的子域名。
    • 若导出API所在的API分组绑定了多个独立域名,则只随机导出其中的一个独立域名。

相关文档