RArafftechnologies
Networking

Reserve a floating IP

Changed on

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

Request

  • Base URL
    https://api.rafftechnologies.com
  • URL
    https://api.rafftechnologies.com/api/v1/ips/reserve
  • Auth
    API key in header X-API-Key

Headers

X-Project-IDstring uuid required

Project ID. Required for all mutating operations (create, delete, power actions, resize).

Request body

type'IPv4' | 'IPv6'

IP family to reserve. Defaults to IPv4.

region'us-east'

Region. Defaults to the project's default region.

billing_period'monthly' | 'yearly' | 'twenty_four_month'

Subscription billing period. Ignored for PAYG accounts.

Response

IP reserved

successboolean

Example response

{
  "data": {
    "ip_address": "203.0.113.42"
  }
}

Changes