如果要将 API Connect 与 IBM® Cloud Pak for
Integration配合使用,那么可以从 CP4I 资产存储库导入 API 定义。
关于本任务
要完成此任务,必须为您分配具有 Api-Drafts:Edit 许可权的角色。 “开发者”角色默认拥有此权限;如果您被分配了一个自定义角色,该角色必须拥有此权限。 有关更多信息,请参阅 创建定制角色。
过程
- 在导航窗格中,单击
“开发 ”,然后单击 ”。这样会显示选择 API 类型屏幕。
- 根据 API 要基于的 OpenAPI 规范版本,选择 OpenAPI 2.0 或 OpenAPI 3.0 。
- 在 "导入" 部分中,选择 从资产存储库,然后单击 下一步。
- 单击 启动资产存储库。
- 从资产存储库列表中,单击要导入的 API 的名称。
API 资源管理器窗口将打开,允许您检查 API 的详细信息。
- 单击 从资产创建。
系统将检查 API 定义的有效性,并显示一条消息指示验证成功。
- 单击下一步。
- 可选: 如果您希望立即使用该 API 进行后续开发和测试,请选择 “激活 API”。
注:
- 选择 激活 API 选项时, API Connect 会自动完成以下操作:
- 创建草稿产品,将 API 添加到该产品,并将该产品发布到沙箱目录以便可以调用该 API。 产品标题为
api_title 自动产品。 此产品在开发视图中不可见,您无法直接删除。 但是,如果您删除了该 API,草稿产品将随 API 一起被删除;请参阅 “删除 API 定义 ”。 该产品在它发布至的任何目录中可见。 若要将产品从目录中移除,必须单独进行此操作;请参阅 “从目录中移除产品”
- 为产品预订沙箱测试应用程序,以便立即在测试环境中对 API 进行测试。 有关测试 API 的信息,请参阅 测试 API。
- 如果在沙盒目录中为“预览”、“发布”或“替换”操作启用了生命周期审批,则无法使用 “激活 API ”选项。 如果启用了任何此类生命周期审批,则必须将其禁用才能使用“激活 API ”选项;有关生命周期审批设置的详细信息,请参阅 《创建和配置目录》。
- 要使用 激活 API 选项,必须为您分配具有
Product:Manage 和 Subscription:Manage 许可权的角色。 缺省情况下,预先提供的开发者角色具有这些许可权;如果为您分配了定制角色,那么必须具有这些许可权。 有关更多信息,请参阅 创建定制角色。
- 单击下一步。
“摘要”面板会在创建 API 定义时显示消息。
- 选择以下某个选项:
- 要进一步配置 API,请单击编辑 API。 有关详细信息,请参阅 编辑 API 定义。
- 如果此时不想要进一步配置 API,请单击面包屑跟踪中的开发链接,以返回到欢迎页面;随后即可立即继续处理其他任务。 有关以后如何配置 API 的详细信息,请参阅 编辑 API 定义。