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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"endTime": "yyyy-mm-ddThh:mm:ssZ" }
}
```
### 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-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": "succeeded",
"cause": "",
"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": "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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"endTime": "yyyy-mm-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"endTime": "yyyy-mm-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"endTime": "yyyy-mm-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"endTime": "yyyy-mm-ddThh:mm:ssZ"
}
}
```
### 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-ddThh:mm:ssZ",
"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-ddThh:mm:ssZ",
"endTime": "yyyy-mm-ddThh:mm:ssZ"
}
}
```
## 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-ddThh:mm:ssZ",
"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ê.