Networking
Reserve a floating IP
Reserve a floating public IP. The IP is allocated immediately and held for your account until you release it.
Billing
Reserved IPs are billed. For subscription accounts the IP price is charged from the account balance up front for the chosen billing_period (default monthly):
- Insufficient balance for the subscription returns 402. Top up the balance and retry.
For pay-as-you-go (PAYG) accounts no upfront charge happens — usage accrues hourly.
post/api/v1/ips/reserve
Headers
X-Project-IDstring uuid required
Project ID. Required for all mutating operations (create, delete, power actions, resize).
Request body
Response
IP reserved
Example response
{
"data": {
"ip_address": "203.0.113.42"
}
}