All Products
Search
Document Center

AnalyticDB:DescribeVpcs

Last Updated:Aug 28, 2026

Queries available 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

RegionId

string

No

The region ID.

cn-hangzhou

ZoneId

string

No

The zone ID.

cn-hangzhou-k

VpcId

string

No

The VPC ID.

vpc-bp13h7uzhulpuxvnp****

Response elements

Element

Type

Description

Example

object

Vpcs

object

The queried VPCs.

Vpc

array<object>

The queried VPC.

array<object>

The queried VPC.

Status

string

The status of the VPC. Valid values:

  • Pending

  • Available

Available

VpcName

string

The name of the VPC.

vpc1

VpcId

string

The ID of the VPC.

vpc-uf6m0r5pihw1r79od6990

IsDefault

boolean

Whether the VPC is the default VPC in the region. Valid values:

  • true

  • false

false

CidrBlock

string

The IPv4 CIDR block of the VPC.

192.168.0.0/16

RegionNo

string

The region of the VPC.

cn-hangzhou

GmtCreate

string

The time when the VPC was created.

1693217052000

AliUid

string

The ID of the Alibaba Cloud account.

1431771514176727

VSwitchs

array<object>

The vSwitches in the VPC.

object

The vSwitch ID in the VPC.

Status

string

The status of the vSwitch. Valid values:

  • Pending

  • Available

Available

VSwitchId

string

The vSwitch ID.

vsw-8vbxk6ij0yz16bu4l3ijj

IsDefault

boolean

Whether the vSwitch is the default vSwitch. Valid values: true false

false

CidrBlock

string

The IPv4 CIDR block of the vSwitch.

172.17.0.0/24

GmtCreate

string

The time when the vSwitch was created.

1549012834000

GmtModified

string

The time when the vSwitch was modified.

1731031910000

IzNo

string

The zone ID of the vSwitch.

cn-hangzhou-j

VSwitchName

string

The name of the vSwitch.

vs1

GmtModified

string

The time when the VPC was modified.

1724639118000

Bid

string

The user channel ID.

26842

RequestId

string

The request ID.

78BDC895-F7C0-5961-92BE-F1C3D12B4BB5

Examples

Success response

JSON format

{
  "Vpcs": {
    "Vpc": [
      {
        "Status": "Available",
        "VpcName": "vpc1",
        "VpcId": "vpc-uf6m0r5pihw1r79od6990",
        "IsDefault": false,
        "CidrBlock": "192.168.0.0/16",
        "RegionNo": "cn-hangzhou",
        "GmtCreate": "1693217052000",
        "AliUid": "1431771514176727",
        "VSwitchs": [
          {
            "Status": "Available",
            "VSwitchId": "vsw-8vbxk6ij0yz16bu4l3ijj",
            "IsDefault": false,
            "CidrBlock": "172.17.0.0/24",
            "GmtCreate": "1549012834000",
            "GmtModified": "1731031910000",
            "IzNo": "cn-hangzhou-j",
            "VSwitchName": "vs1"
          }
        ],
        "GmtModified": "1724639118000",
        "Bid": "26842"
      }
    ]
  },
  "RequestId": "78BDC895-F7C0-5961-92BE-F1C3D12B4BB5"
}

Error codes

See Error Codes for a complete list.

Release notes

See Release Notes for a complete list.