IP Addresses (Dedicated IPv4)
A dedicated IPv4 address is a public address of your own, taken from the region's pool. It stays in your organization until you release it, and you can move it from one server to another.
Floating IPs are not available in veloxa-us-east-1 yet. What this page describes is the dedicated IPv4 add-on, managed on the IP Addresses page in the console and through API v2. Every server is also reachable without one, through a block of ports on the region's shared IPv4 address — see Shared & Dedicated IPv4.
When to Use a Dedicated IPv4 Address
- Standard ports — serve on ports 80 and 443, or any other port, over IPv4
- Stable DNS — point your domain's A record at the address; move it to a replacement server without touching DNS
Request an Address
In the console, use the IP Addresses page. With the API, request an address and, optionally, the server to route it to:
POST /api/v2/ips
{ "server": "web-1" } // optional
# Response
{
"data": {
"id": "<ip-uuid>",
"address": "203.0.113.42",
"server": "web-1",
...
}
}
If the pool has no free address, or you already hold as many as your plan allows, the request is refused. List your addresses with GET /api/v2/ips.
Attach to a Server
PUT /api/v2/ips/<ip-uuid>/server
{ "server": "web-1" }
The address is routed to the server, which then has to answer on it: add it to the server's network interface (see Dedicated IPv4).
Detach / Move
# Detach without releasing
PUT /api/v2/ips/<ip-uuid>/server
{ "server": null }
# Move to a different server
PUT /api/v2/ips/<ip-uuid>/server
{ "server": "web-2" }
Release an address you no longer need from the IP Addresses page. Both API calls need an API key with instances:write.
Pricing
An IPv4 address from the pool is a dedicated IPv4 add-on: $2 a month per address by default, billed hourly from the hour it is assigned to your account until you release it, attached to a server or not. The console shows the current price on the IP addresses page. How many addresses an account may hold at once depends on its plan. See Billing.