服务器迁移中心
服务器迁移中心
文档指南
请输入
- 文档首页
服务器迁移中心API参考迁移任务CreateMigrationJob - 创建迁移任务
复制全文
下载 pdfCreateMigrationJob - 创建迁移任务
文档反馈
问问助手调用 CreateMigrationJob 接口，创建迁移任务。
注意事项
请求说明
如需进行增量数据迁移，请设置SyncConfig.TriggerLastSync参数为false，并通过SyncConfig.SyncInterval参数指定同步增量数据的间隔时间。
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action string 必选 示例值：CreateMigrationJob
要执行的操作，取值：CreateMigrationJob。
Version string 必选 示例值：2020-04-01
API的版本，取值：2020-04-01。
DestinationConfig.AutoReplicate boolean 可选 示例值：false
迁移任务通过预检后是否自动开始迁移。取值：
- false：默认，不自动迁移。
- true：自动迁移。
说明
仅迁移至云服务器实例、云服务镜像时有效。
DiskConfigs.N.Partitions.N.AbortPartition boolean[] 可选 示例值：DiskConfigs.0.Partitions.0.AbortPartition=false&DiskConfigs.0.Partitions.1.AbortPartition=false
迁移时是否跳过该分区。取值：
- false：默认，不跳过。
- true：跳过。
说明
- 仅Linux文件复制迁移到“云服务器镜像”时支持。
- 挂载点为/与/boot的分区必须迁移。
- 暂仅支持系统盘。
- 第一个N：表示磁盘序号，取值范围：0～14。
- 第二个N：表示分区序号。
- 多个分区配置之间用&分隔。
- 本参数正在邀测中，如需试用，请联系客户经理。
DiskConfigs.N.DestinationDiskSize long[] 可选 示例值：DiskConfigs.0.DestinationDiskSize=40
调整后目标云镜像磁盘容量，单位GiB。
- 参数 - N：表示磁盘序号，取值范围：0～14。
- 多个磁盘序号之间用&分隔。
- 系统盘容量大小支持范围为40 GiB ~ 2048 GiB，且需不低于迁移分区大小之和。
说明
本参数正在邀测中，如需试用，请联系客户经理。
DiskConfigs.N.Partitions.N.DestinationPartitionSize long[] 可选 示例值：DiskConfigs.0.Partitions.0.DestinationPartitionSize=200&DiskConfigs.0.Partitions.1.DestinationPartitionSize=300
调整后目标云镜像分区容量，单位Bytes。
- 第一个N：表示磁盘序号，取值范围：0～14。
- 第二个N：表示分区序号。
- 多个分区容量之间用&分隔。
说明
- 调整后分区大小不能小于已使用空间，且所有分区大小之和不能大于所属磁盘大小。
- 本参数正在邀测中，如需试用，请联系客户经理。
LvmInfo.VgInfos.N.Format string[] 可选 示例值：LvmInfo.VgInfos.1.Format=lvm2
待迁移逻辑卷组格式。
- 参数 - N：表示逻辑卷组序号。
- 多个逻辑卷组之间用&分隔。
注意
参数 - N 的值不能超过源服务器实际卷组数量。
LvmInfo.VgInfos.N.LvInfos.N.BlockDevices.N string[] 可选 示例值：LvmInfo.VgInfos.1.LvInfos.1.BlockDevices.1=/dev/vdb1
待迁移逻辑卷使用的磁盘块设备列表。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 第三个N：表示磁盘块设备序号。
- 多个磁盘块设备之间用&分隔。
LvmInfo.VgInfos.N.LvInfos.N.FsType string[] 可选 示例值：--
待迁移逻辑卷被格式化的文件系统类型。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 多个逻辑卷之间用&分隔。
LvmInfo.VgInfos.N.LvInfos.N.LvName string[] 可选 示例值：LvmInfo.VgInfos.1.LvInfos.1.LvName=lv01
待迁移逻辑卷名称。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 多个逻辑卷之间用&分隔。
LvmInfo.VgInfos.N.LvInfos.N.LvPath string[] 可选 示例值：LvmInfo.VgInfos.1.LvInfos.1.LvPath=/dev/vg_01/lv01
待迁移逻辑卷路径。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 多个逻辑卷之间用&分隔。
LvmInfo.VgInfos.N.LvInfos.N.LvSize string[] 可选 示例值：LvmInfo.VgInfos.1.LvInfos.1.LvSize=943718400
待迁移逻辑卷调整后大小，单位Bytes。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 多个逻辑卷之间用&分隔。
LvmInfo.VgInfos.N.LvInfos.N.LvUUID string[] 可选 示例值：LvmInfo.VgInfos.1.LvInfos.1.LvUUID=VlMqHc-iZfE-Vo*****
待迁移逻辑卷UUID。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 多个逻辑卷之间用&分隔。
LvmInfo.VgInfos.N.LvInfos.N.VgName string[] 可选 示例值：LvmInfo.VgInfos.1.LvInfos.1.VgName=vg_01
待迁移逻辑卷所在卷组名称。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 多个逻辑卷之间用&分隔。
LvmInfo.VgInfos.N.PvInfos.N.PvName string[] 可选 示例值：LvmInfo.VgInfos.1.PvInfos.1.PvName=/dev/vdb1
待迁移物理卷名称。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示物理卷序号。
- 多个物理卷之间用&分隔。
LvmInfo.VgInfos.N.PvInfos.N.PvSize string[] 可选 示例值：LvmInfo.VgInfos.1.PvInfos.1.PvSize=1019215872
待迁移物理卷大小，单位Bytes。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示物理卷序号。
- 多个物理卷之间用&分隔。
LvmInfo.VgInfos.N.PvInfos.N.PvUUID string[] 可选 示例值：LvmInfo.VgInfos.1.PvInfos.1.PvUUID=h3ey9f-VJAi*****
待迁移物理卷UUID。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示物理卷序号。
- 多个物理卷之间用&分隔。
LvmInfo.VgInfos.N.PvInfos.N.VgName string[] 可选 示例值：LvmInfo.VgInfos.1.PvInfos.1.VgName=vg_01
待迁移物理卷所在卷组名称。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示物理卷序号。
- 多个物理卷之间用&分隔。
LvmInfo.VgInfos.N.VgName string[] 可选 示例值：LvmInfo.VgInfos.1.VgName=vg_01
待迁移逻辑卷组名称。
- 参数 - N：表示逻辑卷组序号。
- 多个逻辑卷组之间用&分隔。
注意
参数 - N 的值不能超过源服务器实际卷组数量。
LvmInfo.VgInfos.N.VgSize string[] 可选 示例值：LvmInfo.VgInfos.1.VgSize=1019215872
待迁移逻辑卷组调整后大小，单位Bytes。
- 参数 - N：表示逻辑卷组序号。
- 多个逻辑卷组之间用&分隔。
注意
参数 - N 的值不能超过源服务器实际卷组数量。
LvmInfo.VgInfos.N.VgUUID string[] 可选 示例值：LvmInfo.VgInfos.1.VgUUID=Y2apS5-w7yK-*****
待迁移逻辑卷组UUID。
- 参数 - N：表示逻辑卷组序号。
- 多个逻辑卷组之间用&分隔。
注意
参数 - N 的值不能超过源服务器实际卷组数量。
LvmInfo.VgInfos.N.LvInfos.N.LvUsedSize string[] 可选 示例值：--
待迁移逻辑卷已使用大小，单位Bytes。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 多个逻辑卷之间用&分隔。
LvmInfo.VgInfos.N.LvInfos.N.MountPoint string[] 可选 示例值：--
待迁移逻辑卷挂载点。
- 第一个N：表示逻辑卷组序号。
- 第二个N：表示逻辑卷序号。
- 多个逻辑卷之间用&分隔。
DestinationConfig.AutoInstallBlkNone boolean 可选 示例值：false
是否自动为目标实例或目标镜像安装blk-none。取值：
- true：自动安装。
- false：默认，不自动安装。
说明
仅迁移至Linux云服务器实例、Linux云服务镜像时有效。
DestinationConfig.AutoInstallVirtio11 boolean 可选 示例值：false
是否自动为目标实例或目标镜像安装Virtio1.1驱动。取值：
- true：自动安装。
- false：默认，不自动安装。
说明
仅迁移至Linux云服务器实例、Linux云服务镜像时有效。
DestinationConfig.DestinationSystem string 可选 示例值：VeLinux10Centos
目标操作系统。取值：
- Unknown：未知。
- VeLinux10Centos：表示迁移为veLinux 1.0 CentOS兼容版操作系统。
- VeLinux20Centos：表示迁移为veLinux 2.0 CentOS兼容版操作系统。
说明
DestinationConfig.DestinationType为ECSSystem时，本参数必填。
DestinationConfig.DestinationType string 必选 示例值：ECSInstance
目标类型，取值：
- ECSInstance：云服务器实例。
- ECSImage：云服务器镜像。
- ECSSystem：云服务器操作系统。
DestinationConfig.ImageName string 可选 示例值：image-1
镜像名称。
- 必须以字母、汉字开头。
- 只能包含中文、字母、数字、下划线“_”、中划线“-”、英文句号“.”。
- 长度限制为1 ~ 128个字符。
说明
迁移到云服务器镜像时，本参数必填。
DestinationConfig.InstanceId string 可选 示例值：i-3teco18f1w5a71****
说明
迁移到云服务器实例时，本参数必填。
DestinationConfig.Region string 必选 示例值：cn-beijing
目标地域。
DiskConfigs.N.DiskIndex integer[] 必选 示例值：0
源服务器磁盘下标，从0开始。
- 参数 - N：表示磁盘序号，取值范围：0～14。
- 多个磁盘序号之间用&分隔。
注意
参数 - N 的值不能超过源服务器实际磁盘数量。
DiskConfigs.N.DiskSize integer[] 可选 示例值：10
源服务器磁盘容量，单位GB。
- 参数 - N：表示磁盘序号，与DiskConfigs.N.DiskIndex标识的磁盘序号对应，取值范围：0～14。
- 多个磁盘序号之间用&分隔。
注意
参数 - N 的值不能超过源服务器实际磁盘数量。
DestinationConfig.LicenseType string 可选 示例值：PlatformLicense
许可证类型。取值：
- PlatformLicense：根据您源服务器操作系统类型，采用火山引擎官方渠道的许可证。
- BYOL：自带许可证（BYOL）。
说明
- 仅当源服务器操作系统类型为RedHat、SUSE Linux Enterprise Server或Windows时，本参数生效；其他操作系统类型本参数无效。
- 各操作系统支持的取值如下：
- Windows：支持PlatformLicense、BYOL。
- RedHat / SUSE Linux Enterprise Server：
- 源服务器为火山引擎云服务器实例：支持PlatformLicense、BYOL。
- 源服务器为非火山引擎云服务器实例：仅支持BYOL。
MigrationJobDescription string 可选 示例值：迁移本地虚拟机
任务描述。
- 必须以字母或中文开头。
- 只能包含中文、字母、数字、点号“.”、空格、下划线“_”、中划线“-”、等号“=”、英文逗号“,”、中文逗号“，”和中文句号“。”
- 长度限制在255个字符以内。
MigrationJobName string 必选 示例值：VMToECS
任务名称。
- 以字母或中文开头。
- 只能包含中文、字母、数字、下划线“_”、中划线“-”和点号“.”。
- 长度限制为1～128个字符。
MigrationSourceId string 必选 示例值：s-iegs1y963vj0******
NetworkConfig.BandwidthLimit integer 可选 示例值：5
传输限速，单位Mbps。最小值（默认）为0，表示不限速。
NetworkConfig.NetworkTransitionMode string 可选 示例值：PublicNetwork
网络模式，取值：
- PublicNetwork：公网传输。
- VPC：内网传输。
NetworkConfig.SubnetId string 可选 示例值：subnet-h49ihs*****
说明
迁移到云服务器镜像，且通过内网传输时必填。
NetworkConfig.VpcId string 可选 示例值：vpc-bp15zkdt37pq72zv****
迁移到云服务器镜像，且通过内网传输时必填。
ProjectName string 可选 示例值：project_a
迁移任务所属项目，一个任务只能归属于一个项目。
- 只能包含字母、数字、下划线“_”、点“.”和中划线“-”。
- 长度限制在64个字符以内。
SyncConfig.SyncInterval integer 可选 示例值：2
增量同步时间间隔，单位小时。
取值范围：1~168。
说明
若SyncConfig.TriggerLastSync为false，本参数必填。
SyncConfig.SyncTimes integer 可选 示例值：3
增量同步次数。取值：
- 最大值：30
- 默认值：0
- 最小值：0
说明
仅“一键迁移”支持使用本参数。
SyncConfig.SyncType string 可选 示例值：File
复制类型，取值：
- File（默认）：文件复制。
- Block：块复制。
SyncConfig.TriggerLastSync boolean 可选 示例值：true
是否只进行一次全量同步。取值：
- true（默认）：表示仅进行一次全量数据同步，不进行增量数据同步。
- false：表示进行一次全量数据同步后，还将按SyncConfig.SyncInterval参数指定的间隔进行增量数据同步。
Tags.N.Key string[] 必选 示例值：Tags.1.Key=k1&Tags.2.Key=k2
用户标签的标签键。
- 参数 - N：表示标签键的序号，取值范围：1～20。
- 多个标签键之间用&分隔。
- 命名规则如下：
- 不能以volc:、sys:的任意大小写组合开头。
- 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
- 长度限制在1～128个字符之间。
说明
同一资源的标签键不允许重复。
Tags.N.Value string[] 可选 示例值：Tags.1.Value=v1&Tags.2.Value=v2
用户标签的标签值。
- 参数 - N：表示标签值的序号，取值范围：1～20。
- 多个标签值之间用&分隔。
- 命名规则如下：
- 只能包含语言字符、数字、空格和英文符号“_”、“.”、“:”、“/”、“=”、“+”、“-”、“@”。
- 允许为空，长度限制在0～256个字符之间。
说明
如果传入该参数，则必须先传入Tags.N.Key。
返回参数
MigrationJobId string 示例值：job-3tiegs1y963vj0******
迁移任务ID。
请求示例
返回示例
错误码
最近更新时间：2026.06.17 15:17:36
这个页面对您有帮助吗？
有用
有用
无用
无用