

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.

# EventBridge Amazon-Veranstaltungen für Amazon EBS
<a name="ebs-cloud-watch-events"></a>

Amazon EBS sendet Ereignisse an Amazon EventBridge für Aktionen, die auf Volumes und Snapshots ausgeführt werden. Mit können Sie Regeln festlegen EventBridge, die als Reaktion auf diese Ereignisse programmgesteuerte Aktionen auslösen. Sie können beispielsweise eine Regel erstellen, die eine Benachrichtigung an Ihre E-Mailadresse sendet, wenn ein Snapshot für die schnelle Snapshot-Wiederherstellung aktiviert wurde.

Ereignisse in EventBridge werden als JSON-Objekte dargestellt. Die Felder, die für das Ereignis einzigartig sind, sind im Abschnitt "Detail" des JSON-Objekt enthalten. Im Feld "Ereignis" ist der Name des Ereignisses enthalten. Das Feld "Ergebnis" enthält den vollständigen Status der Aktion, die zur Auslösung des Ereignisses führte. Weitere Informationen finden Sie unter [Amazon EventBridge Event Patterns](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) im * EventBridge Amazon-Benutzerhandbuch*.

Weitere Informationen finden Sie unter [Was ist Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) im * EventBridge Amazon-Benutzerhandbuch*.

