查询导入操作进度 - 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 | 参数解释 异步进度名称 取值范围 不涉及 |
| total | Integer | 参数解释 资源总数 取值范围 不涉及 |
| completed | Boolean | 参数解释 异步操作是否完成 取值范围 true:已完成 false:未完成 |
| cancelled | Boolean | 参数解释 异步操作是否取消 取值范围 true:已取消 false:未取消 |
| informations | Array of strings | 参数解释 提示信息列表 取值范围 不涉及 |
| code | String | 参数解释 错误编码 取值范围 不涉及 |
| reason | String | 参数解释 错误信息 取值范围 不涉及 |
| submitted_time | String | 参数解释 提交时间 取值范围 不涉及 |
| begin_time | String | 参数解释 开始时间 取值范围 不涉及 |
| end_time | String | 参数解释 结束时间 取值范围 不涉及 |
| server_ip | String | 参数解释 服务ip 取值范围 不涉及 |
| last_modified_time | Long | 参数解释 最后修改时间 取值范围 不涉及 |
| finished_count | Integer | 参数解释 执行完成总数 取值范围 不涉及 |
| return_value | Object | 参数解释 异步操作返回值 取值范围 不涉及 |
| exception_message | String | 参数解释 异常信息 取值范围 不涉及 |
| line_up_num | Integer | 参数解释 行编号 取值范围 不涉及 |
| asyn_operation_key | String | 参数解释 异步操作的key 取值范围 不涉及 |
| is_ended | Boolean | 参数解释 是否结束 取值范围 true:已结束 false:未结束 |
| finished_percent | Integer | 参数解释 异步操作完成进度 取值范围 0-100 |
状态码：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
{
"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
{
"error_code" : "CLOUDTEST.00000001",
"error_msg" : "返回的错误信息"
} 状态码：500
{
"error_code" : "CLOUDTEST.00000001",
"error_msg" : "返回的错误信息"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | OK |
| 400 | Bad Request |
| 500 | Internal Server Error |
错误码
请参见错误码。
