查询所有网络ACL策略
功能介绍
查询提交请求的租户有权限操作的所有网络ACL策略信息。单次查询最多返回2000条数据,超过2000后会返回分页标记。分页查询请参考分页查询。
URI
GET /v2.0/fwaas/firewall_policies
分页查询样例:
GET https://{Endpoint}/v2.0/fwaas/firewall_policies?limit=2&marker=6b70e321-0c21-4b83-bb8a-a886d1414a5f&page_reverse=False
参数说明请参见表1
名称 |
是否必选 |
参数类型 |
说明 |
---|---|---|---|
id |
否 |
String |
按照网络ACL策略对应的ID过滤查询 |
name |
否 |
String |
按照网络ACL策略的名称过滤查询 |
description |
否 |
String |
按照网络ACL策略的描述过滤查询 |
tenant_id |
否 |
String |
按照网络ACL策略所属的项目ID过滤查询 |
marker |
否 |
String |
分页查询的起始资源ID,表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用:
|
limit |
否 |
Integer |
分页查询每页返回的记录个数,取值范围为0~intmax(2^31-1),默认值2000。 limit需要和marker配合使用,详细规则请见marker的参数说明。 |
请求参数
无。
请求示例
GET https://{Endpoint}/v2.0/fwaas/firewall_policies
响应参数
参数名称 |
类型 |
说明 |
---|---|---|
firewall_policies |
Array of firewall Policy object |
firewall policy对象列表。请参见表3。 |
firewall_policies_links |
Array of firewall_policies_link object |
firewall_policies_link对象。请参见表4。 只有在使用limit过滤,并且资源个数超过limit或者资源个数超过2000时(limit默认值),该参数的rel和href取值才会显示为next和其对应的link。 |
属性 |
类型 |
说明 |
---|---|---|
id |
String |
网络ACL策略uuid标识。 |
name |
String |
网络ACL策略名称。 |
description |
String |
网络ACL策略描述。 |
tenant_id |
String |
项目ID |
firewall_rules |
Array of strings |
策略引用的网络ACL规则链。 |
audited |
Boolean |
审计标记。 |
public |
Boolean |
是否支持跨租户共享。 |
project_id |
String |
项目ID,请参见获取项目ID。 |
响应示例
{ "firewall_policies": [ { "description": "", "firewall_rules": [ "6c6803e0-ca8c-4aa9-afb3-4f89275b6c32" ], "tenant_id": "23c8a121505047b6869edf39f3062712", "public": false, "id": "6b70e321-0c21-4b83-bb8a-a886d1414a5f", "audited": false, "name": "fwp1", "project_id": "23c8a121505047b6869edf39f3062712" }, { "description": "", "firewall_rules": [ "6c6803e0-ca8c-4aa9-afb3-4f89275b6c32" ], "tenant_id": "23c8a121505047b6869edf39f3062712", "public": false, "id": "fce92002-5a15-465d-aaca-9b44453bb738", "audited": false, "name": "fwp2", "project_id": "23c8a121505047b6869edf39f3062712" } ], "firewall_policies_links": [ { "rel": "previous", "href": "https://{Endpoint}/v2.0/fwaas/firewall_policies?marker=6b70e321-0c21-4b83-bb8a-a886d1414a5f&page_reverse=True" } ] }
状态码
请参见状态码。
错误码
请参见错误码。