
# 查询导入操作进度 - QueryImportProgressEtl
#### 功能介绍
此接口用于查询导入操作进度
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /v4/progress/etl/{operation_uri}
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述                                                       |
|:---|:---|:---|:---|
| operation_uri | 是    | String | **参数解释** 操作URI |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数        | 参数类型                                                              | 描述         |
|:---|:---|:---|
| total     | Integer                                                           | 符合条件的所有记录数 |
| value     | [ProgressVo] object | 进度对象       |
| reason    | String                                                            | 错误信息       |
| page_size | Integer                                                           | 每页展示条数     |
| page_no   | Integer                                                           | 页码         |
| has_more  | Boolean                                                           | 是否有更多      |
   
 表3ProgressVo 
| 参数                 | 参数类型             | 描述             |
|:---|:---|:---|
| 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**
表4响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                             |
|:---|:---|:---|
| error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及  |
| error_msg  | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 |
   
**状态码：500**
表5响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                             |
|:---|:---|:---|
| error_code | String | **参数解释** 接口调用失败错误码 **取值范围** 不涉及  |
| error_msg  | String | **参数解释** 接口调用失败错误信息 **取值范围** 不涉及 |
   
#### 请求示例
查询导入操作进度
```
GET https://{endpoint}/v4/progress/{operation_uri}
{
  "operation_uri" : "import-op-001"
}
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : {
    "uri" : "cc955cae917b4f8a8a98e51e02fc7270v84i00011i8antqp",
    "name" : "Submit Report Task, uris: v84i00011i8antn4",
    "total" : 7,
    "completed" : true,
    "cancelled" : false,
    "informations" : [ ],
    "submitted_time" : "2026-07-20 10:40:24",
    "begin_time" : "2026-07-20 10:40:24",
    "end_time" : "2026-07-20 10:40:34",
    "last_modified_time" : 1784515234486,
    "finished_count" : 7,
    "return_value" : "v84i00011i8antn4",
    "line_up_num" : 0,
    "asyn_operation_key" : "2bd8dce4ddd9499e930b60753324fbf2null",
    "is_ended" : true,
    "finished_percent" : 100
  }
}
```
**状态码：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 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。
