AWS: Fetch ASG Membership and Lifecycle Details
Availability
This workflow action is available only to customers on PagerDuty Operations Cloud plans. See Operations Cloud pricing for more information.
Description
Fetch Auto Scaling Group (ASG) membership and lifecycle details for one or more EC2 instances. The action returns which ASG each instance belongs to, its lifecycle state (e.g., InService, Standby), health status, availability zone, and launch template or launch configuration. This action is useful for:
- Building runbooks that need ASG context before scaling or rotating instances
- Looking up the ASG name for an instance so later steps can call Describe Auto Scaling Groups, Enter Standby, or Set Instance Protection
- Gathering diagnostic information when the incident provides an instance ID (e.g., from alert details)
- Chaining with other Auto Scaling actions in a single workflow
Instructions
- If you have not done so, follow the instructions to Create an Incident Workflow.
- When the instructions prompt you to add actions, select this action.
- Enter the following Inputs and click Save.
- Continue following instructions to Publish the Workflow.
- When the action runs, you will see the Outputs listed below.
Inputs
Field References
Fields with the {+} icon accept Field References, which can be useful for referencing incident data or outputs created in prior workflow steps. To add Field References, click {+}, or enter
{{, and select relevant fields. Refer to the Field References article for more information.
| Name | Description |
|---|---|
| Integration | Select a Workflow Integration or click New AWS Connection to establish a new one. |
| Instance IDs | One or more EC2 instance IDs to look up (comma-separated). For example, from incident custom details or a prior step. |
| AWS Region | The AWS region where the instances and Auto Scaling Groups are located. If left blank, the action uses us-east-1 as the default. |
Outputs
| Name | Description |
|---|---|
| Instances | JSON array of Auto Scaling instance records. Each record includes: instanceId, asgName, lifecycleState, healthStatus, availabilityZone, launchTemplate (if present), launchConfigurationName (if present). |
| Result | Whether the action succeeded: Success or Failed. |
| Result Summary | Brief description of what the action did or if it failed. |
| Error | Error message, if the action failed. |
Tips
- Field References: Use Field References to pass the instance ID from the incident's custom details (e.g., from your monitoring tool's alert payload) so the workflow works automatically when triggered.
- Chaining Actions: Reference the Instances output in later steps (e.g.,
instances[0].asgName) for Set Instance Protection, Enter Standby, or Terminate Instance in Auto Scaling Group.
Updated about 2 hours ago