全部产品
专有网络 VPC

查询专有网络列表

更新时间:2017-06-07 13:26:11   分享:   

描述

查询指定地域的专有网络列表。此接口支持分页查询,每页的数量默认为 10 条。

该接口只会校验参数的合法性,不会校验参数之间的依赖关系,返回结果是所有条件的“交集”。

请求参数

名称 类型 是否必须 描述
Action String 系统规定参数,取值:DescribeVpcs
VpcId String 需要查询的 Vpc 的 Id
RegionId String 查询指定地域的 VPC
IsDefault Boolean 是否为指定Region下的默认VPC,可选值:
true ——是
false——否
当不填写此参数时返回所有指定Region下的VPC
PageNumber Integer 实例状态列表的页码,起始值为 1,默认值为 1
PageSize Integer 分页查询时设置的每页行数,最大值 50 行,默认为 10

返回参数

名称 类型 描述
Vpcs VpcType Vpc 详情 VpcSetType 组成的集合
TotalCount String 列表条条目数
PageNumber Integer 当前页码
PageSize Integer 当前分页包含多少条目

错误码

错误代码 描述 Http 状态码 语义
Forbidden.RegionNotFound Specified region is not found during access authentication. 404 指定 Region 不存在

示例

请求示例

  1. https://vpc.aliyuncs.com/?Action=DescribeVpcs
  2. &RegionId=cn-beijing
  3. &<公共请求参数>

返回示例

XML格式

  1. <DescribeVpcsResponse>
  2. <RequestId> DA1DAE87-43FA-472F-98BB-4FDBAA4A688D</RequestId>
  3. <Vpcs>
  4. <Vpc>
  5. <VpcId> vpc-257gq642n </VpcId>
  6. <RegionId>cn-beijing</RegionId>
  7. <VpcName></VpcName>
  8. <Description></Description>
  9. <VRouterId>vrt-25bezkd03</VRouterId>
  10. <Status>Available</Status>
  11. <UserCidrs></UserCidrs>
  12. <CidrBlock>172.16.0.0/16</CidrBlock>
  13. <VSwitchIds>
  14. </VSwitchIds>
  15. <CreationTime> 2014-10-29T13:30:19Z</CreationTime>
  16. </Vpc>
  17. </Vpcs>
  18. </DescribeVpcResponse>

JSON格式

  1. {
  2. "PageNumber": 1,
  3. "PageSize": 10,
  4. "RequestId": "DA1DAE87-43FA-472F-98BB-4FDBAA4A688D",
  5. "TotalCount": 1,
  6. "Vpcs": {
  7. "Vpc":
  8. {
  9. "CidrBlock": "172.16.0.0/16",
  10. "CreationTime": "2014-10-29T13:30:19Z",
  11. "Description": "",
  12. "RegionId": "cn-beijing",
  13. "Status": "Available",
  14. "UserCidrs": {
  15. "UserCidr": []
  16. },
  17. "VRouterId": "vrt-25bezkd03",
  18. "VSwitchIds": {
  19. "VSwitchId": []
  20. },
  21. "VpcId": "vpc-257gq642n",
  22. "VpcName": ""
  23. }
  24. }
  25. }
本文导读目录
本文导读目录
以上内容是否对您有帮助?