更新时间:2022-08-02 GMT+08:00

查询迁移任务列表

功能介绍

在设置目的端后,主机迁移服务会自动创建迁移任务,使用该接口可以查询迁移任务列表。

URI

GET /v3/tasks

表1 Query参数

参数

是否必选

参数类型

描述

state

String

迁移任务状态

枚举值:

  • READY
  • RUNNING
  • SYNCING
  • MIGRATE_SUCCESS
  • MIGRATE_FAIL
  • ABORTING
  • ABORT
  • DELETING
  • SYNC_F_ROLLBACKING
  • SYNC_F_ROLLBACK_SUCCESS

name

String

任务的名称

最小长度:0

最大长度:255

id

String

任务的ID

最小长度:0

最大长度:255

source_server_id

String

源端服务器的ID

最小长度:0

最大长度:255

limit

Integer

每一页记录的任务数量

最小值:0

最大值:200

缺省值:100

offset

Integer

偏移量

最小值:0

最大值:65535

缺省值:0

enterprise_project_id

String

需要查询的企业项目id

最小长度:0

最大长度:255

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

用户Token。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)。

最小长度:1

最大长度:16384

响应参数

状态码: 200

表3 响应Body参数

参数

参数类型

描述

count

Integer

符合要求的任务数量,不受分页影响

最小值:0

最大值:2147483647

tasks

Array of TasksResponseBody objects

查询到的任务列表

表4 TasksResponseBody

参数

参数类型

描述

id

String

迁移任务id

最小长度:0

最大长度:255

name

String

任务名称(用户自定义)

最小长度:0

最大长度:255

type

String

任务类型,创建迁移任务时必选,更新迁移任务时可选

最小长度:0

最大长度:255

枚举值:

  • MIGRATE_FILE
  • MIGRATE_BLOCK

os_type

String

操作系统类型,分为WINDOWS和LINUX,创建时必选,更新时可选

最小长度:0

最大长度:255

枚举值:

  • WINDOWS
  • LINUX

state

String

任务状态

最小长度:0

最大长度:255

estimate_complete_time

Long

预估完成时间

最小值:0

最大值:9223372036854775807

create_date

Long

任务创建时间

最小值:0

最大值:9223372036854775807

priority

Integer

进程优先级 0:低 1:标准 2:高

最小值:0

最大值:2

枚举值:

  • 0
  • 1
  • 2

speed_limit

Integer

迁移限速

migrate_speed

Double

迁移速率,单位:MB/S

最小值:0

最大值:10000

compress_rate

Double

压缩率

最小值:0

最大值:10000

start_target_server

Boolean

迁移完成后是否启动目的端服务器 true:启动 false:停止

缺省值:false

error_json

String

错误信息

最小长度:0

最大长度:1024

total_time

Long

任务总耗时

最小值:0

最大值:9223372036854775807

migration_ip

String

目的端服务器的IP地址。 公网迁移时请填写弹性IP地址 专线迁移时请填写私有IP地址

最小长度:0

最大长度:255

sub_tasks

Array of SubTaskAssociatedWithTask objects

任务关联的子任务信息

source_server

SourceServerAssociatedWithTask object

任务关联的源端信息

enterprise_project_id

String

迁移项目id

最小长度:0

最大长度:255

target_server

TargetServerAssociatedWithTask object

任务关联的目的端信息

log_collect_status

String

日志收集状态

枚举值:

  • INIT
  • TELL_AGENT_TO_COLLECT
  • WAIT_AGENT_COLLECT_ACK
  • AGENT_COLLECT_FAIL
  • AGENT_COLLECT_SUCCESS
  • WAIT_SERVER_COLLECT
  • SERVER_COLLECT_FAIL
  • SERVER_COLLECT_SUCCESS
  • TELL_AGENT_RESET_ACL
  • WAIT_AGENT_RESET_ACL_ACK

clone_server

CloneServerBrief object

克隆服务器基本信息

syncing

Boolean

是否同步

表5 SubTaskAssociatedWithTask

参数

参数类型

描述

id

Long

子任务id

最小值:0

最大值:100

name

String

子任务名称

最小长度:0

最大长度:255

progress

Integer

子任务的进度,取值为0-100之间的整数

最小值:0

最大值:100

start_date

Long

子任务开始时间

最小值:0

最大值:9223372036854775807

end_date

Long

子任务结束时间(如果子任务还没有结束,则为空)

最小值:0

最大值:9223372036854775807

process_trace

String

迁移或同步时,具体的迁移详情

最小长度:0

最大长度:2048

表6 SourceServerAssociatedWithTask

参数

参数类型

描述

id

String

源端在SMS数据库中的ID

最小长度:0

最大长度:255

ip

String

源端服务器ip,注册源端时必选,更新非必选

最小长度:0

最大长度:255

name

String

用来区分不同源端服务器的名称

最小长度:0

最大长度:255

os_type

String

源端服务器的OS类型,分为Windows和Linux,注册必选,更新非必选

最小长度:0

最大长度:255

枚举值:

  • WINDOWS
  • LINUX

