查询对象存储迁移任务列表
更新时间 2026-03-03 17:25:31
最近更新时间: 2026-03-03 17:25:31
接口功能介绍
查询对象存储迁移任务列表
接口约束
支持的线上资源池 ：华东1
URI
GET /v4/zms/list-migration
路径参数 无
Query参数
| 参数 | 是否必填 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|---|
| regionID | 是 | String | 资源池ID | 81f7728xxxxx0155d307d5b | |
| migrationMode | 否 | String | 迁移模式筛选，①fully-managed：全托管模式；②semi-managed：半托管模式 | fully-managed | |
| migrationStatus | 否 | String | 迁移任务状态筛选，1.creating：创建中；2.created：已创建；3.create_failed：创建失败|请重新创建任务；4.starting：启动中；5.waiting：排队中；6.executing：迁移中；7.stopping：暂停中；8.stopped：暂停；9.restoring：恢复中；10.agent_lost：代理已失联；11.finished：迁移结束；12.failed：迁移中断；13.finished_error：迁移结束|存在失败对象；14.retrying：重试中；15.deleting：删除中 | waiting | |
| agentID | 否 | String | 半托管迁移任务所属代理ID筛选 | 222_agt_80c60304b992616be45d76402 | |
| searchName | 否 | String | 模糊搜索迁移任务名称 | my | |
| pageNo | 否 | Integer | 页码，默认值为1 | 2 | |
| pageSize | 否 | Integer | 页大小，默认值 10，取值范围 1~50 | 3 |
请求参数
请求头header参数 无
请求体body参数 无
响应参数
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| statusCode | Integer | 返回状态码(800为成功，900为处理中/失败) | 800 | |
| message | String | 状态描述 | SUCCESS | |
| returnObj | Object | 响应对象 | returnObj | |
| description | String | 状态描述，一般为中文 | 成功 | |
| errorCode | String | 业务细分码（仅失败时具有此参数），为product.module.code三段式码 | openapi.userPermission.accessFailed | |
| error | String | 业务细分码（大驼峰形式，仅失败时具有此参数），为 Product.Module.Code 三段式码 | Openapi.UserPermission.AccessFailed |
表 returnObj
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| results | Array of Objects | 响应对象 | results | |
| totalCount | Integer | 总数量 | 5 | |
| pageNo | Integer | 当前页码 | 1 | |
| currentCount | Integer | 当前页数量 | 2 | |
| pageSize | Integer | 当前页展示数量 | 10 |
表 results
| 参数 | 参数类型 | 说明 | 示例 | 下级对象 |
|---|---|---|---|---|
| migrationName | String | 迁移任务名称 | cxx-hkpblz-bbt | |
| regionID | String | 资源池ID | 81f7728xxxxx0155d307d5b | |
| sourceType | String | 迁移源类型，默认为S3，①S3：AWS及S3适配；②OSS：阿里云OSS；③COS：腾讯云COS；④OBS：华为云OBS；⑤OOS：天翼云OOS；⑥ZOS：天翼云对象存储ZOS | ZOS | |
| destinationType | String | 目的端类型，目前均为ZOS | ZOS | |
| migrationMode | String | 迁移模式，①fully-managed：全托管模式；②semi-managed：半托管模式 | fully-managed | |
| migrationID | String | 迁移任务ID | 111_mig_76f7dc8b012xxxxf6ed082db55d08 | |
| migrationStatus | String | 迁移任务当前状态，1.creating：创建中；2.created：已创建；3.create_failed：创建失败|请重新创建任务；4.starting：启动中；5.waiting：排队中；6.executing：迁移中；7.stopping：暂停中；8.stopped：暂停；9.restoring：恢复中；10.agent_lost：代理已失联；11.finished：迁移结束；12.failed：迁移中断；13.finished_error：迁移结束|存在失败对象；14.retrying：重试中；15.deleting：删除中 | waiting | |
| migrationAgent | String | 任务所属代理，①若迁移模式为全托管，该字段展示为null；②若半托管任务所属的代理已被删除，该字段展示为“associated agent has been deleted” | agentaa | |
| lastOperationErrorCode | Integer | 最近一次操作异常的错误码，仅在半托管模式迁移操作异常场景存在，其余场景展示为null。 半托管迁移任务在下发操作请求后处于中间状态时有概率在代理上执行操作命令失败，触发任务回滚。 | 21105 | |
| lastOperationErrorMsg | String | 最近一次操作异常的错误原因，仅在半托管模式迁移操作异常场景存在，其余场景展示为null。 半托管迁移任务在下发操作请求后处于中间状态时有概率在代理上执行操作命令失败，触发任务回滚。 | 无法连通源端对象存储服务（ZOS），请检查您的源端参数及代理与源端对象存储服务的联通性，并重新创建任务 | |
| migrateCreateTime | String | 迁移任务创建时间 | 2024-12-11 13:50:10 | |
| migrateCompleteTime | String | 迁移任务完成时间。若当前任务未完成，则显示为null | 2024-12-10 16:30:45 |
枚举参数
无
请求示例
请求url
GET https://zos-global.ctapi.ctyun.cn/v4/zms/list-migration?regionID=81f7728xxxxx0155d307d5b&pageNo=1&pageSize=10
请求头header
无
请求体body
无
响应示例
{
"returnObj": {
"currentCount": 1,
"totalCount": 1,
"pageSize": 10,
"results": [
{
"migrationAgent": "agentaa",
"lastOperationErrorCode": 21105,
"sourceType": "ZOS",
"migrationName": "cxx-hkpblz-bbt",
"migrationStatus": "create_failed",
"migrationID": "111_mig_76f7dc8b012xxxxf6ed082db55d08",
"migrateCreateTime": "2026-01-27 13:39:07",
"migrateCompleteTime": null,
"regionID": "81f7728xxxxx0155d307d5b",
"migrationMode": "semi-managed",
"destinationType": "ZOS",
"lastOperationErrorMsg": "无法连通源端对象存储服务（ZOS），请检查您的源端参数及代理与源端对象存储服务的联通性，并重新创建任务"
},
],
"pageNo": 1
},
"details": "",
"message": "SUCCESS",
"description": "成功",
"statusCode": 800
}
状态码
请参考 状态码
错误码
请参考 错误码
