# LeRobot水印提取任务日志列表 - ListLerobotWatermarkExtractLogs
#### 功能介绍
功能介绍： 获取当前项目下所有LeRobot水印提取任务的日志列表，支持分页查询。返回每条任务的基本信息，包括任务ID、名称、类型、状态、源路径、文件统计和创建/完成时间。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-dsc/dsc_02_0008.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-dsc/dsc_02_0031.html)。
- 如果使用身份策略授权，当前API调用无需身份策略权限。
 
#### URI
GET /v1/{project_id}/lerobot-address/watermark/extract-logs
表1路径参数 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| project_id | 是    | String | **参数解释：** 项目ID。可参考获取项目ID获取。 **约束限制：** 不涉及 **取值范围：** 以IAM服务接口返回值为准，长度为32个字符，满足正则匹配"\^\[a-z0-9\]{32}$" **默认取值：** 不涉及 |
   
表2Query参数 
| 参数     | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                    |
|:---|:---|:---|:---|
| limit  | 否    | Integer | **参数解释：** 每页记录数 **约束限制：** 最小值1，最大值100 **取值范围：** 不涉及 **默认取值：** 20 |
| offset | 否    | Integer | **参数解释：** 偏移量 **约束限制：** 最小值0 **取值范围：** 不涉及 **默认取值：** 0           |
   
#### 请求参数
表3请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释：** 用户Token，用于接口请求的身份认证。通过调用IAM服务查询用户Token接口获取（响应消息头中X-Subject-Token的值）。 **约束限制：** 不涉及 **取值范围：** 不涉及 **默认取值：** 不涉及 |
   
#### 响应参数
**状态码：200**
表4响应Body参数 
| 参数     | 参数类型                                                                                                   | 描述                                                                                                                                                                                       |
|:---|:---|:---|
| total  | Long                                                                                                   | **参数解释：** 总记录数 **取值范围：** 不涉及    |
| offset | Integer                                                                                                | **参数解释：** 当前页码偏移量 **取值范围：** 不涉及 |
| limit  | Integer                                                                                                | **参数解释：** 每页条数 **取值范围：** 不涉及    |
| logs   | Array of [LerobotWatermarkLog] objects | **参数解释：** 任务记录列表 **取值范围：** 不涉及  |
   
 表5LerobotWatermarkLog 
| 参数               | 参数类型    | 描述                                                                                                                                                                                                                                                      |
|:---|:---|:---|
| task_id          | String  | **参数解释：** 任务ID **取值范围：** 不涉及                                                                   |
| task_name        | String  | **参数解释：** 任务名称 **取值范围：** 不涉及                                                                   |
| type             | String  | **参数解释：** 任务类型 **取值范围：** embed-水印嵌入，extract-水印提取                                               |
| state            | String  | **参数解释：** 任务级状态 **取值范围：** PENDING-等待中，PROCESSING-处理中，SUCCESS-成功，PARTIAL_SUCCESS-部分成功，FAILED-失败 |
| source_path      | String  | **参数解释：** 源路径 **取值范围：** 不涉及                                                                    |
| dest_path        | String  | **参数解释：** 目标路径 **取值范围：** 不涉及                                                                   |
| blind_watermark  | String  | **参数解释：** 暗水印内容 **取值范围：** 不涉及                                                                  |
| total_file_num   | Integer | **参数解释：** 待处理文件总数 **取值范围：** 不涉及                                                                |
| success_file_num | Integer | **参数解释：** 成功文件数 **取值范围：** 不涉及                                                                  |
| failed_file_num  | Integer | **参数解释：** 失败文件数 **取值范围：** 不涉及                                                                  |
| create_time      | Long    | **参数解释：** 创建时间 **取值范围：** 不涉及                                                                   |
| finish_time      | Long    | **参数解释：** 完成时间 **取值范围：** 不涉及                                                                   |
| error_msg        | String  | **参数解释：** 任务级错误信息 **取值范围：** 不涉及                                                                |
   
#### 请求示例
查询LeRobot水印提取任务日志列表
```
/v1/da211edc7bac01a07182af742e04dc6d/lerobot-address/watermark/extract-logs?limit=20&offset=0
```
#### 响应示例
**状态码：200**
```
{
  "total" : 1,
  "offset" : 0,
  "limit" : 20,
  "logs" : [ {
    "task_id" : "0c1a3b5f4d0e4f2a9b8067c5d1e2f3a4",
    "task_name" : "lerobot-watermark-extract-task-01",
    "type" : "extract",
    "state" : "SUCCESS",
    "source_path" : "obs-bucket-lerobot-watermark/datasets/lerobot-dataset-01-wm/",
    "total_file_num" : 10,
    "success_file_num" : 8,
    "failed_file_num" : 2,
    "create_time" : 1722902400000,
    "finish_time" : 1722902700000
  } ]
}
```
#### 状态码
| 状态码 | 描述    |
|:---|:---|
| 200 | 请求已成功 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-dsc/ErrorCode.html)。
