查询来源版权检查任务列表 - ListCopyrightCheckTasks
功能介绍
功能介绍:查询来源版权检查任务列表,分页返回任务概要信息。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/copyright-check/tasks
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,标识资源所属的华为云项目,用于隔离不同的租户资源。可通过用户控制台的“我的凭证”页面或调用IAM服务接口获取对应的项目ID 约束限制: 满足正则匹配"^[a-z0-9]{32}$" 取值范围: 由IAM服务接口返回,为固定长度的32个字符,由数字和字母组成 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 参数解释: 每页数量限制 约束限制: 不涉及 取值范围: 1 ~ 100 默认取值: 10 |
| offset | 否 | Integer | 参数解释: 分页偏移 约束限制: 不涉及 取值范围: 0 ~ 1000000 默认取值: 0 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,用于鉴权和标识调用方身份。通过调用IAM服务“查询用户Token”接口获取,Token值为响应消息头中X-Subject-Token对应的值 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 参数解释: 总任务数 取值范围: 不涉及 |
| tasks | Array of CopyrightCheckTaskDetail objects | 参数解释: 任务列表 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| task_id | String | 参数解释: 任务ID 取值范围: 不涉及 |
| user_id | String | 参数解释: 用户ID 取值范围: 不涉及 |
| user_name | String | 参数解释: 用户名称 取值范围: 不涉及 |
| src_bucket | String | 参数解释: 源OBS桶 取值范围: 不涉及 |
| src_filename | String | 参数解释: 源OBS文件 取值范围: 不涉及 |
| task_status | String | 参数解释: 任务状态 取值范围: |
| fail_reason | String | 参数解释: 任务失败原因 取值范围: 不涉及 |
| total_rows | Integer | 参数解释: 总条目数 取值范围: 不涉及 |
| processed_rows | Integer | 参数解释: 已处理条目数 取值范围: 不涉及 |
| confirmed_rows | Integer | 参数解释: 已确认条目数 取值范围: 不涉及 |
| confirm_status | Boolean | 参数解释: 确认状态 取值范围: true-已确认,false-未确认 |
| create_time | String | 参数解释: 创建时间 取值范围: 不涉及 |
| update_time | String | 参数解释: 更新时间 取值范围: 不涉及 |
| start_time | String | 参数解释: 开始时间 取值范围: 不涉及 |
| end_time | String | 参数解释: 结束时间 取值范围: 不涉及 |
| dst_bucket | String | 参数解释: 目标桶 取值范围: 不涉及 |
| dst_directory | String | 参数解释: 目标目录 取值范围: 不涉及 |
| dst_filename | String | 参数解释: 目标文件名 取值范围: 不涉及 |
| export_status | String | 参数解释: 导出状态 取值范围: |
请求示例
查询来源版权检查任务列表
/v1/da211edc7bac01a07182af742e04dc6d/copyright-check/tasks
响应示例
状态码:200
{
"total" : 1,
"tasks" : [ {
"task_id" : "0c1a3b5f4d0e4f2a9b8067c5d1e2f3a4",
"user_id" : "admin",
"user_name" : "管理员",
"src_bucket" : "obs-bucket-copyright-source",
"src_filename" : "copyright-source-template.xlsx",
"task_status" : "DONE",
"fail_reason" : "",
"total_rows" : 100,
"processed_rows" : 100,
"confirmed_rows" : 80,
"confirm_status" : false,
"create_time" : "2026-08-01 10:00:00",
"update_time" : "2026-08-01 10:30:00",
"start_time" : "2026-08-01 10:00:00",
"end_time" : "2026-08-01 10:30:00",
"dst_bucket" : "obs-bucket-copyright-report",
"dst_directory" : "report/2026-08",
"dst_filename" : "copyright-report-20260801.xlsx",
"export_status" : "DONE"
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
错误码
请参见错误码。