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
- 401
- 404
- 409
- 422
- 500
- 503
Accepted for processing
Missing or invalid key, mismatched ID, or inactive integration
Resource not found in this integration
Business or state conflict; inspect detail
Invalid request fields or unsupported parameters
Unexpected server error
Service unavailable or result unconfirmed; for a mutation retain its idempotency key