Skip to content
  • Auto
  • Light
  • Dark

Floating IPs

Floating IPs

Floating IPs

Create a New Floating IP
post/v2/floating_ips
Delete a Floating IP
delete/v2/floating_ips/{floating_ip}
List All Floating IPs
get/v2/floating_ips
Retrieve an Existing Floating IP
get/v2/floating_ips/{floating_ip}
Floating IP
FloatingIPobject
ShowShow
dropletunion
optional
unknown OR idnumberbackup_idsarray of numbercreated_atstringdisknumberfeaturesarray of stringimageImagelockedbooleanmemorynumbernamestringnetworksobjectnext_backup_windowDropletNextBackupWindowregionRegionsizeSizesize_slugstringsnapshot_idsarray of numberstatusenumtagsarray of stringvcpusnumbervolume_idsarray of stringdisk_infoarray of DiskInfogpu_infoGPUInfokernelKernelvpc_uuidstringDroplet

The Droplet that the floating IP has been assigned to. When you query a floating IP, if it is assigned to a Droplet, the entire Droplet object will be returned. If it is not assigned, the value will be null.

Requires droplet:read scope.

Hide ParametersShow Parameters
Nullunknown

If the floating IP is not assigned to a Droplet, the value will be null.

idnumberbackup_idsarray of numbercreated_atstringdisknumberfeaturesarray of stringimageImagelockedbooleanmemorynumbernamestringnetworksobjectnext_backup_windowDropletNextBackupWindowregionRegionsizeSizesize_slugstringsnapshot_idsarray of numberstatusenumtagsarray of stringvcpusnumbervolume_idsarray of stringdisk_infoarray of DiskInfogpu_infoGPUInfokernelKernelvpc_uuidstringDroplet
ipstring
optional

The public IP address of the floating IP. It also serves as its identifier.

formatipv4
lockedboolean
optional

A boolean value indicating whether or not the floating IP has pending actions preventing new ones from being submitted.

project_idstring
optional

The UUID of the project to which the reserved IP currently belongs.

Requires project:read scope.

formatuuid
regionintersection
optional
availablebooleanfeaturesarray of stringnamestringsizesarray of stringslugstringRegion

The region that the floating IP is reserved to. When you query a floating IP, the entire region object will be returned.

Floating IPsActions

Initiate a Floating IP Action
post/v2/floating_ips/{floating_ip}/actions
List All Actions for a Floating IP
get/v2/floating_ips/{floating_ip}/actions
Retrieve an Existing Floating IP Action
get/v2/floating_ips/{floating_ip}/actions/{action_id}