Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# EventBridge Événements Amazon pour Amazon EBS
Amazon EBS envoie des événements à Amazon EventBridge pour les actions effectuées sur les volumes et les instantanés. Avec EventBridge, vous pouvez établir des règles qui déclenchent des actions programmatiques en réponse à ces événements. Par exemple, vous pouvez créer une règle qui envoie une notification sur votre adresse électronique lorsqu’un instantané est activé pour une restauration rapide des instantanés.
Les événements dans EventBridge sont représentés sous forme d'objets JSON. Les champs spécifiques à l’événement figurent dans la section « détail » de l’objet JSON. Le champ « événement » contient le nom de l’événement. Le champ « résultat » contient l’état terminé de l’action qui déclenche l’événement. Pour plus d'informations, consultez les [modèles EventBridge d'événements Amazon](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) dans le *guide de EventBridge l'utilisateur Amazon*.
Pour plus d'informations, consultez [Qu'est-ce qu'Amazon EventBridge ?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) dans le *guide de EventBridge l'utilisateur Amazon*.
**Topics**
+ [Événements de volume EBS](#volume-events)
+ [Événement d'initialisation du volume EBS](#volume-initialization-events)
+ [Événements de modification de volume EBS](#volume-modification-events)
+ [Événements d’instantané EBS](#snapshot-events)
+ [Événements d’archivage d’instantanés EBS](#snapshot-archive-events)
+ [Événements de restauration d’instantané rapide EBS](#fast-snapshot-restore-events)
+ [Utilisation AWS Lambda pour gérer les EventBridge événements](using_lambda.md)
## Événements de volume EBS
Amazon EBS envoie des événements au EventBridge moment où les événements de volume suivants se produisent.
**Topics**
+ [createVolume](#create-volume)
+ [deleteVolume](#delete-volume)
+ [attachVolume](#attach-fail-key)
+ [detachVolume](#detach-volume)
### Créer un volume (createVolume)
L'`createVolume`événement est envoyé à votre AWS compte lorsqu'une action de création de volume est terminée. Cependant, il n'est ni enregistré, ni enregistré, ni archivé. Cet événement peut avoir le résultat `available` ou `failed`. La création échouera si une valeur non valide AWS KMS key a été fournie, comme indiqué dans les exemples ci-dessous.
**Données d’événement**
La liste ci-dessous est l’exemple d’un objet JSON émis par EBS pour un événement `createVolume` réussi.
```
{
"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}}"
}
}
```
La liste ci-dessous est l’exemple d’un objet JSON émis par EBS après un événement `createVolume` ayant échoué. La cause de l’échec est attribuée à une clé KMS désactivée.
```
{
"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}}",
}
}
```
Voici un exemple d’objet JSON émis par EBS après un événement `createVolume` ayant échoué. La cause de l’échec est attribuée à l’importation en attente d’une clé KMS.
```
{
"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}}",
}
}
```
### Supprimer le volume (deleteVolume)
L'`deleteVolume`événement est envoyé à votre AWS compte lorsqu'une action de suppression d'un volume est terminée. Cependant, il n'est ni enregistré, ni enregistré, ni archivé. Le résultat de cet événement est `deleted`. Si la suppression ne se termine pas, l’événement n’est pas envoyé.
**Données d’événement**
La liste ci-dessous est l’exemple d’un objet JSON émis par EBS pour un événement `deleteVolume` réussi.
```
{
"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}}"
}
}
```
### Attacher ou réattacher le volume (attachVolume, reattachVolume)
L'`reattachVolume`événement `attachVolume` or est envoyé à votre AWS compte lorsqu'un volume est attaché ou rattaché à une instance. Cependant, il n'est ni enregistré, ni enregistré, ni archivé. Si vous utilisez une clé KMS pour chiffrer un volume EBS et que la clé KMS devient non valide, EBS émet un événement si cette clé KMS est utilisée ultérieurement pour l’attachement ou le rattachement d’une instance, comme illustré dans les exemples ci-dessous.
**Données d’événement**
La liste ci-dessous est l’exemple d’un objet JSON émis par EBS après un événement `attachVolume` ayant échoué. La cause de l’échec est attribuée à la suppression en attente d’une clé KMS.
**Note**
AWS peut tenter de se reconnecter à un volume après une maintenance de routine du serveur.
```
{
"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": ""
}
}
```
La liste ci-dessous est l’exemple d’un objet JSON émis par EBS après un événement `reattachVolume` ayant échoué. La cause de l’échec est attribuée à la suppression en attente d’une clé KMS.
```
{
"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": ""
}
}
```
### Détacher le volume (DetachVolume)
L'`detachVolume`événement est envoyé à votre AWS compte lorsqu'un volume est détaché d'une instance Amazon EC2.
**Données d’événement**
Voici un exemple d'`detachVolume`événement réussi.
```
{
"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}}"
}
}
}
```
## Événement d'initialisation du volume EBS
Lorsque vous créez un volume Amazon EBS à partir d'un instantané et que vous utilisez le taux d'initialisation du volume par défaut ou un taux provisionné Amazon EBS pour l'initialisation du volume, l'`initializeVolume`événement est envoyé à votre AWS compte dans les cinq minutes suivant la fin de l'initialisation du volume. Pour de plus amples informations, veuillez consulter [Utiliser un débit provisionné par Amazon EBS pour l'initialisation du volume](initalize-volume.md#volume-initialization-rate).
L'événement **n'est pas** envoyé pour les volumes créés à l'aide de Fast Snapshot Restore.
**Important**
`completionTime`reflète la date à laquelle nous avons généré l'événement. Étant donné que l'événement est généré dans les 5 minutes suivant la fin de l'initialisation, il `completionTime` peut se produire jusqu'à cinq minutes après la fin de l'initialisation.
Voici un exemple d'événement.
```
{
"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}}"
}
}
```
## Événements de modification de volume EBS
Amazon EBS envoie `modifyVolume` des événements EventBridge lorsqu'un volume est modifié. Cependant, il n'est ni enregistré, ni enregistré, ni archivé.
```
{
"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}}"
}
}
```
## Événements d’instantané EBS
Amazon EBS envoie des événements au EventBridge moment où les événements de volume suivants se produisent.
**Topics**
+ [createSnapshot](#create-snapshot-complete)
+ [createSnapshots](#create-snapshots-complete)
+ [copySnapshot](#copy-snapshot-complete)
+ [shareSnapshot](#snapshot-shared)
### Créer un instantané (createSnapshot)
L'`createSnapshot`événement est envoyé à votre AWS compte lorsqu'une action visant à créer un instantané est terminée. Cependant, il n'est ni enregistré, ni enregistré, ni archivé. Cet événement peut avoir le résultat `succeeded` ou `failed`.
**Données d’événement**
La liste ci-dessous est l’exemple d’un objet JSON émis par EBS pour un événement `createSnapshot` réussi. Dans la section `detail`, le champ `source` contient l’ARN du volume source. Les champs `startTime` et `endTime` indiquent le moment où la création de l'instantané a commencé et est terminée.
```
{
"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" }
}
```
### Créer des instantanés (createSnapshots)
L'`createSnapshots`événement est envoyé à votre AWS compte lorsqu'une action visant à créer un instantané en plusieurs volumes est terminée. Cet événement peut avoir le résultat `succeeded` ou `failed`.
**Données d’événement**
La liste ci-dessous est l’exemple d’un objet JSON émis par EBS pour un événement `createSnapshots` réussi. Dans la `detail` section, le `source` champ contient les volumes sources ARNs de l'ensemble de clichés multi-volumes. Les champs `startTime` et `endTime` indiquent le moment où la création de l’instantané a commencé et est terminée.
```
{
"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"
}
]
}
}
```
La liste ci-dessous est l’exemple d’un objet JSON émis par EBS après un événement `createSnapshots` ayant échoué. La cause de l’échec correspondait à un ou plusieurs instantanés de l’ensemble d’instantanés multi-volumes qui n’ont pas pu aboutir. Les valeurs de `snapshot_id` sont celles ARNs des instantanés ayant échoué. `startTime`et indiquent `endTime` le début et la fin de l'action de création d'instantanés.
```
{
"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"
}
]
}
}
```
### Copier un instantané (copySnapshot)
L'`copySnapshot`événement est envoyé à votre AWS compte lorsqu'une action de copie d'un instantané est terminée. Cependant, il n'est ni enregistré, ni enregistré, ni archivé. Cet événement peut avoir le résultat `succeeded` ou `failed`.
Dans `detail` cette section, `source` il y a l'ARN de l'instantané source et `snapshot_id` l'ARN de la copie du cliché. `startTime`et `endTime` indiquez le début et la fin de l'opération de copie. `incremental`indique si la copie d'instantané est un instantané incrémentiel (`true`) ou un instantané complet (`false`). `transferType`indique si l'opération de copie instantanée était une opération de copie standard ou une opération de copie basée sur le temps. Pour de plus amples informations, veuillez consulter [Copies temporelles pour les instantanés Amazon EBS et sauvegardées par EBS AMIs](time-based-copies.md).
Si vous copiez l’instantané d’une région à l’autre, l’événement est émis dans la région de destination.
**Scénario 1 : Fin de l'opération de copie instantanée standard**
Voici un exemple d'événement envoyé à votre compte lorsqu'une opération de copie instantanée standard se termine avec succès. Notez que `transferType` est `standard`.
```
{
"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"
}
}
```
**Scénario 2 : L'opération de copie instantanée basée sur le temps s'achève pendant la durée d'achèvement**
Voici un exemple d'événement envoyé à votre compte lorsqu'une opération de copie instantanée basée sur le temps s'achève dans les délais impartis. Notez que cela `transferType` indique qu'il s'agissait d'une opération de copie instantanée basée sur le temps. `time-based` `completionDurationStartTime`indique à quel moment la durée d'achèvement a commencé.
```
{
"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"
}
}
```
**Scénario 3 : L'opération de copie instantanée basée sur le temps se termine mais n'atteint pas la durée d'achèvement demandée**
Lorsqu'une opération de copie instantanée basée sur le temps se termine, mais n'atteint pas la durée d'achèvement demandée, deux CloudWatch événements sont envoyés à votre compte. Voici des exemples de ces événements.
+ Le premier événement est envoyé sur votre compte dès que le délai d'exécution est dépassé, même si l'opération de copie est toujours en cours. Cet événement existe et `EBS Copy Snapshot Missed Completion Duration` en `missedCompletionDurationCause` fournit la raison. `detail-type`
```
{
"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"
}
}
```
+ Le deuxième événement n'est envoyé à votre compte qu'une fois l'instantané terminé. L'événement inclut`missedCompletionDurationCause`, ce qui en fournit la raison.
```
{
"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"
}
}
```
**Scénario 4 : échec de l'opération de copie instantanée**
Voici un exemple d'événement envoyé à votre compte en cas d'échec d'une opération de copie instantanée. Notez que `result` cela `failed` indique que l'opération a échoué.
```
{
"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"
}
}
```
### Partager un instantané (shareSnapshot)
L'`shareSnapshot`événement est envoyé à votre AWS compte lorsqu'un autre compte partage un instantané avec celui-ci. Cependant, il n'est ni enregistré, ni enregistré, ni archivé. Le résultat est toujours `succeeded`.
**Données d’événement**
Ce qui suit est un exemple d’objet JSON émis par EBS après un événement `shareSnapshot` terminé. Dans la `detail` section, la valeur de `source` est le numéro de AWS compte de l'utilisateur qui a partagé l'instantané avec vous. `startTime`et indiquent `endTime` le début et la fin de l'action de partage d'instantanés. L’événement `shareSnapshot` est émis uniquement lorsqu’un instantané privé est partagé avec un autre utilisateur. Le partage d’un instantané public ne déclenche pas l’événement.
```
{
"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"
}
}
```
## Événements d’archivage d’instantanés EBS
Amazon EBS émet des événements liés aux actions d’archivage des instantanés. Pour plus d’informations, voir [Surveillez l'archivage des instantanés Amazon EBS à l'aide d'Events CloudWatch](monitor-snapshot-archiving.md).
## Événements de restauration d’instantané rapide EBS
Amazon EBS envoie des événements EventBridge lorsque l'état de restauration rapide d'un instantané change. Les événements sont générés dans la mesure du possible.
Voici un exemple de données pour cet événement.
```
{
"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}}",
}
}
```
Les valeurs possibles pour `state` sont `enabling`, `optimizing`, `enabled`, `disabling` et `disabled`.
Les valeurs possibles pour `message` sont les suivantes :
`Client.InvalidSnapshot.InvalidState - The requested snapshot transitioned to an invalid state (Error)`
Une demande d’activation de la fonction de restauration d’instantané rapide a échoué et l’état est passé à `disabling` ou `disabled`. La fonction de restauration d’instantané rapide ne peut pas être activée pour cet instantané.
`Client.UserInitiated`
L’état est passé avec succès à `enabling` ou `disabling`.
`Client.UserInitiated - Lifecycle state transition`
L’état est passé avec succès à `optimizing`, `enabled` ou `disabled`.
`Server.InsufficientCapacity - There was insufficient capacity available to satisfy the request`
Une demande d’activation de la fonction de restauration d’instantané rapide a échoué en raison d’une capacité insuffisante et l’état est passé à `disabling` ou `disabled`. Attendez, puis recommencez.
`Server.InternalError - An internal error caused the operation to fail`
Une demande d’activation de la fonction de restauration d’instantané rapide a échoué en raison d’une erreur interne et l’état est passé à `disabling` ou `disabled`. Attendez, puis recommencez.
`Client.InvalidSnapshot.InvalidState - The requested snapshot was deleted or access permissions were revoked`
L’état de restauration d’instantané rapide est passé à `disabling` ou `disabled` parce que l’instantané a été supprimé ou non partagé par son propriétaire. La restauration d’instantané rapide ne peut pas être activée pour un instantané qui a été supprimé ou qui n’est plus partagé avec vous.