文档首页/ 企业主机安全 HSS/ API参考/ API说明/ 防护配置/ 查询策略列表 - ListAiPolicies
更新时间:2026-08-10 GMT+08:00
分享

查询策略列表 - ListAiPolicies

功能介绍

查询策略列表。

调用方法

请参见如何调用API

授权信息

账号具备所有API的调用权限,如果使用账号下的IAM用户调用当前API,该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权,具体权限要求请参见权限和授权项
  • 如果使用身份策略授权,当前API调用无需身份策略权限。

URI

GET /v5/{project_id}/ai/policy

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释:

项目ID,可通过我的凭证,项目id获取

约束限制:

必填

取值范围:

字符长度1-256位

默认取值:

不涉及

表2 Query参数

参数

是否必选

参数类型

描述

policy_group_id

String

参数解释

策略组ID

约束限制

不涉及

取值范围

字符长度1-20位

默认取值

不涉及

请求参数

表3 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释:

用户Token,包含了用户的身份、权限等信息,在调用API接口时,可通过Token进行身份认证。获取方式请参见获取用户Token

约束限制:

不涉及

取值范围:

字符长度1-32768位

默认取值:

不涉及

响应参数

状态码:200

表4 响应Body参数

参数

参数类型

描述

data_list

Array of AiPolicyInfo objects

参数解释:

AI策略列表

取值范围:

取值0-200个对象

表5 AiPolicyInfo

参数

参数类型

描述

policy_id

String

参数解释:

策略ID

取值范围:

字符长度1-20位

policy_name

String

参数解释:

策略名称

取值范围

  • 0: 意图行为一致性检测

  • 1: 命令执行控制

  • 2: 文件访问控制

  • 3: 敏感信息检测

  • 4: 角色限定

enabled

Boolean

参数解释:

是否启用

取值范围:

  • false:否

  • true:是

policy_group_id

String

参数解释

策略组ID

取值范围

字符长度1-20位

content

String

参数解释:

策略详情

取值范围:

字符长度0-65535位

description

String

参数解释:

策略描述

取值范围:

字符长度1-256位

create_time

Integer

参数解释

创建时间

取值范围

最小值0,最大值9223372036854775807

update_time

Integer

参数解释

创建时间

取值范围

最小值0,最大值9223372036854775807

请求示例

查询策略列表

GET https://{endpoint}/v5/{project_id}/ai/policy

响应示例

状态码:200

请求已成功

{
  "data_list" : [ {
    "policy_id" : 2058436565955923968,
    "policy_name" : "policy_name",
    "enabled" : false,
    "policy_group_id" : 2058436565955923961,
    "content" : null,
    "description" : "description1",
    "create_time" : 1778874953990,
    "update_time" : 1778874953990
  } ]
}

状态码

状态码

描述

200

请求已成功

错误码

请参见错误码

相关文档