Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
# Événements programmés pour les instances Amazon EC2
Pour garantir la fiabilité et les performances de l'infrastructure, AWS vous pouvez planifier des événements pour redémarrer, arrêter et mettre hors service vos instances. Ces événements ne se produisent pas fréquemment.
Si l'une de vos instances est affectée par un événement programmé, vous en AWS informera à l'avance par e-mail, en utilisant l'adresse e-mail associée à votre AWS compte. Cet e-mail fournit des détails concernant l’événement, tels que les dates de début et de fin. Selon le type d'événement, vous pouvez peut-être prendre des mesures pour contrôler le calendrier de l'événement. AWS envoie également un AWS Health événement, que vous pouvez surveiller et gérer à l'aide d'Amazon EventBridge. Pour plus d'informations, consultez [la section Surveillance des événements AWS Health avec Amazon EventBridge](https://docs.aws.amazon.com/health/latest/ug/cloudwatch-events-health.html).
Les événements programmés sont gérés par AWS. Vous ne pouvez pas planifier d’événements pour vos instances. Toutefois, vous pouvez :
+ afficher les événements planifiés pour vos instances ;
+ personnaliser les notifications d’événements planifiés afin d’inclure ou de supprimer les balises de la notification par e-mail ;
+ reprogrammer certains événements planifiés ;
+ créer des fenêtres d’événements personnalisées pour les événements planifiés
+ prendre des mesures lorsque le redémarrage, l’arrêt ou la mise hors service d’une instance est planifié.
Pour vous assurer de recevoir des notifications concernant les événements planifiés, vérifiez vos coordonnées sur la page [Compte](https://console.aws.amazon.com/billing/home?#/account).
**Note**
Lorsqu’une instance est affectée par un événement planifié et qu’elle fait partie d’un groupe Auto Scaling, Amazon EC2 Auto Scaling finit par la remplacer dans le cadre de ses surveillances de l’état, sans aucune autre action nécessaire de votre part. Pour plus d'informations sur les surveillances de l'état réalisés par Amazon EC2 Auto Scaling, consultez [Surveillance de l'état des instances d'un groupe Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/ec2-auto-scaling-health-checks.html) dans le *Guide de l'utilisateur d'Amazon EC2 Auto Scaling*.
## Types d’événements planifiés
Amazon EC2 peut créer les types d’événements planifiés suivants pour vos instances, où l’événement se produit à une heure planifiée :
| Type d’événement | Code de l'événement | Action d’événement |
| --- | --- | --- |
| Arrêt de l’instance | instance-stop | À l’heure planifiée, l’instance est arrêtée. Lorsque vous la redémarrez, elle est migrée vers un nouvel hôte. S’applique uniquement aux instances dotées d’un volume racine Amazon EBS. |
| Mise hors service d’instance | instance-retirement | À l’heure planifiée, l’instance est arrêtée si elle possède un volume racine Amazon EBS, ou résiliée si elle possède un volume racine de stockage d’instance. |
| Redémarrage d’instance | instance-reboot | À l’heure planifiée, l’instance est redémarrée. L’instance reste sur l’hôte, et pendant le redémarrage, l’hôte fait l’objet d’une maintenance. Cette opération est appelée redémarrage en place. |
| Redémarrage du système | system-reboot | À l’heure planifiée, l’instance est redémarrée et transférée vers un nouvel hôte. Cette opération est appelée migration par redémarrage. |
| Maintenance du système | system-maintenance | À l’heure planifiée, l’instance peut être temporairement affectée par une maintenance du réseau ou de l’alimentation électrique. |
## Détermination du type d’événement
Vous pouvez vérifier quel type d’événement est planifié pour votre instance.
------
#### [ Console ]
**Pour déterminer le type d’événement**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le panneau de navigation, sélectionnez **Events**.
1. Dans le tableau, le code d’événement apparaît dans la colonne **Type d’événement**.
1. Pour filtrer le tableau afin de n’afficher que les événements relatifs aux instances, dans le champ de recherche, choisissez **Type de ressource : instance** dans la liste des filtres.
------
#### [ AWS CLI ]
**Pour déterminer le type d’événement pour une instance**
Utilisez la commande [describe-instance-status](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-status.html). Si un événement planifié est associé à l’instance, la sortie fournit des informations sur l’événement planifié.
```
aws ec2 describe-instance-status \
--instance-id i-1234567890abcdef0 \
--query InstanceStatuses[].Events
```
Voici un exemple de sortie. Le code de l’événement planifié est `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 ]
**Pour déterminer le type d’événement pour une instance**
Utilisez l’applet de commande [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html). Si un événement planifié est associé à l’instance, la sortie fournit des informations sur l’événement planifié.
```
(Get-EC2InstanceStatus `
-InstanceId i-1234567890abcdef0).Events
```
Voici un exemple de sortie. Le code de l’événement planifié est `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**
+ [
## Types d’événements planifiés
](#types-of-scheduled-events)
+ [
## Détermination du type d’événement
](#scheduled-event-type)
+ [
# Gestion des instances Amazon EC2 dont l’arrêt ou la mise hors service est planifié
](schedevents_actions_retire.md)
+ [
# Gestion des instances Amazon EC2 dont le redémarrage est planifié
](schedevents_actions_reboot.md)
+ [
# Gestion des instances Amazon EC2 dont la maintenance est planifiée
](schedevents_actions_maintenance.md)
+ [
# Affichez les événements programmées qui affectent vos instances Amazon EC2
](viewing_scheduled_events.md)
+ [
# Personnalisation des notifications par e-mail pour les événements programmés qui affectent les instances Amazon EC2
](customizing_scheduled_event_notifications.md)
+ [
# Replanification d’un événement planifié pour une instance EC2
](reschedule-event.md)
+ [
# Créez des fenêtres d'événements personnalisées pour les événements programmés qui affectent vos instances Amazon EC2
](event-windows.md)
# Gestion des instances Amazon EC2 dont l’arrêt ou la mise hors service est planifié
Lorsqu'il AWS détecte une défaillance irréparable de l'hôte sous-jacent de votre instance, il planifie l'arrêt ou la résiliation de l'instance, en fonction du type de volume racine de l'instance.
+ Si l’instance dispose d’un volume racine Amazon EBS, l’arrêt de l’instance est planifié.
+ Si l’instance dispose d’un volume de stockage d’instances, la résiliation de l’instance est planifiée.
Pour de plus amples informations, veuillez consulter [Mise hors service d’instance](instance-retirement.md).
**Important**
Les données stockées sur des volumes de stockage d’instance sont perdues lorsque l’instance est arrêtée, mise en veille prolongée ou résiliée. Ceci inclut les volumes de stockage d’instances attachés à une instance ayant un volume racine EBS. Veillez à enregistrer les données de vos volumes de stockage d’instance dont vous aurez besoin ultérieurement avant que l’instance ne soit arrêtée, mise en veille prolongée ou résiliée.
## Actions que vous pouvez entreprendre
**Actions que vous pouvez effectuer pour les instances disposant d’un volume racine EBS**
Lorsque vous recevez une notification d’événement `instance-stop` planifié, vous pouvez effectuer une des actions suivantes :
+ **Attendre l’arrêt planifié :** vous pouvez attendre que l’instance s’arrête dans sa fenêtre de maintenance planifiée.
+ **Effectuer un arrêt et un démarrage manuels :** vous pouvez arrêter et démarrer l’instance vous-même à un moment qui vous convient, ce qui la transfert vers un nouvel hôte. Ce n’est pas la même chose que le redémarrage de l’instance. Pour de plus amples informations, veuillez consulter [Arrêtez et démarrez des instances Amazon EC2](Stop_Start.md).
+ **Automatiser l’arrêt et le démarrage :** vous pouvez automatiser un arrêt immédiat et un démarrage en réponse à un événement `instance-stop` planifié. Pour plus d'informations, consultez [Exécution automatique d'opérations sur les instances EC2 en réponse aux événements décrits AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) dans le *AWS Health Guide de l'utilisateur*.
**Actions que vous pouvez effectuer pour les instances disposant d’un volume racine de stockage d’instances**
Lorsque vous recevez une notification d’événement `system-retirement` planifié et que vous souhaitez conserver vos données, vous pouvez prendre les mesures suivantes :
1. Lancez une instance de remplacement à partir de votre AMI la plus récente.
1. Effectuez la migration de toutes les données nécessaires vers l’instance de remplacement avant que la résiliation de l’instance ne soit planifiée.
1. Résiliez l’instance d’origine ou attendez qu’elle soit résiliée comme prévu.
Pour plus d’informations sur les actions que vous pouvez entreprendre, consultez la section [Mise hors service d’instance](instance-retirement.md).
# Gestion des instances Amazon EC2 dont le redémarrage est planifié
Lorsqu'il AWS doit effectuer des tâches telles que l'installation de mises à jour ou la maintenance de l'hôte sous-jacent, il peut planifier le redémarrage de l'instance. Au cours du redémarrage planifié, l’instance reste sur le même hôte ou est transférée vers un autre hôte, selon l’événement, comme suit :
+ `instance-reboot` event
+ Pendant le redémarrage, l’instance reste sur l’hôte. Cette opération est appelée *redémarrage en place*.
+ L’hôte actuel fait l’objet d’une maintenance.
+ Se termine généralement en quelques secondes.
+ `system-reboot` event
+ Lors du redémarrage, l’instance est transférée vers un nouvel hôte. Cette opération est appelée *migration par redémarrage*.
+ Se termine généralement en quelques minutes.
Pour vérifier quel type d’événement est planifié pour votre instance, consultez la section [Détermination du type d’événement](monitoring-instances-status-check_sched.md#scheduled-event-type).
## Actions que vous pouvez entreprendre
Lorsque vous recevez une notification d’événement planifié `instance-reboot` ou `system-reboot`, vous pouvez effectuer l’une des actions suivantes :
+ **Attendre le redémarrage planifié :** vous pouvez attendre que le redémarrage de l’instance ait lieu pendant la période de maintenance planifiée.
+ **Replanifier le redémarrage :** vous pouvez [replanifier](reschedule-event.md) le redémarrage de l’instance à une date et heure qui vous conviennent.
+ **Effectuer un redémarrage initié par l’utilisateur :** vous pouvez [redémarrer](ec2-instance-reboot.md) vous-même l’instance manuellement au moment qui vous convient. Toutefois, le résultat dépend de l’événement :
+ Événement `instance-reboot` : votre instance reste sur le matériel actuel (redémarrage en place), aucune maintenance de l’hôte n’a lieu et l’événement reste ouvert.
+ `system-reboot` event
+ Si la migration par redémarrage est activée sur votre instance, un redémarrage initié par l’utilisateur tente de transférer votre instance vers un nouveau matériel. En cas de succès, l’événement est annulé. En cas d’échec, un redémarrage en place a lieu et l’événement reste planifié.
+ Si la migration par redémarrage est désactivée sur votre instance, un redémarrage initié par l’utilisateur permet de maintenir l’instance sur le même matériel (redémarrage en place), aucune maintenance de l’hôte n’a lieu et l’événement reste planifié. Lorsque l'événement planifié aura finalement lieu, votre instance AWS sera déplacée vers un nouveau matériel (redémarrage de la migration).
**Après le AWS redémarrage de votre instance**
Ce qui suit s'applique après AWS le redémarrage de votre instance :
+ L’événement planifié est supprimé.
+ La description de l’événement est mise à jour.
+ Pour un événement `instance-reboot` :
+ La maintenance de l’hôte sous-jacent est terminée.
+ Pour un événement `system-reboot` :
+ L’instance est déplacée vers un nouvel hôte.
+ L’instance conserve son adresse IP et son nom DNS.
+ Toutes les données se trouvant sur les volumes locaux du stockage d’instances sont préservées.
+ Vous pouvez utiliser votre instance après son démarrage complet.
**Options alternatives**
Si vous ne parvenez pas à replanifier l’événement de redémarrage ou à activer la migration par redémarrage pour un redémarrage initié par l’utilisateur, mais que vous souhaitez maintenir un fonctionnement normal pendant la période de maintenance planifiée, vous pouvez effectuer les opérations suivantes :
+ **Pour une instance avec un volume racine EBS**
+ Arrêtez et démarrez manuellement l’instance pour la transférer vers un nouvel hôte. Ce n’est pas la même chose que le redémarrage manuel de l’instance, où celle-ci reste sur le même hôte.
+ Il est également possible d’automatiser l’arrêt et le démarrage immédiats de l’instance en réponse à l’événement de redémarrage planifié. Pour plus d'informations, consultez [Exécution automatique d'opérations sur les instances EC2 en réponse aux événements décrits AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) dans le *AWS Health Guide de l'utilisateur*.
**Important**
Les données des volumes de stockage d’instances sont perdues lorsqu’une instance est arrêtée. Pour de plus amples informations, veuillez consulter [Arrêtez et démarrez des instances Amazon EC2](Stop_Start.md).
+ **Pour une instance disposant d’un volume racine de stockage d’instances**
1. Lancez une instance de remplacement à partir de votre AMI la plus récente.
1. Procédez à la migration de toutes les données nécessaires vers l’instance de remplacement avant la fenêtre de maintenance planifiée.
1. Résiliez l’instance d’origine.
## Activation ou désactivation de la migration par redémarrage
Lorsqu’un événement `system-reboot` est planifié pour une instance, vous pouvez la redémarrer avant l’événement. Le résultat d’un redémarrage initié par l’utilisateur dépend du paramètre de migration par redémarrage de l’instance :
+ Activé : un redémarrage initié par l’utilisateur tente de transférer votre instance vers un nouveau matériel (migration par redémarrage). En cas de succès, l’événement est annulé. En cas d’échec, un redémarrage en place a lieu et l’événement reste planifié. Notez que même lorsqu’elle est activée, la migration par redémarrage ne peut avoir lieu que si votre instance répond aux [exigences de migration par redémarrage](#requirements-for-reboot-migration).
+ Désactivé : un redémarrage initié par l’utilisateur maintient l’instance sur le même matériel (redémarrage en place), aucune maintenance de l’hôte n’a lieu et l’événement reste planifié. Lorsque l'événement planifié aura finalement lieu, votre instance AWS sera déplacée vers un nouveau matériel (redémarrage de la migration).
Un redémarrage avec migration prend plus de temps qu’un redémarrage en place :
+ Redémarrage en place : environ 30 secondes
+ Redémarrage avec migration : plusieurs minutes
**Note**
La migration par redémarrage initiée par l’utilisateur est activée par défaut pour les instances qui reçoivent une notification d’événement `system-reboot`.
### Conditions relatives à l’activation de la migration par redémarrage
La migration par redémarrage peut être activée sur les instances qui répondent aux critères suivants :
**Types d’instances**
Tous les types d’instance ne prennent pas en charge l’activation de la migration par redémarrage. Vous pouvez afficher les types d’instance qui prennent en charge l’activation de la migration par redémarrage.
**Pour afficher les types d’instance qui prennent en charge l’activation de la migration par redémarrage**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le panneau de navigation de gauche, choisissez **Instance Types** (Types d’instance).
1. Dans la barre de filtre, saisissez **Prise en charge de la migration par démarrage : prise en charge** Au fur et à mesure que vous saisissez les caractères et que le nom du filtre apparaît, vous pouvez le sélectionner.
La table **Types d’instance** affiche tous les types d’instance prenant en charge l’activation de la migration par redémarrage.
**Pour afficher les types d’instance qui prennent en charge l’activation de la migration par redémarrage**
Utilisez la commande [describe-instance-types](https://docs.aws.amazon.com/cli/latest/reference/ec2/describe-instance-types.html) avec le filtre `reboot-migration-support`.
```
aws ec2 describe-instance-types \
--filters Name=reboot-migration-support,Values=supported \
--query "InstanceTypes[*].[InstanceType]" \
--output text | sort
```
**Pour afficher les types d’instance qui prennent en charge l’activation de la migration par redémarrage**
Utilisez l'[Get-EC2InstanceType](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceType.html)applet de commande avec le `reboot-migration-support` filtre.
```
Get-EC2InstanceType `
-Filter @{Name="reboot-migration-support";Values="true"} | `
Select InstanceType | Sort-Object InstanceType
```
**Tenancy**
+ Partagé
+ Dedicated Instance
Pour de plus amples informations, veuillez consulter [Instances EC2 dédiées Amazon](dedicated-instance.md).
**Limites**
La migration par redémarrage **n’est pas** prise en charge pour les instances présentant les caractéristiques suivantes :
+ Plateforme : instances exécutées de manière native sur l’hyperviseur Xen
+ Taille de l’instance : instances `metal`
+ Location : hôte dédié. Pour les hôtes dédiés, utilisez plutôt la [récupération automatique de l’hôte dédié](dedicated-hosts-recovery.md).
+ Stockage : instances avec volumes de stockage d’instance
+ Mise en réseau : instances utilisant un adaptateur Elastic Fabric Adapter
+ Auto Scaling : instances qui font partie d’un groupe Auto Scaling
### Étapes pour activer ou désactiver la migration par redémarrage
La migration par redémarrage est activée par défaut lorsqu’une instance reçoit un événement `system-reboot`. Vous pouvez désactiver la migration par redémarrage afin que, lors d’un redémarrage initié par l’utilisateur, l’instance reste sur le même matériel (redémarrage en place).
La configuration `default` ne permet pas la migration par redémarrage pour une instance non prise en charge. Pour de plus amples informations, veuillez consulter [Conditions relatives à l’activation de la migration par redémarrage](#requirements-for-reboot-migration).
Vous pouvez désactiver ou activer la migration par redémarrage sur une instance en cours d’exécution ou arrêtée.
------
#### [ AWS CLI ]
**Pour désactiver la migration par redémarrage**
Utilisez la [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html)commande et définissez le `--reboot-migration` paramètre sur`disabled`.
```
aws ec2 modify-instance-maintenance-options \
--instance-id i-0abcdef1234567890 \
--reboot-migration disabled
```
**Pour activer la migration par redémarrage**
Utilisez la [modify-instance-maintenance-options](https://docs.aws.amazon.com/cli/latest/reference/ec2/modify-instance-maintenance-options.html)commande et définissez le `--reboot-migration` paramètre sur`default`.
```
aws ec2 modify-instance-maintenance-options \
--instance-id i-0abcdef1234567890 \
--reboot-migration default
```
------
#### [ PowerShell ]
**Pour désactiver la migration par redémarrage**
Utilisez l’applet de commande [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html).
```
Edit-EC2InstanceMaintenanceOption `
-InstanceId `
-RebootMigration Disabled
```
**Pour activer la migration par redémarrage**
Utilisez l’applet de commande [Edit-EC2InstanceMaintenanceOption](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceMaintenanceOption.html).
```
Edit-EC2InstanceMaintenanceOption `
-InstanceId i-1234567890abcdef0 `
-RebootMigration Enabled
```
------
# Gestion des instances Amazon EC2 dont la maintenance est planifiée
Lorsqu' AWS il doit gérer l'hôte sous-jacent d'une instance, il planifie la maintenance de l'instance. Il existe deux types d’événements de maintenance : maintenance du réseau et maintenance de l’alimentation.
+ Lors d’une maintenance du réseau, les instances planifiées perdent leur connectivité réseau pendant une courte période. La connectivité réseau normale vers votre instance est restaurée une fois la maintenance terminée.
+ Lors d’une maintenance de l’alimentation, les instances planifiées sont mises hors ligne pendant une courte période, puis redémarrées. Lorsqu’un redémarrage est effectué, les paramètres de configuration de votre instance sont conservés.
Une fois que votre instance a redémarré (cela prend normalement quelques minutes), vérifiez que votre application fonctionne comme prévu. À ce stade, votre instance ne devrait plus avoir d’événement planifié associé. Dans le cas contraire, la description de l’événement planifié commence par **[Terminé]**. Cela peut parfois prendre jusqu’à 1 heure pour que la description de statut de cette instance soit actualisée. Les événements de maintenance terminés restent affichés sur le tableau de bord de la console Amazon EC2 pendant une semaine maximum.
## Actions que vous pouvez entreprendre
**Actions que vous pouvez effectuer pour les instances disposant d’un volume racine EBS**
Lorsque vous recevez une notification d’événement `system-maintenance`, vous pouvez effectuer une des actions suivantes :
+ **Attendre la maintenance planifiée :** vous pouvez attendre que la maintenance ait lieu comme prévu.
+ **Effectuer un arrêt et un démarrage manuels :** vous pouvez arrêter et démarrer l’instance, ce qui a pour effet de la transférer vers un nouvel hôte. Ce n’est pas la même chose que le redémarrage de l’instance. Pour de plus amples informations, veuillez consulter [Arrêtez et démarrez des instances Amazon EC2](Stop_Start.md).
+ **Automatiser l’arrêt et le démarrage :** vous pouvez automatiser un arrêt immédiat et un démarrage en réponse à un événement de maintenance planifié. Pour plus d'informations, consultez [Exécution automatique d'opérations sur les instances EC2 en réponse aux événements décrits AWS Health](https://docs.aws.amazon.com/health/latest/ug/automating-instance-actions.html) dans le *AWS Health Guide de l'utilisateur*.
**Actions que vous pouvez effectuer pour les instances disposant d’un volume racine de stockage d’instances**
Lorsque vous recevez une notification d’événement `system-maintenance`, vous pouvez effectuer une des actions suivantes :
+ **Attendre la maintenance planifiée :** vous pouvez attendre que la maintenance ait lieu comme prévu.
+ **Lancer une instance de remplacement :** si vous souhaitez maintenir un fonctionnement normal pendant la période de maintenance planifiée :
1. Lancez une instance de remplacement à partir de votre AMI la plus récente.
1. Procédez à la migration de toutes les données nécessaires vers l’instance de remplacement avant la fenêtre de maintenance planifiée.
1. Résiliez l’instance d’origine.
# Affichez les événements programmées qui affectent vos instances Amazon EC2
En plus de recevoir une notification des événements planifiés par e-mail, vous pouvez vérifier la présence d’événements planifiés.
------
#### [ Console ]
**Pour afficher les événements planifiés pour vos instances**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Le tableau de bord affiche toutes les ressources avec un événement associé sous **Événements planifiés**.
![\[Affichage d’événements à l’aide du tableau de bord.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/dashboard-scheduled-events.png)
1. Pour obtenir plus de détails, sélectionnez **Événements** dans le volet de navigation. Toutes les ressources avec un événement associé sont affichées. Vous pouvez filtrer par caractéristiques telles que le type d’événement, le type de ressource et la zone de disponibilité.
![\[Affichage d’événements à l’aide de la page Événements.\]](http://docs.aws.amazon.com/fr_fr/AWSEC2/latest/UserGuide/images/events-instance-scheduled-stop.png)
------
#### [ AWS CLI ]
**Pour afficher les événements planifiés pour vos instances**
Utilisez la commande [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"
```
L’exemple de sortie suivant montre un événement de redémarrage :
```
[
"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"
}
]
]
```
Voici un exemple de sortie montrant un événement de mise hors service d’instance.
```
[
"Events": [
{
"InstanceEventId": "instance-event-0e439355b779n26",
"Code": "instance-stop",
"Description": "The instance is running on degraded hardware",
"NotBefore": "2015-05-23T00:00:00.000Z"
}
]
]
```
------
#### [ PowerShell ]
**Pour afficher les événements planifiés pour vos instances**
Utilisez la commande [Get-EC2InstanceStatus](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceStatus.html) suivante.
```
(Get-EC2InstanceStatus -InstanceId i-1234567890abcdef0).Events
```
Voici un exemple de sortie montrant un événement de mise hors service d’instance.
```
Code : instance-stop
Description : The instance is running on degraded hardware
NotBefore : 5/23/2015 12:00:00 AM
```
------
#### [ Instance metadata ]
**Pour afficher les événements planifiés pour vos instances à l’aide des métadonnées de l’instance**
Vous pouvez récupérer des informations sur les événements de maintenance actifs pour vos instances à partir des [métadonnées de l’instance](ec2-instance-metadata.md) à l’aide de Service des métadonnées d’instance Version 2 ou Service des métadonnées d’instance Version 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
```
Voici un exemple de sortie avec des informations sur un événement de redémarrage système planifié, au format 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"
}
]
```
**Pour afficher l’historique des événements terminés ou annulés pour vos instances à l’aide des métadonnées de l’instance**
Vous pouvez récupérer des informations sur les événements terminés ou annulés pour vos instances à partir des [métadonnées de l’instance](ec2-instance-metadata.md) à l’aide de Service des métadonnées d’instance Version 2 ou Service des métadonnées d’instance Version 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
```
Voici un exemple de sortie avec des informations sur un événement de redémarrage du système qui a été annulé et un événement de redémarrage du système qui a été terminé, au format 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 ]
Vous pouvez utiliser le Tableau de bord AWS Health pour en savoir plus sur les événements susceptibles d'affecter votre instance. Il Tableau de bord Health organise les problèmes en trois groupes : les problèmes ouverts, les modifications planifiées et les autres notifications. Le groupe des modifications planifiées contient des éléments qui sont en cours ou à venir.
Pour plus d’informations, consultez [Premiers pas avec le Tableau de bord AWS Health](https://docs.aws.amazon.com/health/latest/ug/getting-started-health-dashboard.html) dans le *Guide de l’utilisateur AWS Health *.
------
# Personnalisation des notifications par e-mail pour les événements programmés qui affectent les instances Amazon EC2
Vous pouvez personnaliser les notifications d’événements planifiés pour inclure des balises dans la notification par e-mail. Cela facilite l’identification de la ressource affectée (instances ou Hôtes dédiés) et la hiérarchisation des actions pour l’événement à venir.
Lorsque vous personnalisez les notifications d’événements pour inclure des balises, vous pouvez choisir d’inclure :
+ Toutes les balises associées à la ressource affectée
+ Seules les balises spécifiques associées à la ressource affectée
Par exemple, supposons que vous assignez les balises `application`, `costcenter`, `project` et `owner` à toutes vos instances. Vous pouvez choisir d’inclure toutes les balises dans les notifications d’événements. Sinon, si vous souhaitez afficher uniquement les balises `owner` et `project` dans les notifications d’événements, vous pouvez choisir d’inclure uniquement ces balises.
Après avoir sélectionné les balises à inclure, les notifications d’événement incluront l’ID de ressource (ID d’instance ou Hôte dédié) et les paires clé de balise et valeur associées à la ressource affectée.
**Topics**
+ [
## Inclure des balises dans les notifications d’événements
](#register-tags)
+ [
## Supprimer les balises des notifications d’événements
](#deregister-tags)
+ [
## Afficher les balises à inclure dans les notifications d’événements
](#view-tags)
## Inclure des balises dans les notifications d’événements
Les balises que vous choisissez d’inclure s’appliquent à toutes les ressources (instances et Hôtes dédiés) de la région sélectionnée. Pour personnaliser les notifications d’événements dans d’autres régions, sélectionnez d’abord la région requise, puis effectuez les étapes suivantes.
------
#### [ Console ]
**Pour inclure des balises dans les notifications d’événements**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le volet de navigation, sélectionnez **Événements**.
1. Choisissez **Actions**, **Manage event notifications (Gérer les notifications d’événements)**.
1. Activez **Inclure des balises dans les notifications d’événements**.
1. Faites l’une des opérations suivantes, en fonction des balises que vous souhaitez inclure dans les notifications d’événement :
+ Pour inclure toutes les balises associées à l’instance affectée ou Hôte dédié, sélectionnez **Inclure toutes les balises de ressource**.
+ Pour sélectionner les balises à inclure, sélectionnez **Choisir les balises à inclure**, puis sélectionnez ou saisissez les clés de balise.
1. Choisissez **Enregistrer**.
------
#### [ AWS CLI ]
**Pour inclure toutes les balises dans les notifications d’événements**
Utilisez la commande [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) et définissez le `IncludeAllTagsOfInstance` paramètre sur. `true`
```
aws ec2 register-instance-event-notification-attributes \
--instance-tag-attribute "IncludeAllTagsOfInstance=true"
```
**Pour inclure des balises spécifiques dans les notifications d’événements**
Utilisez la commande [register-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/register-instance-event-notification-attributes.html) et spécifiez les balises à inclure à l'aide du `InstanceTagKeys` paramètre.
```
aws ec2 register-instance-event-notification-attributes \
--instance-tag-attribute 'InstanceTagKeys=["tag_key_1", "tag_key_2", "tag_key_3"]'
```
------
#### [ PowerShell ]
**Pour inclure toutes les balises dans les notifications d’événements**
Utilisez l’applet de commande [Register-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventNotificationAttribute.html).
```
Register-EC2InstanceEventNotificationAttribute `
-InstanceTagAttribute_IncludeAllTagsOfInstance $true
```
**Pour inclure des balises spécifiques dans les notifications d’événements**
Utilisez l’applet de commande [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
```
------
## Supprimer les balises des notifications d’événements
Vous pouvez supprimer les balises des notifications d’événements.
------
#### [ Console ]
**Pour supprimer les balises des notifications d’événements**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le volet de navigation, sélectionnez **Événements**.
1. Choisissez **Actions**, **Manage event notifications (Gérer les notifications d’événements)**.
1. Pour supprimer toutes les balises des notifications d’événement, désactivez **Inclure des balises dans les notifications d’événement**.
1. Pour supprimer des balises spécifiques des notifications d’événements, sélectionnez le **X**) pour les clés de balise correspondantes.
1. Choisissez **Enregistrer**.
------
#### [ AWS CLI ]
**Pour supprimer toutes les balises des notifications d’événements**
Utilisez la commande [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) et définissez le `IncludeAllTagsOfInstance` paramètre sur. `false`
```
aws ec2 deregister-instance-event-notification-attributes \
--instance-tag-attribute "IncludeAllTagsOfInstance=false"
```
**Pour supprimer une balise des notifications d’événements**
Utilisez la commande [deregister-instance-event-notification-attributes](https://docs.aws.amazon.com/cli/latest/reference/ec2/deregister-instance-event-notification-attributes.html) et spécifiez les balises à supprimer à l'aide du `InstanceTagKeys` paramètre.
```
aws ec2 deregister-instance-event-notification-attributes \
--instance-tag-attribute 'InstanceTagKeys=["tag_key_3"]'
```
------
#### [ PowerShell ]
**Pour supprimer toutes les balises des notifications d’événements**
Utilisez l’applet de commande [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html).
```
Unregister-EC2InstanceEventNotificationAttribute `
-InstanceTagAttribute_IncludeAllTagsOfInstance $false
```
**Pour supprimer une balise des notifications d’événements**
Utilisez l’applet de commande [Unregister-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventNotificationAttribute.html).
```
Unregister-EC2InstanceEventNotificationAttribute `
-InstanceTagAttribute_InstanceTagKey tag_key_3
```
------
## Afficher les balises à inclure dans les notifications d’événements
Vous pouvez afficher les balises qui doivent être incluses dans les notifications d’événements.
------
#### [ Console ]
**Pour afficher les balises à inclure dans les notifications d’événements**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le volet de navigation, sélectionnez **Événements**.
1. Choisissez **Actions**, **Manage event notifications (Gérer les notifications d’événements)**.
------
#### [ AWS CLI ]
**Pour afficher les balises à inclure dans les notifications d’événements**
Utilisez la commande [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 ]
**Pour afficher les balises à inclure dans les notifications d’événements**
Utilisez l’applet de commande [Get-EC2InstanceEventNotificationAttribute](https://docs.aws.amazon.com/powershell/latest/reference/items/Get-EC2InstanceEventNotificationAttribute.html).
```
Get-EC2InstanceEventNotificationAttribute
```
------
# Replanification d’un événement planifié pour une instance EC2
Vous pouvez replanifier un événement de sorte qu’il se produise à une date et une heure spécifiques qui vous conviennent. Une fois que vous avez reprogrammé un événement, l’affichage de la date actualisée peut prendre une minute ou deux.
**Limitations**
+ Seuls les événements dotés d’une date d’échéance d’événement peuvent être reprogrammés. L’événement peut être reprogrammé jusqu’à la date d’échéance de celui-ci. La date limite de l’événement est indiquée dans la colonne **Échéance** (console) et dans le champ `NotBeforeDeadline` (AWS CLI).
+ Seuls les événements n’ayant pas encore démarré peuvent être reprogrammés. L’heure de début est indiquée dans la colonne **Heure de début** (console) et dans le champ `NotBefore` (AWS CLI). Les événements planifiés pour un lancement dans les 5 prochaines minutes ne peuvent pas être replanifiés.
+ La nouvelle heure de début doit être au moins 60 minutes après l’heure actuelle.
+ Si vous reprogrammez plusieurs événements à l’aide de la console, la date d’échéance de l’événement est déterminée par l’événement avec la date d’échéance d’événement la plus proche.
------
#### [ Console ]
**Pour replanifier un événement**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le volet de navigation, sélectionnez **Événements**.
1. Choisissez **Type de ressource : instance** dans la liste des filtres.
1. Sélectionnez une ou plusieurs instances, puis sélectionnez **Actions**, **Schedule Event (Programmer un événement)**.
Seuls les événements ayant une date d’échéance, indiquée par la valeur **Event Deadline (Échéance de l’événement)**, peuvent être reprogrammés. Si l’un des événements sélectionnés n’a pas de date d’échéance, **Actions**, **Schedule Event (Programmer un événement)** est désactivé.
1. Dans **New start time (Nouvelle heure de début)**, saisissez une nouvelle date et une nouvelle heure pour l’événement. La nouvelle date et la nouvelle heure doivent être antérieures à la valeur de **Event Deadline (Échéance de l’événement)**.
1. Choisissez **Enregistrer**.
L'heure de démarrage mise à jour peut prendre une à deux minutes pour s'afficher dans la console.
------
#### [ AWS CLI ]
**Pour replanifier un événement**
Utilisez la commande [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 ]
**Pour replanifier un événement**
Utilisez l’applet de commande [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
```
------
# Créez des fenêtres d'événements personnalisées pour les événements programmés qui affectent vos instances Amazon EC2
Vous pouvez définir des fenêtres d’événements hebdomadaires personnalisées récurrentes pour des événements planifiés qui redémarrent, arrêtent ou résilient vos instances Amazon EC2. Vous pouvez associer une ou plusieurs instances à une fenêtre d’événements. Si un événement est planifié pour ces instances, AWS planifiera les événements dans la fenêtre d’événements associée.
Vous pouvez utiliser des fenêtres d’événements afin d’optimiser la disponibilité de la charge de travail globale en spécifiant des fenêtres d’événements pendant des périodes creuses pour cette charge de travail. Vous pouvez également aligner les fenêtres d’événements avec vos planifications de maintenance internes.
Vous définissez une fenêtre d’événements en spécifiant un ensemble de plages de temps. La plage de temps minimale est de 2 heures. Les plages de temps combinées doivent totaliser au moins 4 heures.
Vous pouvez associer une ou plusieurs instances à une fenêtre d'événements à l'aide d'instances IDs ou de balises d'instance. Vous pouvez également associer des hôtes dédiés à une fenêtre d’événements en utilisant l’ID d’hôte.
**Avertissement**
Les fenêtres d’événements s’appliquent uniquement à des événements planifiés qui arrêtent, redémarrent ou résilient des instances.
Les fenêtres d’événements ne sont pas applicables aux événements suivants :
Événements planifiés accélérés et événements de maintenance du réseau.
Maintenance non programmée, telle que la [récupération automatique des instances](ec2-instance-recover.md) et les redémarrages non planifiés.
**Topics**
+ [
## Considérations
](#event-windows-considerations)
+ [
## Créer une fenêtre d’événements
](#create-event-windows)
+ [
## Associer une cible à une fenêtre d’événements
](#associate-target-event-window)
+ [
## Dissociation d’une cible d’une fenêtre d’événements
](#disassociate-target-event-window)
+ [
## Modification d’une fenêtre d’événements
](#modify-event-windows)
+ [
## Suppression d’une fenêtre d’événements
](#delete-event-windows)
## Considérations
+ Toutes les heures de fenêtre d’événements sont au format UTC.
+ Une fenêtre d’événements peut contenir plusieurs plages temporelles. Bien que chaque plage individuelle doive durer au moins 2 heures, la durée totale de toutes les plages doit être d’au moins 4 heures.
+ Un seul type de cible (ID d’instance, ID d’hôte dédié ou étiquette d’instance) peut être associé à une fenêtre d’événements.
+ Une cible (ID d’instance, ID d’hôte dédié ou étiquette d’instance) ne peut être associée qu’à à une fenêtre d’événements.
+ Un maximum de 100 instances IDs, 50 hôtes IDs dédiés ou 50 balises d'instance peuvent être associées à une fenêtre d'événements. Les étiquettes d’instance peuvent être associées à un nombre quelconque d’instances.
+ Un maximum de 200 fenêtres d'événements peuvent être créées par AWS région.
+ Plusieurs instances associées à des fenêtres d’événements peuvent avoir des événements planifiés se produisant en même temps.
+ Si vous avez AWS déjà planifié un événement, la modification d'une fenêtre d'événements ne changera pas l'heure de l'événement planifié. Si l’événement a une date d’échéance, vous pouvez [replanifier l’événement](reschedule-event.md).
+ Vous pouvez arrêter et démarrer une instance avant l’événement planifié. Cette opération a pour effet de transférer l’instance vers un nouvel hôte et de supprimer l’événement.
## Créer une fenêtre d’événements
Vous pouvez créer une ou plusieurs fenêtres d’événements. Pour chaque fenêtre d’événements, vous spécifiez un ou plusieurs blocs de temps. Par exemple, vous pouvez créer une fenêtre d’événements avec des blocs de temps qui se produisent tous les jours à 4 heures du matin pendant 2 heures. Ou vous pouvez créer une fenêtre d’événements avec des blocs de temps qui se produisent les dimanches de 2 à 4 heures et les mercredis de 3 à 5 heures.
Les fenêtres d’événements se reproduisent à une fréquence hebdomadaire jusqu’à ce que vous les supprimiez.
------
#### [ Console ]
**Pour créer une fenêtre d'événements**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le panneau de navigation, sélectionnez **Events**.
1. Choisissez **Actions**, **Gérer les fenêtres d’événements**.
1. Choisissez **Créer une fenêtre d’événements d’instance**.
1. Pour **Nom de la fenêtre d’événements**, saisissez un nom descriptif.
1. Pour **Planification de la fenêtre d’événements**, choisissez de spécifier les blocs de temps dans la fenêtre d’événements à l’aide du générateur de planification cron ou en spécifiant des plages de temps.
+ Si vous choisissez **Générateur de planification Cron**, spécifiez les paramètres suivants :
1. Pour **Jours (UTC)**, spécifiez les jours de la semaine où la fenêtre d’événements se produit.
1. Pour **Heure de début (UTC)**, spécifiez l’heure à laquelle la fenêtre d’événements commence.
1. Pour **Durée**, spécifiez la durée des blocs de temps dans la fenêtre d’événements. La durée minimale par bloc de temps est de 2 heures. La durée minimale de la fenêtre d’événements doit être égale ou supérieure à 4 heures au total. Toutes les heures sont indiquées en heure universelle coordonnée (UTC).
+ Si vous choisissez **Plages de temps**, choisissez **Ajouter une nouvelle plage de temps**, puis spécifiez le jour et l’heure de début, ainsi que le jour et l’heure de fin. Répétez l’opération pour chaque plage de temps. La durée minimale par plage de temps est de 2 heures. La durée minimale pour toutes les plages de temps combinées doit être égale ou supérieure à 4 heures au total.
1. (Facultatif) Pour **Informations sur la cible**, associez une ou plusieurs instances à la fenêtre d’événements. Utilisez des instances IDs ou des balises d'instance pour associer des instances. Utilisez host IDs pour associer des hôtes dédiés. Lorsque la maintenance de ces cibles est planifiée, l’événement se produit au cours de cette fenêtre d’événements.
Notez que vous pouvez créer la fenêtre d’événements sans y associer de cible. Plus tard, vous pourrez modifier la fenêtre pour associer une ou plusieurs cibles.
1. (Facultatif) Pour **Etiquettes de la fenêtre d’événements**, choisissez **Ajouter une étiquette**, puis saisissez la clé et la valeur de l’étiquette. Répétez l’opération pour chaque étiquette.
1. Choisissez **Créer une fenêtre d’événements**.
------
#### [ AWS CLI ]
**Pour créer une fenêtre d'événements avec une plage de temps**
Utilisez la commande [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
```
Voici un exemple de sortie.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"TimeRanges": [
{
"StartWeekDay": "monday",
"StartHour": 2,
"EndWeekDay": "wednesday",
"EndHour": 8
}
],
"Name": "myEventWindowName",
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
**Pour créer une fenêtre d'événements avec une expression cron à**
Utilisez la commande [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
```
Voici un exemple de sortie.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"State": "creating",
"Tags": [
{
"Key": "K1",
"Value": "V1"
}
]
}
}
```
------
#### [ PowerShell ]
**Pour créer une fenêtre d'événements avec une plage de temps**
Utilisez l’applet de commande [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)
```
Voici un exemple de sortie.
```
AssociationTarget :
CronExpression :
InstanceEventWindowId : iew-0abcdef1234567890
Name : my-event-window
State : creating
Tags : {key1}
TimeRanges : {Amazon.EC2.Model.InstanceEventWindowTimeRange}
```
**Pour créer une fenêtre d'événements avec une expression cron à**
Utilisez l’applet de commande [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"
```
Voici un exemple de sortie.
```
AssociationTarget :
CronExpression : * 21-23 * * 2,3
InstanceEventWindowId : iew-0abcdef1234567890
Name : my-event-window
State : creating
Tags : {key1}
TimeRanges : {}
```
------
## Associer une cible à une fenêtre d’événements
Après avoir créé une fenêtre d’événements, vous pouvez associer des cibles à la fenêtre d’événements. Vous ne pouvez associer qu’un seul type de cible à une fenêtre d’événements. Vous pouvez spécifier une instance IDs, un hôte IDs dédié ou des balises d'instance.
------
#### [ Console ]
**Pour associer des cibles à une fenêtre d’événements**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le panneau de navigation, sélectionnez **Events**.
1. Sélectionnez la fenêtre d’événements à modifier.
1. Choisissez **Actions**, puis **Modifier la fenêtre d’événements de l’instance**.
------
#### [ AWS CLI ]
**Pour associer des étiquettes d'instance à une fenêtre d'événements**
Utilisez la commande [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}]"
```
Voici un exemple de sortie.
```
{
"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"
}
}
```
**Pour associer une instance IDs à une fenêtre d'événements**
Utilisez la commande [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"
```
Voici un exemple de sortie.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [
"i-1234567890abcdef0",
"i-0598c7d356eba48d7"
],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Pour associer un hôte dédié à une fenêtre d'événements**
Utilisez la commande [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"
```
Voici un exemple de sortie.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": [
"h-029fa35a02b99801d"
]
},
"State": "creating"
}
}
```
------
#### [ PowerShell ]
**Pour associer des étiquettes d'instance à une fenêtre d'événements**
Utilisez l’applet de commande [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)
```
**Pour associer une instance IDs à une fenêtre d'événements**
Utilisez l’applet de commande [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
```
**Pour associer un hôte dédié à une fenêtre d'événements**
Utilisez l’applet de commande [Register-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Register-EC2InstanceEventWindow.html).
```
Register-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_DedicatedHostId h-029fa35a02b99801d
```
------
## Dissociation d’une cible d’une fenêtre d’événements
------
#### [ Console ]
**Pour dissocier des cibles d’une fenêtre d’événements**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le panneau de navigation, sélectionnez **Events**.
1. Sélectionnez la fenêtre d’événements à modifier.
1. Choisissez **Actions**, puis **Modifier la fenêtre d’événements de l’instance**.
------
#### [ AWS CLI ]
**Pour dissocier des étiquettes d'instance d'une fenêtre d'événements**
Utilisez la commande [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}]"
```
Voici un exemple de sortie.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Pour dissocier une instance IDs d'une fenêtre d'événements**
Utilisez la commande [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"
```
Voici un exemple de sortie.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
**Pour dissocier un hôte dédié d'une fenêtre d'événements**
Utilisez la commande [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
```
Voici un exemple de sortie.
```
{
"InstanceEventWindow": {
"InstanceEventWindowId": "iew-0abcdef1234567890",
"Name": "myEventWindowName",
"CronExpression": "* 21-23 * * 2,3",
"AssociationTarget": {
"InstanceIds": [],
"Tags": [],
"DedicatedHostIds": []
},
"State": "creating"
}
}
```
------
#### [ PowerShell ]
**Pour dissocier des étiquettes d'instance d'une fenêtre d'événements**
Utilisez l’applet de commande [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)
```
**Pour dissocier une instance IDs d'une fenêtre d'événements**
Utilisez l’applet de commande [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
```
**Pour dissocier un hôte dédié d'une fenêtre d'événements**
Utilisez l’applet de commande [Unregister-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Unregister-EC2InstanceEventWindow.html).
```
Unregister-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-AssociationTarget_DedicatedHostId h-029fa35a02b99801d
```
------
## Modification d’une fenêtre d’événements
Vous pouvez modifier tous les champs d’une fenêtre d’événements à l’exception de son ID. Par exemple, quand l’heure d’été commence, vous pouvez modifier la planification de la fenêtre d’événements. Pour des fenêtres d’événements existantes, vous pouvez ajouter ou supprimer des cibles.
Lors de la modification de la fenêtre d’événements, vous pouvez modifier une plage de temps ou une expression cron, mais pas les deux.
------
#### [ Console ]
**Pour modifier une fenêtre d'événements**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le panneau de navigation, sélectionnez **Events**.
1. Choisissez **Actions**, **Gérer les fenêtres d’événements**.
1. Sélectionnez la fenêtre d’événements à modifier, puis choisissez **Actions**, **Modifier la fenêtre d’événements d’instance**.
1. Modifiez les champs de la fenêtre d’événements, puis choisissez **Modifier la fenêtre d’événements**.
------
#### [ AWS CLI ]
**Pour modifier la plage de temps d'une fenêtre d'événements**
Utilisez la commande [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
```
Voici un exemple de sortie.
```
{
"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"
}
]
}
}
```
**Pour modifier une ensemble de plages de temps pour une fenêtre d'événements**
Utilisez la commande [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}]'
```
Voici un exemple de sortie.
```
{
"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"
}
]
}
}
```
**Pour modifier l'expression cron d'une fenêtre d'événements**
Utilisez la commande [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"
```
Voici un exemple de sortie.
```
{
"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 ]
**Pour modifier la plage de temps d'une fenêtre d'événements**
Utilisez l’applet de commande [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)
```
**Pour modifier l'expression cron d'une fenêtre d'événements**
Utilisez l’applet de commande [Edit-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Edit-EC2InstanceEventWindow.html).
```
Edit-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-CronExpression "* 21-23 * * 2,3"
```
------
## Suppression d’une fenêtre d’événements
Vous pouvez supprimer une fenêtre d’événements à la fois.
------
#### [ Console ]
**Pour supprimer une fenêtre d'événements**
1. Ouvrez la console Amazon EC2 à l’adresse [https://console.aws.amazon.com/ec2/](https://console.aws.amazon.com/ec2/).
1. Dans le panneau de navigation, sélectionnez **Events**.
1. Choisissez **Actions**, **Gérer les fenêtres d’événements**.
1. Sélectionnez la fenêtre d’événements à supprimer, puis choisissez **Actions**, **Supprimer la fenêtre d’événements d’instance**.
1. Lorsque vous y êtes invité, tapez **delete**, puis choisissez **Supprimer**.
------
#### [ AWS CLI ]
**Pour supprimer une fenêtre d'événements**
Utilisez la [delete-instance-event-window](https://docs.aws.amazon.com/cli/latest/reference/ec2/delete-instance-event-window.html)commande et spécifiez la fenêtre d'événements à supprimer.
```
aws ec2 delete-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890
```
**Pour supprimer de force une fenêtre d’événements**
Utilisez le paramètre `--force-delete` si la fenêtre d’événements est actuellement associée à des cibles.
```
aws ec2 delete-instance-event-window \
--instance-event-window-id iew-0abcdef1234567890 \
--force-delete
```
------
#### [ PowerShell ]
**Pour supprimer une fenêtre d'événements**
Utilisez l’applet de commande [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html).
```
Remove-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890
```
**Pour supprimer de force une fenêtre d’événements**
Utilisez l’applet de commande [Remove-EC2InstanceEventWindow](https://docs.aws.amazon.com/powershell/latest/reference/items/Remove-EC2InstanceEventWindow.html).
```
Remove-EC2InstanceEventWindow `
-InstanceEventWindowId iew-0abcdef1234567890 `
-ForceDelete $true
```
------