LifecycleHook (AWS SDK for Java 1.8.9 API)

java.lang.Object
- com.amazonaws.services.autoscaling.model.LifecycleHook

All Implemented Interfaces:

Serializable
```
public class LifecycleHook
extends Object
implements Serializable
```
A lifecycle hook tells Auto Scaling that you want to perform an action when an instance launches or terminates. When you have a lifecycle hook in place, the Auto Scaling group will either:
- Pause the instance after it launches, but before it is put into service
- Pause the instance as it terminates, but before it is fully terminated
To learn more, see Auto Scaling Pending State and Auto Scaling Terminating State .
See Also:
Serialized Form

Constructor Summary

Constructors
Constructor and Description

LifecycleHook()

Constructors
Constructor and Description
`LifecycleHook()`

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`equals(Object obj)`
`String`	`getAutoScalingGroupName()` The name of the Auto Scaling group to which the lifecycle action belongs.
`String`	`getDefaultResult()` Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs.
`Integer`	`getGlobalTimeout()` The maximum length of time an instance can remain in a `Pending:Wait` or `Terminating:Wait` state.
`Integer`	`getHeartbeatTimeout()` Defines the amount of time that can elapse before the lifecycle hook times out.
`String`	`getLifecycleHookName()` The name of the lifecycle action hook.
`String`	`getLifecycleTransition()` The Amazon EC2 instance state to which you want to attach the lifecycle hook.
`String`	`getNotificationMetadata()` Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
`String`	`getNotificationTargetARN()` The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook.
`String`	`getRoleARN()` The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.
`int`	`hashCode()`
`void`	`setAutoScalingGroupName(String autoScalingGroupName)` The name of the Auto Scaling group to which the lifecycle action belongs.
`void`	`setDefaultResult(String defaultResult)` Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs.
`void`	`setGlobalTimeout(Integer globalTimeout)` The maximum length of time an instance can remain in a `Pending:Wait` or `Terminating:Wait` state.
`void`	`setHeartbeatTimeout(Integer heartbeatTimeout)` Defines the amount of time that can elapse before the lifecycle hook times out.
`void`	`setLifecycleHookName(String lifecycleHookName)` The name of the lifecycle action hook.
`void`	`setLifecycleTransition(String lifecycleTransition)` The Amazon EC2 instance state to which you want to attach the lifecycle hook.
`void`	`setNotificationMetadata(String notificationMetadata)` Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
`void`	`setNotificationTargetARN(String notificationTargetARN)` The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook.
`void`	`setRoleARN(String roleARN)` The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.
`String`	`toString()` Returns a string representation of this object; useful for testing and debugging.
`LifecycleHook`	`withAutoScalingGroupName(String autoScalingGroupName)` The name of the Auto Scaling group to which the lifecycle action belongs.
`LifecycleHook`	`withDefaultResult(String defaultResult)` Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs.
`LifecycleHook`	`withGlobalTimeout(Integer globalTimeout)` The maximum length of time an instance can remain in a `Pending:Wait` or `Terminating:Wait` state.
`LifecycleHook`	`withHeartbeatTimeout(Integer heartbeatTimeout)` Defines the amount of time that can elapse before the lifecycle hook times out.
`LifecycleHook`	`withLifecycleHookName(String lifecycleHookName)` The name of the lifecycle action hook.
`LifecycleHook`	`withLifecycleTransition(String lifecycleTransition)` The Amazon EC2 instance state to which you want to attach the lifecycle hook.
`LifecycleHook`	`withNotificationMetadata(String notificationMetadata)` Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
`LifecycleHook`	`withNotificationTargetARN(String notificationTargetARN)` The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook.
`LifecycleHook`	`withRoleARN(String roleARN)` The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - LifecycleHook
```
public LifecycleHook()
```
- Method Detail
  - getLifecycleHookName
```
public String getLifecycleHookName()
```
    The name of the lifecycle action hook.
    Constraints:
    Length: 1 - 255
    Pattern: [A-Za-z0-9\-_\/]+
    
    Returns:
    The name of the lifecycle action hook.
  - setLifecycleHookName
```
public void setLifecycleHookName(String lifecycleHookName)
```
    The name of the lifecycle action hook.
    Constraints:
    Length: 1 - 255
    Pattern: [A-Za-z0-9\-_\/]+
    
    Parameters:
    lifecycleHookName - The name of the lifecycle action hook.
  - withLifecycleHookName
```
public LifecycleHook withLifecycleHookName(String lifecycleHookName)
```
    The name of the lifecycle action hook.
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 255
    Pattern: [A-Za-z0-9\-_\/]+
    
    Parameters:
    lifecycleHookName - The name of the lifecycle action hook.
    
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - getAutoScalingGroupName
```
public String getAutoScalingGroupName()
```
    The name of the Auto Scaling group to which the lifecycle action belongs.
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Returns:
    The name of the Auto Scaling group to which the lifecycle action belongs.
  - setAutoScalingGroupName
```
public void setAutoScalingGroupName(String autoScalingGroupName)
```
    The name of the Auto Scaling group to which the lifecycle action belongs.
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Parameters:
    autoScalingGroupName - The name of the Auto Scaling group to which the lifecycle action belongs.
  - withAutoScalingGroupName
