EventBridge Eventos de Amazon para Amazon EBS - Amazon EBS

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

EventBridge Eventos de Amazon para Amazon EBS

Amazon EBS envía eventos a Amazon EventBridge para las acciones realizadas en volúmenes e instantáneas. Con EventBridge él, puede establecer reglas que activen acciones programáticas en respuesta a estos eventos. Por ejemplo, puede crear una regla que envíe una notificación a su correo electrónico cuando se active una instantánea para la restauración rápida de instantáneas.

Los eventos de EventBridge se representan como objetos JSON. Los campos que son únicos del evento se encuentran en la sección "detail" del objeto JSON. El campo “evento” contiene el nombre del evento. El campo “resultado” contiene el estado completad de la acción que desencadenó el evento. Para obtener más información, consulta los patrones de EventBridge eventos de Amazon en la Guía del EventBridge usuario de Amazon.

Para obtener más información, consulta ¿Qué es Amazon EventBridge? en la Guía del EventBridge usuario de Amazon.

Eventos de volumen de EBS

Amazon EBS envía los eventos al EventBridge momento en que se producen los siguientes eventos de volumen.

Crear volumen (CreateVolume)

El createVolume evento se envía a su AWS cuenta cuando se completa una acción para crear un volumen. Sin embargo, no se guarda, registra ni archiva. Este evento tiene un resultado de available o failed. La creación no se realizará correctamente si AWS KMS key se proporciona una información no válida, como se muestra en los ejemplos siguientes.

Datos de evento

La lista siguiente es un ejemplo de un objeto JSON emitido por EBS para un evento createVolume correcto.

{ "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" } }

La lista siguiente es un ejemplo de un objeto JSON emitido por EBS después de que un evento createVolume diera error. La causa del error fue una Clave de KMS deshabilitada.

{ "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 continuación se ofrece un ejemplo de un objeto JSON emitido por EBS después de que un evento createVolume diera error. La causa del error fue una importación pendiente de una Clave de 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", } }

Eliminar volumen (deleteVolume)

El deleteVolume evento se envía a tu AWS cuenta cuando se completa una acción para eliminar un volumen. Sin embargo, no se guarda, registra ni archiva. Este evento da como resultado deleted. Si la eliminación no se completa, el evento no se enviará nunca.

Datos de evento

La lista siguiente es un ejemplo de un objeto JSON emitido por EBS para un evento deleteVolume correcto.

{ "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" } }

Asociar o volver a asociar volumen (attachVolume, reattachVolume)

El evento attachVolume o reattachVolume se envía a la cuenta de AWS cuando no se logra asociar o volver a asociar un volumen a una instancia. Sin embargo, no se guarda, registra ni archiva. Si utiliza una Clave de KMS para cifrar un volumen de EBS y la Clave de KMS deja de ser válida, EBS emitirá un evento si esa Clave de KMS se utiliza posteriormente para asociar o volver a asociar a una instancia, como se muestra en los ejemplos a continuación.

Datos de evento

La lista siguiente es un ejemplo de un objeto JSON emitido por EBS después de que un evento attachVolume diera error. La causa del error fue una eliminación pendiente de una Clave de KMS.

nota

AWS puede intentar volver a conectarse a un volumen tras un mantenimiento rutinario del 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": "" } }

La lista siguiente es un ejemplo de un objeto JSON emitido por EBS después de que un evento reattachVolume diera error. La causa del error fue una eliminación pendiente de una Clave de 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": "" } }

Separar volumen (detachVolume)

El detachVolume evento se envía a tu AWS cuenta cuando se separa un volumen de una EC2 instancia de Amazon.

Datos de evento

A continuación, se muestra un ejemplo de un evento de detachVolume correcto.

{ "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" } } }

Eventos de modificación del volumen de EBS

Amazon EBS envía modifyVolume eventos EventBridge cuando se modifica un volumen. Sin embargo, no se guarda, registra ni archiva.

{ "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 instantánea de EBS

Amazon EBS envía los eventos al EventBridge momento en que se producen los siguientes eventos de volumen.

Crear instantánea (createSnapshot)

El createSnapshot evento se envía a su AWS cuenta cuando se completa una acción para crear una instantánea. Sin embargo, no se guarda, registra ni archiva. Este evento tiene un resultado de succeeded o failed.

Datos de evento

La lista siguiente es un ejemplo de un objeto JSON emitido por EBS para un evento createSnapshot correcto. En la sección detail, el campo source contiene el ARN del volumen de origen. Los campos startTime y endTime indican el inicio y la finalización de la creación de la instantánea.

{ "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" } }

Crear instantáneas (createSnapshots)

El createSnapshots evento se envía a su AWS cuenta cuando se completa una acción para crear una instantánea de varios volúmenes. Este evento tiene un resultado de succeeded o failed.

Datos de evento

La lista siguiente es un ejemplo de un objeto JSON emitido por EBS para un evento createSnapshots correcto. En la detail sección, el source campo contiene los volúmenes ARNs de origen del conjunto de instantáneas de varios volúmenes. Los campos startTime y endTime indican el inicio y la finalización de la creación de la instantánea.

{ "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" } ] } }

La lista siguiente es un ejemplo de un objeto JSON emitido por EBS después de que un evento createSnapshots diera error. La causa del error fue que no se pudieron completar una o varias instantáneas para el conjunto de instantáneas de varios volúmenes. Los valores de snapshot_id son los ARNs de las instantáneas fallidas. startTimey endTime representan cuándo comenzó y finalizó la acción de creación de instantáneas.

