DescribeLifecycleHooks
Gets information about the lifecycle hooks for the specified Auto Scaling group.
Request Parameters
For information about the parameters that are common to all actions, see Common Parameters.
- AutoScalingGroupName
-
The name of the Auto Scaling group.
Type: String
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
Required: Yes
- LifecycleHookNames.member.N
-
The names of one or more lifecycle hooks. If you omit this property, all lifecycle hooks are described.
Type: Array of strings
Array Members: Maximum number of 50 items.
Length Constraints: Minimum length of 1. Maximum length of 255.
Pattern:
[A-Za-z0-9\-_\/]+
Required: No
Response Elements
The following element is returned by the service.
- LifecycleHooks.member.N
-
The lifecycle hooks for the specified group.
Type: Array of LifecycleHook objects
Errors
For information about the errors that are common to all actions, see Common Errors.
- ResourceContention
-
You already have a pending update to an Amazon EC2 Auto Scaling resource (for example, an Auto Scaling group, instance, or load balancer).
HTTP Status Code: 500
Examples
Example
This example illustrates one usage of DescribeLifecycleHooks.
Sample Request
https://autoscaling.amazonaws.com/?Action=DescribeLifecycleHooks
&AutoScalingGroupName=my-asg
&Version=2011-01-01
&AUTHPARAMS
Sample Response
<DescribeLifecycleHooksResponse xmlns="https://autoscaling.amazonaws.com/doc/2011-01-01/">
<DescribeLifecycleHooksResult>
<LifecycleHooks>
<member>
<AutoScalingGroupName>my-asg</AutoScalingGroupName>
<RoleARN>arn:aws:iam::1234567890:role/my-auto-scaling-role</RoleARN>
<LifecycleTransition>autoscaling:EC2_INSTANCE_LAUNCHING</LifecycleTransition>
<GlobalTimeout>172800</GlobalTimeout>
<LifecycleHookName>my-launch-hook</LifecycleHookName>
<HeartbeatTimeout>3600</HeartbeatTimeout>
<DefaultResult>ABANDON</DefaultResult>
<NotificationTargetARN>arn:aws:sqs:us-east-1:123456789012:my-queue</NotificationTargetARN>
</member>
</LifecycleHooks>
</DescribeLifecycleHooksResult>
<ResponseMetadata>
<RequestId>7c6e177f-f082-11e1-ac58-3714bEXAMPLE</RequestId>
</ResponseMetadata>
</DescribeLifecycleHooksResponse>
See Also
For more information about using this API in one of the language-specific Amazon SDKs, see the following: