虚拟私有云 VPC虚拟私有云 VPC

更新时间:2021/07/11 GMT+08:00
分享

查询所有网络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条及之后的所有资源记录。

limit

Integer

分页查询每页返回的记录个数,取值范围为0~intmax。

limit需要和marker配合使用,详细规则请见marker的参数说明。

请求消息

无。

响应消息

表2 响应参数

参数名称

类型

说明

firewall_policies

Array of firewall Policy object

firewall policy对象。请参见表3

firewall_policies_links

Array of firewall_policies_link object

firewall_policies_link对象。请参见表4

表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版本的关系

样例

请求样例

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

响应样例

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

状态码

请参见状态码

错误码

请参见错误码

分享:

    相关文档

    相关产品