All Products
Search
Document Center

Cloud Firewall:DescribeVpcListLite

Last Updated:Jan 12, 2026

Queries a list of Virtual Private Clouds (VPCs).

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

SourceIp

string

No

The source IP address of the requester.

58.34.174.194

Lang

string

No

The language of the request and response. Valid values:

  • zh (default): Chinese.

  • en: English.

zh

VpcName

string

No

The instance name of the VPC.

vpc-shanghai

VpcId

string

No

The instance ID of the VPC.

vpc-8vbwbo90rq0anm6t****

RegionNo

string

No

The ID of the region where the VPC resides.

Note

For more information about the regions that Cloud Firewall supports, see Supported regions.

cn-shanghai

Response elements

Element

Type

Description

Example

object

RequestId

string

The ID of the request.

55E56A55-D93A-5614-AE00-BE2F8077F891

VpcList

array<object>

The list of VPCs.

object

The list of VPCs.

VpcId

string

The instance ID of the VPC.

vpc-wz9dqhljd10fk0b4eh885

VpcName

string

The instance name of the VPC.

Cloud_Firewall_VPC

RegionNo

string

The ID of the region to which the VPC belongs.

cn-hangzhou

Examples

Success response

JSON format

{
  "RequestId": "55E56A55-D93A-5614-AE00-BE2F8077F891",
  "VpcList": [
    {
      "VpcId": "vpc-wz9dqhljd10fk0b4eh885",
      "VpcName": "Cloud_Firewall_VPC",
      "RegionNo": "cn-hangzhou"
    }
  ]
}

Error codes

HTTP status code

Error code

Error message

Description

400 ErrorParamsNotEnough Parameters are insufficient. Parameters are insufficient.
400 ErrorDbFailed Query db failed. DB access error.
400 ErrorJsonDecode decoding json failed Failed to parse JSON data.
400 ErrorNoInstanceInDb no instance for process in db. The specified instance does not exist.

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.