调用MigrateToOtherZone,迁移对应可用区下的节点到目标可用区。

当您升配实例,遇到可用区规格库存不足的问题时,可以通过迁移可用区节点来解决。在调用此接口前,需要确保:

  • 当前账号存在资源充足的可用区。

    在迁移当前规格的节点到其他可用区后,需手动升配集群,并不会在迁移过程中升配集群,因此要选择资源充足的可用区,避免集群升配失败。建议优先选择字母顺序靠后的新可用区(例如对于cn-hangzhou-e和cn-hangzhou-h可用区,优先选择cn-hangzhou-h)。

  • 集群处于健康状态。

    可通过GET _cat/health?v命令查看集群健康状态。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求头

该接口使用公共请求头,无特殊请求头。请参见公共请求参数文档。

请求语法

POST /openapi/instances/[InstanceId]/actions/migrate-zones HTTPS|HTTP

请求参数

名称 类型 是否必选 示例值 描述
dryRun Boolean false

校验是否可以进行可用区节点迁移。true表示只校验不执行迁移任务;false表示校验通过后即进行迁移任务。

InstanceId String es-cn-n6w1o1x0w001c****

实例ID。

RequestBody

RequestBody中还需填入以下参数,用来指定迁移的可用区信息。

名称

类型

是否必选

示例值

描述

fromZoneId

String

cn-hangzhou-i

实例目前所在的可用区。

toZoneId

String

cn-hangzhou-b

迁移到的目标可用区。

toVswitchId

String

vsw-bp1f7r0ma00pf9h2l****

虚拟交换机ID。

示例如下。


{
    "fromZoneId": "cn-hangzhou-e",
    "toZoneId": "cn-hangzhou-f",
    "toVswitchId": "vsw-bp16t5hpc689dgkgc****"
}

返回数据

名称 类型 示例值 描述
RequestId String 5FFD9ED4-C2EC-4E89-B22B-1ACB6FE1****

请求ID。

Result Boolean true

返回结果:

  • true:迁移成功
  • false:迁移失败

示例

请求示例

POST /openapi/instances/es-cn-n6w1o1x0w001c****/actions/migrate-zones?dryRun=false HTTP/1.1
公共请求头
{
    "fromZoneId": "cn-hangzhou-e",
    "toZoneId": "cn-hangzhou-f",
    "toVswitchId": "vsw-bp16t5hpc689dgkgc****"
}

正常返回示例

XML 格式

<Result>true</Result>
<RequestId>24A77388-9444-49A3-A1CF-F48385E5****</RequestId>

JSON 格式

{
	"Result": true,
	"RequestId": "24A77388-9444-49A3-A1CF-F48385E5****"
}

错误码

访问错误中心查看更多错误码。