IP addresses
IP addresses endpoints for your Cloud API integration.
List IP addresses
Includes attached and saved addresses. attachment=unattached selects saved addresses with vm_id=null. Only separately paid IPv4 have their own renewal price and auto-renewal; included primary IPv4 and IPv6 may have null billing fields. Prices are fixed, without markup.
Quote IPv4 without a VPS
One IPv4 in the selected location, without a VPS or cluster selection. Terms: 1/3/6/12/24/36 calendar months (default 1). Price is the fixed monthly rate from GET /plans times months, without markup or discount. The address belongs to api_user_id. auto_renew defaults to false; when enabled, renewals use the last paid term and current price.
Rent IPv4 without a VPS
One IPv4 in the selected location, without a VPS or cluster selection. Terms: 1/3/6/12/24/36 calendar months (default 1). Price is the fixed monthly rate from GET /plans times months, without markup or discount. The address belongs to api_user_id. auto_renew defaults to false; when enabled, renewals use the last paid term and current price.
Calculate IPv4 purchase
Buys one extra IPv4 for months=1/3/6/12/24/36 calendar months (default 1) and attaches it to this VPS. Price is the fixed monthly rate times months, without integration markup or term discount. Its payment term and auto-renewal are independent of the VPS. A VPS can have at most 10 IPv4 including the primary address.
Buy IPv4
Buys one extra IPv4 for months=1/3/6/12/24/36 calendar months (default 1) and attaches it to this VPS. Price is the fixed monthly rate times months, without integration markup or term discount. Its payment term and auto-renewal are independent of the VPS. A VPS can have at most 10 IPv4 including the primary address.
Attach saved IPv4
Attaches an available, paid saved IPv4 to a compatible VPS without a new purchase or term change. api_key_id is in query; no JSON body. Check guest_configuration_required: network configuration inside the guest may need updating.
Detach IPv4
Detaches an extra IPv4; the primary address cannot be detached. keep_ip is required in query: true keeps the address with continuing separate billing, false releases it. Check guest_configuration_required and adjust guest networking when required. Unused time is not refunded.
Renew IPv4
Renews a separately paid IPv4 for months=1/3/6/12/24/36 calendar months from max(current time, paid_until). If omitted, months retains the last paid term. Price is the current monthly rate times the term, without markup or discount. The chosen term is also used by the next auto-renewal. Primary IPv4 and IPv6 cannot renew separately. Returns HTTP 200, a completed order and paid_until. Reuse the same Idempotency-Key and parameters after a lost response.
IPv4 auto-renewal
Changes the auto-renewal setting without charging the balance or extending the paid term. The default is false. See the lifecycle guide for renewal timing, duration and pricing.
Release saved IPv4
Permanently releases an unattached saved IPv4. The address must not be assigned to a VPS. No charge or refund is created. The result contains operation_id; HTTP 200 confirms release.