

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

# 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-ddThh:mm:ssZ",
  "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-ddThh:mm:ssZ",
  "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-ddThh:mm:ssZ",
  "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-ddThh:mm:ssZ",
    "EC2InstanceId": "i-1234567890abcdef0",
    "StartTime": "yyyy-mm-ddThh:mm:ssZ",
    "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-ddThh:mm:ssZ",
  "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-ddThh:mm:ssZ",
    "EC2InstanceId": "i-1234567890abcdef0",
    "StartTime": "yyyy-mm-ddThh:mm:ssZ",
    "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-ddThh:mm:ssZ",
  "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-ddThh:mm:ssZ",
    "EC2InstanceId": "i-1234567890abcdef0",
    "StartTime": "yyyy-mm-ddThh:mm:ssZ",
    "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-ddThh:mm:ssZ",
  "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-ddThh:mm:ssZ",
    "EC2InstanceId": "i-1234567890abcdef0",
    "StartTime": "yyyy-mm-ddThh:mm:ssZ",
    "Cause": "description-text",
    "Origin": "AutoScalingGroup",
    "Destination": "EC2"
  }
}
```