文档首页/ API网关 APIG/ 最佳实践/ 版本迁移/ APIG共享版迁移到专享版
更新时间:2024-11-27 GMT+08:00
分享

APIG共享版迁移到专享版

应用场景

APIG共享版即将退市,为了避免影响用户的业务,需要将共享版上已有资源迁移到专享版上继续使用。

约束与限制

  • 基于APIG共享版使用了云商店功能暂不支持迁移。
  • 基于APIG共享版使用了跨用户授权功能暂不支持迁移。
  • 基于APIG共享版使用了ELB通道类型的VPC通道暂不支持迁移。
  • 由DataArts创建的共享版资源需要由DataArts服务提供迁移。

涉及以上特殊场景的用户,可提交工单联系技术支持工程师协助处理。

迁移可能带来的影响

  1. 公网出入口的变化

    专享版实例可以根据需要分别开启公网入口和公网出口,每个实例都会有单独的公网入口IP和公网出口IP,该IP与原有的共享版IP不同,如果上游和下游(服务端和客户端)的相关服务有网络安全策略的设置,需要修改相应的网络安全策略,放通对应IP的访问。

  2. 内网出入口的变化

    每个专享版实例都会拥有一个VPC内的入口私有IP,以及VPC内的多个出口私有IP(专享实例的基础版、专业版、企业版,以及铂金版分别有3、5、6、7个私有地址。在铂金版的基础上,铂金版X依次增加4个私有地址。),上下游服务(服务端和客户端)需要酌情调整网络安全策略,保证网络可达。如果下游存在跨VPC调用的场景时,需要通过VPC终端节点对接到APIG专享版的VPC终端节点服务上,以保证网络可达。具体操作详见实施步骤

  3. 调试域名的变化

    原共享版的分组调试域名{group-id}.apig.{region-id}.huaweicloudapis.com将会更新为{group-id}.apic.{region-id}.huaweicloudapis.com,如果有使用调试域名进行API调用的,则需要做相应修改。

操作流程

  1. 迁移前检查

    检查共享版当前使用情况,确定是否可以迁移,以及专享版实例规格。

  2. 创建专享版实例

    根据检查结果,购买满足共享版需求的专享版实例。

  3. 申请迁移

    联系技术支持工程师或者客户经理,申请迁移共享版。

  4. 验证和切流

    验证迁移结果,并实施最终切流。

实施步骤

迁移前检查

  1. 查看用户是否使用云商店功能。

    登录API网关控制台页面,在“总览”页面右上角单击“进入共享版控制台”。
    • 在左侧导航栏中选择“开放API > API分组”,查看分组状态。如果全部分组状态显示为“未上架”,则说明未使用云商店功能,可以迁移共享版;否则,请提交工单联系技术支持工程师协助处理。

    • 在左侧导航栏中选择“调用API > 已购买API”,查看已购买的API。如果已购买API列表为空,则说明未使用云商店功能,可以迁移共享版;否则,请提交工单联系技术支持工程师协助处理。

  2. 查看API授权信息。

    1. 在左侧导航栏中选择“开放API > API管理”。
    2. 单击API名称,进入API详情页面。
    3. 单击“授权信息”页签,查看授权应用。如果授权的应用非用户自身的应用,则为跨用户授权场景,不支持迁移共享版,请提交工单联系技术支持工程师协助处理;否则,可以迁移共享版。

  3. 查看VPC通道类型。

    在左侧导航栏中选择“开放API > VPC通道”,查看通道类型。如果VPC通道类型为“ELB通道”,则不支持迁移共享版,请提交工单联系技术支持工程师协助处理;否则,可以迁移共享版。

  4. 查看是否存在DataArts服务创建的资源。

    在左侧导航栏中选择“开放API > API分组”,查看分组名称。如果分组名称由“dlm_default_”开头且描述中有“default api group created by dlm”字样,则表示该分组资源由DataArts服务创建。这部分资源需要联系DataArts的服务人员进行迁移,除DataArts以外的资源可以正常迁移。

  5. 查看所有API的近期调用量,累计求和后估算当前的QPS,最终确认需要购买的专享版实例规格。

    1. 在左侧导航栏中选择“开放API > API管理”。
    2. 单击API名称,进入API详情页面。
    3. 在“总览”页签中,查看“请求次数”,累计求和后估算QPS。

创建专享版实例

  1. 根据估算的QPS需求,选择购买专享版实例规格版本。规格详情请参考产品规格
  2. 购买实例。具体操作请参考购买实例

    • 创建实例时,VPC建议选择后端服务器所在的VPC,可以减少网络配置的复杂度。
    • 根据业务是否有公网访问和访问公网的需求,来确定是否开启实例的公网入口和公网出口。

申请迁移

联系技术支持工程师或者客户经理,申请迁移共享版,并提供如下信息。

迁移账号名称

XXXXX

迁移信息

项目ID

专享版实例ID

局点

XXX

XXX

XXX

验证和切流

  1. 迁移完成后,需要先在APIG专享版实例上调试验证迁移后的资源功能是否正常。

    • 可以使用调试功能来测试API功能是否正常,详情参考调试API
    • 可以使用分组调试域名进行API功能测试,详情参考调用API

  2. 验证完毕后进行切流,切流目前主要存在以下几种场景。

    • 使用独立域名从公网访问的场景

      需要将原来的自定义域名的cname记录从共享版分组子域名更改为专享版实例的实例域名{instance-id}.apic.{region-id}.huaweicloudapis.com。

    • 同VPC内使用独立域名从内网访问的场景

      需要将原来的自定义域名的cname记录从共享版分组子域名更改为专享版实例的实例域名{instance-id}.apic.{region-id}.huaweicloudapis.com。

    • 跨VPC使用独立域名从内网访问的场景
      1. 需要先使用VPC终端节点打通跨VPC的网络链路。具体操作请参考终端节点简介管理终端节点
      2. 将原来的自定义域名的cname记录从共享版分组子域名更改为2.a中创建的新VPC终端节点的域名。

相关文档