# 查询所有网络ACL规则 #### 功能介绍 查询提交请求的租户有权限操作的所有网络ACL规则信息。单次查询最多返回2000条数据，超过2000后会返回分页标记。 #### 调试 您可以在[API Explorer](https://apiexplorer.developer.huaweicloud.com/apiexplorer/doc?product=VPC&version=v2&api=NeutronListFirewallRules)中调试该接口。 #### URI GET /v2.0/fwaas/firewall_rules 样例： ``` GET https://{Endpoint}/v2.0/fwaas/firewall_rules?name={firewall_rule_name}&tenant_id={tenant_id}&public={is_public}&protocol={protocol}&ip_version={ip_version}&action={action}&enabled={is_enabled} ``` 分页查询样例： ``` GET https://{Endpoint}/v2.0/fwaas/firewall_rules?limit=2&marker=2a193015-4a88-4aa1-84ad-d4955adae707&page_reverse=False ``` 参数说明请参见[表1]。 表1参数说明 | 名称 | 是否必选 | 参数类型 | 说明 | |:---|:---|:---|:---| | id | 否 | String | 按照网络ACL规则对应的ID过滤查询 | | name | 否 | String | 按照网络ACL规则的名称过滤查询 | | description | 否 | String | 按照网络ACL规则的描述过滤查询 | | ip_version | 否 | Integer | 按照网络ACL规则的IP协议版本过滤查询 取值范围：4,6 | | action | 否 | String | 按照网络ACL规则的行为过滤查询 取值范围：allow or deny | | enabled | 否 | Boolean | 按照网络ACL规则是否使能过滤查询 取值范围：true or false | | 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_rules ``` #### 响应参数 表2响应参数 | 参数名称 | 类型 | 说明 | |:---|:---|:---| | firewall_rules | Array of [Firewall Rule] objects | firewall rule对象列表，参见[表4]。单次查询最多返回2000条数据，超过2000后会返回分页标记。 | | firewall_rules_links | Array of [firewall_rules_link] Object | 分页信息，参见[表3] 。 只有在使用limit过滤，并且资源个数超过limit或者资源个数超过2000时（limit默认值），该参数的rel和href取值才会显示为next和其对应的link。 | 表3firewall_rules_link对象 | 参数名称 | 类型 | 说明 | |:---|:---|:---| | href | String | API链接 | | rel | String | API链接与该API版本的关系 | 表4Firewall Rule对象 | 参数名称 | 类型 | 说明 | |:---|:---|:---| | id | String | 网络ACL规则的uuid标识。 | | name | String | 网络ACL规则名称。 | | description | String | 网络ACL规则描述。 | | tenant_id | String | 项目ID | | public | Boolean | 是否支持跨租户共享。 | | protocol | String | IP协议。 | | source_port | String | 源端口号或者一段端口范围。 | | destination_port | String | 目的端口号或者一段端口范围。 | | ip_version | Integer | IP协议版本。 | | source_ip_address | String | 源地址或者CIDR。 | | destination_ip_address | String | 目的地址或者CIDR。 | | action | String | 对通过网络ACL的流量执行的操作。 | | enabled | Boolean | 是否使能网络ACL规则。 | | project_id | String | 项目ID，请参见[获取项目ID](https://support.huaweicloud.com/api-vpc/vpc_api_0011.html)。 | #### 响应示例 ``` { "firewall_rules": [ { "protocol": "tcp", "description": "update check parameter", "source_ip_address": "116.66.184.0/24", "destination_ip_address": "0.0.0.0/0", "destination_port": null, "source_port": null, "id": "2a193015-4a88-4aa1-84ad-d4955adae707", "name": "crhfwruleupdate", "tenant_id": "a1c6f90c94334bd2953d9a61b8031a68", "project_id": "a1c6f90c94334bd2953d9a61b8031a68", "enabled": true, "action": "allow", "ip_version": 4, "public": false }, { "protocol": "tcp", "description": "update check parameter", "source_ip_address": null, "destination_ip_address": null, "destination_port": "40:60", "source_port": "20:50", "id": "db7a204c-9eb1-40a2-9bd6-ed5cfd3cff32", "name": "update_firewall-role-tommy", "tenant_id": "a1c6f90c94334bd2953d9a61b8031a68", "project_id": "a1c6f90c94334bd2953d9a61b8031a68", "enabled": false, "action": "deny", "ip_version": 4, "public": false } ], "firewall_rules_links": [ { "rel": "previous", "href": "https://{Endpoint}/v2.0/fwaas/firewall_rules?marker=2a193015-4a88-4aa1-84ad-d4955adae707&page_reverse=True" } ] } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-vpc/vpc_api_0002.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-vpc/vpc_api_0003.html)。