文档首页 > > API参考> API> 任务管理> 查询指定ID的迁移任务

查询指定ID的迁移任务

分享
更新时间: 2019/12/31 GMT+08:00

功能介绍

查询指定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:迁移任务同主机迁移服务失去连接

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

migration_ip

String

目的端服务器的IP地址。

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

region_name

String

目的端服务器的区域名称

region_id

String

目的端服务器的区域ID

project_name

String

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

project_id

String

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

sub_task_list

JSON数组

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

source_server

JSON

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

target_server

JSON

目的端服务器的信息,参见表5

表3 sub_task_list中成员结构

参数

参数类型

描述

id

long

子任务ID

name

String

子任务名称

  • 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

是否是系统盘

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

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,
     "migration_ip": "192.168.1.175",
     "region_name":"north-china",
     "region_id":"cn-north-1",
     "project_name":"cn-north-1",
     "project_id": "962def8b6e984888b80501c851d534b2",
     "sub_tasks": [{
       "id": 477,
       "name": "ATTACH_AGENT_IMAGE",
       "progress": 0,
       "start_date": null,
       "end_date": null,
       "totalTime": 0
      }, {
       "id": 484,
       "name": "FORMAT_DISK_WINDOWS",
       "progress": 0,
       "start_date": null,
       "end_date": null,
       "totalTime": 0
      }, {
       "id": 491,
       "name": "MIGRATE_WINDOWS_BLOCK",
       "progress": 0,
       "start_date": null,
       "end_date": null,
       "totalTime": 0
      }, {
       "id": 498,
       "name": "CONFIGURE_WINDOWS",
       "progress": 0,
       "start_date": null,
       "end_date": null,
       "totalTime": 0
      }, {
       "id": 505,
       "name": "DETTACH_AGENT_IMAGE",
       "progress": 0,
       "start_date": null,
       "end_date": null,
       "totalTime": 0
      }
     ],
     "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",
          "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",
          "mount_point": null,
          "size": 42851106816,
          "used_size": 26961067520,
          "free_size": 15890039296
         }
        ]
       }
      ],
      "btrfs_list": [],
      "volume_groups": []
     }
    }

状态码

状态码请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问