Appearance
runner.delete_gcp_workload ​
Delete GCE VM and instance template for a runner environment.
Delete the GCE runner workload (environment VM + instance template).
Overview ​
| Property | Value |
|---|---|
| Workflow type | Dag |
| Library | App-runners-gcp |
| Version | 1.0 |
Input Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
runner_group_uuid | uuid | Yes | — | UUID of the RunnerGroup this action operates on, picked from the organization's list of runner groups. |
organization_uuid | uuid | No | — | UUID of the caller's organization, injected server-side from the authenticated request; scopes the operation to the correct tenant. |
workflow_run_id | string | No | — | Engine-stamped workflow run ID |
workflow_run_uuid | string | No | — | Engine-stamped correlation/run id (ADR-015/E1); tolerated on input |
Output Schema ​
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
runner_group_uuid | uuid | No | — | UUID of the RunnerGroup whose GCE workload was deleted, echoed back from the input. |
organization_uuid | uuid | No | — | UUID of the caller's organization, echoed back from the input. |
cloud_connection_uuid | uuid | No | — | UUID of the GCP CloudConnection backing this runner group's cloud backend, picked from the organization's GCP connections. |
project_id | string | No | — | — |
zone | string | No | — | — |
mig_name | string | No | — | — |
workflow_run_uuid | string | No | — | Internal engine correlation/run identifier for this DAG execution, stamped by the engine (ADR-015/E1). |
failure_reason | string | No | — | Populated only when the workflow ends in FAILED |
failure_type | string | No | — | — |
failed_action | string | No | — | — |
failed_at_state | string | No | — | — |
failed_step | string | No | — | — |
failed_layer | string | No | — | — |
error | string | No | — | — |
error_type | string | No | — | — |
pre | json | No | — | Output of the pre DAG step |
vm_delete | json | No | — | Output of the vm_delete DAG step |
template_delete | json | No | — | Output of the template_delete DAG step |
post | json | No | — | Output of the post DAG step |
DAG Layers ​
| # | Layer | Steps | Compensation |
|---|---|---|---|
| 1 | pre | runner.delete_gcp_workload__pre | — |
| 2 | vm_delete | gcp.compute.vm.delete | — |
| 3 | template_delete | gcp.compute.instance_template.delete | — |
| 4 | post | runner.delete_gcp_workload__post | — |
Execution Flow ​
Sub-workflows ​
| Sub-workflow | Step name |
|---|---|
runner.delete_gcp_workload__pre | pre |
gcp.compute.vm.delete | vm_delete |
gcp.compute.instance_template.delete | template_delete |
runner.delete_gcp_workload__post | post |
API Usage ​
bash
POST /api/workflows/start
Content-Type: application/json
{
"workflow_type": "runner.delete_gcp_workload",
"initial_data": {
"runner_group_uuid": "value"
}
}