All Products
Search
Document Center

AnalyticDB:DescribeVpcs

Last Updated:Jan 08, 2026

Queries a list of available virtual private clouds (VPCs).

Debugging

You can run this interface directly in OpenAPI Explorer, saving you the trouble of calculating signatures. After running successfully, OpenAPI Explorer can automatically generate SDK code samples.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
RegionIdstringNo

The region ID.

cn-hangzhou
ZoneIdstringNo

The zone ID.

cn-hangzhou-k
VpcIdstringNo

The VPC ID.

vpc-bp13h7uzhulpuxvnp****

Response parameters

ParameterTypeDescriptionExample
object
Vpcsobject

The queried VPCs.

Vpcarray<object>

The queried VPC.

Vpcobject

The queried VPC.

Statusstring

The status of the VPC. Valid values:

  • Pending
  • Available
Available
VpcNamestring

The name of the VPC.

vpc1
VpcIdstring

The ID of the VPC.

vpc-uf6m0r5pihw1r79od6990
IsDefaultboolean

Indicates whether the VPC is the default VPC in the region. Valid values:

  • true
  • false
false
CidrBlockstring

The IPv4 CIDR block of the VPC.

192.168.0.0/16
RegionNostring

The region in which the VPC resides.

cn-hangzhou
GmtCreatestring

The time when the VPC was created.

1693217052000
AliUidstring

The ID of the Alibaba Cloud account.

1431771514176727
VSwitchsarray<object>

The vSwitches in the VPC.

VSwitchobject

The vSwitch ID in the VPC.

Statusstring

The status of the vSwitch. Valid values:

  • Pending
  • Available
Available
VSwitchIdstring

The vSwitch ID.

vsw-8vbxk6ij0yz16bu4l3ijj
IsDefaultboolean

Indicates whether the vSwitch is the default vSwitch. Valid values: true false

false
CidrBlockstring

The IPv4 CIDR block of the vSwitch.

172.17.0.0/24
GmtCreatestring

The time when the vSwitch was created.

1549012834000
GmtModifiedstring

The time when the vSwitch was modified.

1731031910000
IzNostring

The zone ID of the vSwitch.

cn-hangzhou-j
VSwitchNamestring

The name of the vSwitch.

vs1
GmtModifiedstring

The time when the VPC was modified.

1724639118000
Bidstring

The user channel ID.

26842
RequestIdstring

The request ID.

78BDC895-F7C0-5961-92BE-F1C3D12B4BB5

Examples

Sample success responses

JSONformat

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

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
No change history