实例可用区迁移

接口说明

实例可用区迁移。

实例可用区迁移所需时间和数据量大小有关，整个过程可能耗时1小时，并且会伴随60秒以内的闪断，请在业务低峰期执行迁移可用区操作。建议使用高可用连接进行访问，并且确保应用程序具有重连机制。

约束说明

• 支持DDS社区版集群、副本集实例。
• 跨AZ实例不支持该操作。
• IPV6子网创建的实例不支持该操作。
• 针对副本集实例，如果当前存在只读节点或未激活的备节点，不支持该操作。
• 针对集群实例，如果当前存在只读节点，不支持该操作。

URI

• URI格式

  POST https://{Endpoint}/v3/{project_id}/instances/{instance_id}/migrate

• URI样例

  https://dds.ap-southeast-1.myhuaweicloud.com/v3/0549b4a43100d4f32f51c01c2fe4acdb/instances/9136fd2a9fcd405ea4674276ce36dae8in02/migrate

请求消息

• 参数说明

  表2 参数说明

  名称	参数类型	是否必选	描述
  target_azs	String	是	迁移到的目标单az或者多az。该值从查询实例可迁移到的可用区接口的返回体中code字段获取。

请求示例

• 迁移实例可用区到单az

  { 
          "target_azs":"az1xahz"
  }

• 迁移实例可用区到多az

  {
  	"target_azs":"az1xahz,az2xahz,az3xahz"
  }

响应消息

• 参数说明

  表3 参数说明

  名称	参数类型	是否必选	描述
  job_id	String	是	任务ID。

• 响应示例

  { 
      "job_id": "3711e2ad-5787-49bc-a47f-3f0b066af9f5" 
  }

SDK

单击文档数据库服务 DDS SDK，下载SDK或查看SDK文档。SDK的安装、认证方式等在SDK文档中对应语言类型的【使用】目录下。

状态码

详情请参见状态码。

错误码

详情请参见错误码。