Class CfnAutoScalingGroup.LifecycleHookSpecificationProperty

Namespace

Amazon.CDK.AWS.AutoScaling

Assembly

Amazon.CDK.AWS.AutoScaling.dll

LifecycleHookSpecification specifies a lifecycle hook for the LifecycleHookSpecificationList property of the AWS::AutoScaling::AutoScalingGroup resource. A lifecycle hook specifies actions to perform when Amazon EC2 Auto Scaling launches or terminates instances.

public class CfnAutoScalingGroup.LifecycleHookSpecificationProperty : CfnAutoScalingGroup.ILifecycleHookSpecificationProperty

Inheritance

object

CfnAutoScalingGroup.LifecycleHookSpecificationProperty

Implements

CfnAutoScalingGroup.ILifecycleHookSpecificationProperty

Inherited Members

object.GetType()

object.MemberwiseClone()

object.ToString()

object.Equals(object)

object.Equals(object, object)

object.ReferenceEquals(object, object)

object.GetHashCode()

Examples

// The code below shows an example of how to instantiate this type.
             // The values are placeholders you should change.
             using Amazon.CDK.AWS.AutoScaling;

             var lifecycleHookSpecificationProperty = new LifecycleHookSpecificationProperty {
                 LifecycleHookName = "lifecycleHookName",
                 LifecycleTransition = "lifecycleTransition",

                 // the properties below are optional
                 DefaultResult = "defaultResult",
                 HeartbeatTimeout = 123,
                 NotificationMetadata = "notificationMetadata",
                 NotificationTargetArn = "notificationTargetArn",
                 RoleArn = "roleArn"
             };

Remarks

For more information, see Amazon EC2 Auto Scaling lifecycle hooks in the Amazon EC2 Auto Scaling User Guide . You can find a sample template snippet in the Examples section of the AWS::AutoScaling::LifecycleHook resource.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-autoscalinggroup-lifecyclehookspecification.html

ExampleMetadata: fixture=_generated

Constructors

LifecycleHookSpecificationProperty()

public LifecycleHookSpecificationProperty()

Properties

DefaultResult

The action the Auto Scaling group takes when the lifecycle hook timeout elapses or if an unexpected failure occurs.

public string? DefaultResult { get; set; }

Property Value

string

Remarks

The default value is ABANDON .

Valid values: CONTINUE | ABANDON

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-autoscalinggroup-lifecyclehookspecification.html#cfn-autoscaling-autoscalinggroup-lifecyclehookspecification-defaultresult

HeartbeatTimeout

The maximum time, in seconds, that can elapse before the lifecycle hook times out.

public double? HeartbeatTimeout { get; set; }

Property Value

double?

Remarks

The range is from 30 to 7200 seconds. The default value is 3600 seconds (1 hour).

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-autoscalinggroup-lifecyclehookspecification.html#cfn-autoscaling-autoscalinggroup-lifecyclehookspecification-heartbeattimeout

LifecycleHookName

The name of the lifecycle hook.

public string LifecycleHookName { get; set; }

Property Value

string

Remarks

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-autoscalinggroup-lifecyclehookspecification.html#cfn-autoscaling-autoscalinggroup-lifecyclehookspecification-lifecyclehookname

LifecycleTransition

The lifecycle transition. For Auto Scaling groups, there are two major lifecycle transitions.

public string LifecycleTransition { get; set; }

Property Value

string

Remarks

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-autoscalinggroup-lifecyclehookspecification.html#cfn-autoscaling-autoscalinggroup-lifecyclehookspecification-lifecycletransition

NotificationMetadata

Additional information that you want to include any time Amazon EC2 Auto Scaling sends a message to the notification target.

public string? NotificationMetadata { get; set; }

Property Value

string

Remarks

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-autoscalinggroup-lifecyclehookspecification.html#cfn-autoscaling-autoscalinggroup-lifecyclehookspecification-notificationmetadata

NotificationTargetArn

The Amazon Resource Name (ARN) of the notification target that Amazon EC2 Auto Scaling sends notifications to when an instance is in a wait state for the lifecycle hook.

public string? NotificationTargetArn { get; set; }

Property Value

string

Remarks

You can specify an Amazon SNS topic or an Amazon SQS queue.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-autoscalinggroup-lifecyclehookspecification.html#cfn-autoscaling-autoscalinggroup-lifecyclehookspecification-notificationtargetarn

RoleArn

The ARN of the IAM role that allows the Auto Scaling group to publish to the specified notification target.

public string? RoleArn { get; set; }

Property Value

string

Remarks

For information about creating this role, see Configure a notification target for a lifecycle hook in the Amazon EC2 Auto Scaling User Guide .

Valid only if the notification target is an Amazon SNS topic or an Amazon SQS queue.

Link: http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-properties-autoscaling-autoscalinggroup-lifecyclehookspecification.html#cfn-autoscaling-autoscalinggroup-lifecyclehookspecification-rolearn