You can call this operation to query virtual private clouds (VPCs).

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 headers

This operation only uses common request headers. For more information, see the Common request parameters topic.

Request syntax

GET /pop/v5/vpc_list HTTPS|HTTP

Request parameters

Response parameters

Parameter Type Example Description
Code Integer 200

The returned code.
Message String success

The returned message.
RequestId String b197-40ab-9155-7ca7
VpcList Array

The returned list of VPCs.
VpcId String vpc-wz9pcq3jofczwpujq****

The ID of the VPC returned.
VpcName String edas-default-vpc4

The name of the VPC returned.
RegionId String cn-shenzhen

The ID of the region where the returned VPC is located.
UserId String edas_****_test@aliyun-****.com

The ID of the user who created the returned VPC.
Expired Boolean false

Indicates whether the returned VPC has expried.
EcsNum Integer 0

The number of Elastic Compute Service (ECS) instances associated with the returned VPC.

Examples

Sample requests

GET /pop/v5/vpc_list HTTP/1.1
Common request headers

Sample success responses

JSON format 

{
    "Message": "success",
    "VpcList": {
        "VpcEntity": [
            {
                "VpcName": "public_auto_test_vpc_",
                "Expired": false,
                "RegionId": "cn-shenzhen",
                "UserId": "edas_****_test@aliyun-****.com",
                "EcsNum": 2,
                "VpcId": "vpc-wz90fbqjyyvxznxpy****"
            },
            {
                "VpcName": "edas-default-vpc2",
                "Expired": false,
                "RegionId": "cn-shenzhen",
                "UserId": "edas_****_test@aliyun-****.com",
                "EcsNum": 8,
                "VpcId": "vpc-wz90iikh8t4kdlwlj****"
            }
        ]
    },
    "Code": 200
}

XML format 

<Message>success</Message>
<VpcList>
    <VpcEntity>
        <VpcName>public_auto_test_vpc_</VpcName>
        <Expired>false</Expired>
        <RegionId>cn-shenzhen</RegionId>
        <UserId>edas_common_test@aliyun-inner.com</UserId>
        <EcsNum>2</EcsNum>
        <VpcId>vpc-wz90fbqjyyvxznxpyx7qb</VpcId>
    </VpcEntity>
    <VpcEntity>
        <VpcName>edas-default-vpc2</VpcName>
        <Expired>false</Expired>
        <RegionId>cn-shenzhen</RegionId>
        <UserId>edas_common_test@aliyun-inner.com</UserId>
        <EcsNum>8</EcsNum>
        <VpcId>vpc-wz90iikh8t4kdlwlj6jt2</VpcId>
    </VpcEntity>
</VpcList>
<Code>200</Code>

Error codes

For a list of error codes, visit the API Error Center.