```
public LifecycleHook withAutoScalingGroupName(String autoScalingGroupName)
```
    The name of the Auto Scaling group to which the lifecycle action belongs.
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Parameters:
    autoScalingGroupName - The name of the Auto Scaling group to which the lifecycle action belongs.
    
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - getLifecycleTransition
```
public String getLifecycleTransition()
```
    The Amazon EC2 instance state to which you want to attach the lifecycle hook. See DescribeLifecycleHooks for a list of available lifecycle hook types.
    
    Returns:
    The Amazon EC2 instance state to which you want to attach the lifecycle hook. See DescribeLifecycleHooks for a list of available lifecycle hook types.
  - setLifecycleTransition
```
public void setLifecycleTransition(String lifecycleTransition)
```
    The Amazon EC2 instance state to which you want to attach the lifecycle hook. See DescribeLifecycleHooks for a list of available lifecycle hook types.
    
    Parameters:
    lifecycleTransition - The Amazon EC2 instance state to which you want to attach the lifecycle hook. See DescribeLifecycleHooks for a list of available lifecycle hook types.
  - withLifecycleTransition
```
public LifecycleHook withLifecycleTransition(String lifecycleTransition)
```
    The Amazon EC2 instance state to which you want to attach the lifecycle hook. See DescribeLifecycleHooks for a list of available lifecycle hook types.
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    lifecycleTransition - The Amazon EC2 instance state to which you want to attach the lifecycle hook. See DescribeLifecycleHooks for a list of available lifecycle hook types.
    
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - getNotificationTargetARN
```
public String getNotificationTargetARN()
```
    The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook. This ARN target can be either an SQS queue or an SNS topic. The notification message sent to the target will include:
    - Lifecycle action token
    - User account ID
    - Name of the Auto Scaling group
    - Lifecycle hook name
    - EC2 instance ID
    - Lifecycle transition
    - Notification metadata
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    Returns:
    The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook. This ARN target can be either an SQS queue or an SNS topic. The notification message sent to the target will include:
    
    Lifecycle action token
    
    User account ID
    
    Name of the Auto Scaling group
    
    Lifecycle hook name
    
    EC2 instance ID
    
    Lifecycle transition
    
    Notification metadata
  - setNotificationTargetARN
```
public void setNotificationTargetARN(String notificationTargetARN)
```
    The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook. This ARN target can be either an SQS queue or an SNS topic. The notification message sent to the target will include:
    - Lifecycle action token
    - User account ID
    - Name of the Auto Scaling group
    - Lifecycle hook name
    - EC2 instance ID
    - Lifecycle transition
    - Notification metadata
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    Parameters:
    notificationTargetARN - The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook. This ARN target can be either an SQS queue or an SNS topic. The notification message sent to the target will include:
    
    Lifecycle action token
    
    User account ID
    
    Name of the Auto Scaling group
    
    Lifecycle hook name
    
    EC2 instance ID
    
    Lifecycle transition
    
    Notification metadata
  - withNotificationTargetARN
```
public LifecycleHook withNotificationTargetARN(String notificationTargetARN)
```
    The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook. This ARN target can be either an SQS queue or an SNS topic. The notification message sent to the target will include:
    - Lifecycle action token
    - User account ID
    - Name of the Auto Scaling group
    - Lifecycle hook name
    - EC2 instance ID
    - Lifecycle transition
    - Notification metadata
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    Parameters:
    notificationTargetARN - The ARN of the notification target that Auto Scaling will use to notify you when an instance is in the transition state for the lifecycle hook. This ARN target can be either an SQS queue or an SNS topic. The notification message sent to the target will include:
    
    Lifecycle action token
    
    User account ID
    
    Name of the Auto Scaling group
    
    Lifecycle hook name
    
    EC2 instance ID
    
    Lifecycle transition
    
    Notification metadata
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - getRoleARN
```
public String getRoleARN()
```
    The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Returns:
    The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.
  - setRoleARN
```
public void setRoleARN(String roleARN)
```
    The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Parameters:
    roleARN - The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.
  - withRoleARN
```
public LifecycleHook withRoleARN(String roleARN)
```
    The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 1600
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Parameters:
    roleARN - The ARN of the Amazon IAM role that allows the Auto Scaling group to publish to the specified notification target.
    
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - getNotificationMetadata
```
public String getNotificationMetadata()
```
    Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
    Constraints:
    Length: 1 - 1023
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Returns:
    Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
  - setNotificationMetadata
```
public void setNotificationMetadata(String notificationMetadata)
```
    Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
    Constraints:
    Length: 1 - 1023
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Parameters:
    notificationMetadata - Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
  - withNotificationMetadata
