本文导读

展开导读

文档首页/ 主机迁移服务 SMS/ API参考（阿布扎比区域）/ 历史API/ 任务管理/ 查询迁移任务列表

查询迁移任务列表

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

查看PDF

功能介绍

查询迁移任务列表。

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
        }
    ],
}
]

状态码

状态码请参见状态码。

错误码

请参见历史错误码。

父主题： 任务管理

上一篇：上传迁移日志

下一篇：查询指定ID的迁移任务

意见反馈

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

有帮助没帮助

提供反馈

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

系统繁忙，请稍后重试

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

内容与产品页面不一致

内容不易理解

缺失示例代码

步骤不可操作

搜不到想要的内容

缺少最佳实践

意见反馈（选填）

0/500

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

字符长度不能超过500

直接提交取消