

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

# Beispiele für Ereignisse und Muster zur Instanzaktualisierung
<a name="instance-refresh-eventbridge-events"></a>

Mit Amazon können Sie *Regeln* erstellen EventBridge, die eingehenden *Ereignissen* entsprechen, und diese zur Verarbeitung an *Ziele* weiterleiten.

**Topics**
+ [Instance-Aktualisierungsereignisse](#instance-refresh-events)
+ [Die Aktualisierung der Instanz ersetzt Ereignisse im Lebenszyklus des Root-Volumes](#instance-refresh-rvr-lifecycle-events)

## Instance-Aktualisierungsereignisse
<a name="instance-refresh-events"></a>

Die folgenden Beispiele zeigen Ereignisse für das Instance-Aktualisierungs-Feature. Ereignisse werden auf die bestmögliche Weise ausgegeben.

**Topics**
+ [Prüfpunkt erreicht](#instance-refresh-checkpoint-reached)
+ [Instance-Aktualisierung gestartet](#instance-refresh-started)
+ [Instance-Aktualisierung erfolgreich](#instance-refresh-succeeded)
+ [Instance-Aktualisierung fehlgeschlagen](#instance-refresh-failed)
+ [Instance-Aktualisierung abgebrochen](#instance-refresh-cancelled)
+ [Das Rollback der Instanzaktualisierung wurde gestartet](#instance-refresh-rollback-started)
+ [Das Rollback der Instanzaktualisierung war erfolgreich](#instance-refresh-rollback-succeeded)
+ [Das Rollback der Instanzaktualisierung ist fehlgeschlagen](#instance-refresh-rollback-failed)

### Prüfpunkt erreicht
<a name="instance-refresh-checkpoint-reached"></a>

Während einer Instance-Aktualisierung sendet Amazon EC2 Auto Scaling das folgende Ereignis, wenn die Anzahl der ersetzten Instances den für den Prüfpunkt definierten prozentualen Schwellenwert erreicht. 

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Auto Scaling Instance Refresh Checkpoint Reached",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "InstanceRefreshId": "{{ab00cf8f}}-{{9126}}-{{4f3c}}-{{8010}}-{{dbb8cad6fb86}}",
    "AutoScalingGroupName": "{{my-asg}}",
    "CheckpointPercentage": "{{50}}",
    "CheckpointDelay": "{{300}}"
  }
}
```

### Instance-Aktualisierung gestartet
<a name="instance-refresh-started"></a>

Amazon EC2 Auto Scaling sendet das folgende Ereignis, wenn sich der Zustand einer Instance-Aktualisierung auf `InProgress` ändert.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Auto Scaling Instance Refresh Started",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "InstanceRefreshId": "{{c613620e}}-{{07e2}}-{{4ed2}}-{{a9e2}}-{{ef8258911ade}}",
    "AutoScalingGroupName": "{{my-asg}}"
  }
}
```

### Instance-Aktualisierung erfolgreich
<a name="instance-refresh-succeeded"></a>

Amazon EC2 Auto Scaling sendet das folgende Ereignis, wenn sich der Zustand einer Instance-Aktualisierung auf `Successful` ändert.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Auto Scaling Instance Refresh Succeeded",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "InstanceRefreshId": "{{c613620e}}-{{07e2}}-{{4ed2}}-{{a9e2}}-{{ef8258911ade}}",
    "AutoScalingGroupName": "{{my-asg}}"
  }
}
```

### Instance-Aktualisierung fehlgeschlagen
<a name="instance-refresh-failed"></a>

Amazon EC2 Auto Scaling sendet das folgende Ereignis, wenn sich der Zustand einer Instance-Aktualisierung auf `Failed` ändert.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Auto Scaling Instance Refresh Failed",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "InstanceRefreshId": "{{c613620e}}-{{07e2}}-{{4ed2}}-{{a9e2}}-{{ef8258911ade}}",
    "AutoScalingGroupName": "{{my-asg}}"
  }
}
```

### Instance-Aktualisierung abgebrochen
<a name="instance-refresh-cancelled"></a>

Amazon EC2 Auto Scaling sendet das folgende Ereignis, wenn sich der Zustand einer Instance-Aktualisierung auf `Cancelled` ändert.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Auto Scaling Instance Refresh Cancelled",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "InstanceRefreshId": "{{c613620e}}-{{07e2}}-{{4ed2}}-{{a9e2}}-{{ef8258911ade}}",
    "AutoScalingGroupName": "{{my-asg}}"
  }
}
```

### Das Rollback der Instanzaktualisierung wurde gestartet
<a name="instance-refresh-rollback-started"></a>

Amazon EC2 Auto Scaling sendet das folgende Ereignis, wenn sich der Zustand einer Instance-Aktualisierung auf `RollbackInProgress` ändert.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Auto Scaling Instance Refresh Rollback Started",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "InstanceRefreshId": "{{c613620e}}-{{07e2}}-{{4ed2}}-{{a9e2}}-{{ef8258911ade}}",
    "AutoScalingGroupName": "{{my-asg}}"
  }
}
```

### Das Rollback der Instanzaktualisierung war erfolgreich
<a name="instance-refresh-rollback-succeeded"></a>

Amazon EC2 Auto Scaling sendet das folgende Ereignis, wenn sich der Zustand einer Instance-Aktualisierung auf `RollbackSuccessful` ändert.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Auto Scaling Instance Refresh Rollback Succeeded",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "InstanceRefreshId": "{{c613620e}}-{{07e2}}-{{4ed2}}-{{a9e2}}-{{ef8258911ade}}",
    "AutoScalingGroupName": "{{my-asg}}"
  }
}
```

### Das Rollback der Instanzaktualisierung ist fehlgeschlagen
<a name="instance-refresh-rollback-failed"></a>

Amazon EC2 Auto Scaling sendet das folgende Ereignis, wenn sich der Zustand einer Instance-Aktualisierung auf `Failed` ändert.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Auto Scaling Instance Refresh Rollback Failed",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "InstanceRefreshId": "{{c613620e}}-{{07e2}}-{{4ed2}}-{{a9e2}}-{{ef8258911ade}}",
    "AutoScalingGroupName": "{{my-asg}}"
  }
}
```

## Die Aktualisierung der Instanz ersetzt Ereignisse im Lebenszyklus des Root-Volumes
<a name="instance-refresh-rvr-lifecycle-events"></a>

Wenn Sie Ihrer Auto Scaling-Gruppe Lifecycle-Hooks hinzufügen, sendet Amazon EC2 Auto Scaling Ereignisse an den EventBridge Zeitpunkt, an dem eine Instance in einen Wartestatus übergeht. Weitere Informationen finden Sie unter [Verwenden Sie Lifecycle-Hooks mit Replace Root-Volume](replace-root-volume.md#replace-root-volume-lifecycle-hooks).

Die folgenden Beispiele zeigen Ereignisse, wenn Ihre Auto Scaling Scaling-Gruppe Instances hat, die während einer Instance-Aktualisierung ein Root-Volume ersetzt werden. Ereignisse werden auf die bestmögliche Weise ausgegeben.

**Topics**
+ [Starten Sie die Lebenszyklusaktion „Root-Volume ersetzen](#rvr-start-lifecycle-action)
+ [Lebenszyklusaktion „Root-Volume ersetzen“ beenden](#rvr-end-lifecycle-action)
+ [Beispiel für Ereignismuster](#rvr-event-patterns)

### Starten Sie die Lebenszyklusaktion „Root-Volume ersetzen
<a name="rvr-start-lifecycle-action"></a>

Wenn eine Instance während der Aktualisierung der Instanz für den Austausch des Root-Volumes ausgewählt wird und ihr Status sich auf ändert`ReplacingRootVolume:Wait`.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Instance-terminate Lifecycle Action",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{2021}}-{{01}}-{{13}}T{{00}}:{{12}}:{{37}}.{{214}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "LifecycleActionToken": "{{71514b9d}}-{{6a40}}-{{4b26}}-{{8523}}-{{05e7eEXAMPLE}}",
    "AutoScalingGroupName": "{{my-asg}}",
    "LifecycleHookName": "{{my-terminate-lifecycle-hook}}",
    "EC2InstanceId": "i-{{1234567890abcdef0}}",
    "LifecycleTransition": "autoscaling:EC2_INSTANCE_TERMINATING",
    "NotificationMetadata": "{{additional-info}}",
    "Origin": "AutoScalingGroup",
    "Destination": "AutoScalingGroup",
    "Action": "ReplaceRootVolume"
  }
}
```

### Lebenszyklusaktion „Root-Volume ersetzen“ beenden
<a name="rvr-end-lifecycle-action"></a>

Wenn eine Instance den Austausch des Root-Volumes abgeschlossen hat und sich ihr Status auf ändert`Pending:Wait`.

```
{
  "version": "0",
  "id": "{{12345678}}-{{1234}}-{{1234}}-{{1234}}-{{123456789012}}",
  "detail-type": "EC2 Instance-launch Lifecycle Action",
  "source": "aws.autoscaling",
  "account": "{{123456789012}}",
  "time": "{{2021}}-{{01}}-{{13}}T{{00}}:{{12}}:{{37}}.{{214}}Z",
  "region": "{{us-west-2}}",
  "resources": [
    "{{auto-scaling-group-arn}}"
  ],
  "detail": {
    "LifecycleActionToken": "{{71514b9d}}-{{6a40}}-{{4b26}}-{{8523}}-{{05e7eEXAMPLE}}",
    "AutoScalingGroupName": "{{my-asg}}",
    "LifecycleHookName": "{{my-launch-lifecycle-hook}}",
    "EC2InstanceId": "i-{{1234567890abcdef0}}",
    "LifecycleTransition": "autoscaling:EC2_INSTANCE_LAUNCHING",
    "NotificationMetadata": "{{additional-info}}",
    "Origin": "AutoScalingGroup",
    "Destination": "AutoScalingGroup",
    "Action": "ReplaceRootVolume"
  }
}
```

### Beispiel für Ereignismuster
<a name="rvr-event-patterns"></a>

Der vorherige Abschnitt enthält Beispielereignisse, die von Amazon EC2 Auto Scaling während einer Instance-Aktualisierung mit der Strategie „Root-Volume ersetzen“ ausgelöst wurden. EventBridge Ereignismuster haben dieselbe Struktur wie die Ereignisse, denen sie entsprechen. Das Muster zitiert die Felder, die Sie abgleichen möchten, und liefert die Werte, nach denen Sie suchen. Die folgenden Felder des Ereignisses bilden das in der Regel definierte Ereignismuster, das eine Aktion aufruft:

`"source": "aws.autoscaling"`  
Gibt an, dass das Ereignis aus Amazon EC2 Auto Scaling stammt.

`"detail-type": "{{EC2 Instance-launch Lifecycle Action}}"`  
Identifiziert den Ereignistyp.

`"Action": "{{ReplaceRootVolume}}"`  
Identifiziert, welche Aktion auf der Instanz ausgeführt wird.

Verwenden Sie das folgende Beispielereignismuster, um alle Ereignisse zu erfassen, die mit Instances in Verbindung stehen, die sich darauf vorbereiten, ihre Root-Volumes zu ersetzen:

```
{
  "source": [ "aws.autoscaling" ],
  "detail-type": [ "EC2 Instance-terminate Lifecycle Action" ],
  "detail": {
      "Action": [ "ReplaceRootVolume" ]
   }
}
```

Verwenden Sie das folgende Beispielereignismuster, um alle Ereignisse zu erfassen, die damit zusammenhängen, dass Instances nach Abschluss des Austauschs des Root-Volumes wieder in Betrieb genommen werden:

```
{
  "source": [ "aws.autoscaling" ],
  "detail-type": [ "EC2 Instance-launch Lifecycle Action" ],
  "detail": {
      "Action": [ "ReplaceRootVolume" ]
   }
}
```