

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Amazon EC2 Auto Scaling イベントリファレンス
<a name="ec2-auto-scaling-event-reference"></a>

Amazon EventBridge を使用すると、受信*イベント*を照合し、処理のために*ターゲット*にルーティングする*ルール*を作成できます。

**Topics**
+ [ライフサイクルアクションイベント](#ec2-auto-scaling-lifecycle-action-events)
+ [成功したスケーリングイベント](#ec2-auto-scaling-successful-scaling-events)
+ [失敗したスケーリングイベント](#ec2-auto-scaling-unsuccessful-scaling-events)

## ライフサイクルアクションイベント
<a name="ec2-auto-scaling-lifecycle-action-events"></a>

Auto Scaling グループにライフサイクルフックを追加すると、インスタンスが待機状態に移行するときに、Amazon EC2 Auto Scaling が EventBridge にイベントを送信します。イベントは、ベストエフォートベースで生成されます。

**Topics**
+ [スケールアウトライフサイクルアクション](#launch-lifecycle-action)
+ [スケールインライフサイクルアクション](#terminate-lifecycle-action)

### スケールアウトライフサイクルアクション
<a name="launch-lifecycle-action"></a>

次のイベント例は、起動ライフサイクルフックを理由として、Amazon EC2 Auto Scaling がインスタンスを `Pending:Wait` 状態に移行したことを示しています。

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Instance-launch Lifecycle Action",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": { 
    "LifecycleActionToken": "{{87654321}}-{{4321}}-{{4321}}-{{4321}}-{{210987654321}}", 
    "AutoScalingGroupName": "{{my-asg}}", 
    "LifecycleHookName": "{{my-lifecycle-hook}}", 
    "EC2InstanceId": "i-{{1234567890abcdef0}}", 
    "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING",
    "NotificationMetadata": "{{additional-info}}",
    "Origin": "{{EC2}}",
    "Destination": "{{AutoScalingGroup}}"
  } 
}
```

### スケールインライフサイクルアクション
<a name="terminate-lifecycle-action"></a>

次のイベント例は、終了ライフサイクルフックを理由として、Amazon EC2 Auto Scaling がインスタンスを `Terminating:Wait` 状態に移行したことを示しています。

**重要**  
Auto Scaling グループがスケールイン時にインスタンスをウォームプールに返す場合、インスタンスをウォームプールに返すことによって `EC2 Instance-terminate Lifecycle Action` イベントが生成される場合もあります。インスタンスがスケールインで待機状態に移行したときに配信されるイベントには、`Destination` の値として `WarmPool` が含まれます。詳細については、「[Instance reuse policy](ec2-auto-scaling-warm-pools.md#instance-reuse-policy)」を参照してください。

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Instance-terminate Lifecycle Action",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": { 
    "LifecycleActionToken":"{{87654321}}-{{4321}}-{{4321}}-{{4321}}-{{210987654321}}", 
    "AutoScalingGroupName":"{{my-asg}}", 
    "LifecycleHookName":"{{my-lifecycle-hook}}", 
    "EC2InstanceId":"i-{{1234567890abcdef0}}", 
    "LifecycleTransition":"autoscaling:EC2_INSTANCE_TERMINATING", 
    "NotificationMetadata":"{{additional-info}}",
    "Origin": "AutoScalingGroup",
    "Destination": "{{EC2}}"
  } 
}
```

## 成功したスケーリングイベント
<a name="ec2-auto-scaling-successful-scaling-events"></a>

次の例は、成功したスケーリングイベントのイベントタイプを示しています。イベントは、ベストエフォートベースで生成されます。

**Topics**
+ [成功したスケールアウトイベント](#launch-successful)
+ [成功したスケールインイベント](#terminate-successful)

### 成功したスケールアウトイベント
<a name="launch-successful"></a>

次のイベント例は、Amazon EC2 Auto Scaling がインスタンスを正常に起動したことを示しています。

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Instance Launch Successful",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}",
    "{{instance-arn}}"
  ],
  "detail": {
    "StatusCode": "InProgress",
    "Description": "Launching a new EC2 instance: i-{{12345678}}",
    "AutoScalingGroupName": "{{my-asg}}",
    "ActivityId": "{{87654321}}-{{4321}}-{{4321}}-{{4321}}-{{210987654321}}",
    "Details": {
      "Availability Zone": "{{us-west-2b}}",
      "Subnet ID": "subnet-{{12345678}}"
    },
    "RequestId": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
    "StatusMessage": "",
    "EndTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "EC2InstanceId": "i-{{1234567890abcdef0}}",
    "StartTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "Cause": "{{description-text}}",
    "Origin": "{{EC2}}",
    "Destination": "{{AutoScalingGroup}}"
  }
}
```

### 成功したスケールインイベント
<a name="terminate-successful"></a>

次のイベント例は、Amazon EC2 Auto Scaling がインスタンスを正常に終了したことを示しています。

**重要**  
Auto Scaling グループがスケールイン時にインスタンスをウォームプールに返す場合、インスタンスをウォームプールに返すことによって `EC2 Instance Terminate Successful` イベントが生成される場合もあります。インスタンスがウォームプールに正常に戻ったときに配信されるイベントには、`Destination` の値として `WarmPool` が含まれます。詳細については、「[Instance reuse policy](ec2-auto-scaling-warm-pools.md#instance-reuse-policy)」を参照してください。

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Instance Terminate Successful",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}",
    "{{instance-arn}}"
  ],
  "detail": {
    "StatusCode": "InProgress",
    "Description": "Terminating EC2 instance: i-{{12345678}}",
    "AutoScalingGroupName": "{{my-asg}}",
    "ActivityId": "{{87654321}}-{{4321}}-{{4321}}-{{4321}}-{{210987654321}}",
    "Details": {
      "Availability Zone": "{{us-west-2b}}",
      "Subnet ID": "subnet-{{12345678}}"
    },
    "RequestId": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
    "StatusMessage": "",
    "EndTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "EC2InstanceId": "i-{{1234567890abcdef0}}",
    "StartTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "Cause": "{{description-text}}",
    "Origin": "AutoScalingGroup",
    "Destination": "{{EC2}}"
  }
}
```

## 失敗したスケーリングイベント
<a name="ec2-auto-scaling-unsuccessful-scaling-events"></a>

次の例は、失敗したスケーリングイベントのイベントタイプを示しています。イベントは、ベストエフォートベースで生成されます。

**Topics**
+ [失敗したスケールアウトイベント](#launch-unsuccessful)
+ [失敗したスケールインイベント](#terminate-unsuccessful)

### 失敗したスケールアウトイベント
<a name="launch-unsuccessful"></a>

次のイベント例は、Amazon EC2 Auto Scaling がインスタンスの起動に失敗したことを示しています。

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Instance Launch Unsuccessful",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}",
    "{{instance-arn}}"
  ],
  "detail": {
    "StatusCode": "Failed",
    "AutoScalingGroupName": "{{my-asg}}",
    "ActivityId": "{{87654321}}-{{4321}}-{{4321}}-{{4321}}-{{210987654321}}",
    "Details": {
      "Availability Zone": "{{us-west-2b}}",
      "Subnet ID": "subnet-{{12345678}}"
    },
    "RequestId": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
    "StatusMessage": "{{message-text}}",
    "EndTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "EC2InstanceId": "i-{{1234567890abcdef0}}",
    "StartTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "Cause": "{{description-text}}",
    "Origin": "{{EC2}}",
    "Destination": "{{AutoScalingGroup}}"
  }
}
```

### 失敗したスケールインイベント
<a name="terminate-unsuccessful"></a>

次のイベント例は、Amazon EC2 Auto Scaling がインスタンスの終了に失敗したことを示しています。

**重要**  
Auto Scaling グループがスケールイン時にインスタンスをウォームプールに返すときに、インスタンスをウォームプールに返すことに失敗すると、`EC2 Instance Terminate Unsuccessful` イベントが生成される場合もあります。インスタンスがウォームプールに戻るのに失敗した場合に配信されるイベントには、`Destination` の値として `WarmPool` が含まれます。詳細については、「[Instance reuse policy](ec2-auto-scaling-warm-pools.md#instance-reuse-policy)」を参照してください。

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Instance Terminate Unsuccessful",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}",
    "{{instance-arn}}"
  ],
  "detail": {
    "StatusCode": "Failed",
    "AutoScalingGroupName": "{{my-asg}}",
    "ActivityId": "{{87654321}}-{{4321}}-{{4321}}-{{4321}}-{{210987654321}}",
    "Details": {
      "Availability Zone": "{{us-west-2b}}",
      "Subnet ID": "subnet-{{12345678}}"
    },
    "RequestId": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
    "StatusMessage": "{{message-text}}",
    "EndTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "EC2InstanceId": "i-{{1234567890abcdef0}}",
    "StartTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "Cause": "{{description-text}}",
    "Origin": "AutoScalingGroup",
    "Destination": "{{EC2}}"
  }
}
```