As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# EventBridge Eventos da Amazon para o Amazon EBS
O Amazon EBS envia eventos para a Amazon EventBridge para ações realizadas em volumes e snapshots. Com EventBridge, você pode estabelecer regras que acionam ações programáticas em resposta a esses eventos. Por exemplo, você pode criar uma regra que envia uma notificação para seu e-mail quando um snapshot é habilitado para restauração rápida de snapshot.
Os eventos em EventBridge são representados como objetos JSON. Os campos que são exclusivos do evento estão contidos na seção "detalhes" do objeto JSON. O campo "evento" contém o nome do evento. O campo "resultados" contém o status concluído da ação que acionou o evento. Para obter mais informações, consulte os [padrões de EventBridge eventos](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-event-patterns.html) da *Amazon no Guia EventBridge do usuário da Amazon*.
Para obter mais informações, consulte [O que é a Amazon EventBridge?](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-what-is.html) no *Guia do EventBridge usuário da Amazon*.
**Topics**
+ [Eventos de volume do EBS](#volume-events)
+ [Evento de inicialização de volume do EBS](#volume-initialization-events)
+ [Eventos de modificação de volume do EBS](#volume-modification-events)
+ [Eventos de snapshot do EBS](#snapshot-events)
+ [Eventos de arquivo de snapshots do EBS](#snapshot-archive-events)
+ [Eventos de restauração rápida do snapshot do EBS](#fast-snapshot-restore-events)
+ [Usando AWS Lambda para lidar com EventBridge eventos](using_lambda.md)
## Eventos de volume do EBS
O Amazon EBS envia eventos para EventBridge quando os seguintes eventos de volume ocorrerem.
**Topics**
+ [createVolume](#create-volume)
+ [deleteVolume](#delete-volume)
+ [attachVolume](#attach-fail-key)
+ [detachVolume](#detach-volume)
### Criar volume (createVolume)
O `createVolume` evento é enviado para sua AWS conta quando uma ação para criar um volume é concluída. Contudo, ele não é salvo, registrado em log ou arquivado. Esse evento pode ter um resultado de `available` ou `failed`. A criação falhará se um AWS KMS key inválido for fornecido, conforme mostrado nos exemplos abaixo.
**Dados de eventos**
A lista abaixo é um exemplo de um objeto JSON emitido por EBS para um evento `createVolume` bem-sucedido.
```
{
"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}}"
}
}
```
A lista abaixo é um exemplo de um objeto JSON emitido por EBS depois de um evento `createVolume` com falha. A causa da falha foi uma Chave do KMS desabilitada.
```
{
"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}}",
}
}
```
A lista a seguir é um exemplo de um objeto JSON emitido por EBS depois de um evento `createVolume` com falha. A causa da falha foi a importação pendente de uma Chave do 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}}",
}
}
```
### Excluir volume (deleteVolume)
O `deleteVolume` evento é enviado para sua AWS conta quando uma ação para excluir um volume é concluída. Contudo, ele não é salvo, registrado em log ou arquivado. Esse evento tem o resultado `deleted`. Se a exclusão não for concluída, o evento nunca será enviado.
**Dados de eventos**
A lista abaixo é um exemplo de um objeto JSON emitido por EBS para um evento `deleteVolume` bem-sucedido.
```
{
"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}}"
}
}
```
### Anexar ou reanexar volumes (attachVolume, reattachVolume)
O evento `attachVolume` ou `reattachVolume` será enviado à sua conta da AWS quando um volume for anexado ou anexado novamente a uma instância. Contudo, ele não é salvo, registrado em log ou arquivado. Se você usar uma Chave do KMS para criptografar um volume do EBS e a Chave do KMS se tornar inválida, o EBS emitirá um evento se a Chave do KMS for usada posteriormente para associar ou reassociar a uma instância, conforme mostrado nos exemplos abaixo.
**Dados de eventos**
A lista abaixo é um exemplo de um objeto JSON emitido por EBS depois de um evento `attachVolume` com falha. A causa da falha foi a exclusão pendente de uma Chave do KMS.
**nota**
AWS pode tentar se reconectar a um volume após a manutenção de rotina do servidor.
```
{
"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": ""
}
}
```
A lista abaixo é um exemplo de um objeto JSON emitido por EBS depois de um evento `reattachVolume` com falha. A causa da falha foi a exclusão pendente de uma Chave do 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": ""
}
}
```
### Desanexar volume (detachVolume)
O `detachVolume` evento é enviado para sua AWS conta quando um volume é separado de uma instância do Amazon EC2.
**Dados de eventos**
O exemplo a seguir é um evento de `detachVolume` bem-sucedido.
```
{
"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}}"
}
}
}
```
## Evento de inicialização de volume do EBS
Quando você cria um volume do Amazon EBS a partir de um snapshot e usa a taxa de inicialização de volume padrão ou uma taxa provisionada do Amazon EBS para inicialização de volume, o `initializeVolume` evento é enviado para sua AWS conta em até cinco minutos após a conclusão da inicialização do volume. Para obter mais informações, consulte [Use uma taxa provisionada do Amazon EBS para inicialização de volume](initalize-volume.md#volume-initialization-rate).
O evento **não** é enviado para volumes criados usando restauração rápida de snapshots.
**Importante**
`completionTime` reflete quando geramos o evento. Como o evento é gerado em até 5 minutos após a conclusão da inicialização, o `completionTime` pode ser até cinco minutos após a conclusão da inicialização.
O comando a seguir é um exemplo de evento.
```
{
"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}}"
}
}
```
## Eventos de modificação de volume do EBS
O Amazon EBS envia `modifyVolume` eventos para EventBridge quando um volume é modificado. Contudo, ele não é salvo, registrado em log ou arquivado.
```
{
"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}}"
}
}
```
## Eventos de snapshot do EBS
O Amazon EBS envia eventos para EventBridge quando os seguintes eventos de volume ocorrerem.
**Topics**
+ [createSnapshot](#create-snapshot-complete)
+ [createSnapshots](#create-snapshots-complete)
+ [copySnapshot](#copy-snapshot-complete)
+ [shareSnapshot](#snapshot-shared)
### Criar snapshot (createSnapshot)
O `createSnapshot` evento é enviado para sua AWS conta quando uma ação para criar um instantâneo é concluída. Contudo, ele não é salvo, registrado em log ou arquivado. Esse evento pode ter um resultado de `succeeded` ou `failed`.
**Dados de eventos**
A lista abaixo é um exemplo de um objeto JSON emitido por EBS para um evento `createSnapshot` bem-sucedido. Na seção `detail`, o campo `source` contém o ARN do volume de origem. Os campos `startTime` e `endTime` indicam quando a criação do snapshot começou e foi concluída.
```
{
"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" }
}
```
### Criar snapshots (createSnapshots)
O `createSnapshots` evento é enviado para sua AWS conta quando uma ação para criar um instantâneo de vários volumes é concluída. Esse evento pode ter um resultado de `succeeded` ou `failed`.
**Dados de eventos**
A lista abaixo é um exemplo de um objeto JSON emitido por EBS para um evento `createSnapshots` bem-sucedido. Na `detail` seção, o `source` campo contém os volumes ARNs de origem do conjunto de instantâneos de vários volumes. Os campos `startTime` e `endTime` indicam quando a criação do snapshot começou e foi concluída.
```
{
"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"
}
]
}
}
```
A lista abaixo é um exemplo de um objeto JSON emitido por EBS depois de um evento `createSnapshots` com falha. A causa da falha foi a impossibilidade de conclusão de um ou mais snapshots do conjunto de snapshots de múltiplos volumes. Os valores de `snapshot_id` são os ARNs dos instantâneos com falha. `startTime`e `endTime` representam quando a ação de criação de instantâneos começou e terminou.
```
{
"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"
}
]
}
}
```
### Copiar snapshot (copySnapshot)
O `copySnapshot` evento é enviado para sua AWS conta quando uma ação para copiar um instantâneo é concluída. Contudo, ele não é salvo, registrado em log ou arquivado. Esse evento pode ter um resultado de `succeeded` ou `failed`.
Na seção `detail`, `source` é o ARN do snapshot de origem e `snapshot_id` é o ARN da cópia do snapshot. `startTime` e `endTime` indicam quando a operação de cópia começou e terminou. `incremental` indica se a cópia do snapshot é um snapshot incremental (`true`) ou um snapshot completo (`false`). `transferType` indica se a operação de cópia de snapshot foi uma operação de cópia padrão ou uma operação de cópia baseada em tempo. Para obter mais informações, consulte [Cópias baseadas em tempo para snapshots do Amazon EBS e com suporte do EBS AMIs](time-based-copies.md).
Se você estiver copiando o snapshot entre regiões, o evento será emitido na região de destino.
**Cenário 1: a operação de cópia de snapshot padrão é concluída**
Veja a seguir um exemplo de um evento enviado à sua conta quando uma operação de cópia de snapshot padrão termina com êxito. Note que `transferType` é `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"
}
}
```
**Cenário 2: a operação de cópia de snapshot com base em tempo é concluída dentro da duração de conclusão**
Veja a seguir um exemplo de um evento que é enviado à sua conta quando uma operação de cópia de snapshot com base em tempo é concluída dentro de sua duração de conclusão. Observe que `transferType` é `time-based` para indicar que foi uma operação de cópia de snapshot com base em tempo. `completionDurationStartTime` indica quando a duração da conclusão começou.
```
{
"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"
}
}
```
**Cenário 3: a operação de cópia de snapshot com base em tempo é concluída, mas fora da duração de conclusão solicitada**
Quando uma operação de cópia instantânea com base no tempo é concluída, mas não cumpre a duração de conclusão solicitada, CloudWatch envia dois eventos para sua conta. Veja a seguir exemplos desses eventos.
+ O primeiro evento é enviado para sua conta assim que a duração da conclusão não é atendida, mesmo que a operação de cópia ainda esteja em andamento. Para este evento, o `detail-type` é `EBS Copy Snapshot Missed Completion Duration`, e `missedCompletionDurationCause` fornece o motivo.
```
{
"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"
}
}
```
+ O segundo evento é enviado à sua conta somente quando o snapshot é concluído. O evento inclui `missedCompletionDurationCause`, que fornece o motivo.
```
{
"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"
}
}
```
**Cenário 4: falha na operação de cópia de snapshot**
A seguir está um exemplo de evento enviado para a sua conta quando uma operação de cópia de snapshot falha. Observe que `result` é `failed` para indicar que a operação falhou.
```
{
"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"
}
}
```
### Compartilhar snapshot (shareSnapshot)
O `shareSnapshot` evento é enviado para sua AWS conta quando outra conta compartilha um instantâneo com ela. Contudo, ele não é salvo, registrado em log ou arquivado. O resultado é sempre `succeeded`.
**Dados de eventos**
Veja a seguir um exemplo de um objeto JSON emitido pelo EBS depois de um evento `shareSnapshot` concluído. Na `detail` seção, o valor de `source` é o número da AWS conta do usuário que compartilhou o snapshot com você. `startTime`e `endTime` representam quando a ação de compartilhamento instantâneo começou e terminou. O evento `shareSnapshot` é emitido somente quando um snapshot privado é compartilhado com outro usuário. Compartilhar um snapshot público não aciona o evento.
```
{
"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"
}
}
```
## Eventos de arquivo de snapshots do EBS
O Amazon EBS emite eventos relacionados a ações de arquivamento de snapshots. Para obter mais informações, consulte [Monitore o arquivamento de snapshots do Amazon EBS usando Eventos CloudWatch](monitor-snapshot-archiving.md).
## Eventos de restauração rápida do snapshot do EBS
O Amazon EBS envia eventos para EventBridge quando o estado de restauração rápida de um snapshot é alterado. Os eventos são emitidos com base no melhor esforço.
A seguir estão dados de exemplo para esse evento.
```
{
"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}}",
}
}
```
Os valores possíveis para `state` são `enabling`, `optimizing`, `enabled`, `disabling` e `disabled`.
Os valores possíveis para `message` são os seguintes:
`Client.InvalidSnapshot.InvalidState - The requested snapshot transitioned to an invalid state (Error)`
A solicitação para habilitar a restauração rápida do snapshot falhou e o estado mudou para `disabling` ou `disabled`. A restauração rápida do snapshot não pode ser habilitada para esse snapshot.
`Client.UserInitiated`
O estado fez a transição para `enabling` ou `disabling`.
`Client.UserInitiated - Lifecycle state transition`
O estado fez a transição para `optimizing`, `enabled` ou `disabled`.
`Server.InsufficientCapacity - There was insufficient capacity available to satisfy the request`
A solicitação para habilitar a restauração rápida do snapshot falhou por capacidade insuficiente, e o estado mudou para `disabling` ou `disabled`. Espere e tente novamente.
`Server.InternalError - An internal error caused the operation to fail`
A solicitação para habilitar a restauração rápida do snapshot falhou por erro interno, e o estado mudou para `disabling` ou `disabled`. Espere e tente novamente.
`Client.InvalidSnapshot.InvalidState - The requested snapshot was deleted or access permissions were revoked`
Foi feita a transição do estado de restauração rápida de snapshots para `disabling` ou `disabled` porque o snapshot foi excluído ou não compartilhado pelo proprietário do snapshot. A restauração rápida de snapshots não pode ser habilitada para um snapshot que tenha sido excluído ou não seja mais compartilhado com você.