查询VPC内网IP
更新时间：2021-01-19
描述
用于查询VPC内网IP信息。
- 只能查询已使用的IP信息，当查询未使用的IP时，本接口不会报错，但不会出现在返回结果里
- 单次查询的Ip个数最大为100
- privateIpAddresses 和 privateIpRange二者不能同时为空
- 当 privateIpAddresses 和 privateIpRange同时存在时候，以privateIpRange为准。
请求结构
GET /v{version}/vpc/{vpcId}/privateIpAddressInfo?privateIpAddresses=192.168.0.5&privateIpAddresses=192.168.0.6 HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| vpcId | String | 是 | URL参数 | VPC的id |
| privateIpAddresses | List<String> | 否 | Query参数 | 要查询的ip列表 |
| privateIpRange | String | 否 | Query参数 | 要查询的ip范围,格式如"192.168.0.1-192.168.0.5" |
返回头域
除公共头域，无其它特殊头域。
返回参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| vpcPrivateIpAddresses | List<VpcPrivateIpAddress> | VPC内PrivateIpAddress的列表 |
请求示例
GET /v1/vpc/vpc-IyWRtII7/privateIpAddressInfo?privateIpAddresses=10.4.2.2&privateIpAddresses=10.4.2.3 HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
返回示例
HTTP/1.1 200 OK
x-bce-request-id: cae72192-b5e6-4e3b-81fd-b91fab13d876
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content Type: application/json;charset=UTF 8
Server: BWS
{
"vpcPrivateIpAddresses":[
{
"privateIpAddress":"10.4.2.2",
"cidr":"10.4.2.0/24",
"privateIpAddressType":"BLB",
"createdTime":"2018-12-27T15:40:10Z"
}
]
}请求示例
GET /v1/vpc/vpc-IyWRtII7/privateIpAddressInfo?privateIpRange=172.17.1.0-172.17.1.5 HTTP/1.1
Host: bcc.bj.baidubce.com
Authorization: authorization string
返回示例
HTTP/1.1 200 OK
x-bce-request-id: cae72192-b5e6-4e3b-81fd-b91fab13d875
Date: Thu, 16 Mar 2017 06:29:48 GMT
Content Type: application/json;charset=UTF 8
Server: BWS
{
"vpcPrivateIpAddresses": [
{
"cidr": "172.17.1.0/24",
"privateIpAddress": "172.17.1.1",
"privateIpAddressType": "sys_occupancy",
"createdTime": "2020-11-19T12:46:01Z"
},
{
"cidr": "172.17.1.0/24",
"privateIpAddress": "172.17.1.2",
"privateIpAddressType": "dhcp",
"createdTime": "2020-06-23T07:50:14Z"
},
{
"cidr": "172.17.1.0/24",
"privateIpAddress": "172.17.1.3",
"privateIpAddressType": "dhcp",
"createdTime": "2020-06-23T07:50:16Z"
}
]
}