{ "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 instantánea (copySnapshot)

El copySnapshot evento se envía a tu AWS cuenta cuando se completa una acción para copiar una instantánea. Sin embargo, no se guarda, registra ni archiva. Este evento tiene un resultado de succeeded o failed.

En la detail sección, source es el ARN de la instantánea de origen y snapshot_id es el ARN de la copia de la instantánea. startTimee endTime indique cuándo se inició y finalizó la operación de copia. incrementalindica si la copia instantánea es una instantánea incremental (true) o una instantánea completa (false). transferTypeindica si la operación de copia instantánea fue una operación de copia estándar o una operación de copia basada en el tiempo. Para obtener más información, consulte Copias basadas en el tiempo para instantáneas de Amazon EBS.

Si está copiando la instantánea entre regiones, el evento se emite en la región de destino.

Caso 1: se completa la operación de copia instantánea estándar

El siguiente es un ejemplo de un evento que se envía a su cuenta cuando una operación de copia instantánea estándar se completa correctamente. Tenga en cuenta que transferType es 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" } }
Escenario 2: La operación de copia instantánea basada en el tiempo finaliza dentro del plazo de finalización

El siguiente es un ejemplo de un evento que se envía a su cuenta cuando una operación de copia instantánea basada en el tiempo finaliza dentro del plazo de finalización. Tenga en cuenta que esto transferType es time-based para indicar que se trataba de una operación de copia instantánea basada en el tiempo. completionDurationStartTimeindica cuándo comenzó la duración de la finalización.

{ "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" } }
Escenario 3: La operación de copia instantánea basada en el tiempo finaliza pero no alcanza el tiempo de finalización solicitado

Cuando se completa una operación de copia instantánea basada en el tiempo, pero no alcanza el tiempo de finalización solicitado, CloudWatch envía dos eventos a su cuenta. Los siguientes son ejemplos de esos eventos.

  • El primer evento se envía a tu cuenta en cuanto se pierde el tiempo de finalización, incluso si la operación de copia aún está en curso. En el caso de este eventoEBS Copy Snapshot Missed Completion Duration, el detail-type es y missedCompletionDurationCause proporciona el 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" } }
  • El segundo evento se envía a su cuenta solo una vez que se completa la instantánea. El evento incluyemissedCompletionDurationCause, lo que explica el 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" } }
Escenario 4: la operación de copia de instantáneas falla

A continuación se muestra un ejemplo de un evento que se envía a su cuenta cuando se produce un error en una operación de copia instantánea. Tenga en cuenta que esto result es failed para indicar que la operación ha fallado.

{ "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" } }

Compartir instantánea (shareSnaphot)

El shareSnapshot evento se envía a tu AWS cuenta cuando otra cuenta comparte una instantánea con ella. Sin embargo, no se guarda, registra ni archiva. El resultado siempre es succeeded.

Datos de evento

A continuación se muestra un ejemplo de un objeto JSON emitido por EBS tras la finalización de un evento shareSnapshot. En la detail sección, el valor de source es el número de AWS cuenta del usuario que compartió la instantánea contigo. startTimey endTime representan cuándo comenzó y finalizó la acción de compartir la instantánea. El evento shareSnapshot solo se activa cuando se comparte una instantánea privada con otro usuario. Si se comparte una instantánea pública, no se desencadena el 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 del archivo de instantáneas de EBS

Amazon EBS emite eventos relacionados con acciones de archivo de instantáneas. Para obtener más información, consulte Supervise el archivado de instantáneas de Amazon EBS mediante Events CloudWatch .

Eventos de restauración rápida de instantáneas de EBS

Amazon EBS envía los eventos EventBridge cuando cambia el estado de restauración rápida de una instantánea. Los eventos se emiten en la medida de lo posible.

El siguiente es un ejemplo de los datos de este 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", } }

Los valores posibles de state son enabling, optimizing, enabled, disabling y disabled.

Los valores posibles para message son los siguientes:

Client.InvalidSnapshot.InvalidState - The requested snapshot transitioned to an invalid state (Error)

Falló una solicitud para habilitar la restauración rápida de instantáneas y el estado pasó a disabling o disabled. La restauración rápida de instantáneas no se puede habilitar para esta instantánea.

Client.UserInitiated

El estado cambió satisfactoriamente a enabling o disabling.

Client.UserInitiated - Lifecycle state transition

El estado cambió satisfactoriamente a optimizing, enabled o disabled.

Server.InsufficientCapacity - There was insufficient capacity available to satisfy the request

Falló una solicitud para habilitar la restauración rápida de instantáneas por capacidad insuficiente y el estado pasó adisabling o disabled. Espere e inténtelo de nuevo.

Server.InternalError - An internal error caused the operation to fail

Falló una solicitud para habilitar la restauración rápida de instantáneas por un error interno y el estado pasó adisabling o disabled. Espere e inténtelo de nuevo.

Client.InvalidSnapshot.InvalidState - The requested snapshot was deleted or access permissions were revoked

El estado de restauración rápida de la instantánea ha pasado a disabling o disabled porque el propietario de la instantánea eliminó o dejó de compartir la instantánea. La restauración rápida de instantáneas no se puede habilitar para una instantánea que se ha eliminado o que ya no se comparte con usted.