All Products
Search
Document Center

Cloud Firewall:DescribeVpcFirewallSummaryInfo

Last Updated:Oct 15, 2025

Queries the summary of VPC firewalls.

Operation description

QPS limit

The queries per second (QPS) limit for this API is 10 for each user. If you exceed this limit, API calls are throttled, which can affect your business. We recommend that you call this API at a reasonable rate.

Try it now

Try this API in OpenAPI Explorer, no manual signing needed. Successful calls auto-generate SDK code matching your parameters. Download it with built-in credential security for local usage.

Test

RAM authorization

No authorization for this operation. If you encounter issues with this operation, contact technical support.

Request parameters

Parameter

Type

Required

Description

Example

Lang

string

No

The language of the response. Valid values:

  • zh (default): Chinese.

  • en: English.

zh

Lang

string

No

The language of the response. Valid values:

  • zh (default): Chinese.

  • en: English.

zh

UserType

string

No

The type of the user. Valid values:

buy: A paid user.

free: A free-of-charge user.

buy

Response elements

Element

Type

Description

Example

object

AvailableVpcFirewallQuota

integer

The remaining quota for VPC firewalls.

4

CenExpressConnectVpcCount

integer

The number of VPCs connected using Cloud Enterprise Network (CEN).

7

CenFirewallVpcCount

integer

The number of CEN VPCs.

10

CenTrVpcCount

integer

The total number of VPCs on the CEN transit router.

13

ClosedCenFirewallCount

integer

The number of configured CEN firewalls that are disabled.

1

ClosedExpressConnectFirewallCount

integer

The number of configured Express Connect firewalls that are disabled.

10

ClosedVpcFirewallCount

integer

The total number of configured border firewalls that are disabled.

5

ConfiguredCenFirewallCount

integer

The number of configured CEN firewall instances of the Basic Edition.

5

ConfiguredCenFirewallRegionCount

integer

The number of regions where CEN is configured.

2

ConfiguredCenFirewallVpcCount

integer

The number of configured CEN VPCs.

18

ConfiguredCenTrFirewallCount

integer

The number of configured firewall instances for the CEN transit router.

2

ConfiguredExpressConnectFirewallCount

integer

The number of configured Express Connect circuits.

2

ConfiguredExpressConnectVpcCount

integer

The number of configured Express Connect VPCs.

2

ConfiguredVpcFirewallCount

integer

The total number of configured border firewalls.

5

ConfiguredVpcFirewallVpcCount

integer

The number of VPCs for which a firewall is configured.

1

ExpressConnectVpcCount

integer

The number of Express Connect VPCs.

2

NotConfiguredCenFirewallCount

integer

The number of CEN firewalls that are not configured.

0

NotConfiguredCenTrFirewallCount

integer

The number of firewall instances for the CEN transit router that are not configured.

6

NotConfiguredExpressConnectFirewallCount

integer

The number of Express Connect firewalls that are not configured.

7

NotConfiguredVpcFirewallCount

integer

The total number of border firewalls that are not configured.

12

OpenedCenExpressConnectVpcCount

integer

The number of VPC connections that are enabled and work as expected.

10

OpenedCenFirewallCount

integer

The number of enabled CEN firewalls.

4

OpenedCenFirewallVpcCount

integer

The number of VPCs protected by CEN.

0

OpenedCenTrFirewallVpcCount

integer

The number of VPCs protected by the CEN transit router.

4

OpenedEcrCount

integer

The number of CEN Express Connect Routers (ECRs).

0

OpenedExpressConnectFirewallCount

integer

The number of enabled Express Connect firewalls.

15

OpenedExpressConnectVpcCount

integer

The number of VPCs protected by Express Connect.

2

OpenedPeerTrCount

integer

The number of protected inter-region connections for the CEN transit router.

3

OpenedVbrCount

integer

The total number of protected Virtual Border Routers (VBRs) for the CEN transit router.

0

OpenedVpcCount

integer

The total number of protected VPCs.

17

OpenedVpcFirewallCount

integer

The total number of enabled border firewalls.

9

OpenedVpnCount

integer

The total number of protected VPNs for the CEN transit router.

6

RequestId

string

The ID of the request.

8AABEF64-7ABF-52CB-BA6C-0598E3DB****

TotalEcrCount

integer

The total number of ECRs.

2

TotalPeerTrCount

integer

The total number of inter-region connections for the CEN transit router.

6

TotalVbrCount

integer

The total number of VBRs for the CEN transit router.

5

TotalVpcCount

integer

The total number of interconnected VPCs.

2

TotalVpcFirewallQuota

integer

The total quota for VPC firewalls.

5

TotalVpnCount

integer

The total number of VPNs for the CEN transit router.

1

Examples

Success response

JSON format

{
  "AvailableVpcFirewallQuota": 4,
  "CenExpressConnectVpcCount": 7,
  "CenFirewallVpcCount": 10,
  "CenTrVpcCount": 13,
  "ClosedCenFirewallCount": 1,
  "ClosedExpressConnectFirewallCount": 10,
  "ClosedVpcFirewallCount": 5,
  "ConfiguredCenFirewallCount": 5,
  "ConfiguredCenFirewallRegionCount": 2,
  "ConfiguredCenFirewallVpcCount": 18,
  "ConfiguredCenTrFirewallCount": 2,
  "ConfiguredExpressConnectFirewallCount": 2,
  "ConfiguredExpressConnectVpcCount": 2,
  "ConfiguredVpcFirewallCount": 5,
  "ConfiguredVpcFirewallVpcCount": 1,
  "ExpressConnectVpcCount": 2,
  "NotConfiguredCenFirewallCount": 0,
  "NotConfiguredCenTrFirewallCount": 6,
  "NotConfiguredExpressConnectFirewallCount": 7,
  "NotConfiguredVpcFirewallCount": 12,
  "OpenedCenExpressConnectVpcCount": 10,
  "OpenedCenFirewallCount": 4,
  "OpenedCenFirewallVpcCount": 0,
  "OpenedCenTrFirewallVpcCount": 4,
  "OpenedEcrCount": 0,
  "OpenedExpressConnectFirewallCount": 15,
  "OpenedExpressConnectVpcCount": 2,
  "OpenedPeerTrCount": 3,
  "OpenedVbrCount": 0,
  "OpenedVpcCount": 17,
  "OpenedVpcFirewallCount": 9,
  "OpenedVpnCount": 6,
  "RequestId": "8AABEF64-7ABF-52CB-BA6C-0598E3DB****",
  "TotalEcrCount": 2,
  "TotalPeerTrCount": 6,
  "TotalVbrCount": 5,
  "TotalVpcCount": 2,
  "TotalVpcFirewallQuota": 5,
  "TotalVpnCount": 1
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorAliUid Aliuid invalid. The aliuid is invalid.
400 ErrorDBSelectError A database select error occurred. The error message returned because an internal error has occurred in querying the database.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.