DescribeLifecycleHooks - Amazon EC2 Auto Scaling
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).

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: