# Querying Private IP Address Details

#### Function

This API is used to query details about a private IP address using the specified ID.

#### URI

GET /v1/{project_id}/privateips/{privateip_id}

Table 1 describes the parameters.

Table 1 Parameter description
Name | Mandatory | Description
--- | --- | ---
project_id | Yes | Specifies the project ID.
privateip_id | Yes | Specifies the ID of the private IP address, which uniquely identifies the private IP address.

#### Request Message

- Request parameter

  None

- Example request

      GET https://{Endpoint}/v1/{project_id}/privateips/d600542a-b231-45ed-af05-e9930cb14f78

#### Response

- Response parameter

  Table 2 Response parameter
  Name | Type | Description
  --- | --- | ---
  privateip | privateip object | Specifies the private IP address objects. For details, see Table 3.

  Table 3 Description of the privateip field
  Name | Type | Description
  --- | --- | ---

  status

  String

  - Specifies the status of the private IP address.
  - Possible values are as follows:
    - ACTIVE
    - DOWN

  id | String | Specifies the ID of the private IP address, which uniquely identifies the private IP address.
  subnet_id | String | Specifies the ID of the subnet from which IP addresses are assigned. If you use the management console, the value of this parameter is the Network ID value.
  tenant_id | String | Specifies the project ID.

  device_owner

  String

  - Specifies the resource using the private IP address. The parameter is left blank if it is not used.
  - The value can be network:dhcp, network:router_interface_distributed, compute:xxx, or neutron:VIP_PORT. (In value compute:xxx, xxx specifies the AZ name, for example, compute:aa-bb-cc indicates that the private IP address is used by an ECS in the aa-bb-cc AZ).
  - The value range specifies only the type of private IP addresses supported by the current service.

  ip_address | String | Specifies the assigned private IP address.

- Example response

      {
          "privateip":
              {
                  "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 Code

See Status Codes.

#### Error Code

See Error Codes.

Parent topic: Private IP Address