更新时间:2026-08-19 GMT+08:00
分享

批量删除策略

功能介绍

批量删除 AI 护栏策略

URI

POST /v1/{project_id}/aiguard/policies/batch-delete

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,用于标识请求所属的项目

约束限制:

字符串类型,32位UUID

取值范围:

只能由英文字母、数字组成,长度为1~64个字符

默认取值:

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token,用于验证请求的合法性。通过调用IAM服务获取用户Token接口获取(响应消息头中X-Subject-Token的值)

约束限制:

字符串类型,长度1~16384个字符

取值范围:

只能由英文字母、数字及"-"、"_"组成

默认取值:

不涉及

Content-Type

String

参数解释:

内容类型,用于指定请求体的媒体类型

约束限制:

固定值application/json;charset=utf8

取值范围:

application/json;charset=utf8

默认取值:

application/json;charset=utf8

表3 请求Body参数

参数

是否必选

参数类型

描述

policy_ids

Array of strings

参数解释:

策略ID列表,用于指定要删除的策略ID列表

约束限制:

数组类型,最多100个ID

取值范围:

每个元素为32位UUID

默认取值:

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

policy_ids

Array of strings

参数解释:

已删除的策略ID列表,用于返回已删除的策略ID

取值范围:

字符串数组

状态码:400

表5 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,用于标识错误类型

取值范围:

字符串类型,长度1~64字符

error_msg

String

参数解释:

错误信息,用于描述错误详情

取值范围:

字符串类型,长度1~2048字符

状态码:500

表6 响应Body参数

参数

参数类型

描述

error_code

String

参数解释:

错误码,用于标识错误类型

取值范围:

字符串类型,长度1~64字符

error_msg

String

参数解释:

错误信息,用于描述错误详情

取值范围:

字符串类型,长度1~2048字符

请求示例

{
  "policy_ids" : [ "policy1", "policy2" ]
}

响应示例

状态码:200

操作成功

{
  "policy_ids" : [ "policy1", "policy2" ]
}

状态码

状态码

描述

200

操作成功

400

参数错误

500

服务端内部错误

错误码

请参见错误码

相关文档