CreateCrossZoneMigrationJob - 创建跨可用区迁移任务

SMC支持将阿里云云服务器ECS迁移到同地域的不同可用区,同时也支持在同规格族内更改实例规格(vCPU和内存),满足您迁移云服务器ECS和变配实例规格的业务需求。您可以通过此接口创建跨可用区任务。

接口说明

关于跨可用区迁移的使用限制及其迁移影响等信息,请参见跨可用区迁移操作

调试

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

调试

授权信息

下表是API对应的授权信息,可以在RAM权限策略语句的Action元素中使用,用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下:

  • 操作:是指具体的权限点。

  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。

  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:

    • 对于必选的资源类型,用前面加 * 表示。

    • 对于不支持资源级授权的操作,用全部资源表示。

  • 条件关键字:是指云产品自身定义的条件关键字。

  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

smc:CreateCrossZoneMigrationJob

create

*全部资源

*

请求参数

名称

类型

必填

描述

示例值

RegionId

string

迁移源要迁入的目标阿里云地域 ID。

例如,您需要迁移源服务器至杭州,则相应的阿里云地域 ID 为cn-hangzhou。您可以调用 DescribeRegions 查看最新的阿里云地域列表。

cn-hangzhou

ClientToken

string

保证请求幂等性。从您的客户端生成一个参数值,确保不同请求间该参数值唯一。ClientToken 只支持 ASCII 字符,且不能超过 64 个字符。更多详情,请参见如何保证幂等性

123e4567-e89b-12d3-a456-426655440000

InstanceId

string

ECS 实例 ID。

i-bp1ff25rzvnul6kr****

TargetVSwitchId

string

目标交换机 ID。

vsw-bp1mxqnssl8nafltc****

TargetZoneId

string

目标可用区 ID。

cn-hangzhou-i

TargetInstanceType

string

目标实例规格。

ecs.g7.large

AutoPay

boolean

是否自动付费,取值说明:

  • true:(默认值)自动付费,请确保账号有足够的余额。

  • false:手动付费。具体操作,请参见手动续费包年包月实例

false

Disk

array<object>

云盘信息。

object

云盘对象。

DiskId

string

云盘 ID。

d-bp1eeplkn4j29wf7****

Category

string

云盘种类为 cloud_essd,表示 ESSD 云盘。

cloud_essd

PerformanceLevel

string

ESSD 云盘的性能等级。取值范围:

  • PL0:单盘最高随机读写 IOPS 1 万。

  • PL1:单盘最高随机读写 IOPS 5 万。

  • PL2:单盘最高随机读写 IOPS 10 万。

  • PL3:单盘最高随机读写 IOPS 100 万。

PL0

ResourceGroupId

string

资源组 ID。

rg-acfmw3ty5y7****

返回参数

名称

类型

描述

示例值

object

返回参数信息。

RequestId

string

请求 ID。

A9DBD2F8-DE5A-5844-BA6F-957A996CBD78

JobId

string

迁移任务 ID。

j-bp17bclvg344jlyt****

示例

正常返回示例

JSON格式

{
  "RequestId": "A9DBD2F8-DE5A-5844-BA6F-957A996CBD78",
  "JobId": "j-bp17bclvg344jlyt****"
}

错误码

HTTP status code

错误码

错误信息

描述

400 ReplicationJobDataDiskIndex.Invalid The specified replication job contains data disk index not found in source server. 迁移任务包含的数据盘索引在迁移源中不存在。
400 VSwitchIdVpcId.Mismatch The specified VSwitchId and VpcId does not match. 指定的VSwitchIdVpcId不匹配。
400 InvalidSecurityGroupId.IncorrectNetworkType The network type of the specified security group does not support this action. 安全组网络类型不支持该操作,请检查安全组网络类型。
400 InvalidSecurityGroupId.VPCMismatch The specified security group and the specified virtual switch are not in the same VPC. 指定的安全组和交换机不在一个专有网络。
400 QuotaExceeded.ReplicationJob The maximum number of replication jobs is exceeded. Please submit a ticket to raise the quota. 迁移任务的数量已超过最大允许值,请提交工单。
400 ReplicationJobName.Duplicate The specified replication job name already exists. 迁移任务名称已存在,请修改迁移任务名称。
400 SourceServerState.Invalid The specified source server status: %s is invalid. This operation can only be performed in the following status: %s. 迁移源的状态:%s 是无效的。该操作只能在以下状态进行:%s。
500 InternalError An error occurred while processing your request. Please try again. If the problem still exists, please submit a ticket. 内部错误,请重试。如果多次尝试失败,请提交工单。
403 EntityNotExist.Role The account is unauthorized. Please assign the role AliyunServiceRoleForSMC to your account. 账号不具备操作权限,请赋予账户AliyunServiceRoleForSMC角色。

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

变更历史

更多信息,参考变更详情