文档中心

云手机

请输入

安全策略

查询安全策略列表 ListSecurityPolicy

查询已创建的安全策略列表，支持分页查询，每条策略返回当前已启用的最新版本详细信息。

使用说明

调用 MUA OpenAPI 前，必须先访问跨服务访问请求为您的账号授权。

注意事项

本接口整体 QPS 限制为 50 次/秒、单用户 QPS 限制为 10 次/秒。超过限制，API 调用会被限流。

请求说明

请求地址：https://open.volcengineapi.com?Action=ListSecurityPolicy&Version=2023-08-01

请求参数

下表仅列出该接口特有的请求参数和部分公共参数。更多信息请见公共参数。

Header

参数	类型	是否必选	示例值	描述
Content-Type	String	是	application/json	请求头信息。

Query

参数	类型	是否必选	示例值	描述
Action	String	是	ListSecurityPolicy	接口名称。当前 API 的名称为 ListSecurityPolicy。
Version	String	是	2023-08-01	接口版本。当前 API 的版本为 2023-08-01。

Body

参数	类型	是否必选	示例值	描述
PolicyId	String	否	policy-8f5c2*****	按安全策略 ID 精准筛选，您可以调用 CreateSecurityPolicy 接口获取。
ProductId	String	否	product-001	业务 ID，管理 MUA 资源、开展 MUA 业务的标识。您可以登录 MUA 控制台，在查看业务信息中获取。不传默认查询该账号下所有业务的安全策略列表。
AgentType	String	否	mua	Agent 类型，暂仅支持 mua。
Status	Integer	否	1	安全策略的状态，取值： 1：启用安全策略。 0：禁用安全策略。
Effect	String	否	approval_required	安全策略生效后的处理方式，不传时返回所有处理方式的安全策略，取值： allow：允许，适用于风险较低或已获授权的操作。 approval_required：需人工审批，操作可执行，但需用户确认后方可继续。 deny：拒绝执行，适用于命中拦截规则或当前上下文不足以安全执行的操作。
SearchField	String	否	description	搜索字段，取值： description：按策略说明 Description 搜索。不传时默认按策略名称 Name 搜索。说明您可以调用 CreateSecurityPolicy 接口获取Description、Name。
Keyword	String	否	敏感信息	搜索的关键词。
Limit	Integer	否	10	每页返回的条数，取值范围为 1~100，默认值为 10。
Offset	Integer	否	1	页码，默认值为 1。

返回参数

下表仅列出本接口特有的返回参数。更多信息请参见返回结构。

参数	类型	示例值	描述
Total	Integer	1	满足筛选条件的安全策略总数量。
List	Array	[]	安全策略列表，每个元素为一条策略的详细信息，数据结构请参见 SecurityPolicyInfo。

请求示例

返回示例

错误码

MUA OpenAPI 错误码请参见错误码。

最近更新时间：2026.09.30 14:53:51

这个页面对您有帮助吗？

有用

无用