查询VPC内网IP
所有文档

          私有网络 VPC

          查询VPC内网IP


          描述

          用于查询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"
                }
            ]
           }
          上一篇
          更新VPC
          下一篇
          子网相关接口