Skip to main content
Get the status and result of an operation.

TL;DR

  • Use when: Checking async operation results
  • Returns: Operation state, stdout/stderr, exit code
  • Cost: No VM needed

Parameters

ParameterTypeRequiredDefaultDescription
operation_idstringYes-Operation UUID

Response

For instance (command) operations:
{
  "operation_kind": "instance",
  "state": "SUCCESS",
  "exit_code": 0,
  "stdout": "output here",
  "stderr": null,
  "result_image": "img-uuid",
  "resources": {
    "elapsed_time": 1.234
  }
}
For import operations:
{
  "operation_kind": "image_import",
  "state": "SUCCESS",
  "result_image": "img-uuid",
  "result_tag": "python:3.11"
}

Examples

Check Status

{"tool": "get_operation", "args": {
  "operation_id": "op-abc123"
}}

Operation States

StateDescription
PENDINGQueued
EXECUTINGRunning
SUCCESSCompleted successfully
FAILEDCompleted with error
CANCELLEDCancelled

See Also