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

查询迁移任务列表

功能介绍

查询迁移任务列表。

URI

GET /v1/sms/tasks

请求消息

请求参数

请求参数如表1所示。

表1 请求参数

参数

是否必选

参数类型

描述

state

String

任务的状态

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

name

String

任务的名称

id

String

任务的ID

source_server_id

String

源端服务器的ID

num_per_page

int

每一页记录的任务数量

page_num

int

第几页(下标从0开始)

响应消息

响应参数

响应参数如表2所示。

表2 响应参数

参数

参数类型

描述

count

int

符合查询条件的任务个数

tasks

Json数组

任务列表,参见表3

表3 tasks中的成员结构

参数

参数类型

描述

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

任务创建时间

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

migaration_ip

String

目的端服务器的IP地址。

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

sub_tasks

JSON数组

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

log_collect_status

String

INIT:就绪

TELL_AGENT_TO_COLLECT:通知agent收集日志

WAIT_AGENT_COLLECT_ACK:等待Agent反馈收集结果

AGENT_COLLECT_FAIL:Agent收集失败

AGENT_COLLECT_SUCCESS:Agent收集成功

WAIT_SERVER_COLLECT:等待SMS转储日志

SERVER_COLLECT_FAIL:SMS转储日志失败

SERVER_COLLECT_SUCCESS:SMS转储日志成功

TELL_AGENT_RESET_ACL:通知Agent取消日志授权

WAIT_AGENT_RESET_ACL_ACK:等待Agent确认

SUCCESS:日志收集完成

source_server

JSON

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

target_server

JSON

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

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

子任务结束时间

totalTime

long

任务总耗时,单位ms

表5 source_server结构

参数

参数类型

描述

id

String

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

ip

String

源端服务器的IP地址

name

String

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

os_type

String

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

os_version

String

操作系统版本

例如:WINDOWS7_64BIT

oem_system

Boolean

是否是oem类型

state

String

源端服务器的检查状态

  • CHECKING:检查中
  • AVAILABLE:检查通过,可以迁移上
  • UNAVAILABLE:检查失败,不能迁移
表6 target_server结构

参数

参数类型

描述

id

String

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

vm_id

String

目的端服务器的ID

name

String

目的端服务器的名称

ip

String

目的端服务器的私有IP

os_type

String

目的端服务器的类型

  • WINDOWS:目的端服务器为Windows系统
  • LINUX:目的端服务器为Linux系统

os_version

String

目的端服务器的版本号

例如:WINDOWS7_64BIT

示例

  • 请求示例
    GET  v1/sms/tasks
  • 响应示例
    {
    "count":1,
    "tasks":[{
        "id": "90c950d7-d184-4b5e-87c0-f0bd09dfa0c1",
        "name": "taskName",
        "type": "MIGRATE_BLOCK",
        "os_type": "WINDOWS",
        "state": "RUNNING",
        "connected": true,
        "consume_time": 12733551760,
        "estimate_complete_time": 1519733551760,
        "create_date": 1519733551760,
        "auto_install_pvdriver": false,
        "allow_sync": true,
        "final_sync": false,
        "priority": 1,
        "speed_limit": 0,
        "migrate_speed": 9.644518,
        "start_target_server": true,
        "error_json":"",
        "total_time": 175848,
        "migration_ip":"X.X.X.X",
        "source_server": {
            "id": "b6bbff1f-9b43-4c60-8030-d4e1e576fea8",
            "ip": "10.159.219.7",
            "hostname": null,
            "addDate": 1519722504092,
            "os_type": "WINDOWS",
            "os_version": "WINDOWS2012_64BIT",
            "oem_system": false,
            "state": "AVAILABLE"
        },
        "target_server": {
            "id": "7f40e37c-c883-4583-afe9-4e5026f336a7",
            "ip": "x.x.x.x",
            "vm_id": "2c44c00e-6354-49e2-b36f-151284a91f6c",
            "name": "windows",
            "port": 8899,
            "os_type": "WINDOWS",
            "os_version": "WINDOWS2012_64BIT",
        },
        "sub_tasks": [{         
                "id": 141,
                "name": "CREATE_CLOUD_SERVER",
                "progress": 100,
                "start_date": 1519733559435,
                "end_date": 1519733715574,
                "totalTime": 156139
            }, {
                "id": 142,
                "name": "SSL_CONFIG",
                "progress": 100,
                "start_date": 1519733715589,
                "end_date": 1519733735298,
                "totalTime": 19709
            }, 
                "id": 143,
                "name": "ATTACH_AGENT_IMAGE",
                "progress": 100,
                "start_date": 1519733559435,
                "end_date": 1519733715574,
                "totalTime": 156139
            }, {
                "id": 144,
                "name": "FORMAT_DISK_WINDOWS",
                "progress": 100,
                "start_date": 1519733715589,
                "end_date": 1519733735298,
                "totalTime": 19709
            }, {
                "id": 145,
                "name": "MIGRATE_WINDOWS_BLOCK",
                "progress": 41,
                "start_date": 1519733735314,
                "end_date": null,
                "totalTime": 0
            }, {
                "id": 146,
                "name": "CONFIGURE_WINDOWS",
                "progress": 0,
                "start_date": null,
                "end_date": null,
                "totalTime": 0
            }, {
                "id": 147,
                "name": "DETTACH_AGENT_IMAGE",
                "progress": 0,
                "start_date": null,
                "end_date": null,
                "totalTime": 0
            }
        ],
    }
    ]
    

状态码

状态码请参见状态码

错误码

请参见历史错误码