Precheck a GPU VM resize
Checks whether a GPU VM can take a requested CPU, memory, or root-disk change before you start the resize. The attached GPU stays the same. Requires scope: vm.write.
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_id
Virtual machine ID.
Query parameters
workspace_id
The positive numeric workspace ID to scope this request to. Zero, negative, and non-numeric values are rejected.
Request
This endpoint expects an object.
cpu
Target vCPUs.
ram_mb
Target memory in MB.
disk_gb
Target root disk size in GB.
Response
Resize decision returned successfully.
decision
in_place: the change can be applied on the current host.migration_required: the VM must move to another host first.blocked: the change cannot be made; seereasons.
Allowed values:
reasons
Why the decision was reached.
warnings
Non-blocking warnings about the change.
migration_checklist
Items to confirm before a migration.
migration_steps
Steps a migration would perform.
requires_stop
Whether the VM must be stopped for the change.
downtime_expected
Whether the change interrupts the VM.
no_changes
True when the target shape equals the current one.
current_state
VM lifecycle status recorded by the engine.
current
A VM shape: vCPUs, memory and root disk.
target
A VM shape: vCPUs, memory and root disk.
mode
Same values as decision; present when the engine reports the mode separately.
Allowed values:
live_state
Power state observed on the host, when available.
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found 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