```
public LifecycleHook withNotificationMetadata(String notificationMetadata)
```
    Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
    Returns a reference to this object so that method calls can be chained together.
    Constraints:
    Length: 1 - 1023
    Pattern: [\u0020-\uD7FF\uE000-\uFFFD\uD800\uDC00-\uDBFF\uDFFF\r\n\t]*
    
    Parameters:
    notificationMetadata - Contains additional information that you want to include any time Auto Scaling sends a message to the notification target.
    
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - getHeartbeatTimeout
```
public Integer getHeartbeatTimeout()
```
    Defines the amount of time that can elapse before the lifecycle hook times out. When the lifecycle hook times out, Auto Scaling performs the action defined in the DefaultResult parameter. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
    
    Returns:
    Defines the amount of time that can elapse before the lifecycle hook times out. When the lifecycle hook times out, Auto Scaling performs the action defined in the DefaultResult parameter. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
  - setHeartbeatTimeout
```
public void setHeartbeatTimeout(Integer heartbeatTimeout)
```
    Defines the amount of time that can elapse before the lifecycle hook times out. When the lifecycle hook times out, Auto Scaling performs the action defined in the DefaultResult parameter. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
    
    Parameters:
    heartbeatTimeout - Defines the amount of time that can elapse before the lifecycle hook times out. When the lifecycle hook times out, Auto Scaling performs the action defined in the DefaultResult parameter. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
  - withHeartbeatTimeout
```
public LifecycleHook withHeartbeatTimeout(Integer heartbeatTimeout)
```
    Defines the amount of time that can elapse before the lifecycle hook times out. When the lifecycle hook times out, Auto Scaling performs the action defined in the DefaultResult parameter. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    heartbeatTimeout - Defines the amount of time that can elapse before the lifecycle hook times out. When the lifecycle hook times out, Auto Scaling performs the action defined in the DefaultResult parameter. You can prevent the lifecycle hook from timing out by calling RecordLifecycleActionHeartbeat.
    
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - getGlobalTimeout
```
public Integer getGlobalTimeout()
```
    The maximum length of time an instance can remain in a Pending:Wait or Terminating:Wait state. Currently, this value is set at 48 hours.
    
    Returns:
    The maximum length of time an instance can remain in a Pending:Wait or Terminating:Wait state. Currently, this value is set at 48 hours.
  - setGlobalTimeout
```
public void setGlobalTimeout(Integer globalTimeout)
```
    The maximum length of time an instance can remain in a Pending:Wait or Terminating:Wait state. Currently, this value is set at 48 hours.
    
    Parameters:
    globalTimeout - The maximum length of time an instance can remain in a Pending:Wait or Terminating:Wait state. Currently, this value is set at 48 hours.
  - withGlobalTimeout
```
public LifecycleHook withGlobalTimeout(Integer globalTimeout)
```
    The maximum length of time an instance can remain in a Pending:Wait or Terminating:Wait state. Currently, this value is set at 48 hours.
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    globalTimeout - The maximum length of time an instance can remain in a Pending:Wait or Terminating:Wait state. Currently, this value is set at 48 hours.
    
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - getDefaultResult
```
public String getDefaultResult()
```
    Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The value for this parameter can be either CONTINUE or ABANDON. The default value for this parameter is CONTINUE.
    
    Returns:
    Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The value for this parameter can be either CONTINUE or ABANDON. The default value for this parameter is CONTINUE.
  - setDefaultResult
```
public void setDefaultResult(String defaultResult)
```
    Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The value for this parameter can be either CONTINUE or ABANDON. The default value for this parameter is CONTINUE.
    
    Parameters:
    defaultResult - Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The value for this parameter can be either CONTINUE or ABANDON. The default value for this parameter is CONTINUE.
  - withDefaultResult
```
public LifecycleHook withDefaultResult(String defaultResult)
```
    Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The value for this parameter can be either CONTINUE or ABANDON. The default value for this parameter is CONTINUE.
    Returns a reference to this object so that method calls can be chained together.
    
    Parameters:
    defaultResult - Defines the action the Auto Scaling group should take when the lifecycle hook timeout elapses or if an unexpected failure occurs. The value for this parameter can be either CONTINUE or ABANDON. The default value for this parameter is CONTINUE.
    
    Returns:
    A reference to this updated object so that method calls can be chained together.
  - toString
```
public String toString()
```
    Returns a string representation of this object; useful for testing and debugging.
    
    Overrides:
    
    toString in class Object
    
    Returns:
    A string representation of this object.
    See Also:
    Object.toString()
  - hashCode
```
public int hashCode()
```
    Overrides:
    
    hashCode in class Object
  - equals
```
public boolean equals(Object obj)
```
    Overrides:
    
    equals in class Object

Class LifecycleHook

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

LifecycleHook

Method Detail

getLifecycleHookName

setLifecycleHookName

withLifecycleHookName

getAutoScalingGroupName

setAutoScalingGroupName

withAutoScalingGroupName

getLifecycleTransition

setLifecycleTransition

withLifecycleTransition

getNotificationTargetARN

setNotificationTargetARN

withNotificationTargetARN

getRoleARN

setRoleARN

withRoleARN

getNotificationMetadata

setNotificationMetadata

withNotificationMetadata

getHeartbeatTimeout

setHeartbeatTimeout

withHeartbeatTimeout

getGlobalTimeout

setGlobalTimeout

withGlobalTimeout

getDefaultResult

setDefaultResult

withDefaultResult

toString

hashCode

equals