os_version

String

操作系统版本,注册必选,更新非必选

最小长度:0

最大长度:255

oem_system

Boolean

是否是OEM操作系统(Windows)

state

String

当前源端服务器状态

枚举值:

  • unavailable
  • waiting
  • initialize
  • replicate
  • syncing
  • stopping
  • stopped
  • deleting
  • error
  • cloning
  • testing
  • finished
表7 TargetServerAssociatedWithTask

参数

参数类型

描述

id

String

目的端在SMS数据库中的ID

最小长度:0

最大长度:255

vm_id

String

目的端虚机id

最小长度:0

最大长度:255

name

String

目的端服务器名称

最小长度:0

最大长度:255

ip

String

目的端服务器ip

最小长度:0

最大长度:255

os_type

String

目的端服务器的OS类型

最小长度:0

最大长度:255

枚举值:

  • WINDOWS
  • LINUX

os_version

String

操作系统版本

最小长度:0

最大长度:255

表8 CloneServerBrief

参数

参数类型

描述

vm_id

String

克隆服务器ID

最小长度:0

最大长度:255

name

String

克隆虚拟机的名称

最小长度:0

最大长度:255

请求示例

查询迁移任务列表

GET  https://{endpoint}/v3/tasks

响应示例

状态码: 200

OK

{
  "count" : 3,
  "tasks" : [ {
    "id" : "ef3b9722-07a0-40ae-89b0-889ee96dfc56",
    "name" : "sms_task_lxxxx11",
    "type" : "MIGRATE_FILE",
    "os_type" : "LINUX",
    "state" : "MIGRATE_SUCCESS",
    "connected" : true,
    "estimate_complete_time" : null,
    "create_date" : 1585139506000,
    "priority" : 1,
    "speed_limit" : 0,
    "migrate_speed" : 0.0,
    "start_target_server" : true,
    "error_json" : "",
    "total_time" : 3878000,
    "migration_ip" : "",
    "source_server" : {
      "id" : "f32ab4d6-d150-4fb3-aa55-edbb5cf9947f",
      "ip" : "192.168.*.107",
      "name" : "xxx-linux-1",
      "os_type" : "LINUX",
      "os_version" : "CENTOS_7_6_64BIT",
      "oem_system" : false,
      "state" : "AVAILABLE"
    },
    "target_server" : {
      "id" : "267b25a6-4a5b-4143-96b6-29777db00da1",
      "vm_id" : "",
      "name" : "",
      "ip" : null,
      "os_type" : "LINUX",
      "os_version" : null
    },
    "log_collect_status" : "INIT"
  }, {
    "id" : "a5f9cd5a-cfb2-4313-81d1-3dbf19a1e6d1",
    "name" : "sms_task_xxx22",
    "type" : "MIGRATE_BLOCK",
    "os_type" : "WINDOWS",
    "state" : "MIGRATE_SUCCESS",
    "connected" : true,
    "estimate_complete_time" : null,
    "create_date" : 1585138569000,
    "priority" : 1,
    "speed_limit" : 0,
    "migrate_speed" : 0.0,
    "start_target_server" : true,
    "error_json" : "",
    "total_time" : 10824000,
    "migration_ip" : "",
    "source_server" : {
      "id" : "91718cc3-b5bf-48ce-b196-5035ffd9ff53",
      "ip" : "192.168.*.245",
      "name" : "xxx-windows-2",
      "os_type" : "WINDOWS",
      "os_version" : "WINDOWS2012_R2_64BIT",
      "oem_system" : false,
      "state" : "AVAILABLE"
    },
    "target_server" : {
      "id" : "71fe0494-442a-408f-b0b3-0143774e4de4",
      "vm_id" : "",
      "name" : "",
      "ip" : null,
      "os_type" : "WINDOWS",
      "os_version" : "WINDOWS2012_R2_64BIT"
    },
    "log_collect_status" : "INIT"
  }, {
    "id" : "c51407dd-7d1a-4831-bb93-887869d3ab4b",
    "name" : "sms_task_leddesktop",
    "type" : "MIGRATE_BLOCK",
    "os_type" : "WINDOWS",
    "state" : "MIGRATE_SUCCESS",
    "connected" : false,
    "estimate_complete_time" : null,
    "create_date" : 1566130392000,
    "priority" : 1,
    "speed_limit" : 200,
    "migrate_speed" : 0.0,
    "start_target_server" : true,
    "error_json" : "",
    "total_time" : 882000,
    "migration_ip" : "192.168.1.201",
    "source_server" : null,
    "target_server" : {
      "id" : "f985ee82-1a94-4839-b983-fb952dbaf00b",
      "vm_id" : "a548a4f5-020d-46f8-9b34-59cf1dc60ab6",
      "name" : "xxx-sms-target",
      "ip" : null,
      "os_type" : "WINDOWS",
      "os_version" : "WINDOWS2008_R2_64BIT"
    },
    "log_collect_status" : "INIT"
  } ]
}

状态码

状态码

描述

200

OK

错误码

请参见错误码