文档首页/ 主机迁移服务 SMS/ API参考（吉隆坡区域）/ 历史API/ 任务管理/ 查询指定ID的迁移任务
更新时间：2022-08-02 GMT+08:00
查看PDF
分享

查询指定ID的迁移任务

功能介绍

查询指定ID的迁移任务。

URI

GET /v1/sms/tasks/{task_id}

参数说明请参见表1。
表1 参数说明

参数

是否必选

描述

task_id

是

任务的ID

请求消息

不涉及

响应消息

响应参数

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

id

String

任务ID

name

String

任务名称

type

String

任务类型

  • MIGRATE_FILE：文件级
  • MIGRATE_BLOCK：块级

os_type

String
  • WINDOWS：Windows迁移任务
  • LINUX：Linux迁移任务

state

String

任务状态

  • READY：就绪
  • RUNNING：迁移中
  • SYNCING:同步中
  • ABORTING：暂停中
  • ABORT：暂停
  • MIGRATE_FAIL：迁移失败
  • MIGRATE_SUCCESS：迁移成功
  • SYNC_FAIL：同步失败
  • SYNC_SUCCESS：同步成功

connected

Boolean

连接状态

  • true：迁移任务同主机迁移服务连接正常
  • false：迁移任务同主机迁移服务失去连接

estimate_complete_time

long

迁移任务预计剩余时间。

create_date

long

任务创建时间

start_date

long

任务开始时间

finish_date

long

任务结束时间

priority

int

迁移进程优先级

  • 0：低
  • 1：标准 （默认）
  • 2：高

speed_limit

int

迁移速率限制，单位MB

默认为0（不限制）

migrate_speed

float

迁移速率

start_target_server

Boolean

迁移完成后目的端服务器的状态

  • true：启动（默认值）
  • false：停止

error_json

String

任务失败原因

total_time

long

任务总耗时，单位ms

float_ip

String

目的端浮动ip

migration_ip

String

目的端服务器的IP地址。

  • 公网迁移时请填写弹性IP地址
  • 专线迁移时请填写私有IP地址

vm_template_id

String

模板id，请参见查询模板列表获取的id

region_name

String

目的端服务器的区域名称

region_id

String

目的端服务器的区域ID

project_name

String

目的端服务器所在项目名称

project_id

String

目的端服务器所在项目ID，参见获取项目ID

sub_tasks

JSON数组

子任务信息列表，参见表3

source_server

JSON

源端服务器信息，参见表4

target_server

JSON

目的端服务器的信息，参见表5
表3 sub_tasks中成员结构

参数

参数类型

描述

id

long

子任务ID

name

String

子任务名称

  • CREATE_CLOUD_SERVER：迁移时创建服务器
  • SSL_CONFIG：设置安全传输通道
  • ATTACH_AGENT_IMAGE：挂载代理镜像
  • DETTACH_AGENT_IMAGE：卸载载代理镜像
  • FORMAT_DISK_LINUX：Linux分区格式化
  • FORMAT_DISK_WINDOWS：Windows分区格式化
  • MIGRATE_LINUX_FILE：Linux文件级数据迁移
  • MIGRATE_WINDOWS_BLOCK：Windows块级数据迁移
  • SYNC_LINUX_FILE：Linux文件级数据同步
  • SYNC_WINDOWS_BLOCK：Windows块级数据同步
  • CONFIGURE_LINUX：Linux配置修改
  • CONFIGURE_WINDOWS：Windows配置修改

progress

int

子任务进度

start_date

long

子任务开始时间

end_date

long

子任务结束时间
表4 source_server结构

参数

参数类型

描述

id

String

该源端服务器在主机迁移服务上的ID

ip

String

源端服务器的IP地址

name

String

源端服务器的名称，用户可以在添加后进行修改，默认和hostname一致

os_type

String
  • WINDOWS：源端服务器为Windows系统
  • LINUX：源端服务器为Linux系统

os_version

String

操作系统版本

例如：WINDOWS2008_R2_64BIT

oem_system

Boolean

是否是oem类型

state

String

源端服务器的检查状态

  • CHECKING：检查中
  • AVAILABLE：检查通过，可以迁移
  • UNAVAILABLE：检查失败，不能迁移
表5 target_server结构

参数

参数类型

描述

id

String

该源端服务器在主机迁移服务上的ID

vm_id

String

目的端服务器的ID

name

String

目的端服务器的名称

ip

String

目的端服务器的私有IP

os_type

String

目的端服务器的类型

  • WINDOWS：目的端服务器为Windows
  • LINUX：目的端服务器为Linux

os_version

String

目的端服务器的版本号

system_dir

String

系统目录

例如：C:\\Windows\\System32

disks

JSON数组

目的端服务器的磁盘信息

volume_groups

JSON数组

目的端服务器的卷组信息

btrfs_list

JSON数组

目的端服务器的BTRFS信息，参见表6
表6 btrfs_list数据结构

参数

参数类型

描述

name

String

文件系统名称，例如/dev/vdb1

label

String

文件系统标签，若无标签为空字符串

uuid

String

文件系统的uuid

device

String

btrfs包含的设备名称

default_subvolid

String

默认子卷ID

default_subvol_name

String

默认子卷名称

default_subvol_mountpath

String

默认子卷挂载路径

subvolumn

Json数组

子卷信息，参见表7
表7 subvolumn数据结构

参数

是否必选

参数类型

描述

uuid

是

String

子卷的父卷的uuid

is_snapshot

是

String

子卷是否为快照

subvol_id

是

String

子卷的id

parent_id

是

String

子卷的父卷id

