Queries the information about all policy groups of access control policies that are created for virtual private cloud (VPC) firewalls.

Description

You can call the DescribeVpcFirewallAclGroupList operation to query the information about all policy groups of access control policies that are created for VPC firewalls.

Limits

You can call this operation up to 10 times per second per account. If the number of the calls per second exceeds the limit, throttling is triggered. As a result, your business may be affected. We recommend that you take note of the limit when you call this operation.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeVpcFirewallAclGroupList

The operation that you want to perform.

Set the value to DescribeVpcFirewallAclGroupList.

Lang String No zh

The natural language of the request and response. Valid values:

  • zh: Chinese (default)
  • en: English
FirewallConfigureStatus String No configured

Specifies whether VPC firewalls are configured.

  • notconfigured: VPC firewalls are not configured.
  • configured: VPC firewalls are configured.
  • If this parameter is left empty, all policy groups of access control policies are queried.
CurrentPage String No 1

The number of the page to return.

Default value: 1.

PageSize String No 10

The number of entries to return on each page.

Maximum value: 50.

Response parameters

Parameter Type Example Description
AclGroupList Array of Data

The information about the policy group.

AclGroupId String vfw-a42bbb7b887148c9****

The ID of the policy group.

Valid values:

  • If the VPC firewall is used to protect a Cloud Enterprise Network (CEN) instance, the value of this parameter is the ID of the CEN instance.

    Example: cen-ervw0g12b5jbw****

  • If the VPC firewall is used to protect an Express Connect circuit, the value of this parameter is the ID of the VPC firewall instance.

    Example: vfw-a42bbb7b887148c9****

AclGroupName String group_test

The name of the policy group.

  • If the VPC firewall is used to protect a CEN instance, the value of this parameter is the name of the CEN instance.
  • If the VPC firewall is used to protect an Express Connect circuit, the value of this parameter is the name of the VPC firewall instance.
RequestId String CBF1E9B7-D6A0-4E9E-AD3E-2B47E6C2837D

The ID of the request.

TotalCount Integer 1

The total number of the policy groups that are returned.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeVpcFirewallAclGroupList
&FirewallConfigureStatus=configured
&<Common request parameters>

Sample success responses

XML format

<DescribeVpcFirewallAclGroupListResponse>
  <TotalCount>1</TotalCount>
  <AclGroupList>
        <AclGroupId>vfw-a42bbb7b887148c9****</AclGroupId>
        <AclGroupName>group_test</AclGroupName>
  </AclGroupList>
</DescribeVpcFirewallAclGroupListResponse>

JSON format

{"TotalCount":1,"AclGroupList":[{"AclGroupId":"vfw-a42bbb7b887148c9****","AclGroupName":"group_test"}]}