修改内容审核任务 - UpdateAiDataSecurityTask
功能介绍
功能介绍:修改指定内容审核任务的配置,包括任务名称、描述、检测模态、数据格式、OBS数据源、调度策略、检测配置、违规文件迁移等参数。修改时复用创建任务的校验逻辑,任务名称不能与同项目同类型已有任务重复。仅任务处于非等待/非处理中状态时允许修改。
调用方法
请参见如何调用API。
授权信息
账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权,具体权限要求请参见权限和授权项。
- 如果使用身份策略授权,当前API调用无需身份策略权限。
URI
PUT /v1/{project_id}/content-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个字符 默认取值: 不涉及 |
请求参数
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| X-Auth-Token | 是 | String | 参数解释: 用户Token,用于鉴权和标识调用方身份。通过调用IAM服务“查询用户Token”接口获取,Token值为响应消息头中X-Subject-Token对应的值 约束限制: 不涉及 取值范围: 不涉及 默认取值: 不涉及 |
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| task_name | 是 | String | 参数解释: 任务名称 约束限制: 最大长度512字符,满足正则匹配"^[a-zA-Z一-龥]+[0-9a-zA-Z一-龥_-]*" 取值范围: 不涉及 默认取值: 不涉及 |
| description | 否 | String | 参数解释: 资源描述信息 约束限制: 最大长度512字符 取值范围: 不涉及 默认取值: 不涉及 |
| content_modals | 是 | Array of strings | 参数解释: 内容模态列表,数组元素为字符串类型,指定本次审核需要检测的内容类型(如文本、图片、OCR文本等) 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| data_formats | 是 | Array of strings | 参数解释: 数据格式列表,数组元素为字符串类型,指定本次审核需要检测的数据文件格式 约束限制: 不涉及 取值范围: 默认取值: 不涉及 |
| data_source | 是 | String | 参数解释: 数据来源 约束限制: 当前仅支持OBS 取值范围: 默认取值: 不涉及 |
| src_bucket | 是 | String | 参数解释: 源OBS桶 约束限制: 最大长度512字符 取值范围: 不涉及 默认取值: 不涉及 |
| src_directory | 否 | String | 参数解释: 源目录 约束限制: 最大长度512字符 取值范围: 不涉及 默认取值: 不涉及 |
| 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>类型,用于配置各项检测规则及其风险阈值 约束限制: key需与task_type匹配(COPYRIGHT类型支持IP_CONFIDENCE/MATCH_LENGTH/TOLERANCE;COMPLIANCE类型支持内容检测项),COPYRIGHT类型下MATCH_LENGTH必须大于TOLERANCE 取值范围: COPYRIGHT类型:IP_CONFIDENCE取值0.6~0.99,MATCH_LENGTH取值10~500,TOLERANCE取值0~50;COMPLIANCE类型:value取值0~100 默认取值: IP_CONFIDENCE未传且content_modals含STATIC_IMAGE时默认0.75;MATCH_LENGTH未传且content_modals含TEXT或OCR_TEXT时默认20;TOLERANCE未传且content_modals含TEXT或OCR_TEXT时默认5 |
| move_violation | 是 | Boolean | 参数解释: 是否移动违规文件 约束限制: 不涉及 取值范围: true-是,false-否 默认取值: 不涉及 |
| dst_bucket | 否 | String | 参数解释: 目标OBS桶 约束限制: 最大长度512字符 取值范围: 不涉及 默认取值: 不涉及 |
| dst_directory | 否 | String | 参数解释: 目标目录 约束限制: 最大长度512字符 取值范围: 不涉及 默认取值: 不涉及 |
| blacklist_ids | 否 | Array of strings | 参数解释: 黑名单ID列表,数组元素为字符串类型,表示内容审核黑名单的ID,黑名单中的内容将被标记为违规。可通过查询内容审核黑名单列表接口获取 约束限制: 不涉及 取值范围: 数组元素为黑名单ID,字符类型,长度不超过64个字符 默认取值: 不涉及 |
| whitelist_ids | 否 | Array of strings | 参数解释: 白名单ID列表,数组元素为字符串类型,表示内容审核白名单的ID,白名单中的内容允许通过审核。可通过查询内容审核白名单列表接口获取 约束限制: 不涉及 取值范围: 数组元素为白名单ID,字符类型,长度不超过64个字符 默认取值: 不涉及 |
响应参数
状态码:200
| 参数 | 参数类型 | 描述 |
|---|---|---|
| task_id | String | 参数解释: 任务ID 取值范围: 不涉及 |
请求示例
修改内容审核任务配置
{
"task_name" : "content-check-task-finance",
"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
},
"move_violation" : true,
"dst_bucket" : "obs-bucket-violation-archive",
"dst_directory" : "violation/2026-08",
"blacklist_ids" : [ "2e3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b" ],
"whitelist_ids" : [ "3f4a5b6c7d8e9f0a1b2c3d4e5f6a7b8c" ]
} 响应示例
状态码:200
{
"task_id" : "0c1a3b5f4d0e4f2a9b8067c5d1e2f3a4"
} 状态码
| 状态码 | 描述 |
|---|---|
| 200 | 更新成功 |
错误码
请参见错误码。