调用DescribeVpcs，获取用户VPC列表。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 DescribeVpcs

系统规定参数。取值：DescribeVpcs。

RegionId String 是 cn-hangzhou

待查询的VPC所属的地域ID。
ZoneId String 否 cn-hangzhou-d

查询的VPC所属的可用区ID。
PageNumber Integer 否 1

VPC列表的页码。默认值：1，取值范围：1~100。
PageSize Integer 否 50

分页查询时设置的每页行数。默认值：50，取值范围：1~50。

返回数据

名称 类型 示例值 描述
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0FE2C83B

请求ID。
Vpcs Object

VPC数组结果。
Vpc Array of Vpc

单个VPC的详细信息。
VpcId String vpc-bp1qpo0kug3a20qqe****

VPC的ID。
VpcName String vpc1

VPC名称。
Status String Available

VPC的状态，取值：

  • Pending：配置中。
  • Available：可用。
IsDefault Boolean true

是否是该地域的默认VPC，取值：

  • true：是该地域的默认VPC。
  • false：不是该地域的默认VPC。
CidrBlock String 192.168.0.0/16

VPC的IPv4网段。
RegionNo String cn-hangzhou

VPC所在的地域ID。
GmtCreate String 2021-04-18T15:02:37Z

VPC的创建时间。
GmtModified String 2021-04-18T15:02:37Z

VPC的修改时间。
VSwitchs Array of String vsw-bp1nhbnpv2blyz8dl****

交换机的ID。

示例

请求示例

http(s)://[Endpoint]/?Action=DescribeVpcs
&RegionId=cn-hangzhou
&ZoneId=cn-hangzhou-d
&PageNumber=1
&PageSize=50
&公共请求参数

正常返回示例

XML格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeVpcsResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0FE2C83B</RequestId>
    <Vpcs>
        <Vpc>
            <VpcId>vpc-bp1qpo0kug3a20qqe****</VpcId>
            <VpcName>vpc1</VpcName>
            <Status>Available</Status>
            <IsDefault>true</IsDefault>
            <CidrBlock>192.168.0.0/16</CidrBlock>
            <RegionNo>cn-hangzhou</RegionNo>
            <GmtCreate>2021-04-18T15:02:37Z</GmtCreate>
            <GmtModified>2021-04-18T15:02:37Z</GmtModified>
            <VSwitchs>vsw-bp1nhbnpv2blyz8dl****</VSwitchs>
        </Vpc>
    </Vpcs>
</DescribeVpcsResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0FE2C83B",
  "Vpcs" : {
    "Vpc" : [ {
      "VpcId" : "vpc-bp1qpo0kug3a20qqe****",
      "VpcName" : "vpc1",
      "Status" : "Available",
      "IsDefault" : true,
      "CidrBlock" : "192.168.0.0/16",
      "RegionNo" : "cn-hangzhou",
      "GmtCreate" : "2021-04-18T15:02:37Z",
      "GmtModified" : "2021-04-18T15:02:37Z",
      "VSwitchs" : [ "vsw-bp1nhbnpv2blyz8dl****" ]
    } ]
  }
}

错误码

访问错误中心查看更多错误码。