gcp.compute.instance_group_manager.delete

Delete a GCE managed instance group; idempotent when the group is already absent.

Delete a GCE managed instance group (zonal or regional). Idempotent on NOT_FOUND.

Overview

Property	Value
Workflow type	Linear
Library	Base-gcp
Version	1.0

Input Schema

Field	Type	Required	Default	Description
connection_uuid	uuid	Yes	—	GCP CloudConnection UUID.
project_id	string	No	—	GCP project override; defaults to the connection project.
name	string	Yes	—	Managed instance group name to delete.
zone	string	No	—	GCE zone for a zonal managed instance group; provide exactly one of zone or region.
region	string	No	—	GCE region for a regional managed instance group; provide exactly one of zone or region.
request_id	string	No	—	Optional provider request id for retry-safe deletion.

Output Schema

Field	Type	Required	Default	Description
connection_uuid	uuid	No	—	GCP CloudConnection UUID echoed from input.
project_id	string	No	—	Effective GCP project.
authenticated_project_id	string	No	—	Project resolved by credential validation.
auth_validation	boolean	No	—	True when credential validation succeeded.
name	string	No	—	Managed instance group name echoed from input.
zone	string	No	—	GCE zone echoed from input when the MIG is zonal.
region	string	No	—	GCE region echoed from input when the MIG is regional.
request_id	string	No	—	Optional provider request id echoed from input.
provider_resource_id	string	No	—	projects/{project}/zones/{zone}/instanceGroupManagers/{name} or projects/{project}/regions/{region}/instanceGroupManagers/{name}.
operation_name	string	No	—	Compute long-running operation name for the delete.
operation_status	string	No	—	Initial provider operation status.
operation	json	No	—	Sanitized provider operation response.
already_absent	boolean	No	—	True when the managed instance group was already deleted (NOT_FOUND treated as success).
failure_reason	string	No	—	Human-readable failure reason.
failure_type	string	No	—	Engine exception class.
failure_category	string	No	—	Provider failure category.
failure_details	json	No	—	Structured provider failure details.
failed_step	string	No	—	Failed logical step.
failed_layer	json	No	—	Engine failed layer.
failed_at_state	string	No	—	State where failure occurred.
failed_action	string	No	—	Failed transition action.
error	string	No	—	Error message.
error_type	string	No	—	Error class.
failed_at	string	No	—	ISO failure timestamp.

States

State	Initial	Terminal	Success	Auto-advance	Description
pending	Yes	No	—	preflight	—
deleting	No	No	—	complete	—
preflighting	No	No	—	execute	—
completed	No	Yes	Yes	—	—
failed	No	Yes	No	—	—

State Diagram

Transitions

From	Action	To	Description
pending	preflight	preflighting	—
preflighting	execute	deleting	—
deleting	complete	completed	—
* (any state)	fail	failed	—

API Usage

POST /api/workflows/start
Content-Type: application/json

{
  "workflow_type": "gcp.compute.instance_group_manager.delete",
  "initial_data": {
    "connection_uuid": "value",
    "name": "value"
  }
}