全部产品
Search
文档中心

服务器迁移中心:CreateCrossZoneMigrationJob - 创建跨可用区迁移任务

更新时间:Oct 29, 2024

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

接口说明

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

调试

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

授权信息

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

  • 操作:是指具体的权限点。
  • 访问级别:是指每个操作的访问级别,取值为写入(Write)、读取(Read)或列出(List)。
  • 资源类型:是指操作中支持授权的资源类型。具体说明如下:
    • 对于必选的资源类型,用背景高亮的方式表示。
    • 对于不支持资源级授权的操作,用全部资源表示。
  • 条件关键字:是指云产品自身定义的条件关键字。
  • 关联操作:是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限,操作才能成功。
操作访问级别资源类型条件关键字关联操作
smc:CreateCrossZoneMigrationJobcreate
  • 全部资源
    *

请求参数

名称类型必填描述示例值
RegionIdstring

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

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

cn-hangzhou
ClientTokenstring

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

123e4567-e89b-12d3-a456-426655440000
InstanceIdstring

实例 ID。

i-bp1ff25rzvnul6kr****
TargetVSwitchIdstring

目标阿里云服务器 ecs 的交换机 id。

vsw-bp1mxqnssl8nafltcx32e
TargetZoneIdstring

目标可用区 id。

cn-hangzhou-i
TargetInstanceTypestring

目标实例规格

ecs.g7.large
AutoPayboolean

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

  • true:(默认值)自动付费,请确保账号有足够的余额。
  • false:手动付费。具体操作请参见手动续费包年包月实例
false
Diskarray<object>

云盘列表。

object

云盘列表。

DiskIdstring

云盘 ID。

d-bp1eeplkn4j29wf7irpb
Categorystring

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

cloud_essd
PerformanceLevelstring

ESSD 云盘的性能等级。可能值:

  • PL0:单盘最高随机读写 IOPS 1 万。
  • PL1:单盘最高随机读写 IOPS 5 万。
  • PL2:单盘最高随机读写 IOPS 10 万。
  • PL3:单盘最高随机读写 IOPS 100 万。
PL0
ResourceGroupIdstring

资源组 ID。

rg-acfmw3ty5y7****

返回参数

名称类型描述示例值
object

返回参数信息。

RequestIdstring

请求 ID。

A9DBD2F8-DE5A-5844-BA6F-957A996CBD78
JobIdstring

迁移任务 ID。

j-bp17bclvg344jlyt****

示例

正常返回示例

JSON格式

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

错误码

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

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