Floating IPs
A Floating IP is a static public IPv4 address that you can reassign between instances instantly — without changing DNS or waiting for TTL.
When to Use Floating IPs
- Blue/green deployments — provision the new version, then flip the Floating IP to it. Zero downtime, instant rollback.
- High availability failover — if your primary fails, reassign the IP to a hot standby in seconds
- Stable DNS — point your domain's A record at a Floating IP; swap the underlying instance without touching DNS
Reserve a Floating IP
POST /v1/floating-ips
{
"region": "vh-us-south-1"
}
# Response
{
"id": "fip_abc123",
"ip": "203.0.113.42",
"region": "vh-us-south-1",
"instance_id": null
}
Assign to an Instance
POST /v1/floating-ips/fip_abc123/assign
{ "instance_id": "inst_def456" }
The IP is routed to the new instance within 5 seconds — no DNS change needed.
Unassign / Reassign
# Unassign without deleting
POST /v1/floating-ips/fip_abc123/unassign
# Reassign to a different instance
POST /v1/floating-ips/fip_abc123/assign
{ "instance_id": "inst_new789" }
Pricing
- Floating IPs are free while assigned to a running instance
- $2/month when reserved but unassigned (to discourage IP hoarding)