5.2 任务管理
5.2.1 创建迁移任务
功能介绍
根据源端服务器创建一个迁移任务。
调试
您可以在API Explorer中调试该接口。
URI
POST /v3/tasks
请求参数
表5-67 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String 用户Token。通过调用IAM服务 获取用户Token接口获取(响应 消息头中X-Subject-Token的 值)。
最小长度：1 最大长度：16384
表5-68 请求 Body 参数
参数 是否必选 参数类型 描述
name 是 String 任务名称
最小长度：0 最大长度：255
type 是 String 任务类型
枚举值：
● MIGRATE_FILE
● MIGRATE_BLOCK start_target_s
erver 否 Boolean 迁移后是否启动目的端虚拟机
缺省值：true
os_type 是 String 操作系统类型
最小长度：0 最大长度：255
参数 是否必选 参数类型 描述 source_server 是 SourceServer
ByTask object 源端服务器信息 target_server 是 TargetServer
ByTask object 目的端虚拟机信息
migration_ip 否 String 迁移ip，如果是自动创建虚拟 机，不需要此参数
最小长度：0 最大长度：255 region_name 是 String region的名称
最小长度：0 最大长度：255 region_id 是 String region id
最小长度：0 最大长度：255 project_name 是 String 项目名称
最小长度：0 最大长度：255 project_id 是 String 项目id
最小长度：0 最大长度：255 vm_template_
id 否 String 自动创建虚拟机使用模板
最小长度：0 最大长度：255 use_public_ip 否 Boolean 是否使用公网ip 缺省值：true
syncing 否 Boolean 复制或者同步后是否会继续持续 同步，不添加则默认是false 缺省值：false
表5-69 SourceServerByTask
参数 是否必选 参数类型 描述
id 是 String 源端服务器id
最小长度：0 最大长度：255
表5-70 TargetServerByTask
参数 是否必选 参数类型 描述
btrfs_list 否 Array of BtrfsFileSyste m objects
btrfs信息，数据从源端获取
disks 是 Array of
TargetDisks objects
磁盘信息
name 是 String 名称
最小长度：0 最大长度：255
vm_id 是 String 虚拟机id
最小长度：0 最大长度：255 volume_group
s 否 Array of
VolumeGrou ps objects
卷组，数据从源端获取
表5-71 BtrfsFileSystem
参数 是否必选 参数类型 描述
name 是 String 文件系统名称
最小长度：0 最大长度：255
label 是 String 文件系统标签，若无标签为空字
符串
最小长度：0 最大长度：255
uuid 是 String 文件系统的uuid
最小长度：0 最大长度：255 device 是 String btrfs包含的设备名称
最小长度：0 最大长度：255
size 是 Long 文件系统数据占用大小
最小值：0
最大值：9223372036854775807
参数 是否必选 参数类型 描述
nodesize 是 Long btrfs节点大小
最小值：0
最大值：9223372036854775807
sectorsize 是 Integer 扇区大小 最小值：0
最大值：2147483647 data_profile 是 String 数据配置（RAD）
最小长度：0 最大长度：255
system_profile 是 String 文件系统配置（RAD）
最小长度：0 最大长度：255 metadata_prof
ile 是 String 元数据配置（RAD）
最小长度：0 最大长度：255 global_reserve
1 是 String Btrfs文件系统信息
最小长度：0 最大长度：255 g_vol_used_si
ze 是 Long Btrfs卷已使用空间大小
最小值：0
最大值：9223372036854775807
default_subvo
lid 是 String 默认子卷ID
最小长度：0 最大长度：255 default_subvo
l_name 是 String 默认子卷名称
最小长度：0 最大长度：255 default_subvo
l_mountpath 是 String 默认子卷挂载路径/BTRFS文件 系统的挂载路径
最小长度：0 最大长度：255 subvolumn 是 Array of
BtrfsSubvolu mn objects
子卷信息
表5-72 BtrfsSubvolumn
参数 是否必选 参数类型 描述
uuid 是 String 父卷的uuid
最小长度：0 最大长度：255 is_snapshot 是 String 子卷是否为快照
最小长度：0 最大长度：255 subvol_id 是 String 子卷的id
最小长度：0 最大长度：255 parent_id 是 String 父卷id
最小长度：0 最大长度：255 subvol_name 是 String 子卷的名称
最小长度：0 最大长度：255 subvol_mount
_path 是 String 子卷的挂载路径
最小长度：0 最大长度：255
表5-73 TargetDisks
参数 是否必选 参数类型 描述
device_use 否 String 磁盘类型，普通磁盘，OS所在 磁盘，BOOT所在磁盘
缺省值：NORMAL 枚举值：
● NORMAL
● OS
● BOOT
disk_id 否 String 磁盘id,自动创建虚拟机不用设置 最小长度：0
最大长度：255
参数 是否必选 参数类型 描述
name 是 String 名称，根据磁盘顺序设置为disk
X
最小长度：0 最大长度：255 physical_volu
mes 是 Array of
PhysicalVolu mes objects
物理卷信息
size 是 Long 大小
最小值：0
最大值：9223372036854775807
used_size 是 Long 使用大小
最小值：0
最大值：9223372036854775807
表5-74 PhysicalVolumes
参数 是否必选 参数类型 描述
device_use 否 String 分区类型，普通分区，启动分 区，系统分区
最小长度：0 最大长度：255 file_system 否 String 文件系统类型
最小长度：0 最大长度：255
index 否 Integer 顺序
最小值：0
最大值：2147483647 mount_point 否 String 挂载点
最小长度：0 最大长度：255
name 否 String 名称，windows表示盘符，
Linux表示设备号 最小长度：0 最大长度：255
参数 是否必选 参数类型 描述
size 否 Long 大小
最小值：0
最大值：9223372036854775807
used_size 否 Long 使用大小
最小值：0
最大值：9223372036854775807
uuid 否 String GUID，可从源端查询
最小长度：0 最大长度：255
表5-75 VolumeGroups
参数 是否必选 参数类型 描述
components 否 String Pv信息 最小长度：0 最大长度：255
free_size 否 Long 剩余空间
最小值：0
最大值：9223372036854775807
logical_volum
es 否 Array of
LogicalVolum es objects
lv信息
name 否 String 名称
最小长度：0 最大长度：255
size 否 Long 大小
最小值：0
最大值：9223372036854775807
表5-76 LogicalVolumes
参数 是否必选 参数类型 描述
block_count 否 Integer 块数量 最小值：0
最大值：4294967296 缺省值：0
block_size 否 Long 块大小
最小值：0
最大值：1048576 缺省值：0
file_system 是 String 文件系统 最小长度：0 最大长度：255 inode_size 是 Integer inode数量
最小值：0
最大值：4294967296 mount_point 是 String 挂载点
最小长度：0 最大长度：256
name 是 String 名称
最小长度：0 最大长度：1024
size 是 Long 大小
最小值：0
最大值：9223372036854775807
used_size 是 Long 使用大小
最小值：0
最大值：9223372036854775807
free_size 是 Long 剩余空间
最小值：0
最大值：9223372036854775807
响应参数
状态码： 200
表5-77 响应 Body 参数
参数 参数类型 描述
id String 创建成功返回的任务id
最小长度：0 最大长度：255
请求示例
创建迁移任务（创建新服务器）
POST https://{endpoint}/v3/tasks { "name" : "MigrationTask", "type" : "MIGRATE_FILE", "os_type" : "LINUX", "start_target_server" : true, "use_public_ip" : true, "migration_ip" : "192.168.0.1",
"region_name" : "华北-乌兰察布二零三", "region_id" : "region_id",
"project_name" : "project_name",
"project_id" : "b276e6fb38c74aa2ba4598f049745ce9", "source_server" : {
"id" : "16c03428-ff9a-4f36-84aa-583e41499bb2"
}, "target_server" : {
"vm_id" : "1900aab8-90c4-462c-b4c5-acdafc8fbeca", "name" : "Auto-tar-chengxiao",
"disks" : [ {
"name" : "/dev/vda",
"disk_id" : "76a59f9f-5901-4913-a9a5-f6742baa308c", "size" : 42949672960,
{ "id" : "8abda8635e09d185015e09d188dd0001xx"
}
状态码
状态码 描述
200 OK
错误码
请参见错误码。