查询指定来源版权检查任务详情 - ShowCopyrightCheckTask
功能介绍
功能介绍:查询指定来源版权检查任务的详细信息,包括任务状态、处理进度、确认状态、检测结果列表(每行的数据名称、URL、域名、许可信息、版权信息、风险级别、确认状态等)。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/copyright-check/tasks/{task_id}
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,标识资源所属的华为云项目,用于隔离不同的租户资源。可通过用户控制台的“我的凭证”页面或调用IAM服务接口获取对应的项目ID 约束限制: 满足正则匹配"^[a-z0-9]{32}$" 取值范围: 由IAM服务接口返回,为固定长度的32个字符,由数字和字母组成 默认取值: 不涉及 |
| task_id | 是 | String | 参数解释: 版权检查任务的ID,唯一的资源标识,用于定位要操作的具体版权检查任务。可通过调用创建版权检查任务接口的返回值获取,或通过查询版权检查任务列表接口获取 约束限制: 满足正则匹配"^[a-zA-Z0-9-]{10,64}$" 取值范围: 字符类型,长度不超过64个字符 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| limit | 否 | Integer | 参数解释: 每页数量限制 约束限制: 不涉及 取值范围: 1 ~ 100 默认取值: 10 |
| offset | 否 | Integer | 参数解释: 分页偏移 约束限制: 不涉及 取值范围: 0 ~ 1000000 默认取值: 0 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,用于鉴权和标识调用方身份。通过调用IAM服务“查询用户Token”接口获取,Token值为响应消息头中X-Subject-Token对应的值 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| status | String | 参数解释: 响应状态 取值范围: |
| task_id | String | 参数解释: 任务ID 取值范围: 不涉及 |
| user_id | String | 参数解释: 用户ID 取值范围: 不涉及 |
| user_name | String | 参数解释: 用户名 取值范围: 不涉及 |
| src_bucket | String | 参数解释: 源文件存储的桶名称 取值范围: 不涉及 |
| src_file | String | 参数解释: 源文件路径 取值范围: 不涉及 |
| 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 | 参数解释: 导出状态 取值范围: |
| check_results | CheckResults object | 参数解释: 版权检测结果 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 参数解释: 总检测数量 取值范围: 不涉及 |
| details | Array of CheckDetail objects | 参数解释: 检测结果详细信息列表 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| row_id | String | 参数解释: 行ID 取值范围: 不涉及 |
| data_name | String | 参数解释: 数据名称 取值范围: 不涉及 |
| data_url | String | 参数解释: 数据URL 取值范围: 不涉及 |
| domain | String | 参数解释: 数据来源域名 取值范围: 不涉及 |
| license_url | String | 参数解释: 版权许可URL 取值范围: 不涉及 |
| license_name | String | 参数解释: 版权许可名称 取值范围: 不涉及 |
| license_content | String | 参数解释: 版权许可内容 取值范围: 不涉及 |
| copyright_url | String | 参数解释: 版权声明URL 取值范围: 不涉及 |
| copyright_content | String | 参数解释: 版权声明内容 取值范围: 不涉及 |
| risk_level | String | 参数解释: 风险级别 取值范围: 不涉及 |
| search_time | String | 参数解释: 检索时间 取值范围: 不涉及 |
| confirm_status | Boolean | 参数解释: 是否已确认 取值范围: true-已确认,false-未确认 |
| confirmer_id | String | 参数解释: 确认人ID 取值范围: 不涉及 |
| confirmer_name | String | 参数解释: 确认人姓名 取值范围: 不涉及 |
| confirm_risk_level | String | 参数解释: 确认的风险级别 取值范围: 不涉及 |
| confirm_time | String | 参数解释: 确认时间 取值范围: 不涉及 |
请求示例
查询指定来源版权检查任务详情
/v1/da211edc7bac01a07182af742e04dc6d/copyright-check/tasks/0c1a3b5f4d0e4f2a9b8067c5d1e2f3a4
响应示例
状态码:200
{
"status" : "SUCCESS",
"task_id" : "0c1a3b5f4d0e4f2a9b8067c5d1e2f3a4",
"user_id" : "admin",
"user_name" : "管理员",
"src_bucket" : "obs-bucket-copyright-source",
"src_file" : "copyright-source-template.xlsx",
"task_status" : "DONE",
"fail_reason" : "",
"total_rows" : 1,
"processed_rows" : 1,
"confirmed_rows" : 1,
"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",
"check_results" : {
"total" : 1,
"details" : [ {
"row_id" : "1",
"data_name" : "金融数据分析报告",
"data_url" : "https://finance.example.com/report/2026",
"domain" : "finance.example.com",
"license_url" : "https://license.example.com/finance",
"license_name" : "金融内容许可",
"license_content" : "本作品已获版权方授权",
"copyright_url" : "https://copyright.example.com/record/finance-2026",
"copyright_content" : "版权所有",
"risk_level" : "HIGH_RISK",
"search_time" : "2026-08-01 10:05:00",
"confirm_status" : false,
"confirmer_id" : "",
"confirmer_name" : "",
"confirm_risk_level" : "",
"confirm_time" : ""
} ]
}
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
错误码
请参见错误码。