获取内容审核任务列表 - ListAiDataSecurityTasks
功能介绍
功能介绍:获取指定项目下的内容审核任务列表,支持按任务类型、任务名称、任务状态、内容模态、调度类型等条件筛选,返回任务总数及分页任务详情列表。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
GET /v1/{project_id}/content-check/tasks
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| project_id | 是 | String | 参数解释: 项目ID,标识资源所属的华为云项目,用于隔离不同的租户资源。可通过用户控制台的“我的凭证”页面或调用IAM服务接口获取对应的项目ID 约束限制: 满足正则匹配"^[a-z0-9]{32}$" 取值范围: 由IAM服务接口返回,为固定长度的32个字符,由数字和字母组成 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_type | 否 | String | 参数解释: 任务类型 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| task_name | 否 | String | 参数解释: 任务名称,用于按任务名称模糊筛选内容审核任务 约束限制: 不涉及 取值范围: 字符类型,长度不超过512个字符 默认取值: 不涉及 |
| status | 否 | String | 参数解释: 任务状态,用于按任务状态筛选内容审核任务 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| content_modals | 否 | String | 参数解释: 内容模型 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| schedule_type | 否 | String | 参数解释: 调度类型 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| limit | 否 | Integer | 参数解释: 每页数量限制 约束限制: 不涉及 取值范围: 1 ~ 1000 默认取值: 10 |
| offset | 否 | Integer | 参数解释: 分页偏移 约束限制: 不涉及 取值范围: 0 ~ 1000 默认取值: 0 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,用于鉴权和标识调用方身份。通过调用IAM服务“查询用户Token”接口获取,Token值为响应消息头中X-Subject-Token对应的值 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| total | Integer | 参数解释: 总记录数 取值范围: 不涉及 |
| tasks | Array of ContentCheckTaskInfo objects | 参数解释: 任务列表 取值范围: 不涉及 |
| 参数 | 参数类型 | 描述 |
|---|---|---|
| id | String | 参数解释: 资源ID,唯一标识 取值范围: 不涉及 |
| task_name | String | 参数解释: 任务名称 取值范围: 不涉及 |
| task_type | String | 参数解释: 任务类型 取值范围: |
| description | String | 参数解释: 资源描述信息 取值范围: 不涉及 |
| content_modals | Array of strings | 参数解释: 内容模态列表,数组元素为字符串类型,表示该审核任务检测的内容类型(如文本、图片、OCR文本等) 取值范围: |
| data_formats | Array of strings | 参数解释: 数据格式列表,数组元素为字符串类型,表示该审核任务支持检测的数据文件格式(如纯文本、PDF、Word等) 取值范围: |
| data_source | String | 参数解释: 数据来源 取值范围: |
| src_bucket | String | 参数解释: 源OBS桶 取值范围: 不涉及 |
| src_directory | String | 参数解释: 源目录 取值范围: 不涉及 |
| traverse_subdir | Boolean | 参数解释: 是否遍历子目录 取值范围: true-是,false-否 |
| schedule_type | String | 参数解释: 调度类型 取值范围: - MONTHLY-每月执行 |
| next_run_time | Long | 参数解释: 下次运行时间,Unix时间戳,单位毫秒,表示任务计划下一次自动执行的时间点 取值范围: 0 ~ 9999999999999(Unix时间戳,单位毫秒) |
| detection_config | map<string, object> | 参数解释: 内容审核检测配置,Map<String,Double>类型,用于配置各项检测规则及其风险阈值 取值范围: COPYRIGHT类型:IP_CONFIDENCE取值0.6~0.99,MATCH_LENGTH取值10~500,TOLERANCE取值0~50;COMPLIANCE类型:value取值0~100 |
| status | String | 参数解释: 操作结果状态 取值范围: |
| error_reason | String | 参数解释: 错误原因 取值范围: 不涉及 |
| total_files | Integer | 参数解释: 文件总数,表示该内容审核任务本次处理涉及的文件总数 取值范围: 大于等于0的整数,单位为个 |
| processed_files | Integer | 参数解释: 已处理文件 取值范围: 不涉及 |
| violated_files | Integer | 参数解释: 违规文件 取值范围: 不涉及 |
| move_violation | Boolean | 参数解释: 是否移动违规文件 取值范围: true-是,false-否 |
| dst_bucket | String | 参数解释: 目标OBS桶 取值范围: 不涉及 |
| dst_directory | String | 参数解释: 目标目录 取值范围: 不涉及 |
| created_at | Long | 参数解释: 任务创建时间,Unix时间戳,单位毫秒,表示任务被创建的时间点 取值范围: 0 ~ 9999999999999(Unix时间戳,单位毫秒) |
| started_at | Long | 参数解释: 任务启动时间,Unix时间戳,单位毫秒,表示任务实际开始执行的时间点 取值范围: 0 ~ 9999999999999(Unix时间戳,单位毫秒) |
| completed_at | Long | 参数解释: 任务完成时间,Unix时间戳,单位毫秒,表示任务执行完成的时间点 取值范围: 0 ~ 9999999999999(Unix时间戳,单位毫秒) |
| blacklist_ids | Array of strings | 参数解释: 黑名单ID列表 取值范围: 不涉及 |
| blacklist_names | Array of strings | 参数解释: 黑名单名称列表 取值范围: 不涉及 |
| whitelist_ids | Array of strings | 参数解释: 白名单ID列表 取值范围: 不涉及 |
| whitelist_names | Array of strings | 参数解释: 白名单名称列表 取值范围: 不涉及 |
| export_status | String | 参数解释: 导出状态 取值范围: |
| export_error_reason | String | 参数解释: 导出错误原因 取值范围: 不涉及 |
| export_bucket | String | 参数解释: 导出桶 取值范围: 不涉及 |
| export_directory | String | 参数解释: 导出目录 取值范围: 不涉及 |
| export_filename | String | 参数解释: 导出文件名 取值范围: 不涉及 |
| export_started_at | Long | 参数解释: 导出启动时间,Unix时间戳,单位毫秒,表示离线报告开始导出的时间点 取值范围: 0 ~ 9999999999999(Unix时间戳,单位毫秒) |
| export_completed_at | Long | 参数解释: 导出完成时间,Unix时间戳,单位毫秒,表示离线报告导出完成的时间点 取值范围: 0 ~ 9999999999999(Unix时间戳,单位毫秒) |
| updated_at | Long | 参数解释: 任务更新时间,Unix时间戳,单位毫秒,表示任务信息最近一次被更新的时间点 取值范围: 0 ~ 9999999999999(Unix时间戳,单位毫秒) |
请求示例
查询内容审核任务列表
/v1/da211edc7bac01a07182af742e04dc6d/content-check/tasks?limit=10&offset=0
响应示例
状态码:200
{
"total" : 1,
"tasks" : [ {
"id" : "0c1a3b5f4d0e4f2a9b8067c5d1e2f3a4",
"task_name" : "content-check-task-finance",
"task_type" : "COPYRIGHT",
"description" : "金融业务数据内容合规审核任务",
"content_modals" : [ "TEXT", "OCR_TEXT" ],
"data_formats" : [ "PDF", "WORD" ],
"data_source" : "OBS",
"src_bucket" : "obs-bucket-finance-audit",
"src_directory" : "finance/reports/2026",
"traverse_subdir" : true,
"schedule_type" : "WEEKLY",
"next_run_time" : 1787392800000,
"detection_config" : {
"IP_CONFIDENCE" : 0.85,
"MATCH_LENGTH" : 20,
"TOLERANCE" : 5
},
"status" : "COMPLETED",
"error_reason" : "任务执行完成未记录异常",
"total_files" : 1280,
"processed_files" : 1280,
"violated_files" : 36,
"move_violation" : true,
"dst_bucket" : "obs-bucket-violation-archive",
"dst_directory" : "violation/2026-08",
"created_at" : 1787306400000,
"started_at" : 1787306460000,
"completed_at" : 1787309400000,
"blacklist_ids" : [ "2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b" ],
"blacklist_names" : [ "content-check-blacklist-copyright" ],
"whitelist_ids" : [ "3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c" ],
"whitelist_names" : [ "content-check-whitelist-authorized" ],
"export_status" : "SUCCESS",
"export_error_reason" : "导出任务执行成功无异常",
"export_bucket" : "obs-bucket-export-reports",
"export_directory" : "export/content-check/2026-08",
"export_filename" : "content-check-report-2026-08-18.csv",
"export_started_at" : 1787307000000,
"export_completed_at" : 1787309600000,
"updated_at" : 1787309660000
} ]
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 查询成功 |
错误码
请参见错误码。