查询私有IP列表

功能介绍

查询指定子网下的私有IP列表。

URI

GET /v1/{project_id}/subnets/{subnet_id}/privateips

GET https://{Endpoint}/v1/{project_id}/subnets/{subnet_id}/privateips?limit=10&marker=4779ab1c-7c1a-44b1-a02e-93dfc361b32d

请求消息

• 请求参数

  无

• 请求样例

  GET https://{Endpoint}/v1/{project_id}/subnets/{subnet_id}/privateips

响应消息

• 请求参数

  表2 请求参数

  名称	参数类型	说明
  privateips	Array of privateip objects	私有IP列表对象，请参见表3。 说明：不支持显示预留的系统接口，如有需要请登录管理控制台查看。

  表3 privateip字段说明

  名称	参数类型	说明
  status	String	功能说明：私有IP的状态 取值范围： ACTIVE：活动的 DOWN：不可用
  id	String	私有IP标识
  subnet_id	String	分配IP的子网标识
  tenant_id	String	项目ID
  device_owner	String	功能说明：私有IP的使用者，空表示未使用 取值范围：network:dhcp，network:router_interface_distributed，compute:xxx(xxx对应具体的可用区名称，例如compute:aa-bb-cc表示是被可用区aa-bb-cc上的ECS使用)，neutron:VIP_PORT 约束：此处的取值范围只是本服务支持的类型，其他类型未做标注
  ip_address	String	申请到的私有IP

• 响应样例

  {
      "privateips": [
          {
              "status": "DOWN",
              "id": "d600542a-b231-45ed-af05-e9930cb14f78",
              "subnet_id": "531dec0f-3116-411b-a21b-e612e42349fd",
              "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
              "device_owner": "",
              "ip_address": "192.168.1.11"
          },
          {
              "status": "DOWN",
              "id": "d600542a-b231-45ed-af05-e9930cb14f79",
              "subnet_id": "531dec0f-3116-411b-a21b-e612e42349fd",
              "tenant_id": "8b7e35ad379141fc9df3e178bd64f55c",
              "device_owner": "",
              "ip_address": "192.168.1.12"
          }
      ]
  }

状态码

请参见状态码。

错误码

请参考错误码。