调用DescribeVpcs接口查询已创建的VPC。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeVpcs |
要执行的操作。取值:DescribeVpcs。 |
RegionId | String | 是 | cn-hangzhou |
VPC所在的地域。 您可以通过调用DescribeRegions接口获取地域ID。 |
VpcId | String | 否 | vpc-bp1b1xjllp3ve5yze**** |
VPC的ID。 最多支持指定20个VPC ID,多个VPC ID之间用半角逗号隔开。 |
VpcName | String | 否 | Vpc-1 |
VPC的名称。 |
IsDefault | Boolean | 否 | false |
是否查询指定地域下的默认VPC,取值:
|
DryRun | Boolean | 否 | false |
是否只预检此次请求,取值:
|
ResourceGroupId | String | 否 | rg-acfmxvfvazb4p**** |
要查询的VPC所属的资源组ID。 |
PageNumber | Integer | 否 | 1 |
列表的页码,默认值为1。 |
PageSize | Integer | 否 | 10 |
分页查询时每页的行数,最大值为50,默认值为10。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
RequestId | String | C6532AA8-D0F7-497F-A8EE-094126D441F5 |
请求ID。 |
TotalCount | Integer | 2 |
列表条目数。 |
PageNumber | Integer | 1 |
当前页码。 |
PageSize | Integer | 10 |
每页包含的条目数。 |
Vpcs | Array |
VPC的详细信息。 |
|
VpcId | String | vpc-bp1qpo0kug3a20qqe**** |
VPC的ID。 |
RegionId | String | cn-hangzhou |
VPC所在的地域。 |
Status | String | Available |
VPC的状态,取值:
|
VpcName | String | vpc1 |
VPC的名称。 |
CreationTime | String | 2018-04-18T15:02:37Z |
VPC的创建时间。 |
CidrBlock | String | 10.0.0.0/24 |
VPC的IPv4网段。 |
Ipv6CidrBlock | String | 2408:4004:0:a600::/56 |
VPC的IPv6网段。 |
VRouterId | String | vrt-bp1jcg5cmxjbl9xgc**** |
VPC路由器的ID。 |
Description | String | This is my VPC. |
VPC的描述信息。 |
IsDefault | Boolean | false |
是否是该地域的默认VPC。
|
ResourceGroupId | String | rg-acfmxazb4ph**** |
VPC所属的资源组ID。 |
CenStatus | String | Detached |
VPC绑定云企业网的状态。
|
Tags | Array |
VPC的标签信息。 |
|
Key | String | env |
VPC绑定的标签键。 |
Value | String | internal |
VPC绑定的标签值。 |
VSwitchIds | List | vsw-bp1nhbnpv2blyz8dl**** |
VPC中交换机的列表。 |
UserCidrs | List | 10.0.0.0/8 |
用户侧网段的列表。 |
NatGatewayIds | List | nat-245xxxftwt45bg**** |
NAT网关的ID。 |
RouterTableIds | List | vtb-bp1krxxzp0c29fmon**** |
路由表ID。 |
SecondaryCidrBlocks | List | 192.168.20.0/24 |
VPC的附加IPv4网段。 |
示例
请求示例
https://vpc.aliyuncs.com/?Action=DescribeVpcs
&RegionId=cn-hangzhou
&<公共请求参数>
正常返回示例
XML
格式
<DescribeVpcsResponse>
<PageNumber>1</PageNumber>
<Vpcs>
<Vpc>
<VpcName>abc</VpcName>
<Description>abc</Description>
<IsDefault>false</IsDefault>
<ResourceGroupId>rg-acfmxazb4ph****</ResourceGroupId>
<UserCidrs></UserCidrs>
<NatGatewayIds></NatGatewayIds>
<RouterTableIds>
<RouterTableIds>vtb-bp1krxxzp0c29fmon****</RouterTableIds>
</RouterTableIds>
<VpcId>vpc-bp1qpo0kug3a20qqe****</VpcId>
<VRouterId>vrt-bp1jcg5cmxjbl9xgc****</VRouterId>
<CreationTime>2018-12-06T06:11:55Z</CreationTime>
<Status>Available</Status>
<CidrBlock>172.16.0.0/12</CidrBlock>
<VSwitchIds></VSwitchIds>
<RegionId>cn-hangzhou</RegionId>
<Ipv6CidrBlock></Ipv6CidrBlock>
</Vpc>
<Vpc>
<VpcName>kttest</VpcName>
<Description></Description>
<IsDefault>false</IsDefault>
<ResourceGroupId>rg-acfmxazb4ph****</ResourceGroupId>
<UserCidrs></UserCidrs>
<NatGatewayIds></NatGatewayIds>
<RouterTableIds>
<RouterTableIds>vtb-bp1blq1oh0ybfnpm1****</RouterTableIds>
</RouterTableIds>
<VpcId>vpc-bp1aevy8sofi8mh1q****</VpcId>
<VRouterId>vrt-bp149ve7yeyvio4nc****</VRouterId>
<CreationTime>2018-11-08T08:54:03Z</CreationTime>
<Status>Available</Status>
<CidrBlock>192.168.0.0/16</CidrBlock>
<VSwitchIds>
<VSwitchId>vsw-bp12mw1f8k3jgygk****</VSwitchId>
</VSwitchIds>
<RegionId>cn-hangzhou</RegionId>
<Ipv6CidrBlock></Ipv6CidrBlock>
</Vpc>
</Vpcs>
<TotalCount>2</TotalCount>
<PageSize>10</PageSize>
<RequestId>C6532AA8-D0F7-497F-A8EE-094126D441F5</RequestId>
</DescribeVpcsResponse>
JSON
格式
{
"PageNumber": 1,
"Vpcs": {
"Vpc": [
{
"VpcName": "abc",
"Description": "abc",
"IsDefault": false,
"ResourceGroupId": "rg-acfmxazb4ph****",
"UserCidrs": {
"UserCidr": []
},
"NatGatewayIds": {
"NatGatewayIds": []
},
"RouterTableIds": {
"RouterTableIds": [
"vtb-bp1krxxzp0c29fmon****"
]
},
"VpcId": "vpc-bp1qpo0kug3a20qqe****",
"VRouterId": "vrt-bp1jcg5cmxjbl9xgc****",
"CreationTime": "2018-12-06T06:11:55Z",
"Status": "Available",
"CidrBlock": "172.16.0.0/12",
"VSwitchIds": {
"VSwitchId": []
},
"RegionId": "cn-hangzhou",
"Ipv6CidrBlock": ""
},
{
"VpcName": "kttest",
"Description": "",
"IsDefault": false,
"ResourceGroupId": "rg-acfmxazb4ph****",
"UserCidrs": {
"UserCidr": []
},
"NatGatewayIds": {
"NatGatewayIds": []
},
"RouterTableIds": {
"RouterTableIds": [
"vtb-bp1blq1oh0ybfnpm1****"
]
},
"VpcId": "vpc-bp1aevy8sofi8mh1q****",
"VRouterId": "vrt-bp149ve7yeyvio4nc****",
"CreationTime": "2018-11-08T08:54:03Z",
"Status": "Available",
"CidrBlock": "192.168.0.0/16",
"VSwitchIds": {
"VSwitchId": [
"vsw-bp12mw1f8k3jgygk9****"
]
},
"RegionId": "cn-hangzhou",
"Ipv6CidrBlock": ""
}
]
},
"TotalCount": 2,
"PageSize": 10,
"RequestId": "C6532AA8-D0F7-497F-A8EE-094126D441F5"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
500 | InternalError | The request processing has failed due to some unknown error. | 请求处理由于某些未知错误失败。 |
访问错误中心查看更多错误码。
在文档使用中是否遇到以下问题
更多建议
匿名提交