

• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la [documentation Amazon CloudWatch Dashboard](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

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.

# AWS Systems Manager Change Calendar
<a name="systems-manager-change-calendar"></a>

Change Calendar, un outil dans AWS Systems Manager, vous permet de définir des plages de dates et d'heures auxquelles les actions que vous spécifiez (par exemple, dans [les runbooks de Systems Manager Automation](systems-manager-automation.md)) peuvent ou non être effectuées dans votre Compte AWS. Dans Change Calendar, ces plages sont appelées des *événements*. Lorsque vous créez une entrée Change Calendar, vous créez un [document Systems Manager](documents.md) de type `ChangeCalendar`. Dans Change Calendar, le document stocke les données [iCalendar 2.0](https://icalendar.org/) au format texte brut. Les événements que vous ajoutez à l'entrée Change Calendar font partie du document. Pour vos premiers pas dans Change Calendar, ouvrez [Systems Manager console](https://console.aws.amazon.com//systems-manager/change-calendar). Dans le panneau de navigation, sélectionnez **Change Calendar**.

Vous pouvez créer un calendrier et ses événements dans la console Systems Manager. Vous pouvez également importer un fichier iCalendar (`.ics`), exporté à partir d'un fournisseur de calendrier tiers pris en charge, pour ajouter ses événements à votre calendrier. Les fournisseurs pris en charge comprennent Google Calendar, Microsoft Outlook et iCloud Calendar.

Une entrée Change Calendar peut être de l'un des deux types suivants :

**`DEFAULT_OPEN`** ou Ouvert par défaut  
Toutes les actions peuvent être exécutées par défaut, sauf pendant les événements du calendrier. Pendant les événements, l'état d'un calendrier `DEFAULT_OPEN` est `CLOSED` et les événements sont bloqués.

**`DEFAULT_CLOSED`** ou Fermé par défaut  
Toutes les actions sont bloquées par défaut, sauf pendant les événements du calendrier. Pendant les événements, l'état d'un calendrier `DEFAULT_CLOSED` est `OPEN` et les actions sont autorisées.

Vous pouvez choisir d'ajouter automatiquement tous les flux de travail d'automatisation, les fenêtres de maintenance et les associations State Manager planifiés à un calendrier. Vous pouvez également supprimer chacun de ces types de l'affichage du calendrier. 

## À qui est destiné Change Calendar ?
<a name="systems-manager-change-calendar-who"></a>

**Change Managerchangement de disponibilité**  
AWS Systems ManagerChange Managerne sera plus ouvert aux nouveaux clients à compter du 7 novembre 2025. Si vous souhaitez l'utiliserChange Manager, inscrivez-vous avant cette date. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez [AWS Systems ManagerChange Managerla section Modification de la disponibilité](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html). 
+ AWS clients qui exécutent les types d'actions suivants :
  + Créez ou exécutez des runbooks d'automatisation.
  + Créez des demandes de modification dans Change Manager.
  + Exécutez des fenêtres de maintenance.
  + Créez des associations dans State Manager.

  L'automatisation Change Manager et Maintenance Windows le State Manager sont tous des outils AWS Systems Manager. En intégrant ces outils à Change Calendar, vous pouvez autoriser ou bloquer ces types d’action en fonction du statut actuel du calendrier de modifications qui leur est associé.
+ Administrateurs chargés de maintenir la cohérence, la stabilité et la fonctionnalité des configurations des nœuds gérés par Systems Manager.

## Avantages d'Change Calendar
<a name="systems-manager-change-calendar-benefits"></a>

Change Calendar offre entre autres les avantages suivants.
+ **Vérifier les modifications avant qu'elles soient appliquées**

  Une entrée Change Calendar peut vous aider à vous assurer que les modifications potentiellement destructrices apportées à votre environnement sont passées en revue avant d'être appliquées.
+ **Appliquer les modifications uniquement pendant les heures appropriées**

  Les entrées Change Calendar permettent de préserver la stabilité de votre environnement pendant les heures des événements. Par exemple, vous pouvez créer une entrée Change Calendar pour bloquer les modifications lorsque vous vous attendez à une forte demande sur vos ressources, par exemple, lors d'une conférence ou d'une promotion marketing publique. Une entrée de calendrier peut également bloquer les modifications lorsque vous vous attendez à un support administratif limité, par exemple, pendant les vacances ou les jours fériés. Vous pouvez utiliser une entrée de calendrier pour autoriser les modifications sauf pendant certaines périodes de la journée ou de la semaine où le support administratif est limité pour résoudre les échecs d'actions ou de déploiements.
+ **Obtenir du statut actuel ou à venir du calendrier**

  Vous pouvez exécuter l'opération d'API `GetCalendarState` de Systems Manager pour afficher du statut actuel du calendrier, son état à une heure spécifique ou la prochaine fois qu'une modification de du statut du calendrier est planifiée.
**Note**  
L’API `GetCalendarState` dispose d’un quota de 10 requêtes par seconde. Pour plus d’informations sur les quotas Systems Manager, veuillez consulter la rubrique [Quotas de service Systems Manager](https://docs.aws.amazon.com/general/latest/gr/ssm.html#limits_ssm) dans la *Référence générale d'Amazon Web Services*.
+ 

**EventBridge soutien**  
Cet outil Systems Manager est pris en charge en tant que type d'*événement* dans les EventBridge règles d'Amazon. Pour plus d'informations, consultez [Surveillance des événements de Systems Manager avec Amazon EventBridge](monitoring-eventbridge-events.md) et [Référence : modèles et types d' EventBridge événements Amazon pour Systems Manager](reference-eventbridge-events.md).

**Topics**
+ [À qui est destiné Change Calendar ?](#systems-manager-change-calendar-who)
+ [Avantages d'Change Calendar](#systems-manager-change-calendar-benefits)
+ [Configuration de Change Calendar](systems-manager-change-calendar-prereqs.md)
+ [Utilisation de l’option Change Calendar](systems-manager-change-calendar-working.md)
+ [Ajouter des dépendances Change Calendar à des runbooks Automation](systems-manager-change-calendar-automations.md)
+ [Résolution des problèmes de Change Calendar](change-calendar-troubleshooting.md)

# Configuration de Change Calendar
<a name="systems-manager-change-calendar-prereqs"></a>

Effectuez les opérations suivantes avant Change Calendar d'utiliser un outil AWS Systems Manager.

## Installer les derniers outils de ligne de commande
<a name="change-calendar-prereqs-tools"></a>

Installez les derniers outils de ligne de commande pour obtenir des informations d'état sur les calendriers.


| Exigence | Description | 
| --- | --- | 
|  AWS CLI  |  (Facultatif) Pour utiliser le AWS Command Line Interface (AWS CLI) pour obtenir des informations sur l'état des calendriers, installez la dernière version du AWS CLI sur votre ordinateur local. Pour plus d'informations sur l'installation ou la mise à niveau de l'interface CLI, consultez [Installation, mise à jour et désinstallation de la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) dans le *Guide de l'utilisateur AWS Command Line Interface *.  | 
|  Outils AWS pour PowerShell  |  (Facultatif) Pour utiliser les outils PowerShell pour obtenir des informations sur l'état des calendriers, installez la dernière version de Tools for PowerShell sur votre ordinateur local. Pour plus d'informations sur l'installation ou la mise à niveau des outils pour PowerShell, consultez la section [Installation des Outils AWS pour PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) dans le *guide de Outils AWS pour PowerShell l'utilisateur*.  | 

## Configuration d’autorisations
<a name="change-calendar-prereqs-permissions"></a>

Si votre utilisateur, votre groupe ou votre rôle dispose des autorisations d'administrateur, vous avez accès complet à Change Calendar. Si vous ne disposez pas d'autorisations d'administrateur, un administrateur doit vous les donner en affectant la stratégie gérée `AmazonSSMFullAccess` ou en affectant une stratégie qui fournit les autorisations nécessaires à votre utilisateur, votre groupe ou votre rôle.

Les autorisations suivantes sont requises pour travailler avec Change Calendar.

**Les entrées Change Calendar**  
Pour créer, mettre à jour ou supprimer une entrée Change Calendar, y compris ajouter et supprimer des événements de l'entrée, une politique attachée à votre utilisateur, groupe ou rôle doit autoriser les actions suivantes :  
+ `ssm:CreateDocument`
+ `ssm:DeleteDocument`
+ `ssm:DescribeDocument`
+ `ssm:DescribeDocumentPermission`
+ `ssm:GetCalendar`
+ `ssm:ListDocuments`
+ `ssm:ModifyDocumentPermission`
+ `ssm:PutCalendar`
+ `ssm:UpdateDocument`
+ `ssm:UpdateDocumentDefaultVersion`

**État du calendrier**  
Pour obtenir des informations sur l'état actuel ou à venir du calendrier, une politique attachée à votre utilisateur, votre groupe ou votre rôle doit autoriser l'action suivante :  
+ `ssm:GetCalendarState`

**Événements opérationnels**  
Pour afficher les événements opérationnels, tels que les fenêtres de maintenance, les associations et les automatismes planifiés, la politique attachée à votre utilisateur, groupe ou rôle doit autoriser les actions suivantes :  
+ `ssm:DescribeMaintenanceWindows`
+ `ssm:DescribeMaintenanceWindowExecution`
+ `ssm:DescribeAutomationExecutions`
+ `ssm:ListAssociations`

**Note**  
Les entrées Change Calendar appartenant à (c'est-à-dire créées par) d'autres comptes que le vôtre sont en lecture seule, même si elles sont partagées avec votre compte. Les fenêtres de maintenance, les associations State Manager et les automatisations ne sont pas partagées.

# Utilisation de l’option Change Calendar
<a name="systems-manager-change-calendar-working"></a>

Vous pouvez utiliser la console AWS Systems Manager pour ajouter, gérer ou supprimer des entrées dans AWS Systems Manager, un outil d’Change Calendar. Vous pouvez également importer des événements à partir de fournisseurs de calendrier tiers pris en charge en important un fichier iCalendar (`.ics`) exporté à partir du calendrier source. Vous pouvez utiliser l'opération d'API `GetCalendarState` ou la commande `get-calendar-state` AWS Command Line Interface (AWS CLI) pour obtenir des informations sur l'état de Change Calendar à un moment spécifique.

**Topics**
+ [Création d'un calendrier de modifications](change-calendar-create.md)
+ [Création et gestion d'événements dans Change Calendar](change-calendar-events.md)
+ [Importation et gestion d'événements à partir de calendriers tiers](third-party-events.md)
+ [Mise à jour d'un calendrier de modifications](change-calendar-update.md)
+ [Partage d'un calendrier de modifications](change-calendar-share.md)
+ [Suppression d'un calendrier de modifications](change-calendar-delete.md)
+ [Obtenir le statut d'un calendrier de modifications](change-calendar-getstate.md)

# Création d'un calendrier de modifications
<a name="change-calendar-create"></a>

Lorsque vous créez une entrée dans Change Calendar, un outil d’AWS Systems Manager, vous créez un document Systems Manager (document SSM) au format `text`.

**Pour créer un calendrier de modifications**

1. Ouvrez la console AWS Systems Manager à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Sélectionnez **Create calendar (Créer un calendrier)**.

   -ou-

   Si la page d'accueil **Change Calendar** s'ouvre en premier, sélectionnez **Create change calendar** (Créer un calendrier de modification).

1. Dans la page **Create calendar (Créer un calendrier)** dans **Calendar details (Détails du calendrier)**, saisissez un nom pour votre entrée de calendrier. Les noms d'entrée de calendrier peuvent contenir des lettres, des chiffres, des points, des tirets et des traits de soulignement. Le nom doit être suffisamment précis pour permettre d'identifier immédiatement le but de l'entrée de calendrier. Par exemple : **support-off-hours**. Vous ne pouvez pas mettre à jour ce nom après avoir créé l'entrée de calendrier.

1. (Facultatif) Pour **Description**, saisissez une description de votre entrée de calendrier.

1. (Facultatif) Dans la zone **Import calendar (Importer un calendrier)**, sélectionnez **Choose file (Choisir un fichier)** pour sélectionner un fichier iCalendar (`.ics`) exporté à partir d'un fournisseur de calendriers tiers. L'importation du fichier ajoutera ses événements à votre calendrier.

   Les fournisseurs pris en charge comprennent Google Calendar, Microsoft Outlook et iCloud Calendar.

   Pour de plus amples informations, consultez [Importation d'événements à partir de fournisseurs de calendrier tiers](change-calendar-import.md).

1. Dans **Calendar type (Type de calendrier)**, sélectionnez l'une des options suivantes :
   + **Open by default (Ouvert par défaut)** : le calendrier est ouvert (les actions Automation peuvent s'exécuter jusqu'au démarrage d'un événement), puis fermé pendant la durée d'un événement associé.
   + **Closed by default (Fermé par défaut)** : le calendrier est fermé (les actions Automation ne peuvent pas s'exécuter avant le démarrage d'un événement), mais ouvert pendant la durée d'un événement associé.

1. (Facultatif) Dans **Événements de gestion de modification**, sélectionnez **Ajouter au calendrier des événements de gestion de modification**. Cette sélection affiche toutes les fenêtres de maintenance planifiées, les associations State Manager, les flux de travail d'automatisation et les demandes de modification Change Manager dans l'affichage de votre calendrier mensuel.
**Astuce**  
Si par la suite, vous souhaitez supprimer définitivement ces types d'événements de l'affichage du calendrier, modifiez le calendrier, décochez cette case, puis choisissez **Enregistrer**.

1. Sélectionnez **Create calendar (Créer un calendrier)**.

   Une fois l'entrée de calendrier créée, Systems Manager affiche votre entrée de calendrier dans la liste **Change Calendar**. Les colonnes affichent la version du calendrier et le numéro de Compte AWS du propriétaire du calendrier. Votre entrée de calendrier ne peut ni empêcher ni autoriser des actions tant que vous n'avez pas créé ou importé au moins un événement. Pour plus d'informations sur la création d'un événement, consultez [Création d'un événement Change Calendar](change-calendar-create-event.md). Pour plus d'informations sur l'importation d'évènements, consultez [Importation d'événements à partir de fournisseurs de calendrier tiers](change-calendar-import.md).

# Création et gestion d'événements dans Change Calendar
<a name="change-calendar-events"></a>

Après avoir créé un calendrier dans AWS Systems Manager Change Calendar, vous pouvez créer, mettre à jour et supprimer des événements inclus dans votre calendrier ouvert ou fermé. Change Calendarest un outil dans AWS Systems Manager.

**Astuce**  
Comme alternative à la création d'événements directement dans la console Systems Manager, vous pouvez importer un fichier iCalendar (`.ics`) à partir d'une application de calendrier tierce prise en charge. Pour plus d'informations, consultez [Importation et gestion d'événements à partir de calendriers tiers](third-party-events.md).

**Topics**
+ [Création d'un événement Change Calendar](change-calendar-create-event.md)
+ [Mise à jour d'un événement Change Calendar](change-calendar-update-event.md)
+ [Suppression d'un événement Change Calendar](change-calendar-delete-event.md)

# Création d'un événement Change Calendar
<a name="change-calendar-create-event"></a>

Lorsque vous ajoutez un événement à une entrée dans Change Calendar, un outil d’AWS Systems Manager, vous spécifiez une période pendant laquelle l’action par défaut de l’entrée de calendrier est suspendue. Par exemple, si l'entrée de calendrier est de type Fermé par défaut, le calendrier est ouvert aux modifications pendant les événements. (Vous pouvez également créer un événement consultatif, qui sert uniquement un rôle d'information dans le calendrier.)

Actuellement, vous ne pouvez créer un événement Change Calendar qu'à l'aide de la console. Les événements sont ajoutés au document Change Calendar que vous créez lorsque vous créez une entrée Change Calendar.

**Pour créer un événement Change Calendar**

1. Ouvrez la console AWS Systems Manager à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Dans la liste des calendriers, sélectionnez le nom de l'entrée de calendrier à laquelle vous souhaitez ajouter un événement.

1. Dans la page des détails de l'entrée de calendrier, sélectionnez **Create event (Créer un événement)**.

1. Dans la page **Create scheduled event (Créer un événement planifié)** dans **Event details (Détails de l'événement)**, saisissez le nom complet de votre événement. Les noms d'événement peuvent contenir des lettres, des chiffres, des points, des tirets et des traits de soulignement. Le nom doit être suffisamment précis pour permettre d'identifier le but de l'événement. Par exemple : **nighttime-hours**.

1. Pour **Description**, saisissez une description de votre événement. Par exemple, **The support team isn't available during these hours**.

1. (Facultatif) Si vous souhaitez que cet événement ne serve que de notification visuelle ou de rappel, cochez la case **Advisory** (Recommandation). Les événements consultatifs ne jouent aucun rôle fonctionnel dans votre calendrier. Ils servent uniquement à des fins d'information pour ceux qui consultent votre calendrier.

1. Pour **Event start date** (Date de début de l'événement), saisissez ou sélectionnez un jour de démarrage de l'événement, au format `MM/DD/YYYY`, puis saisissez une heure de démarrage de l'événement le jour spécifié, au format `hh:mm:ss` (heures, minutes et secondes).

1. Pour **Event end date (Date de fin de l'événement)**, saisissez ou sélectionnez un jour de fin de l'événement, au format `MM/DD/YYYY`, puis saisissez une heure de fin de l'événement le jour spécifié, au format `hh:mm:ss` (heures, minutes et secondes).

1. Pour **Schedule time zone (Fuseau horaire de planification)**, sélectionnez un fuseau horaire qui s'applique aux heures de début et de fin de l'événement. Vous pouvez saisir une partie d'un nom de ville ou d'une différence de fuseau horaire par rapport à l'heure GMT (heure moyenne de Greenwich) pour trouver un fuseau horaire plus rapidement. La valeur par défaut est UTC (temps universel coordonné).

1. (Facultatif) Pour créer un événement qui se répète chaque jour, chaque semaine ou chaque mois, activez l'option **Recurrence** (Récurrence), puis spécifiez la fréquence et la date de fin facultative de la récurrence.

1. Sélectionnez **Create scheduled event (Créer un événement planifié)**. Le nouvel événement est ajouté à votre entrée de calendrier et s'affiche sous l'onglet **Events (Événements)** de la page des détails de l'entrée de calendrier.

# Mise à jour d'un événement Change Calendar
<a name="change-calendar-update-event"></a>

Procédez comme suit pour mettre à jour un événement Change Calendar dans la console AWS Systems Manager. Change Calendar est un outil d’AWS Systems Manager.

**Pour mettre à jour un événement Change Calendar**

1. Ouvrez la console AWS Systems Manager à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Dans la liste des calendriers, sélectionnez le nom de l'entrée de calendrier pour laquelle vous souhaitez modifier un événement.

1. Dans la page des détails de l'entrée de calendrier, sélectionnez **Events (Événements)**.

1. Dans la page du calendrier, sélectionnez l'événement que vous souhaitez modifier.
**Astuce**  
Utilisez les boutons situés en haut à gauche pour reculer ou avancer d'un an, ou reculer ou avancer d'un mois. Modifiez le fuseau horaire, si nécessaire, en choisissant le fuseau horaire approprié dans la liste située en haut à droite.

1. Dans **Event details** (Détails de l'événement), sélectionnez **Edit** (Modifier).

   Pour modifier le nom et la description de l'événement, ajoutez ou remplacez les valeurs de texte actuelles.

1. Pour modifier l'option **Event start date** (Date de début de l'événement), sélectionnez la date de début actuelle, puis une nouvelle date dans le calendrier. Pour modifier l'heure de début, sélectionnez l'heure de début actuelle, puis une nouvelle heure dans la liste.

1. Pour modifier l'option **Event end date** (Date de fin de l'événement), sélectionnez la date actuelle, puis une nouvelle date de fin dans le calendrier. Pour modifier l'heure de fin, sélectionnez l'heure de fin actuelle, puis une nouvelle heure dans la liste.

1. Pour modifier la valeur du champ **Schedule time zone** (Fuseau horaire de planification), sélectionnez un fuseau horaire à appliquer aux heures de début et de fin de l'événement. Vous pouvez saisir une partie d'un nom de ville ou d'une différence de fuseau horaire par rapport à l'heure GMT (heure moyenne de Greenwich) pour trouver un fuseau horaire plus rapidement. La valeur par défaut est UTC (temps universel coordonné).

1. (Facultatif) Si vous souhaitez que cet événement ne serve que de notification visuelle ou de rappel, cochez la case **Advisory** (Recommandation). Les événements consultatifs ne jouent aucun rôle fonctionnel dans votre calendrier. Ils servent uniquement à des fins d'information pour ceux qui consultent votre calendrier.

1. Sélectionnez **Enregistrer**. Vos modifications s'affichent sous l'onglet **Events (Événements)** de la page des détails de l'entrée de calendrier. Sélectionnez l'événement que vous avez mis à jour pour afficher vos modifications.

# Suppression d'un événement Change Calendar
<a name="change-calendar-delete-event"></a>

Vous pouvez supprimer un événement à la fois dans Change Calendar, un outil d’AWS Systems Manager, via la AWS Management Console. 

**Astuce**  
Si vous avez sélectionné **Ajouter au calendrier des événements de gestion de modification** lors de la création du calendrier, vous pouvez procéder comme suit :  
Pour masquer *temporairement* un type d'événement de gestion des modifications dans l'affichage du calendrier, choisissez le **X** correspondant au type en haut de l'aperçu mensuel.
Pour supprimer *définitivement* ces types de l'affichage du calendrier, modifiez le calendrier, décochez **Ajouter au calendrier des événements de gestion de modification**, puis choisissez **Enregistrer**. La suppression des types de l'affichage du calendrier ne les supprime pas de votre compte.

**Pour supprimer un événement Change Calendar**

1. Ouvrez la console AWS Systems Manager à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Dans la liste des calendriers, sélectionnez le nom de l'entrée de calendrier à partir de laquelle vous souhaitez supprimer un événement.

1. Dans la page des détails de l'entrée de calendrier, sélectionnez **Events (Événements)**.

1. Dans la page du calendrier, sélectionnez l'événement que vous souhaitez supprimer.
**Astuce**  
Utilisez les boutons situés en haut à gauche pour faire reculer ou avancer le calendrier d'un an, ou pour le faire reculer ou avancer d'un mois. Modifiez le fuseau horaire, si nécessaire, en choisissant le fuseau horaire approprié dans la liste située en haut à droite.

1. Dans la page **Event details (Détails de l'événement)**, sélectionnez **Delete (Supprimer)**. Lorsque vous êtes invité à confirmer que vous souhaitez supprimer l'événement, sélectionnez **Confirm** (Confirmer).

# Importation et gestion d'événements à partir de calendriers tiers
<a name="third-party-events"></a>

Au lieu de créer des événements directement dans la AWS Systems Manager console, vous pouvez importer un fichier iCalendar `.ics` () depuis une application de calendrier tierce prise en charge. Votre calendrier peut inclure à la fois des événements importés et des événements créés par vos soins dans Change Calendar, un outil d’ AWS Systems Manager.

**Avant de commencer**  
Avant de tenter d'importer un fichier de calendrier, vérifiez les exigences et les contraintes suivantes :

Format de fichier de calendrier  
Seuls les fichiers iCalendar (`.ics`) valides sont pris en charge.

Fournisseurs de calendriers pris en charge  
Seuls les fichiers `.ics` exportés à partir des fournisseurs de calendriers tiers suivants sont pris en charge :  
+ Google Calendar ([Instructions d'exportation](https://support.google.com/calendar/answer/37111))
+ Microsoft Outlook ([Instructions d'exportation](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6))
+ iCloud Calendar ([Instructions d'exportation](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac))

Taille de fichier  
Vous pouvez importer n'importe quel nombre de fichiers `.ics` valides. Toutefois, la taille totale de tous les fichiers importés pour chaque calendrier ne peut pas dépasser 64 Ko.  
Pour réduire la taille du fichier `.ics`, vérifiez que vous n'exportez que les détails de base de vos entrées de calendrier. Si nécessaire, réduisez la longueur de la période de temps exportée.

Fuseau horaire  
Outre un nom de calendrier, un fournisseur de calendrier et au moins un événement, votre fichier `.ics` exporté doit indiquer le fuseau horaire du calendrier. Dans le cas contraire, ou si l'identification du fuseau horaire pose problème, vous serez invité à spécifier un fuseau horaire après l'importation du fichier.

Limitation d'événements récurrents  
Le fichier `.ics` que vous exportez peut contenir des événements récurrents. Cependant, si une ou plusieurs occurrences d'un événement récurrent ont été supprimées dans le calendrier source, l'importation échouera.

**Topics**
+ [Importation d'événements à partir de fournisseurs de calendrier tiers](change-calendar-import.md)
+ [Mise à jour de tous les événements d'un fournisseur de calendrier tiers](change-calendar-import-add-remove.md)
+ [Suppression de tous les événements importés d'un calendrier tiers](change-calendar-delete-ics.md)

# Importation d'événements à partir de fournisseurs de calendrier tiers
<a name="change-calendar-import"></a>

Procédez comme suit pour importer un fichier iCalendar (`.ics`) à partir d'une application de calendrier tierce prise en charge. Les événements contenus dans le fichier sont incorporés dans les règles de votre calendrier ouvert ou fermé. Vous pouvez importer un fichier dans le nouveau calendrier que vous créez avec Change Calendar (un outil d’ AWS Systems Manager) ou dans un calendrier existant.

Après avoir importé le fichier `.ics`, vous pouvez en supprimer des événements individuels via l'interface Change Calendar. Pour plus d'informations, consultez [Suppression d'un événement Change Calendar](change-calendar-delete-event.md). Vous pouvez aussi supprimer tous les événements du calendrier source en supprimant le ficher `.ics`. Pour plus d'informations, consultez [Suppression de tous les événements importés d'un calendrier tiers](change-calendar-delete-ics.md).

**Pour importer des événements à partir de fournisseurs de calendrier tiers**

1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Pour démarrer avec un nouveau calendrier, sélectionnez **Create calendar (Créer un calendrier)**. Dans la zone **Import calendar (Importer un calendrier**, sélectionnez **Choose file (Choisir un fichier)**. Pour obtenir des informations sur les autres étapes de création d'un calendrier, consultez [Création d'un calendrier de modifications](change-calendar-create.md).

   -ou-

   Pour importer des événements tiers dans un calendrier existant, sélectionnez le nom d'un calendrier existant pour l'ouvrir.

1. Sélectionnez **Actions, Edit** (Actions, modifier), puis dans la zone **Import calendar** (Importer le calendrier), sélectionnez **Choose file** (Choisir un fichier).

1. Sur votre ordinateur local, accédez au fichier `.ics` exporté et sélectionnez-le.

1. Si vous y êtes invité, pour **Select a time zone (Sélectionner un fuseau horaire)**, sélectionnez le fuseau horaire qui s'applique au calendrier.

1. Choisissez **Enregistrer**.

# Mise à jour de tous les événements d'un fournisseur de calendrier tiers
<a name="change-calendar-import-add-remove"></a>

Si plusieurs événements sont ajoutés à votre calendrier source, ou supprimés de celui-ci, une fois son fichier iCalendar `.ics` importé, vous pouvez refléter ces modifications dans Change Calendar. Tout d’abord, réexportez le calendrier source, puis importez le nouveau fichier dans Change Calendar, un outil d’ AWS Systems Manager. Les événements de votre calendrier de modifications seront mis à jour pour refléter le contenu du fichier le plus récent.

**Pour mettre à jour tous les événements provenant d'un fournisseur de calendrier tiers**

1. Dans votre calendrier tiers, ajoutez ou supprimez des événements de sorte qu'ils soient reflétés dans Change Calendar, puis réexportez le calendrier vers un nouveau fichier `.ics`.

1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Dans la liste des calendriers, sélectionnez le nom du calendrier.

1. Sélectionnez **Choisir un fichier**, puis recherchez et sélectionnez le fichier `.ics` de remplacement.

1. En réponse à la notification de l'écrasement du fichier existant, sélectionnez **Confirm (Confirmer)**.

# Suppression de tous les événements importés d'un calendrier tiers
<a name="change-calendar-delete-ics"></a>

Si vous ne voulez plus qu'aucun des événements importés à partir d'un fournisseur tiers figure dans votre calendrier, vous pouvez supprimer le fichier iCalendar `.ics` importé.

**Pour supprimer tous les événements importés d'un calendrier tiers**

1. Ouvrez la AWS Systems Manager console à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Dans la liste des calendriers, sélectionnez le nom du calendrier.

1. Dans la zone **Import calendar (Importer un calendrier)**, sous **My imported calendars (Mes calendriers importés)**, recherchez le nom du calendrier importé, puis sélectionnez le **X** dans sa carte.

1. Choisissez **Enregistrer**.

# Mise à jour d'un calendrier de modifications
<a name="change-calendar-update"></a>

Vous pouvez mettre à jour la description d'un calendrier de modifications, mais pas son nom. Bien que vous puissiez modifier du statut par défaut d'une entrée de calendrier, sachez que cela inverse le comportement des actions de modification lors des événements qui sont associés à cette entrée de calendrier. Par exemple, si vous remplacez du statut **Open by default (Ouvert par défaut)** d'un calendrier par **Closed by default (Fermé par défaut**, des modifications indésirables peuvent être effectuées pendant les périodes d'événement lorsque les utilisateurs qui ont créé les événements associés n'attendent pas de modifications.

Lorsque vous mettez à jour un calendrier de modifications, vous modifiez le document Change Calendar créé lors de la création de l’entrée. Change Calendar est un outil d’AWS Systems Manager.

**Pour mettre à jour un calendrier de modifications**

1. Ouvrez la console AWS Systems Manager à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Dans la liste des calendriers, sélectionnez le nom du calendrier à mettre à jour.

1. Sur la page des détails du calendrier, sélectionnez **Actions, Edit** (Actions, modifier).

1. Dans **Description**, vous pouvez modifier le texte de la description. Vous ne pouvez pas modifier le nom d'un calendrier de modifications.

1. Pour modifier du statut du calendrier, sélectionnez une autre valeur dans **Calendar type (Type de calendrier)**. Sachez que cela inverse le comportement des actions de modification lors des événements qui sont associés au calendrier. Avant de modifier le type de calendrier, vous devez vérifier auprès des autres utilisateurs Change Calendar que ce changement de type de calendrier n'autorise pas des modifications indésirables lors des événements qu'ils ont créés.
   + **Open by default (Ouvert par défaut)** – le calendrier est ouvert (les actions Automation peuvent s'exécuter jusqu'au démarrage d'un événement), puis fermé pendant la durée d'un événement associé.
   + **Closed by default (Fermé par défaut)** – le calendrier est fermé (les actions Automation ne peuvent pas s'exécuter avant le démarrage d'un événement), mais ouvert pendant la durée d'un événement associé.

1. Sélectionnez **Enregistrer**.

   Votre calendrier ne peut ni empêcher ni autoriser des actions tant que vous n'avez pas ajouté au moins un événement. Pour plus d'informations sur l'ajout d'un événement, consultez [Création d'un événement Change Calendar](change-calendar-create-event.md).

# Partage d'un calendrier de modifications
<a name="change-calendar-share"></a>

Vous pouvez partager un calendrier dans Change Calendar, un outil d’AWS Systems Manager, avec d’autres Comptes AWS via la console AWS Systems Manager. Lorsque vous partagez un calendrier, ce calendrier est en lecture seule pour les utilisateurs du compte partagé. Les fenêtres de maintenance, les associations State Manager et les automatisations ne sont pas partagées.

**Pour partager un calendrier de modifications**

1. Ouvrez la console AWS Systems Manager à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Dans la liste des calendriers, sélectionnez le nom du calendrier à partager.

1. Sur la page des détails du calendrier, sélectionnez l'onglet **Sharing** (Partage).

1. Sélectionnez **Actions, Share** (Actions, partager).

1. Dans **Share calendar (Partager le calendrier)**, pour **Account ID (ID de compte)**, saisissez le numéro d'identification d'un compte Compte AWS valide, puis sélectionnez **Share (Partager)**.

   Les utilisateurs du compte partagé peuvent lire le calendrier des modifications, mais ne peuvent y apporter aucune modification.

# Suppression d'un calendrier de modifications
<a name="change-calendar-delete"></a>

Vous pouvez supprimer un calendrier dans Change Calendar, un outil d’AWS Systems Manager, via la console Systems Manager ou la AWS Command Line Interface (AWS CLI). La suppression d'un calendrier des modifications supprime tous les événements associés.

**Pour supprimer un calendrier de modifications**

1. Ouvrez la console AWS Systems Manager à l'adresse [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. Dans le panneau de navigation, sélectionnez **Change Calendar**.

1. Dans la liste des calendriers, sélectionnez le nom du calendrier à supprimer.

1. Dans la page des détails du calendrier, sélectionnez **Actions, Delete** (Actions, Supprimer). Lorsque vous êtes invité à confirmer que vous souhaitez supprimer le calendrier, sélectionnez **Delete (Supprimer)**.

# Obtenir le statut d'un calendrier de modifications
<a name="change-calendar-getstate"></a>

Vous pouvez obtenir le statut global d’un calendrier ou son statut à un moment donné dans Change Calendar, un outil d’ AWS Systems Manager. Vous pouvez également afficher le prochain passage de l'état `OPEN` à l'état `CLOSED` (ou inversement) du calendrier.

**Note**  
Pour plus d'informations sur l'intégration Change Calendar à Amazon EventBridge pour la surveillance automatique des modifications de l'état du calendrier, consultez[Change Calendarintégration avec Amazon EventBridge](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration). EventBridge l'intégration fournit des notifications basées sur les événements lorsque les états du calendrier changent, complétant ainsi l'approche basée sur les sondages de l'action de l'API. `GetCalendarState`

Vous ne pouvez effectuer cette tâche qu'à l'aide de l'opération d'API `GetCalendarState`. La procédure décrite dans cette section utilise le AWS Command Line Interface (AWS CLI).

**Pour obtenir le statut d'un calendrier de modifications**
+ Exécutez la commande suivante pour afficher l'état d'une ou plusieurs calendriers à un moment spécifique. Le paramètre `--calendar-names` est obligatoire, mais `--at-time` est facultatif. Remplacez chaque *example resource placeholder* par vos propres informations.

------
#### [ Linux & macOS ]

  ```
  aws ssm get-calendar-state \
      --calendar-names "Calendar_name_or_document_ARN_1" "Calendar_name_or_document_ARN_2" \
      --at-time "ISO_8601_time_format"
  ```

  Voici un exemple.

  ```
  aws ssm get-calendar-state \
      --calendar-names "arn:aws:ssm:us-east-2:123456789012:document/MyChangeCalendarDocument" "arn:aws:ssm:us-east-2:123456789012:document/SupportOffHours" \
      --at-time "2020-07-30T11:05:14-0700"
  ```

------
#### [ Windows ]

  ```
  aws ssm get-calendar-state ^
      --calendar-names "Calendar_name_or_document_ARN_1" "Calendar_name_or_document_ARN_2" ^
      --at-time "ISO_8601_time_format"
  ```

  Voici un exemple.

  ```
  aws ssm get-calendar-state ^
      --calendar-names "arn:aws:ssm:us-east-2:123456789012:document/MyChangeCalendarDocument" "arn:aws:ssm:us-east-2:123456789012:document/SupportOffHours" ^
      --at-time "2020-07-30T11:05:14-0700"
  ```

------

  La commande renvoie des informations telles que les suivantes.

  ```
  {
      "State": "OPEN",
      "AtTime": "2020-07-30T16:18:18Z",
      "NextTransitionTime": "2020-07-31T00:00:00Z"
  }
  ```

  Les résultats indiquent l'état du calendrier (s'il est de type `DEFAULT_OPEN` ou `DEFAULT_CLOSED`) pour les entrées de calendrier spécifiées appartenant à votre compte ou partagées avec celui-ci, au moment spécifié par la valeur de `--at-time`, et l'heure de la transition suivante. Si vous n'ajoutez pas le paramètre `--at-time`, l'heure actuelle est utilisée.
**Note**  
Si vous spécifiez plusieurs calendriers dans une demande, la commande renvoie le statut `OPEN` uniquement si tous les calendriers de la demande sont ouverts. Si un ou plusieurs calendriers de la demande sont fermés, le statut renvoyé est `CLOSED`.

# Ajouter des dépendances Change Calendar à des runbooks Automation
<a name="systems-manager-change-calendar-automations"></a>

Pour que les actions d'automatisation adhèrent à Change Calendar un outil AWS Systems Manager, ajoutez une étape dans un runbook d'automatisation qui utilise l'[`aws:assertAwsResourceProperty`](automation-action-assertAwsResourceProperty.md)action. Configurez l'action pour exécuter `GetCalendarState` afin de vérifier qu'une entrée de calendrier spécifique est à l'état souhaité (`OPEN` ou `CLOSED`). Le runbook Automation n'est autorisé à passer à l'étape suivante que si l'état du calendrier est `OPEN`. Voici un exemple d'extrait YAML d'un runbook Automation qui ne peut pas passer à l'étape suivante, `LaunchInstance`, tant que l'état du calendrier ne correspond pas à `OPEN`, l'état spécifié dans `DesiredValues`.

Voici un exemple.

```
mainSteps:
  - name: MyCheckCalendarStateStep
    action: 'aws:assertAwsResourceProperty'
    inputs:
      Service: ssm
      Api: GetCalendarState
      CalendarNames: ["arn:aws:ssm:us-east-2:123456789012:document/SaleDays"]
      PropertySelector: '$.State'
      DesiredValues:
      - OPEN
    description: "Use GetCalendarState to determine whether a calendar is open or closed."
    nextStep: LaunchInstance
  - name: LaunchInstance
    action: 'aws:executeScript'
    inputs:
      Runtime: python3.11 
...
```

# Résolution des problèmes de Change Calendar
<a name="change-calendar-troubleshooting"></a>

Utilisez les informations suivantes pour résoudre les problèmes liés à Change Calendar, un outil d’ AWS Systems Manager.

**Topics**
+ [Erreur Échec d'importation du calendrier](#change-manager-troubleshooting-1)

## Erreur Échec d'importation du calendrier
<a name="change-manager-troubleshooting-1"></a>

**Problème** : lors de l'importation d'un fichier iCalendar (`.ics`), le système signale que l'importation du calendrier a échoué.
+ **Solution 1** : vérifiez que vous importez bien un fichier exporté à partir d'un fournisseur de calendrier tiers pris en charge, notamment :
  + Google Calendar ([Instructions d'exportation](https://support.google.com/calendar/answer/37111))
  + Microsoft Outlook ([Instructions d'exportation](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6))
  + iCloud Calendar ([Instructions d'exportation](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac))
+ **Solution 2** : si votre calendrier source contient des événements récurrents, vérifiez qu'aucune occurrence individuelle de l'événement n'a été annulée ou supprimée. Actuellement, Change Calendar ne prend pas en charge l'importation d'événements récurrents avec des annulations individuelles. Pour résoudre le problème, supprimez l'événement récurrent du calendrier source, réexportez le calendrier et réimportez-le dans Change Calendar, puis ajoutez l'événement récurrent via l'interface Change Calendar. Pour plus d'informations, consultez [Création d'un événement Change Calendar](change-calendar-create-event.md).
+ **Solution 3** : vérifiez que votre calendrier source contient au moins un événement. Les téléchargements de fichiers `.ics` exempts d'événements échouent.
+ **Solution 4** : si le système signale que l'importation a échoué parce que le fichier `.ics` est trop volumineux, vérifiez que vous n'exportez que les détails de base de vos entrées de calendrier. Si nécessaire, réduisez la longueur de la période de temps que vous exportez.
+ **Solution 5** : si Change Calendar n'est pas en mesure de déterminer le fuseau horaire du calendrier exporté lorsque vous tentez de l'importer à partir de l'onglet **Events (Événements)**, le message suivant peut s'afficher : « L'importation du calendrier a échoué. Change Calendar n'a pas pu localiser un fuseau horaire valide. Vous pouvez importer le calendrier à partir du menu Editi (Modifier). Dans ce cas, sélectionnez **Actions, Edit (Actions, Modifier)**, puis essayez d'importer le fichier à partir de la page **Edit calendar (Modifier le calendrier)**.
+ **Solution 6** : ne modifiez pas le fichier `.ics` avant importation. Les données du calendrier peuvent être corrompues si vous tentez de modifier le contenu du fichier. Si vous avez modifié le fichier avant de tenter de l'importer, exportez à nouveau le calendrier à partir du calendrier source, puis retentez le téléchargement.