创建迁移任务

功能介绍

根据源端服务器创建一个迁移任务。

URI

POST /v3/tasks

请求参数

表1 请求Header参数
参数	是否必选	参数类型	描述
X-Auth-Token	是	String	用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。最小长度：1 最大长度：16384

表2 请求Body参数
参数	是否必选	参数类型	描述
name	是	String	任务名称最小长度：0 最大长度：255
type	是	String	任务类型枚举值： MIGRATE_FILE MIGRATE_BLOCK
start_target_server	否	Boolean	迁移后是否启动目的端虚拟机缺省值：true
os_type	是	String	操作系统类型最小长度：0 最大长度：255
source_server	是	SourceServerByTask object	源端服务器信息
target_server	是	TargetServerByTask 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

表3 SourceServerByTask
参数	是否必选	参数类型	描述
id	是	String	源端服务器id 最小长度：0 最大长度：255

表4 TargetServerByTask
参数	是否必选	参数类型	描述
btrfs_list	否	Array of BtrfsFileSystem objects	btrfs信息，数据从源端获取
disks	是	Array of TargetDisks objects	磁盘信息
name	是	String	名称最小长度：0 最大长度：255
vm_id	是	String	虚拟机id 最小长度：0 最大长度：255
volume_groups	否	Array of VolumeGroups objects	卷组，数据从源端获取

表5 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_profile	是	String	元数据配置（RAD）最小长度：0 最大长度：255
global_reserve1	是	String	Btrfs文件系统信息最小长度：0 最大长度：255
g_vol_used_size	是	Long	Btrfs卷已使用空间大小最小值：0 最大值：9223372036854775807
default_subvolid	是	String	默认子卷ID 最小长度：0 最大长度：255
default_subvol_name	是	String	默认子卷名称最小长度：0 最大长度：255
default_subvol_mountpath	是	String	默认子卷挂载路径/BTRFS文件系统的挂载路径最小长度：0 最大长度：255
subvolumn	是	Array of BtrfsSubvolumn objects	子卷信息

表6 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

表7 TargetDisks
参数	是否必选	参数类型	描述
device_use	否	String	磁盘类型，普通磁盘，OS所在磁盘，BOOT所在磁盘缺省值：NORMAL 枚举值： NORMAL OS BOOT
disk_id	否	String	磁盘id,自动创建虚拟机不用设置最小长度：0 最大长度：255
name	是	String	名称，根据磁盘顺序设置为disk X 最小长度：0 最大长度：255
physical_volumes	是	Array of PhysicalVolumes objects	物理卷信息
size	是	Long	大小最小值：0 最大值：9223372036854775807
used_size	是	Long	使用大小最小值：0 最大值：9223372036854775807

表8 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

表9 VolumeGroups
参数	是否必选	参数类型	描述
components	否	String	Pv信息最小长度：0 最大长度：255
free_size	否	Long	剩余空间最小值：0 最大值：9223372036854775807
logical_volumes	否	Array of LogicalVolumes objects	lv信息
name	否	String	名称最小长度：0 最大长度：255
size	否	Long	大小最小值：0 最大值：9223372036854775807

**表10** 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

**表11** 响应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_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,
      "device_use" : "BOOT",
      "physical_volumes" : [ {
        "uuid" : null,
        "index" : 0,
        "name" : "/dev/vda1",
        "device_use" : "OS",
        "file_system" : "ext4",
        "mount_point" : "/",
        "size" : 42947575808,
        "used_size" : 5346484224
      } ]
    } ],
    "volume_groups" : [ ],
    "btrfs_list" : [ ]
  }
}

响应示例

状态码： 200

{
  "id" : "8abda8635e09d185015e09d188dd0001xx"
}

状态码

状态码	描述
200	OK

错误码

请参见错误码。

父主题： 任务管理

上一篇：任务管理

下一篇：查询迁移任务列表

意见反馈

文档内容是否对您有帮助？

有帮助没帮助

提供反馈

提交成功！非常感谢您的反馈，我们会继续努力做到更好！

系统繁忙，请稍后重试

在使用文档中是否遇到以下问题

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

请至少选择一项反馈信息并填写问题反馈

字符长度不能超过500

直接提交取消