Dedicated servers
Dedicated servers endpoints for your Cloud API integration.
Calculate dedicated server price
Supply exactly one format: disk_layout for a shared-layout plan, or disk_layouts for a disk-group plan. disk_layouts maps the catalog disks[].id values to supported layout codes for those groups. Include every group and no extra keys. IDs are opaque: do not derive them from disk types. The client selects defaults; the API does not fill them in. Preserve the selection when retrying an order.
Rent a dedicated server
Supply exactly one format: disk_layout for a shared-layout plan, or disk_layouts for a disk-group plan. disk_layouts maps the catalog disks[].id values to supported layout codes for those groups. Include every group and no extra keys. IDs are opaque: do not derive them from disk types. The client selects defaults; the API does not fill them in. Preserve the selection when retrying an order.
List rentals
Lists rentals owned by this integration with customer, location, platform and status filters. Credentials are available only in rental details.
Rental details and credentials
Returns rental hardware, payment term, status and access credentials. Credentials may be null before issue. Cache-Control: no-store. preparing is preparation; active is issued; overdue is unpaid; cleaning is release/cleanup; completed and cancelled are terminal states.
Dedicated server status
Returns power_state, supported power_actions and the reinstall capability. Management is available only for an issued, active, paid rental on a server configured for it. Use power_actions instead of assuming all five commands are supported; unsupported commands are not replaced with a forced restart. On does not confirm OS or application readiness. Cache-Control: no-store.
Dedicated server power
Accepts start, shutdown, stop, reboot or reset. First read the supported power_actions from rental status. shutdown/reboot request a graceful shutdown/restart; stop/reset force it and can lose unsaved data. Returns an asynchronous operation, not a financial order; the integration balance is not charged. Only active, paid rentals with configured management can accept a new command.
Reinstall dedicated OS
Reinstalls the OS and erases server disks; confirmed: true is required. Use os_id from the OS directory. The server must support reinstall and the selected OS; hostname, login, disk layout, IP addresses, owner and paid term are retained. If password and ssh_public_key are both omitted, stored credentials are retained. If either field is supplied, the complete credential set is replaced; the omitted field is not retained. A password, a public SSH key or both may be supplied; an empty set is rejected. cloud_init is not supported here. The command does not charge the balance. After success, read rental details for current credentials; operations and webhooks do not contain them.
Dedicated operation history
Lists power and reinstall operations for this rental, including after it has ended. Newest first; total_count is the count before pagination. A pending operation or an unresolved requires_review result blocks a new command. review_resolved_at records an administrator review; it does not rewrite the historical failed result.
Dedicated operation
Returns the operation only when it belongs to the specified rental and integration. Status: queued, running, succeeded, failed or cancelled. Successful power result includes power_state, changed and optional power_action; reinstall result includes os and verified. verified confirms installation checks, not client application health. Failed operations expose a public error and requires_review. If requires_review is true and review_resolved_at is null, contact support before a new command; repeating the same Idempotency-Key returns the original operation.
Calculate rental renewal
Extends an issued rental at current prices and discounts for the selected term. Additional IPv4 included in the rental are charged at the fixed price. Renewal is possible while active or overdue, before cleanup starts.
Renew rental
Extends an issued rental at current prices and discounts for the selected term. Additional IPv4 included in the rental are charged at the fixed price. Renewal is possible while active or overdue, before cleanup starts.
Rental 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.