# 查询录制回放任务进度 - ShowReplayProgress
#### 功能介绍
查询录制回放任务进度
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-drs/drs_api_0035.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v5/{project_id}/jobs/{job_id}/replay-progress
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                   |
|:---|:---|:---|:---|
| project_id | 是    | String | 租户在某一Region下的Project ID。 获取方法请参见[获取项目ID](https://support.huaweicloud.com/api-drs/drs_api_0106.html)。 |
| job_id     | 是    | String | 任务ID。                                                                                                |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
|:---|:---|:---|:---|
| Content-Type | 否    | String | 发送的实体的MIME类型。推荐用户默认使用application/json，如果API是对象、镜像上传等接口，媒体类型可按照流类型的不同进行确定。                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| X-Auth-Token | 是    | String | 从IAM服务获取的用户Token。用户Token也就是调用IAM获取用户Token接口的响应值，请求响应成功后在响应消息头中包含的"X-Subject-Token"的值即为Token值。                                                                                                                                                                                                                                                                                                                                                                                                                  |
| X-Language   | 否    | String | 请求语言类型。 枚举值： - **en-us**   - **zh-cn**    |
   
#### 响应参数
**状态码：200**
表3响应Body参数 
| 参数                  | 参数类型                                                                                                                       | 描述         |
|:---|:---|:---|
| progress            | Long                                                                                                                       | 回放进度的百分数   |
| parse_count         | Long                                                                                                                       | 需要解析的总数    |
| replay_count        | Long                                                                                                                       | 回放的总数      |
| task_mode           | String                                                                                                                     | 迁移模式       |
| process_time        | Long                                                                                                                       | 迁移时间       |
| transfer_status     | String                                                                                                                     | 迁移状态       |
| max_time            | Long                                                                                                                       | 回放最大时间     |
| min_time            | Long                                                                                                                       | 回放最小时间     |
| now_time            | Long                                                                                                                       | 回放当前时间     |
| min_export_time     | Long                                                                                                                       | 回放报告最小时间   |
| max_export_time     | Long                                                                                                                       | 回放报告最大时间   |
| replay_sql_now_list | Array of [ReplaySqlNowInfo] objects | 正在回放的sql列表 |
   
 表4ReplaySqlNowInfo 
| 参数              | 参数类型   | 描述                                  |
|:---|:---|:---|
| thread_id       | Long   | 会话id                                |
| created_at      | Long   | 创建时间                                |
| modified_at     | Long   | 修改时间                                |
| shard_id        | Long   | 分片id                                |
| schema_name     | String | schema名称                            |
| sql_statement   | String | sql语句                               |
| latency         | Long   | 原始耗时                                |
| execute_latency | Long   | 执行耗时                                |
| target_type     | String | 目标库类型                               |
| target_name     | String | 目标库标识                               |
| status          | String | 回放状态。取值：- running：执行中。- finish：已完成。 |
   
**状态码：400**
表5响应Body参数 
| 参数         | 参数类型   | 描述    |
|:---|:---|:---|
| error_code | String | 错误码。  |
| error_msg  | String | 错误描述。 |
   
#### 请求示例
查询回放任务进度
```
https://{endpoint}/v5/5237e10fe9aa4ad5b16b6a5245248314/jobs/7b35723d-1525-410e-90c3-70f9ed3jb601/replay-progress
```
#### 响应示例
**状态码：200**
OK
```
{
  "progress" : 0,
  "task_mode" : "FULL_INCR_TRANS",
  "transfer_status" : "REPLAY_FINISH",
  "process_time" : 1763017610325,
  "replay_count" : 55956,
  "min_time" : 1763447845000,
  "max_time" : 1763499928000,
  "now_time" : 1763499928000,
  "replay_sql_now_list" : [ ],
  "min_export_time" : 1763625851000,
  "max_export_time" : 1763626722000,
  "parse_count" : 55956
}
```
**状态码：400**
Bad Request
```
{
  "error_code" : "DRS.10020000",
  "error_msg" : "Incorrect parameter type."
}
```
#### 状态码
| 状态码 | 描述          |
|:---|:---|
| 200 | OK          |
| 400 | Bad Request |
   
其他状态请参见[状态码](https://support.huaweicloud.com/api-drs/drs_api_0108.html)。
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-drs/drs_05_0004.html)。