查询导入操作进度 - QueryImportProgress
功能介绍
此接口用于查询导入操作进度
调用方法
请参见如何调用API。
URI
GET /v4/progress/{operation_uri}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| operation_uri | 是 | String | 参数解释 操作URI |
请求参数
无
响应参数
状态码：200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 符合条件的所有记录数 |
| value | ProgressVo object | 进度对象 |
| reason | String | 错误信息 |
| page_size | Integer | 每页展示条数 |
| page_no | Integer | 页码 |
| has_more | Boolean | 是否有更多 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| uri | String | 异步操作URI |
| name | String | 异步进度名称，如"引入用例" |
| submitted_time | String | 异步操作提交时间 |
| begin_time | String | 异步操作开始时间 |
| end_time | String | 异步操作结束时间 |
| server_ip | String | 处理该异步操作的服务器IP |
| last_modified_time | Long | 最后修改时间戳 |
| total | Integer | 需要处理的资源总数 |
| finished_count | Integer | 已处理完成的资源数 |
| completed | Boolean | 异步操作是否完成 |
| cancelled | Boolean | 异步操作是否取消 |
| return_value | Object | 异步操作返回值 |
| exception_message | String | 异步操作异常信息 |
| informations | Array of strings | 提示信息列表 |
| line_up_num | Integer | 排队编号 |
| asyn_operation_key | String | 异步操作的key |
| is_ended | Boolean | 异步操作是否结束 |
| finished_percent | Integer | 异步操作完成进度百分比 |
| code | String | 错误编码 |
| reason | String | 业务失败的提示内容 |
| warn_information | String | 告警信息 |
状态码：400
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
| error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
状态码：500
| 参数 | 参数类型 | 描述 |
|---|---|---|
| error_code | String | 参数解释 接口调用失败错误码 取值范围 不涉及 |
| error_msg | String | 参数解释 接口调用失败错误信息 取值范围 不涉及 |
请求示例
查询导入操作进度
GET https://{endpoint}/v4/progress/{operation_uri}
{
"operation_uri" : "import-op-001"
} 响应示例
状态码：200
OK
{
"total" : 1,
"value" : {
"uri" : "512e958714c34194a99500a9f1acff61v84i00011gndr303",
"name" : "Submit Report Task, uris: v84i00011gndr2sb",
"total" : 6,
"completed" : false,
"cancelled" : false,
"informations" : [ ],
"submitted_time" : "2026-07-01 10:51:46",
"begin_time" : "2026-07-01 10:51:46",
"last_modified_time" : 1782874306563,
"finished_count" : 0,
"line_up_num" : 0,
"asyn_operation_key" : "2bd8dce4ddd9499e930b60753324fbf2null",
"is_ended" : false,
"finished_percent" : 0
},
"reason" : "",
"page_size" : 20,
"page_no" : 1,
"has_more" : false
} 状态码：400
Bad Request
{
"error_code" : "CLOUDTEST.00000001",
"error_msg" : "返回的错误信息"
} 状态码：500
Internal Server Error
{
"error_code" : "CLOUDTEST.00000001",
"error_msg" : "返回的错误信息"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 500 | Internal Server Error |
错误码
请参见错误码。
