# Eventos programados para las instancias de Amazon EC2
Para garantizar la fiabilidad y el rendimiento de la infraestructura, AWS puede programar eventos para reiniciar, detener y retirar las instancias. Estos eventos no ocurren con frecuencia.
Si una de las instancias se verá afectada por un evento programado, AWS se lo notificará con antelación por correo electrónico a la dirección asociada a su cuenta de AWS. El correo electrónico proporciona información acerca del evento, como las fechas de inicio y de finalización. En función del tipo de evento, es posible que pueda tomar medidas para controlar su momento adecuado. Además, AWS envía un evento de AWS Health, que se puede supervisar y administrar con Amazon EventBridge. Para obtener más información, consulte [Monitoreo de eventos de AWS Health con Amazon EventBridge](https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html).
AWS administra los eventos programados. No puede programar eventos para las instancias. Sin embargo, puede hacer lo siguiente:
+ Ver eventos programados para las instancias.
+ Personalizar las notificaciones de eventos programados para incluir o eliminar etiquetas de la notificación de correo electrónico.
+ Reprogramar ciertos eventos programados.
+ Crear ventanas de eventos personalizadas para eventos programados.
+ Tomar medidas cuando una instancia está programada para reiniciarse, detenerse o retirarse.
Para asegurarse de recibir notificaciones de los eventos programados, verifique la información de contacto en la página [Cuenta](https://console.aws.amazon.com/billing/home?#/account).
**nota**
Cuando una instancia se ve afectada por un evento programado y forma parte de un grupo de escalado automático, Amazon EC2 Auto Scaling la sustituye eventualmente como parte de sus comprobaciones de estado, sin que sea necesario realizar más acciones por su parte. Para obtener más información acerca de las comprobaciones de estado realizadas por Amazon EC2 Auto Scaling, consulte [Comprobaciones de estado para instancias en un grupo de escalado automático](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-health-checks.html) en la *Guía del usuario de Amazon EC2 Auto Scaling*.
## Tipos de eventos programados
Amazon EC2 puede crear los siguientes tipos de eventos programados para las instancias, donde el evento se produce a una hora programada:
| Tipo de evento | Código de evento | Acción de eventos |
| --- | --- | --- |
| Detención de instancia | instance-stop | A la hora programada, las instancias se detienen. Cuando vuelva a iniciarla, la instancia migrará a un nuevo host. Se aplica solo a las instancias con un volumen raíz de Amazon EBS. |
| Retirada de instancias | instance-retirement | A la hora programada, la instancia se detiene si tiene un volumen raíz de Amazon EBS o se termina si tiene un volumen raíz del almacén de instancias. |
| Reinicio de la instancia | instance-reboot | A la hora programada, la instancia se vuelve a arrancar. La instancia permanece en el host y, durante el reinicio, el host se somete a mantenimiento. Esto se conoce como reinicio in situ. |
| Reinicio del sistema | system-reboot | A la hora programada, la instancia se reinicia y se migra a un nuevo host. Esto se conoce como migración de reinicio. |
| Mantenimiento del sistema | system-maintenance | A la hora programada, la instancia podría verse temporalmente afectada por un mantenimiento de red o de energía. |
## Determine el tipo de evento
Puede comprobar qué tipo de evento está programado para su instancia.
------
#### [ Console ]
**Para determinar el tipo de evento**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events (Eventos)**.
1. En la tabla, el código del evento aparece en la columna **Tipo de evento**.
1. Para filtrar la tabla y mostrar solo los eventos de las instancias, en el campo de búsqueda, seleccione **Tipo de recurso: instancia** en la lista de filtros.
------
#### [ AWS CLI ]
**Para determinar el tipo de evento de una instancia**
Utilice el comando [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html). Si la instancia tiene un evento programado asociado, el resultado proporciona información sobre el evento programado.
```
aws ec2 describe-instance-status \
--instance-id i-1234567890abcdef0 \
--query InstanceStatuses[].Events
```
A continuación, se muestra un ejemplo del resultado. El código del evento programado es `system-reboot`.
```
[
"Events": [
{
"InstanceEventId": "instance-event-0d59937288b749b32",
"Code": "system-reboot",
"Description": "The instance is scheduled for a reboot",
"NotAfter": "2020-03-14T22:00:00.000Z",
"NotBefore": "2020-03-14T20:00:00.000Z",
"NotBeforeDeadline": "2020-04-05T11:00:00.000Z"
}
]
]
```
------
#### [ PowerShell ]
**Para determinar el tipo de evento de una instancia**
Utilice el cmdlet [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html). Si la instancia tiene un evento programado asociado, el resultado proporciona información sobre el evento programado.
```
(Get-EC2InstanceStatus `
-InstanceId i-1234567890abcdef0).Events
```
A continuación, se muestra un ejemplo del resultado. El código del evento programado es `system-reboot`.
```
Code : system-reboot
Description : The instance is scheduled for a reboot
InstanceEventId : instance-event-0d59937288b749b32
NotAfter : 2020-03-14T22:00:00.000Z
NotBefore : 2020-03-14T20:00:00.000Z
NotBeforeDeadline : 2020-04-05T11:00:00.000Z
```
------
**Topics**
+ [Tipos de eventos programados](#types-of-scheduled-events)
+ [Determine el tipo de evento](#scheduled-event-type)
+ [Administración de instancias de Amazon EC2 programadas para detenerse o retirarse](schedevents_actions_retire.md)
+ [Administración de instancias de Amazon EC2 programadas para reiniciarse](schedevents_actions_reboot.md)
+ [Administración de instancias de Amazon EC2 programadas para mantenimiento](schedevents_actions_maintenance.md)
+ [Ver los eventos programados que afectan a sus instancias de Amazon EC2](viewing_scheduled_events.md)
+ [Personalizar las notificaciones de eventos programados para sus instancias EC2](customizing_scheduled_event_notifications.md)
+ [Reprogramar un evento programado para una instancia de EC2](reschedule-event.md)
+ [Cree ventanas de eventos personalizadas para los eventos programados que afecten a sus instancias de Amazon EC2.](event-windows.md)
# Administración de instancias de Amazon EC2 programadas para detenerse o retirarse
Cuando AWS detecta un error irreparable del host subyacente de la instancia, programa la detención o terminación de la instancia, según el tipo de volumen raíz de la instancia.
+ Si la instancia tiene un volumen raíz de Amazon EBS, la instancia está programada para su detención.
+ Si la instancia tiene un volumen raíz del almacén de instancias, la instancia está programada para su terminación.
Para obtener más información, consulte [Retirada de instancias](instance-retirement.md).
**importante**
Cualquier dato almacenado en volúmenes del almacén de instancias se perderá cuando una instancia se detenga, se termine o se ponga en hibernación. Esto incluye volúmenes del almacén de instancias adjuntados a una instancia que tiene un volumen raíz de EBS. No olvide guardar los datos de los volúmenes del almacén de instancias que puede necesitar más adelante antes de que la instancia se detenga, se termine o se ponga en hibernación.
## Acciones que puede llevar a cabo
**Acciones que puede realizar para instancias con un volumen raíz de EBS**
Cuando reciba una notificación de evento `instance-stop` programado, puede realizar una de las siguientes acciones:
+ **Esperar a la parada programada:** puede esperar a que la instancia se detenga dentro de su período de mantenimiento programado.
+ **Realizar la detención e inicio manuales:** puede detener e iniciar la instancia usted mismo en el momento que más le convenga, lo que la migra a un nuevo host. No es lo mismo que reiniciar la instancia. Para obtener más información, consulte [Detención e iniciación de una instancia de Amazon EC2](Stop_Start.md).
+ **Automatizar la detención y el inicio:**: puede automatizar la detención y el inicio inmediatos en respuesta a un evento `instance-stop`programado. Para obtener más información, consulte [Running operations on EC2 instances automatically in response to events in AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) en la *Guía del usuario de AWS Health*.
**Acciones que puede realizar para instancias con un volumen raíz del almacén de instancias**
Cuando reciba una notificación de evento `system-retirement` programado y desee conservar sus datos, puede realizar las siguientes acciones:
1. Lance una instancia de reemplazo desde su AMI más reciente.
1. Migre todos los datos necesarios a la instancia de reemplazo antes de que la instancia esté programada para terminar.
1. Finalice la instancia original o espere a que finalice según lo programado.
Para más información sobre las medidas que puede tomar, consulte [Retirada de instancias](instance-retirement.md).
# Administración de instancias de Amazon EC2 programadas para reiniciarse
Cuando AWS debe realizar tareas como instalar actualizaciones o mantener el host subyacente, puede programar un reinicio de la instancia. Durante el reinicio programado, la instancia permanece en el mismo host o migra a un host diferente, según el evento, de la siguiente manera:
+ `instance-reboot` event
+ Durante el reinicio, la instancia permanece en el host. Esto se conoce como un *reinicio in situ*.
+ El host actual se somete a mantenimiento.
+ Por lo general, se completa en cuestión de segundos.
+ `system-reboot` event
+ Durante el reinicio, la instancia se migra a un nuevo host. Esto se conoce como una *migración de reinicio*.
+ Por lo general, se completa en cuestión de minutos.
Para comprobar qué tipo de evento está programado para su instancia, consulte [Determine el tipo de evento](monitoring-instances-status-check_sched.md#scheduled-event-type).
## Acciones que puede llevar a cabo
Cuando reciba una notificación de un evento de `instance-reboot` o `system-reboot` programado, puede realizar una de las siguientes acciones:
+ **Espere que se produzca el reinicio:** puede esperar a que se produzca el reinicio de la instancia dentro de su ventana de mantenimiento programada.
+ **Reprogramar el reinicio:** puede [reprogramar](reschedule-event.md) el reinicio de la instancia a la fecha y hora que mejor le convenga.
+ **Realizar un reinicio iniciado por el usuario:** puede [reiniciar](ec2-instance-reboot.md) la instancia manualmente en el momento que más le convenga. Sin embargo, el resultado depende del evento:
+ Evento `instance-reboot`: su instancia permanece en el equipo actual (reinicio local), no se realiza ningún mantenimiento del host y el evento permanece abierto.
+ `system-reboot` event
+ Si la migración de reinicios está habilitada en su instancia, un reinicio iniciado por el usuario intentará migrar su instancia a un nuevo equipo. Si tiene éxito, el evento se borra. Si no tiene éxito, se produce un reinicio in situ y el evento permanece programado.
+ Si la migración de reinicios está deshabilitada en su instancia, un reinicio iniciado por el usuario mantiene la instancia en el mismo equipo (reinicio in situ), no se realiza ningún mantenimiento del host y el evento permanece programado. Cuando finalmente se produzca el evento programado, AWS moverá su instancia a un nuevo equipo (migración de reinicios).
**Después de que AWS reinicie su instancia**
Lo siguiente se aplica después de que AWS reinicie su instancia:
+ El evento programado se borra.
+ Se actualiza la descripción del evento.
+ Para un evento `instance-reboot`:
+ El mantenimiento del host subyacente ha finalizado.
+ Para un evento `system-reboot`:
+ La instancia se traslada a un nuevo host.
+ La instancia conserva su dirección IP y su nombre DNS.
+ Los datos en los volúmenes de almacén de instancias local se conservarán.
+ Puede utilizar su instancia después de que haya iniciado por completo.
**Opciones alternativas**
Si no puede reprogramar el evento de reinicio o habilitar la migración de reinicios para un reinicio iniciado por el usuario, pero desea mantener un funcionamiento normal durante el periodo de mantenimiento programado, puede hacer lo siguiente:
+ **Para una instancia con un volumen raíz de EBS**
+ Detener e iniciar manualmente la instancia para migrarla a un nuevo host. Esto no es lo mismo que reiniciar manualmente la instancia, donde la instancia permanece en el mismo host.
+ Opcionalmente, automatice una parada y arranque inmediatos de la instancia en respuesta al evento de reinicio programado. Para obtener más información, consulte [Running operations on EC2 instances automatically in response to events in AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) en la *Guía del usuario de AWS Health*.
**importante**
Los datos de los volúmenes del almacén de instancias se pierden cuando se detiene una instancia. Para obtener más información, consulte [Detención e iniciación de una instancia de Amazon EC2](Stop_Start.md).
+ **Para una instancia con un volumen raíz de almacén de instancias**
1. Lance una instancia de reemplazo desde su AMI más reciente.
1. Migre todos los datos necesarios a la instancia de sustitución antes del período de mantenimiento programado.
1. Termine la instancia original.
## Cómo habilitar o deshabilitar la migración de reinicios
Cuando una instancia está programada para un evento de `system-reboot`, puede reiniciarla antes del evento. El resultado de un reinicio iniciado por el usuario depende de la configuración de migración de reinicios de la instancia:
+ Habilitado: un reinicio iniciado por el usuario intenta migrar la instancia a un nuevo equipo (migración de reinicios). Si tiene éxito, el evento se borra. Si no tiene éxito, se produce un reinicio in situ y el evento permanece programado. Tenga en cuenta que, aunque esté habilitada, la migración de reinicios solo se puede realizar si la instancia cumple con los [requisitos de migración de reinicios](#requirements-for-reboot-migration).
+ Deshabilitado: un reinicio iniciado por el usuario mantiene la instancia en el mismo equipo (reinicio in situ), no se realiza ningún mantenimiento del host y el evento permanece programado. Cuando finalmente se produzca el evento programado, AWS moverá su instancia a un nuevo equipo (migración de reinicios).
Un reinicio con migración tarda más que un reinicio in situ:
+ Reinicio in situ: aproximadamente 30 segundos
+ Reinicio con migración: varios minutos
**nota**
De forma predeterminada, las instancias que reciben una notificación de evento `system-reboot` están habilitadas para la migración de reinicios iniciada por el usuario.
### Requisitos para habilitar la migración de reinicios
La migración de reinicios se puede habilitar en instancias que cumplan los siguientes criterios:
**Tipos de instancias**
No todos los tipos de instancias admiten la habilitación de la migración de reinicios. Puede ver los tipos de instancias que admiten la habilitación de la migración de reinicios.
**Cómo ver los tipos de instancias que admiten la habilitación de la migración de reinicios**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación izquierdo, elija **Instance Types** (Tipos de instancias).
1. En la barra de filtros, introduzca **Soporte de migración de reinicios: admitidos**. A medida que ingrese los caracteres y aparezca el nombre del filtro, podrá seleccionarlo.
La tabla **Tipos de instancia** muestra todos los tipos de instancia que admiten la habilitación de la migración de reinicios.
**Cómo ver los tipos de instancias que admiten la habilitación de la migración de reinicios**
Utilice el comando [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) con el filtro `reboot-migration-support`.
```
aws ec2 describe-instance-types \
--filters Name=reboot-migration-support,Values=supported \
--query "InstanceTypes[*].[InstanceType]" \
--output text | sort
```
**Cómo ver los tipos de instancias que admiten la habilitación de la migración de reinicios**
Utilice el cmdlet [Get-EC2InstanceType](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceType.html) con el filtro `reboot-migration-support`.
```
Get-EC2InstanceType `
-Filter @{Name="reboot-migration-support";Values="true"} | `
Select InstanceType | Sort-Object InstanceType
```
**Propiedad**
+ Compartida
+ Dedicated Instance
Para obtener más información, consulte [Instancias dedicadas de Amazon EC2](dedicated-instance.md).
**Limitaciones**
La migración de reinicios **no** se admite en instancias con las siguientes características:
+ Plataforma: instancias que se ejecutan de forma nativa en el hipervisor Xen
+ Tamaño de la instancia: `metal` instancias
+ Tenencia: host dedicado. En el caso de los hosts dedicados, utilice la [Recuperación automática del host dedicado](dedicated-hosts-recovery.md) en su lugar.
+ Almacenamiento: instancias con volúmenes de almacén de instancias
+ Redes: instancias que usan un Elastic Fabric Adapter
+ Escalado automático: instancias que forman parte de un grupo de escalado automático
### Pasos para habilitar o deshabilitar la migración de reinicios
Cuando una instancia recibe un evento `system-reboot`, está habilitada para la migración de reinicios de forma predeterminada. Puede deshabilitar la migración de reinicios para que, durante un reinicio iniciado por el usuario, la instancia permanezca en el mismo equipo (reinicio in situ).
La configuración `default` no habilita la migración de reinicios para una instancia no compatible. Para obtener más información, consulte [Requisitos para habilitar la migración de reinicios](#requirements-for-reboot-migration).
Puede deshabilitar o habilitar la migración de reinicios en una instancia en ejecución o detenida.
------
#### [ AWS CLI ]
**Cómo deshabilitar la migración de reinicios**
Use el comando [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html) y establezca el parámetro `--reboot-migration` en `disabled`.
```
aws ec2 modify-instance-maintenance-options \
--instance-id i-0abcdef1234567890 \
--reboot-migration disabled
```
**Cómo habilitar la migración de reinicios**
Use el comando [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html) y establezca el parámetro `--reboot-migration` en `default`.
```
aws ec2 modify-instance-maintenance-options \
--instance-id i-0abcdef1234567890 \
--reboot-migration default
```
------
#### [ PowerShell ]
**Cómo deshabilitar la migración de reinicios**
Utilice el cmdlet [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html).
```
Edit-EC2InstanceMaintenanceOption `
-InstanceId `
-RebootMigration Disabled
```
**Cómo habilitar la migración de reinicios**
Utilice el cmdlet [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html).
```
Edit-EC2InstanceMaintenanceOption `
-InstanceId i-1234567890abcdef0 `
-RebootMigration Enabled
```
------
# Administración de instancias de Amazon EC2 programadas para mantenimiento
Cuando AWS debe realizar el mantenimiento del host subyacente de una instancia, programa la instancia para su mantenimiento. Existen dos tipos de eventos de mantenimiento: mantenimiento de red y mantenimiento de energía.
+ Durante el mantenimiento de red, las instancias programadas pierden la conectividad de red durante un breve periodo de tiempo. La conectividad de red normal a la instancia se restaurará una vez completado el mantenimiento.
+ Durante el mantenimiento de energía, las instancias programadas se desconectan durante un breve periodo y, a continuación, se reinician. Cuando se realiza un reinicio, se conservan todos los valores de configuración de la instancia.
Una vez reiniciada la instancia (esto normalmente tarda unos minutos), verifique que su aplicación está funcionando tal como se espera. En este momento, la instancia ya no debería tener un evento programado asociado o si lo tuviese, la descripción del evento programado empezaría con **[Completed] (Finalizado)**. A veces, se tarda hasta 1 hora en actualizar la descripción de estado de la instancia. Los eventos de mantenimiento completados se muestran en el panel de la consola de Amazon EC2 durante una semana.
## Acciones que puede llevar a cabo
**Acciones que puede realizar para instancias con un volumen raíz de EBS**
Cuando reciba una notificación de un evento `system-maintenance` programado, puede realizar una de las siguientes acciones:
+ **Espere al mantenimiento programado:** puede esperar a que el mantenimiento suceda tal como estaba programado.
+ **Detener e iniciar manualmente:** puede detener e iniciar la instancia, lo que la migra a un nuevo host. No es lo mismo que reiniciar la instancia. Para obtener más información, consulte [Detención e iniciación de una instancia de Amazon EC2](Stop_Start.md).
+ **Automatizar la detención y el inicio:** puede automatizar la detención y el inicio inmediatos en respuesta a un evento de mantenimiento programado. Para obtener más información, consulte [Running operations on EC2 instances automatically in response to events in AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) en la *Guía del usuario de AWS Health*.
**Acciones que puede realizar para instancias con un volumen raíz del almacén de instancias**
Cuando reciba una notificación de un evento de `system-maintenance`, puede realizar una de las siguientes acciones:
+ **Espere al mantenimiento programado:** puede esperar a que el mantenimiento suceda tal como estaba programado.
+ **Lance una instancia de reemplazo:** si desea mantener un funcionamiento normal durante el período de mantenimiento programado:
1. Lance una instancia de sustitución en un nuevo desde su AMI más reciente.
1. Migre todos los datos necesarios a la instancia de sustitución antes del período de mantenimiento programado.
1. Termine la instancia original.
# Ver los eventos programados que afectan a sus instancias de Amazon EC2
Además de recibir notificaciones de eventos programados por correo electrónico, puede consultar los eventos programados.
------
#### [ Console ]
**Para ver eventos programados para las instancias**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. El panel muestra todos los recursos con un evento asociado en **Eventos programados**.
![\[Visualización de eventos mediante el panel\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/images/dashboard-scheduled-events.png)
1. En el panel de navegación, elija **Eventos** para obtener más información. Se muestran todos los recursos con un evento asociado. Puede filtrar por características como el tipo de evento, el tipo de recurso y la zona de disponibilidad.
![\[Visualización de eventos mediante la página de eventos.\]](http://docs.aws.amazon.com/es_es/AWSEC2/latest/UserGuide/images/events-instance-scheduled-stop.png)
------
#### [ AWS CLI ]
**Para ver eventos programados para las instancias**
Utilice el comando [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html).
```
aws ec2 describe-instance-status \
--instance-id i-1234567890abcdef0 \
--query "InstanceStatuses[].Events"
```
La siguiente salida de ejemplo muestra un evento de reinicio.
```
[
"Events": [
{
"InstanceEventId": "instance-event-0d59937288b749b32",
"Code": "system-reboot",
"Description": "The instance is scheduled for a reboot",
"NotAfter": "2019-03-15T22:00:00.000Z",
"NotBefore": "2019-03-14T20:00:00.000Z",
"NotBeforeDeadline": "2019-04-05T11:00:00.000Z"
}
]
]
```
A continuación se muestra un ejemplo del resultado que muestra un evento de retirada de la instancia.
```
[
"Events": [
{
"InstanceEventId": "instance-event-0e439355b779n26",
"Code": "instance-stop",
"Description": "The instance is running on degraded hardware",
"NotBefore": "2015-05-23T00:00:00.000Z"
}
]
]
```
------
#### [ PowerShell ]
**Para ver eventos programados para las instancias**
Utilice el siguiente comando [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html).
```
(Get-EC2InstanceStatus -InstanceId i-1234567890abcdef0).Events
```
A continuación se muestra un ejemplo del resultado que muestra un evento de retirada de la instancia.
```
Code : instance-stop
Description : The instance is running on degraded hardware
NotBefore : 5/23/2015 12:00:00 AM
```
------
#### [ Instance metadata ]
**Para ver eventos programados para las instancias mediante metadatos de instancia**
Para recuperar información sobre los eventos de mantenimiento activos de las instancias desde los [metadatos de las instancias](ec2-instance-metadata.md) puede utilizar el Servicio de metadatos de instancia, versión 2, o el Servicio de metadatos de instancia, versión 1.
**IMDSv2**
```
[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/events/maintenance/scheduled
```
**IMDSv1**
```
[ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/events/maintenance/scheduled
```
A continuación se muestra un resultado de ejemplo con información acerca de un evento de reinicio del sistema programado, en formato JSON.
```
[
{
"NotBefore" : "21 Jan 2019 09:00:43 GMT",
"Code" : "system-reboot",
"Description" : "scheduled reboot",
"EventId" : "instance-event-0d59937288b749b32",
"NotAfter" : "21 Jan 2019 09:17:23 GMT",
"State" : "active"
}
]
```
**Para ver el historial de los eventos completados o cancelados mediante los metadatos de las instancias**
Para recuperar información sobre los eventos completados o cancelados desde las [instancias de metadatos](ec2-instance-metadata.md) puede utilizar el Servicio de metadatos de instancia, versión 2, o el Servicio de metadatos de instancia, versión 1.
**IMDSv2**
```
[ec2-user ~]$ TOKEN=`curl -X PUT "http://169.254.169.254/latest/api/token" -H "X-aws-ec2-metadata-token-ttl-seconds: 21600"` \
&& curl -H "X-aws-ec2-metadata-token: $TOKEN" http://169.254.169.254/latest/meta-data/events/maintenance/history
```
**IMDSv1**
```
[ec2-user ~]$ curl http://169.254.169.254/latest/meta-data/events/maintenance/history
```
A continuación se muestra un resultado de ejemplo con información acerca de un evento de reinicio del sistema que se canceló y un evento de reinicio del sistema que se completó, en formato JSON.
```
[
{
"NotBefore" : "21 Jan 2019 09:00:43 GMT",
"Code" : "system-reboot",
"Description" : "[Canceled] scheduled reboot",
"EventId" : "instance-event-0d59937288b749b32",
"NotAfter" : "21 Jan 2019 09:17:23 GMT",
"State" : "canceled"
},
{
"NotBefore" : "29 Jan 2019 09:00:43 GMT",
"Code" : "system-reboot",
"Description" : "[Completed] scheduled reboot",
"EventId" : "instance-event-0d59937288b749b32",
"NotAfter" : "29 Jan 2019 09:17:23 GMT",
"State" : "completed"
}
]
```
------
#### [ AWS Health ]
Puede usar Panel de AWS Health para obtener información sobre eventos que pueden afectar a su instancia. En el Panel de estado, los problemas están organizados en tres grupos: problemas abiertos, cambios programados y otras notificaciones. El grupo de cambios programados contiene elementos próximos o que están en curso.
Para obtener más información, consulte [Introducción a su Panel de AWS Health](https://docs.aws.amazon.com/health/latest/ug/getting-started-health-dashboard.html) en la *Guía del usuario de AWS Health*.
------
# Personalizar las notificaciones de eventos programados para sus instancias EC2
Puede personalizar las notificaciones de eventos programados para incluir etiquetas en la notificación de correo electrónico. Esto hace que sea más fácil identificar el recurso afectado (instancias o Hosts dedicados) y priorizar acciones para el próximo evento.
Al personalizar las notificaciones de eventos para incluir etiquetas, puede elegir incluir:
+ Todas las etiquetas que están asociadas con el recurso afectado
+ Solo las etiquetas específicas que están asociadas con el recurso afectado
Por ejemplo, supongamos que asigna etiquetas `application`, `costcenter`, `project` y `owner` a todas las instancias. Puede elegir incluir todas las etiquetas en las notificaciones de eventos. Alternativamente, si desea ver solo las etiquetas `owner` y `project` en las notificaciones de eventos, puede elegir incluir solo esas etiquetas.
Después de seleccionar las etiquetas que se van a incluir, las notificaciones de eventos incluirán el ID de recurso (ID de instancia o ID de host dedicado) y los pares de valores y clave de etiqueta asociados al recurso afectado.
**Topics**
+ [Incluir etiquetas en las notificaciones de eventos](#register-tags)
+ [Eliminar etiquetas de las notificaciones de eventos](#deregister-tags)
+ [Ver las etiquetas que se incluirán en las notificaciones de eventos](#view-tags)
## Incluir etiquetas en las notificaciones de eventos
Las etiquetas que elija incluir se aplican a todos los recursos (instancias y Hosts dedicados) de la región seleccionada. Para personalizar las notificaciones de eventos en otras regiones, seleccione primero la región requerida y, a continuación, realice los siguientes pasos.
------
#### [ Console ]
**Para incluir etiquetas en las notificaciones de eventos**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events (Eventos)**.
1. Seleccione **Actions (Acciones)**, **Manage event notifications (Administrar notificaciones de eventos)**.
1. Activar **Incluir etiquetas en las notificaciones de eventos**.
1. Realice una de las siguientes acciones, dependiendo de las etiquetas que desee incluir en las notificaciones de eventos:
+ Para incluir todas las etiquetas asociadas a la instancia afectada o host dedicado, seleccione **Incluir todas las etiquetas de recursos**.
+ Para seleccionar las etiquetas que se van a incluir, seleccione **Elegir las etiquetas que se van a incluir** y, a continuación, seleccione o ingrese las claves de etiqueta.
1. Seleccione **Save**.
------
#### [ AWS CLI ]
**Para incluir todas las etiquetas en las notificaciones de eventos**
Utilice el comando [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) y establezca el parámetro `IncludeAllTagsOfInstance` en `true`.
```
aws ec2 register-instance-event-notification-attributes \
--instance-tag-attribute "IncludeAllTagsOfInstance=true"
```
**Para incluir etiquetas específicas en las notificaciones de eventos**
Utilice el comando [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) y especifique las etiquetas que desea incluir mediante el parámetro `InstanceTagKeys`.
```
aws ec2 register-instance-event-notification-attributes \
--instance-tag-attribute 'InstanceTagKeys=["tag_key_1", "tag_key_2", "tag_key_3"]'
```
------
#### [ PowerShell ]
**Para incluir todas las etiquetas en las notificaciones de eventos**
Utilice el cmdlet [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html).
```
Register-EC2InstanceEventNotificationAttribute `
-InstanceTagAttribute_IncludeAllTagsOfInstance $true
```
**Para incluir etiquetas específicas en las notificaciones de eventos**
Utilice el cmdlet [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html).
```
Register-EC2InstanceEventNotificationAttribute `
-InstanceTagAttribute_InstanceTagKey tag_key_1, tag_key_2, tag_key_3
```
------
## Eliminar etiquetas de las notificaciones de eventos
Puede eliminar etiquetas de las notificaciones de eventos.
------
#### [ Console ]
**Para eliminar etiquetas de las notificaciones de eventos**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events (Eventos)**.
1. Seleccione **Actions (Acciones)**, **Manage event notifications (Administrar notificaciones de eventos)**.
1. Para quitar todas las etiquetas de las notificaciones de eventos, desactive **Incluir etiquetas en las notificaciones de eventos**.
1. Para eliminar etiquetas específicas de las notificaciones de eventos, seleccione la **X**) para las claves de etiqueta correspondientes.
1. Seleccione **Save**.
------
#### [ AWS CLI ]
**Para eliminar todas las etiquetas de las notificaciones de eventos**
Utilice el comando [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) y establezca el parámetro `IncludeAllTagsOfInstance` en `false`.
```
aws ec2 deregister-instance-event-notification-attributes \
--instance-tag-attribute "IncludeAllTagsOfInstance=false"
```
**Para eliminar una etiqueta de las notificaciones de eventos**
Utilice el comando [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) y especifique las etiquetas que desea eliminar mediante el parámetro `InstanceTagKeys`.
```
aws ec2 deregister-instance-event-notification-attributes \
--instance-tag-attribute 'InstanceTagKeys=["tag_key_3"]'
```
------
#### [ PowerShell ]
**Para eliminar todas las etiquetas de las notificaciones de eventos**
Utilice el cmdlet [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html).
```
Unregister-EC2InstanceEventNotificationAttribute `
-InstanceTagAttribute_IncludeAllTagsOfInstance $false
```
**Para eliminar una etiqueta de las notificaciones de eventos**
Utilice el cmdlet [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html).
```
Unregister-EC2InstanceEventNotificationAttribute `
-InstanceTagAttribute_InstanceTagKey tag_key_3
```
------
## Ver las etiquetas que se incluirán en las notificaciones de eventos
Puede ver las etiquetas que se van a incluir en las notificaciones de eventos.
------
#### [ Console ]
**Para ver las etiquetas que se van a incluir en las notificaciones de eventos**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events (Eventos)**.
1. Seleccione **Actions (Acciones)**, **Manage event notifications (Administrar notificaciones de eventos)**.
------
#### [ AWS CLI ]
**Para ver las etiquetas que se incluirán en las notificaciones de eventos**
Utilice el comando [describe-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-event-notification-attributes.html).
```
aws ec2 describe-instance-event-notification-attributes
```
------
#### [ PowerShell ]
**Para ver las etiquetas que se incluirán en las notificaciones de eventos**
Utilice el cmdlet [Get-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceEventNotificationAttribute.html).
```
Get-EC2InstanceEventNotificationAttribute
```
------
# Reprogramar un evento programado para una instancia de EC2
Puede reprogramar un evento para que se produzca en la fecha y hora específicas que mejor le convenga. Después de reprogramar un evento, es posible que pasen uno o dos minutos antes de que se muestre la fecha actualizada.
**Limitaciones**
+ Solo se pueden reprogramar los eventos con una fecha límite de evento. El evento se puede reprogramar hasta la fecha límite del evento. La fecha límite del evento se indica en la columna **Deadline** (Fecha límite) (consola) y el campo `NotBeforeDeadline` (AWS CLI).
+ Solo se pueden reprogramar los eventos que no se han iniciado aún. La hora de inicio se indica en la columna **Start time** (Hora de inicio) (consola) y el campo `NotBefore` (AWS CLI). Los eventos que están programados para comenzar en los próximos 5 minutos no se pueden reprogramar.
+ La nueva hora de inicio del evento debe comenzar al menos 60 minutos a partir de la hora actual.
+ Si reprograma múltiples eventos utilizando la consola, la fecha límite del evento se determina por el evento con la fecha límite de evento más temprana.
------
#### [ Console ]
**Para reprogramar un evento**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events (Eventos)**.
1. Elija **Resource type: instance (Tipo de recurso: instancia)** en la lista de filtros.
1. Seleccione una o varias instancias y, a continuación, elija **Actions (Acciones)**, **Schedule Event (Programar evento)**.
Solo se pueden reprogramar los eventos que tienen una fecha límite de evento indicada por un valor de **Deadline (Fecha límite)**. Si uno de los eventos seleccionados no tiene fecha límite, **Actions (Acciones)** y **Schedule event (Programar evento)** están deshabilitados.
1. En **New start time (Nueva hora de inicio)**, escriba una nueva fecha y hora para el evento. La nueva fecha y hora deben ser anteriores al valor especificado en **Event deadline (Fecha límite de evento)**.
1. Seleccione **Save**.
La hora de inicio del evento actualizada podría tardar uno o dos minutos en reflejarse en la consola.
------
#### [ AWS CLI ]
**Para reprogramar un evento**
Utilice el comando [https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-start-time.html](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-start-time.html).
```
aws ec2 modify-instance-event-start-time \
--instance-id i-1234567890abcdef0 \
--instance-event-id instance-event-0d59937288b749b32 \
--not-before 2020-03-25T10:00:00.000
```
------
#### [ PowerShell ]
**Para reprogramar un evento**
Utilice el cmdlet [Edit-EC2InstanceEventStartTime](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventStartTime.html).
```
Edit-EC2InstanceEventStartTime `
-InstanceId i-1234567890abcdef0 `
-InstanceEventId instance-event-0d59937288b749b32 `
-NotBefore 2020-03-25T10:00:00.000
```
------
# Cree ventanas de eventos personalizadas para los eventos programados que afecten a sus instancias de Amazon EC2.
Puede definir ventanas de eventos semanales personalizados para eventos programados que reinicien, detengan o terminen sus instancias de Amazon EC2. Puede asociar una o varias instancias con un periodo de evento. Si se planifica un evento programado para esas instancias, AWS programará los eventos dentro del periodo de eventos asociado.
Puede utilizar los periodos de eventos para maximizar la disponibilidad de la carga de trabajo mediante la especificación de los periodos de eventos que se producen durante los periodos de menor actividad de su carga de trabajo. También puede alinear los periodos de eventos con sus programas de mantenimiento internos.
Define un periodo de evento mediante la especificación de un conjunto de intervalos de tiempo. El intervalo de tiempo mínimo es de 2 horas. Los intervalos de tiempo combinados deben sumar como mínimo 4 horas.
Puede asociar una o varias instancias con un periodo de evento mediante ID de instancia o etiquetas de instancia. También puede asociar host dedicados con periodos de eventos mediante el ID de alojamiento.
**aviso**
Los periodos de eventos solo se aplican a eventos programados que detienen, reinician o terminan instancias.
Los periodos de eventos no se aplican a lo siguiente:
eventos programados rápidos y eventos de mantenimiento de red
Mantenimiento no programado, como la [recuperación automática de instancias](ec2-instance-recover.md) y los reinicios imprevistos.
**Topics**
+ [Consideraciones](#event-windows-considerations)
+ [Crear un periodo de evento](#create-event-windows)
+ [Asociar un destino con un periodo de evento](#associate-target-event-window)
+ [Desasociar un destino de una ventana de eventos](#disassociate-target-event-window)
+ [Modificar una ventana de eventos](#modify-event-windows)
+ [Eliminar una ventana de eventos](#delete-event-windows)
## Consideraciones
+ Las horas de los periodos de eventos se indican en UTC.
+ Una ventana de eventos puede contener múltiples rangos de tiempo. Aunque cada rango individual debe ser de al menos 2 horas, la duración total de todos los rangos debe ser de al menos 4 horas.
+ Solo se puede asociar un tipo de destino (ID de instancia, ID de host dedicado o etiqueta de instancia) con un periodo de evento.
+ Un destino (ID de instancia, ID de host dedicado o etiqueta de instancia) solo se puede asociar con un periodo de evento.
+ Se puede asociar un máximo de 100 ID de instancia, 50 ID de host dedicado o 50 etiquetas de instancia con un periodo de evento. Las etiquetas de instancia pueden asociarse con cualquier cantidad de instancias.
+ Se puede crear un máximo de 200 periodos de eventos por región de AWS.
+ Es posible que varias instancias asociadas con periodos de eventos tengan eventos programados que ocurran al mismo tiempo.
+ Si AWS ya ha programado un evento, la modificación de un periodo de evento no cambiará el horario del evento programado. Si el evento tiene una fecha límite, puede [reprogramar el evento](reschedule-event.md).
+ Puede detener e iniciar una instancia antes del evento programado. Esto migra la instancia a un nuevo host y borra el evento.
## Crear un periodo de evento
Puede crear uno o varios periodos de eventos. Para cada periodo de evento, debe especificar uno o varios bloques de tiempo. Por ejemplo, puede crear una ventana de evento con bloques de tiempo que ocurran todos los días a las 4 h durante 2 horas. También puede crear una ventana de evento con bloques de tiempo que ocurran los domingos entre las 2 h y las 4 h y los miércoles entre las 3 h y las 5 h.
Los periodos de eventos se repiten semanalmente hasta que se eliminan.
------
#### [ Console ]
**Para crear un periodo de evento**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events**.
1. Elija **Actions** (Acciones), **Manage event windows** (Administrar periodos de eventos).
1. Seleccione **Create instance event window** (Crear periodo de evento de instancia).
1. En **Event window name** (Nombre del periodo de evento), ingrese un nombre descriptivo para el periodo de evento.
1. En **Event window schedule** (Programación del periodo de evento), elija especificar los bloques de tiempo en el periodo de evento con el generador de programación cron o mediante la especificación de los intervalos de tiempo.
+ Si elige **Cron schedule builder** (Generador de programación cron), especifique lo siguiente:
1. En **Days (UTC)** (Días [UTC]), especifique los días de la semana en los que ocurrirá el periodo de evento.
1. En **Start time (UTC)** (Hora de inicio [UTC]), especifique la hora a la que comenzará el periodo de evento.
1. En **Duration** (Duración), especifique la duración de los bloques de tiempo del periodo de evento. La duración mínima por bloque de tiempo es de 2 horas. La duración mínima del periodo de evento debe ser igual o superior a 4 horas en total. Todas las horas se indican en UTC.
+ Si elige **Time ranges** (Intervalos de tiempo), elija **Add new time range** (Agregar un intervalo de tiempo nuevo) y especifique el día y la hora de inicio y el día y la hora de finalización. Repita este procedimiento para cada intervalo de tiempo. La duración mínima por intervalo de tiempo es de 2 horas. La duración mínima para todos los intervalos de tiempo combinados debe ser igual o superior a 4 horas en total.
1. (Opcional) Para **Detalles del destino**, asocie una o varias instancias con la ventana de eventos. Use los ID de instancia o las etiquetas de instancia para asociar instancias. Use los ID de host para asociar hosts dedicados. Cuando se programe el mantenimiento de estos objetivos, el evento se producirá durante esta ventana de eventos.
Tenga en cuenta que puede crear ventanas de eventos sin asociar un destino al la ventana. Luego, puede modificar el periodo para asociar uno o más destinos.
1. (Opcional) En **Event window tags** (Etiquetas del periodo de evento), elija **Add tag** (Agregar etiqueta) e ingrese la clave y el valor de la etiqueta. Repita este proceso para cada etiqueta.
1. Elija **Create event window (Crear un periodo de evento)**.
------
#### [ AWS CLI ]
**Para crear un periodo de evento con un intervalo de tiempo**
Utilice el comando [create-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-instance-event-window.html).
```
aws ec2 create-instance-event-window \
--time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8 \
--tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
--name myEventWindowName
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"TimeRanges": [
{
"StartWeekDay": "monday",
"StartHour": 2,
"EndWeekDay": "wednesday",
"EndHour": 8
}
],
"Name": "myEventWindowName",
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
**Para crear un periodo de evento con una expresión cron**
Utilice el comando [create-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/create-instance-event-window.html).
```
aws ec2 create-instance-event-window \
--cron-expression "* 21-23 * * 2,3" \
--tag-specifications "ResourceType=instance-event-window,Tags=[{Key=K1,Value=V1}]" \
--name myEventWindowName
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
------
#### [ PowerShell ]
**Para crear un periodo de evento con un intervalo de tiempo**
Utilice el cmdlet [New-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2InstanceEventWindow.html).
```
$timeRange = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange.StartWeekDay = "monday"
$timeRange.EndWeekDay = "wednesday"
$timeRange.StartHour = 2
$timeRange.EndHour = 8
$tag = @{Key="key1"; Value="value1"}
$tagspec = New-Object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "instance-event-window"
$tagspec.Tags.Add($tag)
New-EC2InstanceEventWindow `
-Name my-event-window `
-TagSpecification $tagspec `
-TimeRange @($timeRange)
```
A continuación, se muestra un ejemplo del resultado.
```
AssociationTarget :
CronExpression :
InstanceEventWindowId : iew-0abcdef1234567890
Name : my-event-window
State : creating
Tags : {key1}
TimeRanges : {Amazon.EC2.Model.InstanceEventWindowTimeRange}
```
**Para crear un periodo de evento con una expresión cron**
Utilice el cmdlet [New-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/New-EC2InstanceEventWindow.html).
```
$tag = @{Key="key1"; Value="value1"}
$tagspec = New-Object Amazon.EC2.Model.TagSpecification
$tagspec.ResourceType = "instance-event-window"
$tagspec.Tags.Add($tag)
New-EC2InstanceEventWindow `
-Name my-event-window `
-TagSpecification $tagspec`
-CronExpression "* 21-23 * * 2,3"
```
A continuación, se muestra un ejemplo del resultado.
```
AssociationTarget :
CronExpression : * 21-23 * * 2,3
InstanceEventWindowId : iew-0abcdef1234567890
Name : my-event-window
State : creating
Tags : {key1}
TimeRanges : {}
```
------
## Asociar un destino con un periodo de evento
Después de crear una ventana de eventos, puede asociar destinos a la ventana de eventos. Solo puede asociar un tipo de destino a una ventana de eventos. Puede especificar ID de instancias, ID de hosts dedicados o etiquetas de instancias.
------
#### [ Console ]
**Para asociar destinos con una ventana de eventos**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events (Eventos)**.
1. Seleccione la ventana de eventos que desee modificar.
1. Elija **Acciones**, **Modificar ventana de eventos de instancia**.
------
#### [ AWS CLI ]
**Para asociar las etiquetas de instancia con un periodo de evento**
Utilice el comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [
{
"Key": "k2",
"Value": "v2"
},
{
"Key": "k1",
"Value": "v1"
}
],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Para asociar las ID de instancia con una ventana de eventos**
Utilice el comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [
"i-1234567890abcdef0",
"i-0598c7d356eba48d7"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Para asociar un host dedicado con un periodo de evento**
Utilice el comando [associate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/associate-instance-event-window.html).
```
aws ec2 associate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "DedicatedHostIds=h-029fa35a02b99801d"
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": [
"h-029fa35a02b99801d"
]
},
"State": "creating"
}
}
```
------
#### [ PowerShell ]
**Para asociar las etiquetas de instancia con un periodo de evento**
Utilice el cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).
```
$tag1 = @{Key="key1"; Value="value1"}
$tag2 = @{Key="key2"; Value="value2"}
Register-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_InstanceTag @($tag1,$tag2)
```
**Para asociar las ID de instancia con una ventana de eventos**
Utilice el cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).
```
Register-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_InstanceId i-1234567890abcdef0, i-0598c7d356eba48d7
```
**Para asociar un host dedicado con un periodo de evento**
Utilice el cmdlet [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).
```
Register-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_DedicatedHostId h-029fa35a02b99801d
```
------
## Desasociar un destino de una ventana de eventos
------
#### [ Console ]
**Para desasociar destinos de una ventana de eventos**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events (Eventos)**.
1. Seleccione la ventana de eventos que desee modificar.
1. Elija **Acciones**, **Modificar ventana de eventos de instancia**.
------
#### [ AWS CLI ]
**Para desasociar las etiquetas de instancia de un periodo de evento**
Utilice el comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference//ec2/disassociate-instance-event-window.html).
```
aws ec2 disassociate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceTags=[{Key=k2,Value=v2},{Key=k1,Value=v1}]"
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Para desasociar las ID de instancia de una ventana de eventos**
Utilice el comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-instance-event-window.html).
```
aws ec2 disassociate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target "InstanceIds=i-1234567890abcdef0,i-0598c7d356eba48d7"
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Para desasociar un host dedicado de un periodo de evento**
Utilice el comando [disassociate-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/disassociate-instance-event-window.html).
```
aws ec2 disassociate-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--association-target DedicatedHostIds=h-029fa35a02b99801d
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
------
#### [ PowerShell ]
**Para desasociar las etiquetas de instancia de un periodo de evento**
Utilice el cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).
```
$tag1 = @{Key="key1"; Value="value1"}
$tag2 = @{Key="key2"; Value="value2"}
Unregister-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_InstanceTag @($tag1, $tag2)
```
**Para desasociar las ID de instancia de una ventana de eventos**
Utilice el cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).
```
Unregister-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_InstanceId i-1234567890abcdef0, i-0598c7d356eba48d7
```
**Para desasociar un host dedicado de un periodo de evento**
Utilice el cmdlet [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).
```
Unregister-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_DedicatedHostId h-029fa35a02b99801d
```
------
## Modificar una ventana de eventos
Puede modificar todos los campos de una ventana de evento excepto su ID. Por ejemplo, es posible que desee modificar la programación del periodo de evento cuando comience el horario de verano. Es posible que desee agregar o eliminar destinos para los periodos de eventos existentes.
Cuando modifica el periodo de evento, puede modificar un intervalo de tiempo o una expresión cron, pero no ambos.
------
#### [ Console ]
**Para modificar un periodo de evento**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events**.
1. Elija **Actions** (Acciones), **Manage event windows** (Administrar periodos de eventos).
1. Seleccione el periodo de evento que desea modificar y, luego, elija **Actions** (Acciones), **Modify instance event window** (Modificar periodo de evento de instancia).
1. Modifique los campos del periodo de evento y, luego, elija**Modify event window** (Modificar periodo de evento).
------
#### [ AWS CLI ]
**Para modificar el intervalo de tiempo de un periodo de evento**
Utilice el comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).
```
aws ec2 modify-instance-event-window
--instance-event-window-id iew-0abcdef1234567890 \
--time-range StartWeekDay=monday,StartHour=2,EndWeekDay=wednesday,EndHour=8
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"TimeRanges": [
{
"StartWeekDay": "monday",
"StartHour": 2,
"EndWeekDay": "wednesday",
"EndHour": 8
}
],
"Name": "myEventWindowName",
"AssociationTarget": {
"InstanceIds": [
"i-0abcdef1234567890",
"i-0be35f9acb8ba01f0"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
**Para modificar un conjunto de intervalos de tiempo para un periodo de evento**
Utilice el comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).
```
aws ec2 modify-instance-event-window
--instance-event-window-id iew-0abcdef1234567890 \
--time-range '[{"StartWeekDay": "monday", "StartHour": 2, "EndWeekDay": "wednesday", "EndHour": 8},
{"StartWeekDay": "thursday", "StartHour": 2, "EndWeekDay": "friday", "EndHour": 8}]'
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"TimeRanges": [
{
"StartWeekDay": "monday",
"StartHour": 2,
"EndWeekDay": "wednesday",
"EndHour": 8
},
{
"StartWeekDay": "thursday",
"StartHour": 2,
"EndWeekDay": "friday",
"EndHour": 8
}
],
"Name": "myEventWindowName",
"AssociationTarget": {
"InstanceIds": [
"i-0abcdef1234567890",
"i-0be35f9acb8ba01f0"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
**Para modificar la expresión cron de un periodo de evento**
Utilice el comando [modify-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-event-window.html).
```
aws ec2 modify-instance-event-window
--instance-event-window-id iew-0abcdef1234567890 \
--cron-expression "* 21-23 * * 2,3"
```
A continuación, se muestra un ejemplo del resultado.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [
"i-0abcdef1234567890",
"i-0be35f9acb8ba01f0"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
------
#### [ PowerShell ]
**Para modificar el intervalo de tiempo de un periodo de evento**
Utilice el cmdlet [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html).
```
$timeRange1 = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange1.StartWeekDay = "monday"
$timeRange1.EndWeekDay = "wednesday"
$timeRange1.StartHour = 2
$timeRange1.EndHour = 8
$timeRange2 = New-Object Amazon.EC2.Model.InstanceEventWindowTimeRangeRequest
$timeRange2.StartWeekDay = "thursday"
$timeRange2.EndWeekDay = "friday"
$timeRange2.StartHour = 1
$timeRange2.EndHour = 6
Edit-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-TimeRange @($timeRange1, $timeRange2)
```
**Para modificar la expresión cron de un periodo de evento**
Utilice el cmdlet [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html).
```
Edit-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-CronExpression "* 21-23 * * 2,3"
```
------
## Eliminar una ventana de eventos
Puede eliminar una ventana de eventos a la vez.
------
#### [ Console ]
**Para eliminar un periodo de evento**
1. Abra la consola de Amazon EC2 en [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. En el panel de navegación, seleccione **Events**.
1. Elija **Actions** (Acciones), **Manage event windows** (Administrar periodos de eventos).
1. Seleccione el periodo de evento que desea eliminar y, luego, elija **Actions** (Acciones), **Delete instance event window** (Eliminar periodo de evento de instancia).
1. Cuando se le pregunte, escriba **delete** y, a continuación, elija **Delete (Eliminar)**.
------
#### [ AWS CLI ]
**Para eliminar un periodo de evento**
Utilice el comando [delete-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-instance-event-window.html) y especifique el periodo de evento que se eliminará.
```
aws ec2 delete-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890
```
**Para forzar la eliminación de una ventana de eventos**
Utilice el parámetro `--force-delete` si el periodo de evento está asociado actualmente con los destinos.
```
aws ec2 delete-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--force-delete
```
------
#### [ PowerShell ]
**Para eliminar un periodo de evento**
Utilice el cmdlet [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html).
```
Remove-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890
```
**Para forzar la eliminación de una ventana de eventos**
Utilice el cmdlet [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html).
```
Remove-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-ForceDelete $true
```
------