# 获取异步进度 - GetProgressByOperationUri
#### 功能介绍
获取异步进度,用于/async/query/\*\* 接口调用
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-testman/cloudtest_03_2000.html)。
#### URI
GET /testreport/v4/progress/{operation_uri}
表1路径参数 
| 参数            | 是否必选 | 参数类型   | 描述      |
|:---|:---|:---|:---|
| operation_uri | 是    | String | 异步操作uri |
   
表2Query参数 
| 参数           | 是否必选 | 参数类型   | 描述     |
|:---|:---|:---|:---|
| project_uuid | 否    | String | 项目uuid |
   
#### 请求参数
无
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数       | 参数类型                                                                                               | 描述         |
|:---|:---|:---|
| \[数组元素\] | Array of [ApiResultGetProgress] objects | 查询异步结果返回数据 |
   
 表4ApiResultGetProgress 
| 参数    | 参数类型                                                                 | 描述        |
|:---|:---|:---|
| value | [ProgressVo] object | 异步请求返回的数据 |
   
 表5ProgressVo 
| 参数                 | 参数类型             | 描述                                                                                                                                                                                   |
|:---|:---|:---|
| 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**
表6响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                        |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：401**
表7响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                        |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：404**
表8响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                        |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
**状态码：500**
表9响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                        |
|:---|:---|:---|
| error_code | String | **参数解释**: 接口调用失败错误码 **取值范围**: 不涉及  |
| error_msg  | String | **参数解释**: 接口调用失败错误信息 **取值范围**: 不涉及 |
   
#### 请求示例
```
get https://{endpoint}/testreport/v4/progress/u932opbu6aaf
```
#### 响应示例
**状态码：200**
OK
```
{
  "value" : {
    "uri" : "v80h000110a2vvoj",
    "name" : "ASYNC_ELT_QUERY_DATA_LIST",
    "total" : 1,
    "completed" : true,
    "cancelled" : false,
    "informations" : [ ],
    "submitted_time" : "2025-12-09 10:20:55",
    "begin_time" : "2025-12-09 10:20:56",
    "end_time" : "2025-12-09 10:20:56",
    "last_modified_time" : 1765246856149,
    "finished_count" : 1,
    "return_value" : {
      "values" : [ {
        "uri" : "v90100010if59vf5"
      }, {
        "uri" : "v90100010ifoqibk"
      }, {
        "uri" : "v90100010ifqepns"
      }, {
        "uri" : "v90100010iicrvfl"
      }, {
        "uri" : "v90100010ipuih9r"
      }, {
        "uri" : "v90100010iq373am"
      } ]
    },
    "line_up_num" : 0,
    "asyn_operation_key" : "904163c3cc8d47b780028eee55f6b68dnull",
    "is_ended" : true,
    "finished_percent" : 100
  }
}
```
#### 状态码
| 状态码 | 描述                    |
|:---|:---|
| 200 | OK                    |
| 400 | Bad Request           |
| 401 | Unauthorized          |
| 404 | Not Found             |
| 500 | Internal Server Error |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-testman/ErrorCode.html)。