# APIG共享版迁移到专享版
#### 应用场景
[APIG共享版即将退市](https://www.huaweicloud.com/notice/2024/20241024093957484.html)，为了避免影响用户的业务，需要将共享版上已有资源迁移到专享版上继续使用。
#### 约束与限制
- 基于APIG共享版使用了云商店功能暂不支持迁移。
- 基于APIG共享版使用了跨用户授权功能暂不支持迁移。
- 基于APIG共享版使用了ELB通道类型的VPC通道暂不支持迁移。
- 由DataArts创建的共享版资源需要由DataArts服务提供迁移。
涉及以上特殊场景的用户，可[提交工单](https://console.huaweicloud.com/ticket/)联系技术支持工程师协助处理。
#### 迁移可能带来的影响
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调用的，则需要做相应修改。
   
 
#### 操作流程
![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002070382852.png)
1. 迁移前检查 检查共享版当前使用情况，以及专享版实例规格，确定是否可以迁移。
   
2. 创建专享版实例 根据检查结果，购买满足共享版需求的专享版实例。
   
3. 申请迁移 联系技术支持工程师或者客户经理，申请迁移共享版。
   
4. 验证和切流 验证迁移结果，并实施最终切流。
   
 
 #### 实施步骤
**迁移前检查**
1. 查看用户是否使用云商店功能。 
   进入API网关控制台页面，在"总览"页面右上角单击"进入共享版控制台"。
   - 在左侧导航栏中选择"开放API \> API分组"，查看分组状态。如果全部分组状态显示为"未上架"，则说明未使用云商店功能，可以迁移共享版；否则，请[提交工单](https://console.huaweicloud.com/ticket/)联系技术支持工程师协助处理。
     ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002105742477.png "点击放大")
     
   
   - 在左侧导航栏中选择"调用API \> 已购买API"，查看已购买的API。如果已购买API列表为空，则说明未使用云商店功能，可以迁移共享版；否则，请[提交工单](https://console.huaweicloud.com/ticket/)联系技术支持工程师协助处理。
     ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002105782505.png "点击放大")
     
    
   
   
2. 查看API授权信息。 
   1. 在左侧导航栏中选择"开放API \> API管理"。
   
   2. 单击API名称，进入API详情页面。
   
   3. 单击"授权信息"页签，查看授权应用。如果授权的应用非用户自身的应用，则为跨用户授权场景，不支持迁移共享版，请[提交工单](https://console.huaweicloud.com/ticket/)联系技术支持工程师协助处理；否则，可以迁移共享版。
      ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002069902800.png "点击放大")
      
   
   
   
   
3. 查看VPC通道类型。 
   在左侧导航栏中选择"开放API \> VPC通道"，查看通道类型。如果VPC通道类型为"ELB通道"，则不支持迁移共享版，请[提交工单](https://console.huaweicloud.com/ticket/)联系技术支持工程师协助处理；否则，可以迁移共享版。
   ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002070062572.png "点击放大")
   
   
4. 查看是否存在DataArts服务创建的资源。 
   在左侧导航栏中选择"开放API \> API分组"，查看分组名称。如果分组名称由"dlm_default_"开头且描述中有"default api group created by dlm"字样，则表示该分组资源由DataArts服务创建。这部分资源需要联系DataArts的服务人员进行迁移，除DataArts以外的资源可以正常迁移。
   ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002105742481.png "点击放大")
   
   
5. 查看所有API的近期调用量，累计求和后估算当前的QPS，最终确认需要购买的专享版实例规格。 
   1. 在左侧导航栏中选择"开放API \> API管理"。
   
   2. 单击API名称，进入API详情页面。
   
   3. 在"总览"页签中，查看"请求次数"，累计求和后估算QPS。 ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002105782509.png "点击放大")
      
   
   
   
   
**创建专享版实例**
1. 根据估算的QPS需求，选择购买专享版实例规格版本。规格详情请参考[产品规格](https://support.huaweicloud.com/productdesc-apig/apig-specifications.html)。
2. 购买实例。具体操作请参考[购买实例](https://support.huaweicloud.com/usermanual-apig/apig_03_0037.html)。
   
   - 创建实例时，VPC建议选择后端服务器所在的VPC，可以减少网络配置的复杂度。
   
   - 根据业务是否有公网访问和访问公网的需求，来确定是否开启实例的公网入口和公网出口。
   
   
   
   
**申请迁移**
联系技术支持工程师或者客户经理，申请迁移共享版，并提供如下信息。
|  **迁移账号名称**  |             XXXXX             |||
|---|---|---|---|
| ****迁移信息**** | **项目ID** | **专享版实例ID** | **局点** |
| ****迁移信息**** | XXX      | XXX         | XXX    |
   
**验证和切流**
1. 迁移完成后，需要先在APIG专享版实例上调试验证迁移后的资源功能是否正常。 
   - 可以使用调试功能来测试API功能是否正常，详情参考[调试API](https://support.huaweicloud.com/usermanual-apig/apig_03_0012.html)。
   
   - 可以使用分组调试域名进行API功能测试，详情参考[调用API](https://support.huaweicloud.com/usermanual-apig/apig-ug-0011.html)。
   
   
   
   
2. 验证完毕后进行切流，切流目前主要存在以下几种场景。 
   - 使用独立域名从公网访问的场景 需要将原来自定义域名的Cname记录从共享版分组子域名更改为专享版的实例域名{instance-id}.apic.{region-id}.huaweicloudapis.com。
     ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002106034769.png "点击放大")
     
   
   - 同VPC内使用独立域名从内网访问的场景 需要将原来的自定义域名的Cname记录从共享版分组子域名更改为专享版实例的实例域名{instance-id}.apic.{region-id}.huaweicloudapis.com。
     ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002106035045.png "点击放大")
     
   
   - 跨VPC使用独立域名从内网访问的场景
     1. 需要先使用VPC终端节点打通跨VPC的网络链路。具体操作请参考[终端节点简介](https://support.huaweicloud.com/usermanual-vpcep/vpcep_03_0204.html)和[管理终端节点](https://support.huaweicloud.com/usermanual-apig/apig_03_0063.html)。
     
     2. 将原来的自定义域名的Cname记录从共享版分组子域名更改为[2.a]中创建的新VPC终端节点的域名。
        ![](https://support.huaweicloud.com/bestpractice-apig/zh-cn_image_0000002129161841.png "点击放大")