actionEC2

stop_instance

Stop a single EC2 instance

Activity as code

Below are the details and signature of the activity Python module.

Typeaction
Modulechaosaws.ec2.actions
Namestop_instance
Returnlist

Usage

JSON

{
  "name": "stop-instance",
  "type": "action",
  "provider": {
    "type": "python",
    "module": "chaosaws.ec2.actions",
    "func": "stop_instance"
  }
}

YAML

name: stop-instance
provider:
  func: stop_instance
  module: chaosaws.ec2.actions
  type: python
type: action

Arguments

NameTypeDefaultRequiredTitleDescription
instance_idstringNoInstance IDInstance identifier, or filters below
filterslistnullNoInstance FiltersList of key/value pairs to select an instance
azstringnullNoAvailability ZoneAvailability zone to target. If the other fields are left empty, a random instance will be stopped in that AZ
forcebooleanfalseNoForceForce the operation

You may provide an instance id explicitly or, if you only specify the AZ, a random instance will be selected. If you need more control, you can also provide a list of filters following the documentation https://boto3.amazonaws.com/v1/documentation/api/latest/reference/services/ec2.html#EC2.Client.describe_instances

Signature

def stop_instance(
        instance_id: str = None,
        az: str = None,
        force: bool = False,
        filters: List[Dict[str, Any]] = None,
        configuration: Dict[str, Dict[str, str]] = None,
        secrets: Dict[str, Dict[str, str]] = None) -> List[Dict[str, Any]]:
    pass