Buy extra traffic

POST 
/vms/:vm_id/traffic/topup

traffic_tb is an integer; one unit is 1099511627776 bytes (1024⁴). Extra traffic has a fixed price without integration markup and applies only to the current traffic period. Copy expected_period_id from the quote into the purchase to detect a period change (409 quote_expired).

Send a unique Idempotency-Key for each intended action. If the response is lost, retry with the same key and unchanged parameters; do not create a new key for the same purchase.

HTTP 202 accepts the request; it does not confirm completion. Save the order_id or operation id and check its status.

Request rules and errors · Lifecycle · Webhooks

Request

Responses

202

Accepted for processing

401

Missing or invalid key, mismatched ID, or inactive integration

404

Resource not found in this integration

409

Business or state conflict; inspect detail

422

Invalid request fields or unsupported parameters

500

Unexpected server error

503

Service unavailable or result unconfirmed; for a mutation retain its idempotency key