Skip to content
Proud to collaborate with Microsoft for Startups

aws.ec2.terminate_instance ​

Terminate one EC2 instance by instance ID using a CloudConnection-backed AWS session.

Overview ​

PropertyValue
Workflow typeAtomic
LibraryBase-aws
Version1.0

Input Schema ​

FieldTypeRequiredDefaultDescription
connection_uuiduuidYes—AWS CloudConnection UUID.
regionstringNo—AWS region override.
instance_idstringYes—EC2 instance ID to terminate.

Output Schema ​

FieldTypeRequiredDefaultDescription
connection_uuiduuidNo—AWS CloudConnection UUID echoed from input.
regionstringNo—AWS region used.
instance_idstringNo—EC2 instance ID.
final_statestringNo—Current instance state name after the termination call.
previous_statestringNo—Instance state name before the termination call.
terminating_instancejsonNo—Sanitized provider terminating-instance object.
failure_reasonstringNo—Human-readable failure reason.
failed_stepstringNo—Failed logical step.
failed_layerjsonNo—Failed DAG layer if engine supplies one.
failed_at_statestringNo—State where failure occurred.
errorstringNo—Error message.
error_typestringNo—Error class.
failed_atstringNo—ISO failure timestamp.

States ​

StateInitialTerminalSuccessAuto-advanceDescription
pendingYesNo—execute—
completedNoYesYes——
failedNoYesNo——

State Diagram ​

Transitions ​

FromActionToDescription
pendingexecutecompleted—
* (any state)failfailed—

API Usage ​

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

{
  "workflow_type": "aws.ec2.terminate_instance",
  "initial_data": {
    "connection_uuid": "value",
    "instance_id": "value"
  }
}