Skip to navigation

Resize a cloud VM

Moves a cloud VM to another plan: send the target plan’s cpu, ram_mb, disk_gb and billing_catalog (see the request body). The root disk can grow, never shrink. The same precheck the portal runs is applied first. Asynchronous: the response carries operation_id; poll GET /compute/operations/{operation_id} until status is succeeded, failed, cancelled or timed_out. If your client times out, read the status; never resubmit the request. Requires scope: vm.write.

# Example request with curl (set IBEE_API_TOKEN to a platform API token and WORKSPACE_ID to the workspace first).
# VM_ID: Virtual machine ID
curl -X POST "https://api.ibee.ai/v1/compute/cloud-vms/$VM_ID/actions/resize?workspace_id=$WORKSPACE_ID" \
-H "Authorization: Bearer $IBEE_API_TOKEN" \
-H "X-Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"cpu": 4, "ram_mb": 8192, "disk_gb": 80, "billing_catalog": {"sku_id": "<sku_id>", "sku_code": "<sku_code>", "billing_interval": "HOURLY", "committed": false, "commitment_period": "HOURLY", "unit_price_minor": 1, "price_currency": "INR"}}'

Authentication

AuthorizationBearer

IBEE platform API token. Production tokens start with ibee_prod_key_; development tokens start with ibee_dev_key_. Use a token only with its matching gateway environment.

Path parameters

vm_idstringRequired
Virtual machine ID.

Headers

X-Idempotency-KeystringRequired
Unique key used to safely retry write operations.

Query parameters

workspace_idstringRequiredformat: "^[1-9][0-9]*$">=1 character

The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.

Request

This endpoint expects an object.
cpuintegerRequired1-256
Target vCPUs, from the target plan.
ram_mbintegerRequired257-2097152
Target memory in MB, from the target plan.
disk_gbintegerRequired1-10000
Target root disk size in GB, from the target plan. The disk can grow, never shrink.
billing_catalogobjectRequired

Copy the selected plan’s billing_catalog, choose one supported HOURLY or MONTHLY entry from its billing_options, and merge that complete entry into the copy. Send the result here, including the canonical price_currency. Hourly requests also require an explicit selected term. Do not invent prices, drop commitment fields from the selected option, or send only billing_interval and committed. Admission validates the selection against the server’s current catalog. Amounts remain server-authoritative.

Response

VM resize accepted.
operation_idstring
ID of the queued operation.
vm_idstring
ID of the VM the operation acts on.
statusstring

Always accepted.

submitted_atdatetime

When the operation was accepted (ISO 8601).

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
413
Content Too Large Error
422
Unprocessable Entity Error
423
Locked Error
429
Too Many Requests Error
500
Internal Server Error
502
Bad Gateway Error
503
Service Unavailable Error
504
Gateway Timeout Error