Doc AWS SDK 예제 GitHub 리포지토리에서 더 많은 SDK 예제를 사용할 수 있습니다. [AWS](https://github.com/awsdocs/aws-doc-sdk-examples) 

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# CLI로 `PutLifecycleHook` 사용
<a name="auto-scaling_example_auto-scaling_PutLifecycleHook_section"></a>

다음 코드 예시는 `PutLifecycleHook`의 사용 방법을 보여 줍니다.

------
#### [ CLI ]

**AWS CLI**  
**예제 1: 수명 주기 후크를 생성하는 방법**  
이 예제에서는 4,800초의 제한 시간으로 새로 시작된 인스턴스에서 호출할 수명 주기 후크를 생성합니다. 이는 사용자 데이터 스크립트가 완료될 때까지 인스턴스를 대기 상태로 유지하거나 EventBridge를 사용하여 AWS Lambda 함수를 호출하는 데 유용합니다.  

```
aws autoscaling put-lifecycle-hook \
    --auto-scaling-group-name {{my-asg}} \
    --lifecycle-hook-name {{my-launch-hook}} \
    --lifecycle-transition {{autoscaling:EC2_INSTANCE_LAUNCHING}} \
    --heartbeat-timeout {{4800}}
```
이 명령은 출력을 생성하지 않습니다. 동일한 이름의 수명 주기 후크가 이미 있는 경우 새 수명 주기 후크로 덮어씁니다.  
자세한 설명은 *Amazon EC2 Auto Scaling 사용자 가이드*의 [Amazon EC2 Auto Scaling 수명 주기 후크](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html)를 참조하세요.  
**예제 2: 인스턴스의 상태 전환을 알리기 위해 Amazon SNS 이메일 메시지를 전송하는 방법**  
이 예제에서는 인스턴스 시작 시 알림을 수신하는 데 사용할 Amazon SNS 주제 및 IAM 역할과 함께 수명 주기 후크를 생성합니다.  

```
aws autoscaling put-lifecycle-hook \
    --auto-scaling-group-name {{my-asg}} \
    --lifecycle-hook-name {{my-launch-hook}} \
    --lifecycle-transition {{autoscaling:EC2_INSTANCE_LAUNCHING}} \
    --notification-target-arn {{arn:aws:sns:us-west-2:123456789012:my-sns-topic}} \
    --role-arn {{arn:aws:iam::123456789012:role/my-auto-scaling-role}}
```
이 명령은 출력을 생성하지 않습니다.  
자세한 설명은 *Amazon EC2 Auto Scaling 사용자 가이드*의 [Amazon EC2 Auto Scaling 수명 주기 후크](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html)를 참조하세요.  
**예제 3: Amazon SQS 대기열에 메시지를 게시하는 방법**  
이 예제에서는 메타데이터가 포함된 메시지를 지정된 Amazon SQS 대기열에 게시하는 수명 주기 후크를 생성합니다.  

```
aws autoscaling put-lifecycle-hook \
    --auto-scaling-group-name {{my-asg}} \
    --lifecycle-hook-name {{my-launch-hook}} \
    --lifecycle-transition {{autoscaling:EC2_INSTANCE_LAUNCHING}} \
    --notification-target-arn {{arn:aws:sqs:us-west-2:123456789012:my-sqs-queue}} \
    --role-arn {{arn:aws:iam::123456789012:role/my-notification-role}} \
    --notification-metadata {{"SQS message metadata"}}
```
이 명령은 출력을 생성하지 않습니다.  
자세한 설명은 *Amazon EC2 Auto Scaling 사용자 가이드*의 [Amazon EC2 Auto Scaling 수명 주기 후크](https://docs.aws.amazon.com/autoscaling/ec2/userguide/lifecycle-hooks.html)를 참조하세요.  
+  API 세부 정보는 **AWS CLI 명령 참조의 [PutLifecycleHook](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/autoscaling/put-lifecycle-hook.html)을 참조하세요.

------
#### [ PowerShell ]

**Tools for PowerShell V4**  
**예제 1: 이 예제에서는 지정된 Auto Scaling 그룹에 지정된 수명 주기 후크를 추가합니다.**  

```
Write-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName "myLifecycleHook" -LifecycleTransition "autoscaling:EC2_INSTANCE_LAUNCHING" -NotificationTargetARN "arn:aws:sns:us-west-2:123456789012:my-sns-topic" -RoleARN "arn:aws:iam::123456789012:role/my-iam-role"
```
+  API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V4)*의 [PutLifecycleHook](https://docs.aws.amazon.com/powershell/v4/reference)를 참조하세요.

**Tools for PowerShell V5**  
**예제 1: 이 예제에서는 지정된 Auto Scaling 그룹에 지정된 수명 주기 후크를 추가합니다.**  

```
Write-ASLifecycleHook -AutoScalingGroupName my-asg -LifecycleHookName "myLifecycleHook" -LifecycleTransition "autoscaling:EC2_INSTANCE_LAUNCHING" -NotificationTargetARN "arn:aws:sns:us-west-2:123456789012:my-sns-topic" -RoleARN "arn:aws:iam::123456789012:role/my-iam-role"
```
+  API 세부 정보는 *AWS Tools for PowerShell Cmdlet 참조(V5)*의 [PutLifecycleHook](https://docs.aws.amazon.com/powershell/v5/reference)를 참조하세요.

------