**Topics**
+ [EBS-Volume-Ereignisse](#volume-events)
+ [Ereignis zur Initialisierung des EBS-Volumens](#volume-initialization-events)
+ [Ereignisse der EBS-Volume-Änderung](#volume-modification-events)
+ [EBS-Snapshot-Ereignisse](#snapshot-events)
+ [Archivereignisse von EBS-Snapshots](#snapshot-archive-events)
+ [EBS – schnelle Snapshot-Wiederherstellungsereignisse](#fast-snapshot-restore-events)
+ [Wird AWS Lambda zur Behandlung von Ereignissen EventBridge verwendet](using_lambda.md)

## EBS-Volume-Ereignisse
<a name="volume-events"></a>

Amazon EBS sendet Ereignisse an den EventBridge Zeitpunkt, an dem die folgenden Volume-Ereignisse eintreten.

**Topics**
+ [createVolume](#create-volume)
+ [deleteVolume](#delete-volume)
+ [attachVolume](#attach-fail-key)
+ [detachVolume](#detach-volume)

### Volume erstellen (createVolume)
<a name="create-volume"></a>

Das `createVolume` Ereignis wird an Ihr AWS Konto gesendet, wenn eine Aktion zur Erstellung eines Volumes abgeschlossen ist. Es wird jedoch nicht gespeichert, protokolliert oder archiviert. Für dieses Ereignis kann als Ergebnis entweder `available` oder `failed` eintreten. Die Erstellung schlägt fehl, wenn ein ungültiger Wert angegeben AWS KMS key wurde, wie in den folgenden Beispielen gezeigt.

**Ereignisdaten**  
Die nachstehende Liste ist ein Beispiel eines JSON-Objekts, das von EBS für ein erfolgreiches Ereignis `createVolume` ausgestellt wird. 

```
{
   "version": "0",
   "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
   "detail-type": "EBS Volume Notification",
   "source": "aws.ec2",
   "account": "{{012345678901}}",
   "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
   "region": "{{us-east-1}}",
   "resources": [
      "arn:aws:ec2:{{us-east-1}}:{{012345678901}}:volume/vol-{{01234567}}"
   ],
   "detail": {
      "result": "available",
      "cause": "",
      "event": "createVolume",
      "request-id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}"
   }
}
```

Die nachstehende Liste ist ein Beispiel eines JSON-Objekts, das von EBS nach einem fehlgeschlagenen Ereignis `createVolume` ausgestellt wird. Die Ursache für den Fehler war ein deaktivierter Verschlüsselung.

```
{
  "version": "0",
  "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}",
  "detail-type": "EBS Volume Notification",
  "source": "aws.ec2",
  "account": "{{012345678901}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{sa-east-1}}",
  "resources": [
    "arn:aws:ec2:{{sa-east-1}}:{{0123456789ab}}:volume/vol-{{01234567}}",
  ],
  "detail": {
    "event": "createVolume",
    "result": "failed",
    "cause": "arn:aws:kms:{{sa-east-1}}:{{0123456789ab}}:key/{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}} is disabled.",
    "request-id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}",
  }
}
```

Nachstehend finden Sie ein Beispiel eines JSON-Objekts, das von EBS nach einem fehlgeschlagenen Ereignis `createVolume` ausgestellt wird. Die Ursache für den Fehler war ein ausstehender Import des Verschlüsselung.

```
{  
  "version": "0",  
  "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}",  
  "detail-type": "EBS Volume Notification",  
  "source": "aws.ec2",  
  "account": "{{012345678901}}",  
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",  
  "region": "{{sa-east-1}}",  
  "resources": [    
    "arn:aws:ec2:{{sa-east-1}}:{{0123456789ab}}:volume/vol-{{01234567}}",  
  ],  
  "detail": {    
    "event": "createVolume",    
    "result": "failed",    
    "cause": "arn:aws:kms:{{sa-east-1}}:{{0123456789ab}}:key/{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}} is pending import.",    
    "request-id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}",  
  }
}
```

### Volume löschen (deleteVolume)
<a name="delete-volume"></a>

Das `deleteVolume` Ereignis wird an Ihr AWS Konto gesendet, wenn eine Aktion zum Löschen eines Volumes abgeschlossen ist. Es wird jedoch nicht gespeichert, protokolliert oder archiviert. Dieses Ereignis hat das Ergebnis `deleted`. Wenn das Löschen nicht abgeschlossen wird, wird das Ereignis nie gesendet.

**Ereignisdaten**  
Die nachstehende Liste ist ein Beispiel eines JSON-Objekts, das von EBS für ein erfolgreiches Ereignis `deleteVolume` ausgestellt wird. 

```
{
   "version": "0",
   "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
   "detail-type": "EBS Volume Notification",
   "source": "aws.ec2",
   "account": "{{012345678901}}",
   "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
   "region": "{{us-east-1}}",
   "resources": [
      "arn:aws:ec2:{{us-east-1}}:{{012345678901}}:volume/vol-{{01234567}}"
   ],
   "detail": {
      "result": "deleted",
      "cause": "",
      "event": "deleteVolume",
      "request-id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}"
   }
}
```

### Volume anhängen oder erneut anhängen (attachVolume, reattachVolume)
<a name="attach-fail-key"></a>

Das `reattachVolume` Ereignis `attachVolume` oder wird an Ihr AWS Konto gesendet, wenn ein Volume an eine Instance angehängt oder erneut angehängt wird. Es wird jedoch nicht gespeichert, protokolliert oder archiviert. Wenn Sie einen Verschlüsselung zur Verschlüsselung eines EBS-Volumes verwenden und der Verschlüsselung ungültig wird, löst EBS ein Ereignis aus, wenn dieser Verschlüsselung später zum Zuweisen oder erneuten Zuweisen an eine Instance verwendet wird, wie in den folgenden Beispielen gezeigt.

**Ereignisdaten**  
Die nachstehende Liste ist ein Beispiel eines JSON-Objekts, das von EBS nach einem fehlgeschlagenen Ereignis `attachVolume` ausgestellt wird. Die Ursache für den Fehler war eine ausstehende Löschung des Verschlüsselung.

**Anmerkung**  
AWS kann nach einer routinemäßigen Serverwartung versuchen, erneut eine Verbindung zu einem Volume herzustellen.

```
{
  "version": "0",    
  "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}",
  "detail-type": "EBS Volume Notification",
  "source": "aws.ec2",
  "account": "{{012345678901}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-east-1}}",
  "resources": [
  "arn:aws:ec2:{{us-east-1}}:{{0123456789ab}}:volume/vol-{{01234567}}",
  "arn:aws:kms:{{us-east-1}}:{{0123456789ab}}:key/{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}"
  ],
  "detail": {
    "event": "attachVolume",
    "result": "failed",
    "cause": "arn:aws:kms:{{us-east-1}}:{{0123456789ab}}:key/{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}} is pending deletion.",
    "request-id": ""
  }
}
```

Die nachstehende Liste ist ein Beispiel eines JSON-Objekts, das von EBS nach einem fehlgeschlagenen Ereignis `reattachVolume` ausgestellt wird. Die Ursache für den Fehler war eine ausstehende Löschung des Verschlüsselung.

```
{
  "version": "0",    
  "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}",
  "detail-type": "EBS Volume Notification",
  "source": "aws.ec2",
  "account": "{{012345678901}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-east-1}}",
  "resources": [
  "arn:aws:ec2:{{us-east-1}}:{{0123456789ab}}:volume/vol-{{01234567}}",
  "arn:aws:kms:{{us-east-1}}:{{0123456789ab}}:key/{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}"
  ],
  "detail": {
    "event": "reattachVolume",
    "result": "failed",
    "cause": "arn:aws:kms:{{us-east-1}}:{{0123456789ab}}:key/{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}} is pending deletion.",
    "request-id": ""
  }
}
```

### Volumen abnehmen (DetachVolume)
<a name="detach-volume"></a>

Das `detachVolume` Ereignis wird an Ihr AWS Konto gesendet, wenn ein Volume von einer Amazon EC2 EC2-Instance getrennt wird.

**Ereignisdaten**  
Im Folgenden finden Sie ein Beispiel für eine erfolgreiche `detachVolume` Veranstaltung.

```
{
  "version":"0",
  "id":"{{2ec37298-1234-e436-70fc-c96b1example}}",
  "detail-type":"AWS API Call via CloudTrail",
  "source":"aws.ec2",
  "account":"{{123456789012}}",
  "time":"{{2024-03-18T16:35:52Z}}",
  "region":"{{us-east-1}}",
  "resources":[],
  "detail":
  {
    "eventVersion":"1.09",
    "userIdentity":
    {
      "type":"IAMUser",
      "principalId":"{{AIDAJT12345SQ2EXAMPLE}}",
      "arn":"{{arn:aws:iam::123456789012:user/administrator"}},
      "accountId":"{{123456789012"}},
      "accessKeyId":"{{AKIAJ67890A6EXAMPLE"}},
      "userName":"{{administrator}}"
    },
    "eventTime":"{{2024-03-18T16:35:52Z}}",
    "eventSource":"ec2.amazonaws.com",
    "eventName":"DetachVolume",
    "awsRegion":"{{us-east-1}}",
    "sourceIPAddress":"{{12.12.123.12}}",
    "userAgent":"aws-cli/2.7.12 Python/3.9.11 Windows/10 exe/AMD64 prompt/off command/ec2.detach-volume",
    "requestParameters":
    {
      "volumeId":"{{vol-072577c46bexample}}",
      "force":false
    },
    "responseElements":
    {
      "requestId":"{{1234513a-6292-49ea-83f8-85e95example}}",
      "volumeId":"{{vol-072577c46bexample}}",
      "instanceId":"{{i-0217f7eb3dexample}}",
      "device":"{{/dev/sdb}}",
      "status":"detaching",
      "attachTime":{{1710776815000}}
    },
    "requestID":"{{1234513a-6292-49ea-83f8-85e95example}}",
    "eventID":"{{1234551d-a15a-43eb-9e69-c983aexample}}",
    "readOnly":false,
    "eventType":"AwsApiCall",
    "managementEvent":true,
    "recipientAccountId":"{{123456789012}}",
    "eventCategory":"Management",
    "tlsDetails":
    {
      "tlsVersion":"TLSv1.3",
      "cipherSuite":"TLS_AES_128_GCM_SHA256",
      "clientProvidedHostHeader":"{{ec2.us-east-1.amazonaws.com}}"
    }
  }
}
```

## Ereignis zur Initialisierung des EBS-Volumens
<a name="volume-initialization-events"></a>

Wenn Sie ein Amazon EBS-Volume aus einem Snapshot erstellen und die Standard-Volume-Initialisierungsrate oder eine Amazon EBS-Bereitstellungsrate für die Volumeninitialisierung verwenden, wird das `initializeVolume` Ereignis innerhalb von fünf Minuten nach Abschluss der Volume-Initialisierung an Ihr AWS Konto gesendet. Weitere Informationen finden Sie unter [Verwenden Sie eine von Amazon EBS bereitgestellte Rate für die Volumeninitialisierung](initalize-volume.md#volume-initialization-rate).

Das Ereignis wird **nicht** für Volumes gesendet, die mit Fast Snapshot Restore erstellt wurden.

**Wichtig**  
`completionTime`gibt an, wann wir das Ereignis generiert haben. Da das Ereignis innerhalb von 5 Minuten nach Abschluss der Initialisierung generiert wird, `completionTime` kann dies bis zu fünf Minuten nach Abschluss der Initialisierung geschehen.

Es folgt ein Beispielereignis.

```
{
   "version": "0",
   "id": "{{01234567-0123-0123-0123-012345678901}}",
   "detail-type": "EBS Volume Notification",
   "source": "aws.ec2",
   "account": "{{012345678901}}",
   "time": "{{yyyy-mm-ddThh:mm:ssZ}}",
   "region": "{{us-east-1}}",
   "resources": [
      "{{arn:aws:ec2:us-east-1:012345678901:volume/vol-01234567890abcdef}}"
   ],
   "detail": {
      "event": " initializeVolume",
      "result": "succeeded",
      "completionTime": "{{yyyy-mm-ddThh:mm:ssZ}}",
      "request-id": "{{01234567-0123-0123-0123-0123456789ab}}"
   }
}
```

## Ereignisse der EBS-Volume-Änderung
<a name="volume-modification-events"></a>

Amazon EBS sendet `modifyVolume` Ereignisse an, EventBridge wenn ein Volume geändert wird. Es wird jedoch nicht gespeichert, protokolliert oder archiviert.

```
{
   "version": "0",
   "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
   "detail-type": "EBS Volume Notification",
   "source": "aws.ec2",
   "account": "{{012345678901}}",
   "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
   "region": "{{us-east-1}}",
   "resources": [
      "arn:aws:ec2:{{us-east-1}}:{{012345678901}}:volume/vol-{{03a55cf56513fa1b6}}"
   ],
   "detail": {
      "result": "{{optimizing}}",
      "cause": "",
      "event": "modifyVolume",
      "request-id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{0123456789ab}}"
   }
}
```

## EBS-Snapshot-Ereignisse
<a name="snapshot-events"></a>

Amazon EBS sendet Ereignisse an den EventBridge Zeitpunkt, an dem die folgenden Volume-Ereignisse eintreten.

**Topics**
+ [createSnapshot](#create-snapshot-complete)
+ [createSnapshots](#create-snapshots-complete)
+ [copySnapshot](#copy-snapshot-complete)
+ [shareSnapshot](#snapshot-shared)

### Snapshot erstellen (createSnapshot)
<a name="create-snapshot-complete"></a>

Das `createSnapshot` Ereignis wird an Ihr AWS Konto gesendet, wenn eine Aktion zur Erstellung eines Snapshots abgeschlossen ist. Es wird jedoch nicht gespeichert, protokolliert oder archiviert. Für dieses Ereignis kann als Ergebnis entweder `succeeded` oder `failed` eintreten.

**Ereignisdaten**  
Die nachstehende Liste ist ein Beispiel eines JSON-Objekts, das von EBS für ein erfolgreiches Ereignis `createSnapshot` ausgestellt wird. Im Abschnitt `detail` enthält das Feld `source` die ARN des Quellvolumes. Die Felder `startTime` und `endTime` zeigen an, wann die Erstellung des Snapshot begann und abgeschlossen war.

```
{
  "version": "0",
  "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
  "detail-type": "EBS Snapshot Notification",
  "source": "aws.ec2",
  "account": "{{012345678901}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-east-1}}",
  "resources": [
     "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}"
  ],
  "detail": {
    "event": "createSnapshot",
    "result": "succeeded",
    "cause": "",
    "request-id": "",
    "snapshot_id": "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}",
    "source": "arn:aws:ec2::{{us-west-2}}:volume/vol-{{01234567}}",
    "startTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "endTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z"  }
}
```

### Snapshots erstellen (createSnapshots)
<a name="create-snapshots-complete"></a>

Das `createSnapshots` Ereignis wird an Ihr AWS Konto gesendet, wenn eine Aktion zur Erstellung eines Snapshots mit mehreren Volumes abgeschlossen ist. Für dieses Ereignis kann als Ergebnis entweder `succeeded` oder `failed` eintreten.

**Ereignisdaten**  
Die nachstehende Liste ist ein Beispiel eines JSON-Objekts, das von EBS für ein erfolgreiches Ereignis `createSnapshots` ausgestellt wird. In `detail` diesem Abschnitt enthält das `source` Feld die Quell-Volumes ARNs des Snapshot-Sets mit mehreren Volumes. Die Felder `startTime` und `endTime` zeigen an, wann die Erstellung des Snapshot begann und abgeschlossen war.

```
{
  "version": "0",
  "id": "{{01234567-0123-0123-0123-012345678901}}",
  "detail-type": "EBS Multi-Volume Snapshots Completion Status",
  "source": "aws.ec2",
  "account": "{{012345678901}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-east-1}}",
  "resources": [
    "arn:aws:ec2::{{us-east-1}}:snapshot/snap-{{01234567}}",
    "arn:aws:ec2::{{us-east-1}}:snapshot/snap-{{012345678}}"
  ],
  "detail": {
    "event": "createSnapshots",
    "result": "succeeded",
    "cause": "",
    "request-id": "",
    "startTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "endTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "snapshots": [
      {
        "snapshot_id": "arn:aws:ec2::{{us-east-1}}:snapshot/snap-{{01234567}}",
        "source": "arn:aws:ec2::{{us-east-1}}:volume/vol-{{01234567}}",
        "status": "completed"
      },
      {
        "snapshot_id": "arn:aws:ec2::{{us-east-1}}:snapshot/snap-{{012345678}}",
        "source": "arn:aws:ec2::{{us-east-1}}:volume/vol-{{012345678}}",
        "status": "completed"
      }
    ]
  }
}
```

Die nachstehende Liste ist ein Beispiel eines JSON-Objekts, das von EBS nach einem fehlgeschlagenen Ereignis `createSnapshots` ausgestellt wird. Der Fehler wurde verursacht, da ein oder mehrere Snapshots für den Multi-Volume-Snapshot nicht abgeschlossen werden konnten. Die Werte von `snapshot_id` entsprechen den ARNs fehlgeschlagenen Snapshots. `startTime`und `endTime` geben an, wann die Aktion „Snapshots erstellen“ gestartet und beendet wurde.

```
{
  "version": "0",
  "id": "{{01234567-0123-0123-0123-012345678901}}",
  "detail-type": "EBS Multi-Volume Snapshots Completion Status",
  "source": "aws.ec2",
  "account": "{{012345678901}}",
  "time": "{{yyyy-mm-ddThh:mm:ssZ}}",
  "region": "{{us-east-1}}",
  "resources": [
    "arn:aws:ec2::{{us-east-1}}:snapshot/{{snap-01234567}}",
    "arn:aws:ec2::{{us-east-1}}:snapshot/{{snap-012345678}}"
  ],
"detail": {
    "event": "createSnapshots",
    "result": "failed",
    "cause": "Snapshot snap-01234567 is in status error",
   "request-id": "",
    "startTime": "{{yyyy-mm-ddThh:mm:ssZ}}",
    "endTime": "{{yyyy-mm-ddThh:mm:ssZ}}",
    "snapshots": [
      {
        "snapshot_id": "arn:aws:ec2::{{us-east-1}}:snapshot/{{snap-01234567}}",
        "source": "arn:aws:ec2::{{us-east-1}}:volume/{{vol-01234567}}",
        "status": "error"
      },
      {
        "snapshot_id": "arn:aws:ec2::{{us-east-1}}:snapshot/{{snap-012345678}}",
        "source": "arn:aws:ec2::{{us-east-1}}:volume/{{vol-012345678}}",
        "status": "error"
      }
    ]
  }
}
```

### Snapshot kopieren (copySnapshot)
<a name="copy-snapshot-complete"></a>

Das `copySnapshot` Ereignis wird an Ihr AWS Konto gesendet, wenn eine Aktion zum Kopieren eines Snapshots abgeschlossen ist. Es wird jedoch nicht gespeichert, protokolliert oder archiviert. Für dieses Ereignis kann als Ergebnis entweder `succeeded` oder `failed` eintreten.

In dem `detail` Abschnitt `source` befindet sich der ARN des Quell-Snapshots und `snapshot_id` der ARN der Snapshot-Kopie. `startTime`und `endTime` geben an, wann der Kopiervorgang gestartet und beendet wurde. `incremental`gibt an, ob es sich bei der Snapshot-Kopie um einen inkrementellen Snapshot (`true`) oder einen vollständigen Snapshot (`false`) handelt. `transferType`gibt an, ob der Snapshot-Kopiervorgang ein Standardkopiervorgang oder ein zeitbasierter Kopiervorgang war. Weitere Informationen finden Sie unter [Zeitbasierte Kopien für Amazon EBS-Snapshots und EBS-gestützte Kopien AMIs](time-based-copies.md).

Wenn Sie den Snapshot regionsübergreifend kopieren, wird das Ereignis in der Zielregion ausgegeben.

**Szenario 1: Der standardmäßige Snapshot-Kopiervorgang ist abgeschlossen**  
Im Folgenden finden Sie ein Beispiel für ein Ereignis, das an Ihr Konto gesendet wird, wenn ein standardmäßiger Snapshot-Kopiervorgang erfolgreich abgeschlossen wurde. Beachten Sie, dass `transferType` gleich `standard` ist.

```
{
  "version": "0",
  "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
  "detail-type": "EBS Snapshot Notification",
  "source": "aws.ec2",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-east-1}}",
  "resources": [
    "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}"
  ],
  "detail": {
    "event": "copySnapshot",
    "result": "succeeded",
    "cause": "",
    "request-id": "",
    "snapshot_id": "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}",
    "source": "arn:aws:ec2::{{eu-west-1}}:snapshot/snap-{{76543210}}",
    "startTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "endTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "incremental": "true",
    "transferType": "standard"
  }
}
```

**Szenario 2: Der zeitbasierte Snapshot-Kopiervorgang wird innerhalb der Abschlussdauer abgeschlossen**  
Im Folgenden finden Sie ein Beispiel für ein Ereignis, das an Ihr Konto gesendet wird, wenn ein zeitbasierter Snapshot-Kopiervorgang innerhalb seiner Abschlussdauer abgeschlossen wird. Beachten Sie, dass `transferType` dies `time-based` darauf hinweist, dass es sich um einen zeitbasierten Snapshot-Kopiervorgang handelte. `completionDurationStartTime`gibt an, wann die Abschlussdauer begonnen hat.

```
{
  "version": "0",
  "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
  "detail-type": "EBS Snapshot Notification",
  "source": "aws.ec2",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-east-1}}",
  "resources": [
    "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}"
  ],
  "detail": {
    "event": "copySnapshot",
    "result": "succeeded",
    "cause": "",
    "request-id": "",
    "startTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "endTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "snapshot_id": "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}",
    "source": "arn:aws:ec2::{{eu-west-1}}:snapshot/snap-{{76543210}}",
    "incremental": "true", 
    "completionDurationStartTime":"2024-11-16T06:27:33.816Z",
    "transferType": "time-based"
  }
}
```

**Szenario 3: Der zeitbasierte Snapshot-Kopiervorgang wird abgeschlossen, die angeforderte Abschlussdauer wird jedoch nicht eingehalten**  
Wenn ein zeitbasierter Snapshot-Kopiervorgang abgeschlossen wird, die angeforderte Abschlussdauer jedoch nicht eingehalten wird, werden zwei Ereignisse an Ihr Konto CloudWatch gesendet. Im Folgenden finden Sie Beispiele für diese Ereignisse.
+ Das erste Ereignis wird an Ihr Konto gesendet, sobald die Bearbeitungsdauer überschritten wird, auch wenn der Kopiervorgang noch nicht abgeschlossen ist. Für dieses Ereignis `detail-type` ist das der `EBS Copy Snapshot Missed Completion Duration` Fall und `missedCompletionDurationCause` gibt den Grund an.

  ```
  {
   "version":"0",
   "id":"{{fd90eb95-0938-e02c-cf55-b81363b8ac12}}",
   "detail-type":"EBS Copy Snapshot Missed Completion Duration",
   "source":"aws.ec2",
   "account":"{{123456789012}}",
   "time":"{{2024-11-19T18:17:08Z}}",
   "region":"{{us-east-1}}",
   "resources": ["arn:aws:ec2:{{us-east-1}}:{{123456789012}}:snapshot/{{snap-01234567890abcedf}}"],
   "detail":{
     "event":"copySnapshot",
     "missedCompletionDurationCause":"{{Snapshot copy was not able to meet the specified completion duration because your snapshot copy operation throughput quota was exceeded.}}",
     "snapshot_id":"arn:aws:ec2:{{us-east-1}}:{{123456789012}}:snapshot/{{snap-01234567890abcedf}}",
     "source":"arn:aws:ec2:{{us-east-1}}:{{123456789012}}:snapshot/{{snap-00987654321fedcba}}",
     "startTime": "{{Sun Nov 24 22:32:55 UTC 2024}}",
     "transferType": "time-based"
     }
  }
  ```
+ Das zweite Ereignis wird erst an Ihr Konto gesendet, wenn der Snapshot abgeschlossen ist. Das Ereignis beinhaltet`missedCompletionDurationCause`, was den Grund angibt.

  ```
  {
    "version": "0",
    "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
    "detail-type": "EBS Snapshot Notification",
    "source": "aws.ec2",
    "account": "{{123456789012}}",
    "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "region": "{{us-east-1}}",
    "resources": [
      "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}"
    ],
    "detail": {
      "event": "copySnapshot",
      "result": "succeeded",
      "cause": "",
      "request-id": "",
      "startTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
      "endTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
      "snapshot_id": "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}",
      "source": "arn:aws:ec2::{{eu-west-1}}:snapshot/snap-{{76543210}}",
      "incremental": "true", 
      "completionDurationStartTime":"2024-11-16T06:27:33.816Z",
      "missedCompletionDurationCause":"{{Snapshot copy was not able to meet the specified completion duration because your snapshot copy operation throughput quota was exceeded.}}",
      "transferType": "time-based"
    }
  }
  ```

**Szenario 4: Der Snapshot-Kopiervorgang schlägt fehl**  
Im Folgenden finden Sie ein Beispiel für ein Ereignis, das an Ihr Konto gesendet wird, wenn ein Snapshot-Kopiervorgang fehlschlägt. Beachten Sie, dass `result` dies `failed` darauf hinweist, dass der Vorgang fehlgeschlagen ist.

```
{
  "version": "0",
  "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
  "detail-type": "EBS Snapshot Notification",
  "source": "aws.ec2",
  "account": "{{123456789012}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-east-1}}",
  "resources": [
    "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}"
  ],
  "detail": {
    "event": "copySnapshot",
    "result": "failed",
    "cause": "Source snapshot ID is not valid",
    "request-id": "",
    "snapshot_id": "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}",
    "source": "arn:aws:ec2::{{eu-west-1}}:snapshot/snap-{{76543210}}",
    "startTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "endTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z"
  }
}
```

### Snapshot freigeben (shareSnapshot)
<a name="snapshot-shared"></a>

Das `shareSnapshot` Ereignis wird an Ihr AWS Konto gesendet, wenn ein anderes Konto einen Snapshot mit diesem teilt. Es wird jedoch nicht gespeichert, protokolliert oder archiviert. Das Ergebnis ist immer `succeeded`.

**Ereignisdaten**  
Es folgt ein Beispiel eines JSON-Objekts, das nach einem abgeschlossenen `shareSnapshot`-Ereignis von EBS ausgegeben wird. In `detail` diesem Abschnitt `source` ist der Wert von die AWS Kontonummer des Benutzers, der den Snapshot mit Ihnen geteilt hat. `startTime`und `endTime` geben an, wann die Aktion „Snapshot teilen“ gestartet und beendet wurde. Das Ereignis `shareSnapshot` wird nur dann gesendet, wenn ein privater Snapshot mit einem anderen Benutzer geteilt wird. Durch das Teilen eines öffentlichen Snapshot wird das Ereignis noch nicht ausgelöst.

```
{
  "version": "0",
  "id": "{{01234567}}-{{01234}}-{{0123}}-{{0123}}-{{012345678901}}",
  "detail-type": "EBS Snapshot Notification",
  "source": "aws.ec2",
  "account": "{{012345678901}}",
  "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
  "region": "{{us-east-1}}",
  "resources": [
    "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}"
  ],
  "detail": {
    "event": "shareSnapshot",
    "result": "succeeded",
    "cause": "",
    "request-id": "",
    "snapshot_id": "arn:aws:ec2::{{us-west-2}}:snapshot/snap-{{01234567}}",
    "source": {{012345678901}},
    "startTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
    "endTime": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z"
  }
}
```

## Archivereignisse von EBS-Snapshots
<a name="snapshot-archive-events"></a>

Amazon EBS sendet Ereignisse im Zusammenhang mit Snapshot-Archivierungsaktionen aus. Weitere Informationen finden Sie unter [Überwachen Sie die Amazon EBS-Snapshot-Archivierung mithilfe von Ereignissen CloudWatch](monitor-snapshot-archiving.md).

## EBS – schnelle Snapshot-Wiederherstellungsereignisse
<a name="fast-snapshot-restore-events"></a>

Amazon EBS sendet Ereignisse an den EventBridge Zeitpunkt, an dem sich der Status der schnellen Snapshot-Wiederherstellung für einen Snapshot ändert. Ereignisse werden auf bestmögliche Weise ausgegeben.

Im Folgenden finden Sie Beispieldaten für dieses Ereignis.

```
{
   "version": "0",
   "id": "{{01234567}}-{{0123}}-{{0123}}-{{0123}}-{{012345678901}}",
   "detail-type": "EBS Fast Snapshot Restore State-change Notification",
   "source": "aws.ec2",
   "account": "{{123456789012}}",
   "time": "{{yyyy}}-{{mm}}-{{dd}}T{{hh}}:{{mm}}:{{ss}}Z",
   "region": "{{us-east-1}}",
   "resources": [
      "arn:aws:ec2:{{us-east-1}}::snapshot/snap-{{03a55cf56513fa1b6}}"
   ],
   "detail": {
      "snapshot-id": "snap-{{1234567890abcdef0}}",
      "state": "{{optimizing}}",
      "zone": "{{us-east-1a}}",
      "message": "{{Client.UserInitiated - Lifecycle state transition}}",
   }
}
```

Die möglichen Werte für `state` sind `enabling`, `optimizing`, `enabled`, `disabling` und `disabled`.

Die möglichen Werte für `message` sind wie folgt:

`Client.InvalidSnapshot.InvalidState - The requested snapshot transitioned to an invalid state (Error)`  
Eine Anfrage zur Aktivierung der schnellen Snapshot-Wiederherstellung ist fehlgeschlagen und der Status hat zu `disabling` oder `disabled` gewechselt. Die schnelle Snapshot-Wiederherstellung kann für diesen Snapshot nicht aktiviert werden.

`Client.UserInitiated`  
Der Status hat erfolgreich zu `enabling` oder `disabling` gewechselt.

`Client.UserInitiated - Lifecycle state transition`  
Der Status hat erfolgreich zu `optimizing`, `enabled` oder `disabled` gewechselt.

`Server.InsufficientCapacity - There was insufficient capacity available to satisfy the request`  
Eine Anfrage zur Aktivierung der schnellen Snapshot-Wiederherstellung ist aufgrund von unzureichender Kapazität fehlgeschlagen und der Status hat zu `disabling` oder `disabled` gewechselt. Warten Sie und versuchen Sie es dann erneut.

`Server.InternalError - An internal error caused the operation to fail`  
Eine Anfrage zur Aktivierung der schnellen Snapshot-Wiederherstellung ist aufgrund eines internen Fehlers fehlgeschlagen und der Status hat zu `disabling` oder `disabled` gewechselt. Warten Sie und versuchen Sie es dann erneut.

`Client.InvalidSnapshot.InvalidState - The requested snapshot was deleted or access permissions were revoked`  
Der Status für die schnelle Snapshot-Wiederherstellung für den Snapshot hat zu `disabling` oder `disabled` gewechselt, weil der Snapshot vom Snapshot-Besitzer gelöscht oder die Freigabe aufgehoben wurde. Die schnelle Snapshot-Wiederherstellung kann nicht für einen Snapshot aktiviert werden, der gelöscht wurde oder nicht mehr für Sie freigegeben ist.