subvol_name

是

String

子卷的名称

subvol_mount_path

是

String

子卷的挂载路径
表8 disks成员数据结构

参数

参数类型

描述

id

long

该磁盘在SMS端数据库中的ID

name

String

磁盘的名称

relation_name

String

该磁盘对应的源端磁盘名称

disk_id

String

该块磁盘在EVS服务上的ID

partition_style

String

磁盘分区类型

  • MBR：磁盘分区类型为MBR
  • GPT：磁盘分区类型为GPT

size

long

磁盘大小

os_disk

String

是否是系统盘

device_use

String

该分区的用户

  • BOOT：引导分区
  • OS：系统分区
  • NORMAL：普通分区

used_size

String

磁盘已使用大小

physical_volumes

JSON数组

该磁盘下的物理卷信息，参见表9
表9 physical_volumes成员结构

参数

参数类型

描述

id

long

该物理分区在数据库中id

uuid

String

分区的UUID

index

long

该分区的序号

relation_name

String

该分区对应的源端分区名称

name

String

分区名称，如Windows的C和Linux的/dev/vda1

device_use

String

该分区的用户

  • BOOT：引导分区
  • OS：系统分区
  • NORMAL：普通分区

file_system

String

分区的文件系统类型

例如：NTFS

size_per_cluster

String

每个簇的大小

mount_point

String

该分区的挂载点

size

long

该分区总共大小

used_size

long

该分区已使用大小

free_size

long

该分区剩余大小

示例

  • 请求示例

    无请求消息。

  • 响应示例 
    {
 "id": "65da430b-9538-4296-abd0-86a5aaf13c77",
 "name": "sms_task_smssource",
 "type": "MIGRATE_BLOCK",
 "os_type": "WINDOWS",
 "state": "READY",
 "connected": true,
 "estimate_complete_time": null,
 "create_date": 1528699579000,
 "start_date": null,
 "finish_date": null,
 "priority": 1,
 "speed_limit": 0,
 "migrate_speed": 0.0,
 "start_target_server": true,
 "error_json": "",
 "total_time": 0,
 "float_ip": "",
 "migration_ip": "X.X.X.X",
 "vm_template_id": "caa75db7-1748-42f4-b7e5-7b01fb5f89cf",
 "region_name":"MY-Kuala Lumpur",
 "region_id":"my-kualalumpur-1",
 "project_name":"my-kualalumpur-1",
 "project_id": "962def8b6e984888b80501c851d534b2",
 "sub_tasks": [{
   "id": 471,
   "name": "CREATE_CLOUD_SERVER",
   "progress": 100,
   "start_date": null,
   "end_date": null
  }, {
   "id": 475,
   "name": "SSL_CONFIG",
   "progress": 100,
   "start_date": null,
   "end_date": null
  }, 
 "id": 477,
   "name": "ATTACH_AGENT_IMAGE",
   "progress": 0,
   "start_date": null,
   "end_date": null
  }, {
   "id": 484,
   "name": "FORMAT_DISK_WINDOWS",
   "progress": 0,
   "start_date": null,
   "end_date": null
  }, {
   "id": 491,
   "name": "MIGRATE_WINDOWS_BLOCK",
   "progress": 0,
   "start_date": null,
   "end_date": null
  }, {
   "id": 498,
   "name": "CONFIGURE_WINDOWS",
   "progress": 0,
   "start_date": null,
   "end_date": null
  }, {
   "id": 505,
   "name": "DETTACH_AGENT_IMAGE",
   "progress": 0,
   "start_date": null,
   "end_date": null
  }
 ],
 "source_server": {
  "id": "a013ec5f-00d6-456b-8c1f-085599cb97e9",
  "ip": "192.168.1.57",
  "name": "smssource",
  "os_type": "WINDOWS",
  "os_version": "WINDOWS2008_R2_64BIT",
  "oem_system": false,
  "state": "AVAILABLE"
 },
 "target_server": {
  "id": "ec5eca22-db21-49b0-ae53-56a74f0318ec",
  "vm_id": "7c804c50-e9eb-40af-86ec-c78da64f22e2",
  "name": "smssrc",
  "ip": null,
  "os_type": "WINDOWS",
  "os_version": "WINDOWS2008_R2_64BIT",
  "system_dir": "Y:\\Windows\\System32",
  "disks": [{
    "id": 736,
    "name": "Disk 1",
    "disk_id": "e853bb2d-57e0-42b2-96c0-68794063fb0f",
    "partition_style": "MBR",
    "size": 53687091200,
    "used_size": 42964353024,
    "os_disk": true,
    "physical_volumes": [{
      "id": 1135,
      "uuid": "\\?\Volume{f5a31ed9-cde8-11e6-9dd0-806e6f6e6963}\",
      "index": 1,
      "name": "Z:",
      "device_use": "BOOT",
      "file_system": "NTFS",
      "size_per_cluster": 4096,
      "mount_point": null,
      "size": 113246208,
      "used_size": 25624064,
      "free_size": 87622144
     }, {
      "id": 1142,
      "uuid": "\\?\Volume{f5a31eda-cde8-11e6-9dd0-806e6f6e6963}\",
      "index": 2,
      "name": "Y:",
      "device_use": "OS",
      "file_system": "NTFS",
      "size_per_cluster": 4096,
      "mount_point": null,
      "size": 42851106816,
      "used_size": 26961067520,
      "free_size": 15890039296
     }
    ]
   }
  ],
  "btrfs_list": [],
  "volume_groups": []
 }
}

状态码

状态码请参见状态码。

父主题： 任务管理