floating_ip_create

Create floating IP
post/v1/floating-ips

Query Parameters

project

Name or ID of the project

Request Body

Parameters for creating a new floating IP address for instances.

Object
description
ip

An IP address to reserve for use as a floating IP. This field is optional: when not set, an address will be automatically chosen from pool. If set, then the IP must be available in the resolved pool.

name

Names must begin with a lower case ASCII letter, be composed exclusively of lowercase ASCII, uppercase ASCII, numbers, and '-', and may not end with a '-'. Names cannot be a UUID, but they may contain a UUID. They can be at most 63 characters long.

The parent IP pool that a floating IP is pulled from. If unset, the default pool is selected.

Responses

201

successful creation

Object
description

human-readable free-form text about a resource

id

unique, immutable, system-controlled identifier for each resource

The ID of the instance that this Floating IP is attached to, if it is presently in use.

ip

The IP address held by this resource.

ip_pool_id

The ID of the IP pool this resource belongs to.

name

unique, mutable, user-controlled identifier for each resource

Names must begin with a lower case ASCII letter, be composed exclusively of lowercase ASCII, uppercase ASCII, numbers, and '-', and may not end with a '-'. Names cannot be a UUID, but they may contain a UUID. They can be at most 63 characters long.

project_id

The project this resource exists within.

time_created

timestamp when this resource was created

time_modified

timestamp when this resource was last modified

4XX

Error

Object
message
request_id
5XX

Error

Object
message
request_id