查询VPC列表
更新时间：2025-04-25
描述
查询VPC列表信息。
请求结构
Plain Text
1GET /v{version}/vpc?marker=vpc-IyWRtII7&maxKeys=1 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号，当前取值为1 |
| marker | String | 否 | Query参数 | 批量获取列表的查询的起始位置，是一个由系统生成的字符串 |
| maxKeys | Integer | 否 | Query参数 | 每页包含的最大数量，最大数量通常不超过1000，缺省值为1000 |
| isDefault | Boolean | 否 | Query参数 | 是否为默认VPC，可选值：true、false；当不填写此参数时返回所有VPC |
| vpcIds | String | 否 | Query参数 | 指定查询的vpc，多个vpcId用,分割 |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| marker | String | 标记查询的起始位置 |
| isTruncated | Boolean | true表示后面还有数据，false表示已经是最后一页 |
| nextMarker | String | 获取下一页所需要传递的marker值；当isTruncated为false时，该域不出现 |
| maxKeys | Integer | 每页包含的最大数量 |
| vpcs | List<Vpc> | VPC列表 |
请求示例
Plain Text
1GET /v{version}/vpc?marker=vpc-IyWRtII7&maxKeys=1&vpcIds=vpc-IyWRtII7,vpc-xktsjku9 HTTP/1.1
2Host: bcc.bj.baidubce.com
3Content-Type: application/json
4Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2017-03-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de 返回示例
Plain Text
1 HTTP/1.1 200 OK
2 x-bce-request-id: 1214cca7-4ad5-451d-9215-71cb844c0a50
3 Date: Thu, 16 Mar 2017 06:29:48 GMT
4 Content-Type: application/json;charset=UTF-8
5 Server: BWS
6 {
7 "nextMarker": "vpc-xktdeMSf",
8 "marker": "vpc-IyWRtII7",
9 "maxKeys": 1,
10 "isTruncated": true,
11 "vpcs": [{
12 "vpcId": "vpc-IyWRtII7",
13 "name": "VPC Name",
14 "isDefault": true,
15 "cidr": "0.0.0.0/0",
16 "description": "default",
17 "ipv6Cidr": "2400:da00:e003:4c00::/56",
18 "tags": [{
19 "tagKey": "tagKey",
20 "tagValue": "tagValue"
21 }]
22 },
23 {
24 "vpcId": "vpc-xktsjku9",
25 "name": "VPC Name",
26 "isDefault": true,
27 "cidr": "0.0.0.0/0",
28 "description": "default",
29 "ipv6Cidr": "2400:da00:e003:4c00::/56",
30 "tags": [{
31 "tagKey": "tagKey",
32 "tagValue": "tagValue"
33 }]
34 }]
35}