---
title: "Get elastic IP"
method: GET
path: "/v1/elastic-ips/{id}"
tags: ["elastic-ips"]
---

# Get elastic IP

`GET /v1/elastic-ips/{id}`

## Path parameters

- `id` string, uuid, required

## Response `200`

successful

- ElasticIPResp
  - `id` string, uuid, required
  - `orgId` string, uuid, required — if nil, it means the elastic IP is not associated with any instance
  - `status` 'released' | 'associated' | 'disassociated', required
  - `internetConnectionType` 'BGP' | 'Dual-Homed', required
  - `maxBandwidth` string, required
  - `name` string, required
  - `idc` string, required
  - `ipAddress` string, required — IP address of the elastic IP. The longest possible IPv6 address is 39 characters
  - `product` string, required
  - `instanceID` string, uuid, nullable — set instanceID and instanceType to associate the elastic IP to the instance, set to null to disassociate the elastic IP from the instance
  - `instanceType` 'baremetal' | 'container', nullable

## Other responses

- `401` — Authentication information is missing or invalid
- `404` — The specified resource was not found
- `500` — Internal Server Error
- `503` — a dependent service is unavailable

---

[API](https://skmtc.net/gmicloud/apis/cluster-engine-api.md) · [All operations](https://skmtc.net/gmicloud/apis/cluster-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/gmicloud/cluster-engine-api/versions/bcbab016469f/schema)