查询所有网络ACL策略

功能介绍

查询提交请求的租户有权限操作的所有网络ACL策略信息。单次查询最多返回2000条数据，超过2000后会返回分页标记。分页查询请参考分页查询。

调试

您可以在API Explorer中调试该接口。

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

表1 参数说明
名称	是否必选	参数类型	说明
id	否	String	按照网络ACL策略对应的ID过滤查询
name	否	String	按照网络ACL策略的名称过滤查询
description	否	String	按照网络ACL策略的描述过滤查询
tenant_id	否	String	按照网络ACL策略所属的项目ID过滤查询
marker	否	String	分页查询的起始资源ID，表示从指定资源的下一条记录开始查询。 marker需要和limit配合使用：若不传入marker和limit参数，查询结果返回第一页全部资源记录。若不传入marker参数，limit为10，查询结果返回第1~10条资源记录。若marker为第10条记录的资源ID，limit为10，查询结果返回第11~20条资源记录。若marker为第10条记录的资源ID，不传入limit参数，查询结果返回第11~2000条（limit默认值2000）资源记录。
limit	否	Integer	分页查询每页返回的记录个数，取值范围为0~2000，默认值2000。 limit需要和marker配合使用，详细规则请见marker的参数说明。

请求参数

无。

请求示例

GET https://{Endpoint}/v2.0/fwaas/firewall_policies

响应参数

表2 响应参数
参数名称	类型	说明
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。

表3 firewall_Policy对象
参数名称	类型	说明
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。

表4 firewall_policies_link对象
名称	参数类型	说明
href	String	API链接
rel	String	API链接与该API版本的关系

响应示例

{
    "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"
        }
    ]
}