接口约束
4.8 安全策略
4.8.2 查询自定义安全策略列表
状态码
状态码 描述
201 POST操作正常返回。
错误码
请参见错误码。
4.8.2 查询自定义安全策略列表
功能介绍
查询自定义安全策略列表。
接口约束
● 分页查询使用的参数为marker、limit、page_reverse。
● marker和page_reverse只有和limit一起使用时才会生效，单独使用无效。
调试
您可以在API Explorer中调试该接口。
URI
GET /v3/{project_id}/elb/security-policies
表4-138 路径参数
参数 是否必选 参数类型 描述
project_id 是 String 项目ID。
表4-139 Query 参数
参数 是否必选 参数类型 描述
marker 否 String 上一页最后一条记录的ID。
使用说明：
● 必须与limit一起使用。
● 不指定时表示查询第一页。
● 该字段不允许为空或无效的 ID。
limit 否 Integer 每页返回的个数。
最小值：0 最大值：2000 缺省值：2000
page_reverse 否 Boolean 分页的顺序，true表示从后往前 分页，false表示从前往后分 页，默认为false。
使用说明：必须与limit一起使 用。
id 否 Array 自定义安全策略的ID。
支持多值查询，查询条件格式：
id=xxx&id=xxx。
name 否 Array 自定义安全策略的名称。
支持多值查询，查询条件格式：
name=xxx&name=xxx。 description 否 Array 自定义安全策略的描述信息。
支持多值查询，查询条件格式：
description=xxx&description=x xx。
protocols 否 Array 空格分隔的自定义安全策略的
TLS协议。
支持多值查询，查询条件格式：
protocols=xxx&protocols=xxx
。
参数 是否必选 参数类型 描述
ciphers 否 Array 冒号分隔的自定义安全策略的加
密套件。
支持多值查询，查询条件格式：
ciphers=xxx&ciphers=xxx。
请求参数
表4-140 请求 Header 参数
参数 是否必选 参数类型 描述
X-Auth-Token 是 String IAM鉴权Token。
响应参数
状态码： 200
表4-141 响应 Body 参数
参数 参数类型 描述
security_polici
es Array of SecurityPolic y objects
自定义安全策略列表返回对象。
request_id String 请求ID。
注：自动生成 。 page_info PageInfo
object 分页信息。
表4-142 SecurityPolicy
参数 参数类型 描述
id String 自定义安全安全策略的id。
project_id String 自定义安全策略的项目id。
name String 自定义安全策略的名称 description String 自定义安全策略的描述。
listeners ListenerRef
object 监听器
参数 参数类型 描述 protocols Array of
strings 自定义安全策略的TLS协议列表。
ciphers Array of
strings 自定义安全策略的加密套件列表。
created_at String 自定义安全策略的创建时间。
updated_at String 自定义安全策略的更新时间。
表4-143 ListenerRef
参数 参数类型 描述
id String 监听器ID。
表4-144 PageInfo
参数 参数类型 描述
previous_mar
ker String 分页查询结果中第一条记录的ID next_marker String 分页查询结果中最后一条记录的ID。
current_count Integer 当前的记录数。
请求示例
分页查询自定义安全策略列表
GET https://{ELB_Endpoint}/v3/7a9941d34fc1497d8d0797429ecfd354/elb/security-policies?limit=2
响应示例
状态码： 200 操作正常返回。
{ "request_id" : "88424a61-6fa1-4850-aa8b-ce31d78abcf2", "security_policies" : [ {
"id" : "03cf511a-d130-445e-9b02-12d7049ddabf", "name" : "test_security_policy",
"project_id" : "7a9941d34fc1497d8d0797429ecfd354", "description" : "",
"protocols" : [ "TLSv1", "TLSv1.3" ],
"ciphers" : [ "AES128-SHA", "TLS_AES_128_GCM_SHA256", "TLS_AES_256_GCM_SHA384",
"TLS_CHACHA20_POLY1305_SHA256", "TLS_AES_128_CCM_SHA256", "TLS_AES_128_CCM_8_SHA256" ], "listeners" : [ {
"id" : "6f7c0d75-81c4-4735-87a0-dc5df0f27f5a"
} ],
"created_at" : "2021-02-06T10:07:10Z", "updated_at" : "2021-02-06T10:07:10Z"
}, {
"id" : "04e5d426-628c-42db-867c-fcaefbed2cab", "name" : "update_securitypolicy",
"project_id" : "7a9941d34fc1497d8d0797429ecfd354", "description" : "",
"protocols" : [ "TLSv1.2", "TLSv1.1", "TLSv1.3" ],
"ciphers" : [ "CAMELLIA128-SHA", "TLS_AES_256_GCM_SHA384", "TLS_CHACHA20_POLY1305_SHA256",
"TLS_AES_128_CCM_SHA256", "TLS_AES_128_CCM_8_SHA256" ], "listeners" : [ {
"id" : "e19b7379-807e-47fb-b53d-46aff540580c"
} ],
"created_at" : "2021-02-06T10:01:58Z", "updated_at" : "2021-03-20T07:18:59Z"
} ],
"page_info" : {
"next_marker" : "04e5d426-628c-42db-867c-fcaefbed2cab", "previous_marker" : "03cf511a-d130-445e-9b02-12d7049ddabf", "current_count" : 2
}}
状态码
状态码 描述
200 操作正常返回。
错误码
请参见错误码。