• The AWS Systems Manager CloudWatch Dashboard will no longer be available after April 30, 2026. Customers can continue to use Amazon CloudWatch console to view, create, and manage their Amazon CloudWatch dashboards, just as they do today. For more information, see [Amazon CloudWatch Dashboard documentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). # AWS Systems Manager Change Calendar Change Calendar, a tool in AWS Systems Manager, allows you to set up date and time ranges when actions you specify (for example, in [Systems Manager Automation](systems-manager-automation.md) runbooks) might or might not be performed in your AWS account. In Change Calendar, these ranges are called *events*. When you create a Change Calendar entry, you're creating a [Systems Manager document](documents.md) of the type `ChangeCalendar`. In Change Calendar, the document stores [iCalendar 2.0](https://icalendar.org/) data in plaintext format. Events that you add to the Change Calendar entry become part of the document. To get started with Change Calendar, open the [Systems Manager console](https://console.aws.amazon.com//systems-manager/change-calendar). In the navigation pane, choose **Change Calendar**. You can create a calendar and its events in the Systems Manager console. You can also import an iCalendar (`.ics`) file that you have exported from a supported third-party calendar provider to add its events to your calendar. Supported providers include Google Calendar, Microsoft Outlook, and iCloud Calendar. A Change Calendar entry can be one of two types: **`DEFAULT_OPEN`**, or Open by default All actions can run by default, except during calendar events. During events, the state of a `DEFAULT_OPEN` calendar is `CLOSED` and events are blocked from running. **`DEFAULT_CLOSED`**, or Closed by default All actions are blocked by default, except during calendar events. During events, the state of a `DEFAULT_CLOSED` calendar is `OPEN` and actions are permitted to run. You can choose to have all scheduled Automation workflows, maintenance windows, and State Manager associations added automatically to a calendar. You can also remove any of those individual types from the calendar display. ## Who should use Change Calendar? **Change Manager availability change** AWS Systems Manager Change Manager will no longer be open to new customers starting November 7, 2025. If you would like to use Change Manager, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see [AWS Systems Manager Change Manager availability change](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html). + AWS customers who perform the following action types: + Create or run Automation runbooks. + Create change requests in Change Manager. + Run maintenance windows. + Create associations in State Manager. Automation, Change Manager, Maintenance Windows, and State Manager are all tools AWS Systems Manager. By integrating these tools with Change Calendar, you can allow or block these action types depending on the current state of the change calendar you associate with each one. + Administrators who are responsible for keeping the configurations of Systems Manager managed nodes consistent, stable, and functional. ## Benefits of Change Calendar The following are some benefits of Change Calendar. + **Review changes before they're applied** A Change Calendar entry can help ensure that potentially destructive changes to your environment are reviewed before they're applied. + **Apply changes only during appropriate times** Change Calendar entries help keep your environment stable during event times. For example, you can create a Change Calendar entry to block changes when you expect high demand on your resources, such as during a conference or public marketing promotion. A calendar entry can also block changes when you expect limited administrator support, such as during vacations or holidays. You can use a calendar entry to allow changes except for certain times of the day or week when there is limited administrator support to troubleshoot failed actions or deployments. + **Get the current or upcoming state of the calendar** You can run the Systems Manager `GetCalendarState` API operation to show you the current state of the calendar, the state at a specified time, or the next time that the calendar state is scheduled to change. **Note** The `GetCalendarState` API has a quota of 10 requests per second. For more information about Systems Manager quotas, see [Systems Manager service quotas](https://docs.aws.amazon.com/general/latest/gr/ssm.html#limits_ssm) in the *Amazon Web Services General Reference*. + **EventBridge support** This Systems Manager tool is supported as an *event* type in Amazon EventBridge rules. For information, see [Monitoring Systems Manager events with Amazon EventBridge](monitoring-eventbridge-events.md) and [Reference: Amazon EventBridge event patterns and types for Systems Manager](reference-eventbridge-events.md). **Topics** + [Who should use Change Calendar?](#systems-manager-change-calendar-who) + [Benefits of Change Calendar](#systems-manager-change-calendar-benefits) + [Setting up Change Calendar](systems-manager-change-calendar-prereqs.md) + [Working with Change Calendar](systems-manager-change-calendar-working.md) + [Adding Change Calendar dependencies to Automation runbooks](systems-manager-change-calendar-automations.md) + [Troubleshooting Change Calendar](change-calendar-troubleshooting.md) # Setting up Change Calendar Complete the following before using Change Calendar, a tool in AWS Systems Manager. ## Install latest command line tools Install the latest command line tools to get state information about calendars. | Requirement | Description | | --- | --- | | AWS CLI | (Optional) To use the AWS Command Line Interface (AWS CLI) to get state information about calendars, install the newest release of the AWS CLI on your local computer. For more information about how to install or upgrade the CLI, see [Installing, updating, and uninstalling the AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) in the *AWS Command Line Interface User Guide*. | | AWS Tools for PowerShell | (Optional) To use the Tools for PowerShell to get state information about calendars, install the newest release of Tools for PowerShell on your local computer. For more information about how to install or upgrade the Tools for PowerShell, see [Installing the AWS Tools for PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) in the *AWS Tools for PowerShell User Guide*. | ## Set up permissions If your user, group, or role is assigned administrator permissions, then you have full access to Change Calendar. If you don't have administrator permissions, then an administrator must give you permission by either assigning the `AmazonSSMFullAccess` managed policy, or assigning a policy that provides the necessary permissions to your user, group, or role. The following permissions are required to work with Change Calendar. **Change Calendar entries** To create, update, or delete a Change Calendar entry, including adding and removing events from the entry, a policy attached to your user, group, or role must allow the following actions: + `ssm:CreateDocument` + `ssm:DeleteDocument` + `ssm:DescribeDocument` + `ssm:DescribeDocumentPermission` + `ssm:GetCalendar` + `ssm:ListDocuments` + `ssm:ModifyDocumentPermission` + `ssm:PutCalendar` + `ssm:UpdateDocument` + `ssm:UpdateDocumentDefaultVersion` **Calendar state** To get information about the current or upcoming state of the calendar, a policy attached to your user, group, or role must allow the following action: + `ssm:GetCalendarState` **Operational events** To view operational events, such as maintenance windows, associations, and planned automations, the policy attached to your user, group, or role must allow the following actions: + `ssm:DescribeMaintenanceWindows` + `ssm:DescribeMaintenanceWindowExecution` + `ssm:DescribeAutomationExecutions` + `ssm:ListAssociations` **Note** Change Calendar entries that are owned by (that is, created by) accounts other than yours are read-only, even if they're shared with your account. Maintenance windows, State Manager associations, and automations aren't shared. # Working with Change Calendar You can use the AWS Systems Manager console to add, manage, or delete entries in Change Calendar, a tool in AWS Systems Manager. You can also import events from supported third-party calendar providers by importing an iCalendar (`.ics`) file that you exported from the source calendar. And, you can use the `GetCalendarState` API operation or the `get-calendar-state` AWS Command Line Interface (AWS CLI) command to get information about the state of Change Calendar at a specific time. **Topics** + [Creating a change calendar](change-calendar-create.md) + [Creating and managing events in Change Calendar](change-calendar-events.md) + [Importing and managing events from third-party calendars](third-party-events.md) + [Updating a change calendar](change-calendar-update.md) + [Sharing a change calendar](change-calendar-share.md) + [Deleting a change calendar](change-calendar-delete.md) + [Getting the state of a change calendar](change-calendar-getstate.md) # Creating a change calendar When you create an entry in Change Calendar, a tool in AWS Systems Manager, you're creating a Systems Manager document (SSM document) that uses the `text` format. **To create a change calendar** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. Choose **Create calendar**. -or- If the **Change Calendar** home page opens first, choose **Create change calendar**. 1. On the **Create calendar** page, in **Calendar details**, enter a name for your calendar entry. Calendar entry names can contain letters, numbers, periods, dashes, and underscores. The name should be specific enough to identify the purpose of the calendar entry at a glance. An example is **support-off-hours**. You can't update this name after you create the calendar entry. 1. (Optional) For **Description**, enter a description for your calendar entry. 1. (Optional) In the **Import calendar** area, choose **Choose file** to select an iCalendar (`.ics`) file that you have exported from a third-party calendar provider. Importing the file will add its events to your calendar. Supported providers include Google Calendar, Microsoft Outlook, and iCloud Calendar. For more information, see [Importing events from third-party calendar providers](change-calendar-import.md). 1. In **Calendar type**, choose one of the following. + **Open by default** - The calendar is open (Automation actions can run until an event starts), then closed for the duration of an associated event. + **Closed by default** - The calendar is closed (Automation actions can't run until an event starts) but open for the duration of an associated event. 1. (Optional) In **Change management events**, select **Add change management events to the calendar**. This selection displays all scheduled maintenance windows, State Manager associations, Automation workflows, and Change Manager change requests in your monthly calendar display. **Tip** If later you want to permanently remove these events types from the calendar display, edit the calendar, clear this check box, and then choose **Save**. 1. Choose **Create calendar**. After the calendar entry is created, Systems Manager displays your calendar entry in the **Change Calendar** list. The columns show the calendar version and the calendar owner's AWS account number. Your calendar entry can't prevent or allow any actions until you have created or imported at least one event. For information about creating an event, see [Creating a Change Calendar event](change-calendar-create-event.md). For information about importing events, see [Importing events from third-party calendar providers](change-calendar-import.md). # Creating and managing events in Change Calendar After you create a calendar in AWS Systems Manager Change Calendar, you can create, update, and delete events that are included in your open or closed calendar. Change Calendar is a tool in AWS Systems Manager. **Tip** As an alternative to creating events directly in the Systems Manager console, you can import an iCalendar (`.ics`) file from a supported third-party calendar application. For information, see [Importing and managing events from third-party calendars](third-party-events.md). **Topics** + [Creating a Change Calendar event](change-calendar-create-event.md) + [Updating a Change Calendar event](change-calendar-update-event.md) + [Deleting a Change Calendar event](change-calendar-delete-event.md) # Creating a Change Calendar event When you add an event to an entry in Change Calendar, a tool in AWS Systems Manager, you're specifying a period of time during which the default action of the calendar entry is suspended. For example, if the calendar entry type is closed by default, the calendar is open to changes during events. (Alternatively, you can create an advisory event, which serves an informational role on the calendar only.) Currently, you can only create a Change Calendar event by using the console. Events are added to the Change Calendar document that you create when you create a Change Calendar entry. **To create a Change Calendar event** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. In the list of calendars, choose the name of the calendar entry to which you want to add an event. 1. On the calendar entry's details page, choose **Create event**. 1. On the **Create scheduled event** page, in **Event details**, enter a display name for your event. Event names can contain letters, numbers, periods, dashes, and underscores. The name should be specific enough to identify the purpose of the event. An example is **nighttime-hours**. 1. For **Description**, enter a description for your event. For example, **The support team isn't available during these hours**. 1. (Optional) If you want this event to serve as a visual notification or reminder only, select the **Advisory** check box. Advisory events play no functional role on your calendar. They serve informational purposes only for those who view your calendar. 1. For **Event start date**, enter or choose a day in the format `MM/DD/YYYY` to start the event, and enter a time on the specified day in the format `hh:mm:ss` (hours, minutes, and seconds) to start the event. 1. For **Event end date**, enter or choose a day in the format `MM/DD/YYYY` to end the event, and enter a time on the specified day in the format `hh:mm:ss` (hours, minutes, and seconds) to end the event. 1. For **Schedule time zone**, choose a time zone that applies to the start and end times of the event. You can enter part of a city name or time zone difference from Greenwich Mean Time (GMT) to find a time zone faster. The default is Coordinated Universal Time (UTC). 1. (Optional) To create an event that recurs daily, weekly, or monthly, turn on **Recurrence**, and then specify the frequency and optional end date for the recurrence. 1. Choose **Create scheduled event**. The new event is added to your calendar entry, and is displayed on the **Events** tab of the calendar entry's details page. # Updating a Change Calendar event Use the following procedure to update a Change Calendar event in the AWS Systems Manager console. Change Calendar is a tool in AWS Systems Manager. **To update a Change Calendar event** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. In the list of calendars, choose the name of the calendar entry for which you want to edit an event. 1. On the calendar entry's details page, choose **Events**. 1. In the calendar page, choose the event that you want to edit. **Tip** Use the buttons on the upper left to move back or forward one year, or back or forward one month. Change the time zone, if required, by choosing the correct time zone from the list on the upper right. 1. In **Event details**, choose **Edit**. To change the event name and description, add to or replace the current text values. 1. To change the **Event start date** value, choose the current start date, and then choose a new date from the calendar. To change the start time, choose the current start time, and then choose a new time from the list. 1. To change the **Event end date** value, choose the current date, and then choose a new end date from the calendar. To change the end time, choose the current end time, and then choose a new time from the list. 1. To change the **Schedule time zone** value, choose a time zone to apply to the start and end times of the event. You can enter part of a city name or time zone difference from Greenwich Mean Time (GMT) to find a time zone faster. The default is Coordinated Universal Time (UTC). 1. (Optional) If you want this event to serve as a visual notification or reminder only, select the **Advisory** check box. Advisory events play no functional role on your calendar. They serve informational purposes only for those who view your calendar. 1. Choose **Save**. Your changes are displayed on the **Events** tab of the calendar entry's details page. Choose the event that you updated to view your changes. # Deleting a Change Calendar event You can delete one event at a time in Change Calendar, a tool in AWS Systems Manager, by using the AWS Management Console. **Tip** If you selected **Add change management events to the calendar** when you created the calendar, you can do the following: To *temporarily* hide a change management event type from the calendar display, choose the **X** for the type at the top of the monthly preview. To *permanently* remove these types from the calendar display, edit the calendar, clear the **Add change management events to the calendar** check box, and then choose **Save**. Removing the types from the calendar display doesn't delete them from your account. **To delete a Change Calendar event** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. In the list of calendars, choose the name of the calendar entry from which you want to delete an event. 1. On the calendar entry's details page, choose **Events**. 1. In the calendar page, choose the event that you want to delete. **Tip** Use the buttons on the upper left to move the calendar back or forward one year, or back or forward one month. Change the time zone, if required, by choosing the correct time zone from the list on the upper right. 1. On the **Event details** page, choose **Delete**. When you're prompted to confirm that you want to delete the event, choose **Confirm**. # Importing and managing events from third-party calendars As an alternative to creating events directly in the AWS Systems Manager console, you can import an iCalendar (`.ics`) file from a supported third-party calendar application. Your calendar can include both imported events and events that you create in Change Calendar, which is a tool in AWS Systems Manager. **Before you begin** Before you attempt to import a calendar file, review the following requirements and constraints: Calendar file format Only valid iCalendar files (`.ics`) are supported. Supported calendar providers Only `.ics` files exported from the following third-party calendar providers are supported: + Google Calendar ([Export instructions](https://support.google.com/calendar/answer/37111)) + Microsoft Outlook ([Export instructions](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6)) + iCloud Calendar ([Export instructions](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac)) File size You can import any number of valid `.ics` files. However, the total size of all imported files for each calendar can't exceed 64KB. To minimize the size of the `.ics` file, ensure that you are exporting only basic details about your calendar entries. If necessary, reduce the length of the time period that you are exporting. Time zone In addition to a calendar name, a calendar provider, and at least one event, your exported `.ics` file should also indicate the time zone for the calendar. If it does not, or there is a problem identifying the time zone, you will be prompted to specify one after you import the file. Recurring event limitation Your exported `.ics` file can include recurring events. However, if one or more occurrences of a recurring event had been deleted in the source calendar, the import fails. **Topics** + [Importing events from third-party calendar providers](change-calendar-import.md) + [Updating all events from a third-party calendar provider](change-calendar-import-add-remove.md) + [Deleting all events imported from a third-party calendar](change-calendar-delete-ics.md) # Importing events from third-party calendar providers Use the following procedure to import an iCalendar (`.ics`) file from a supported third-party calendar application. The events contained in the file are incorporated into the rules for your open or closed calendar. You can import a file into a new calendar you are creating with Change Calendar (a tool in AWS Systems Manager) or into an existing calendar. After you import the `.ics` file, you can remove individual events from it using the Change Calendar interface. For information, see [Deleting a Change Calendar event](change-calendar-delete-event.md). You can also delete all events from the source calendar by deleting the `.ics` file. For information, see [Deleting all events imported from a third-party calendar](change-calendar-delete-ics.md). **To import events from third-party calendar providers** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. To start with a new calendar, choose **Create calendar**. In the **Import calendar** area, choose **Choose file**. For information about other steps to create a new calendar, see [Creating a change calendar](change-calendar-create.md). -or- To import third-party events into an existing calendar, choose the name of an existing calendar to open it. 1. Choose **Actions, Edit**, and then in the **Import calendar** area, choose **Choose file**. 1. Navigate to and select the exported `.ics` file on your local computer. 1. If prompted, for **Select a time zone**, select which time zone applies to the calendar. 1. Choose **Save**. # Updating all events from a third-party calendar provider If several events are added to or removed from your source calendar after you have imported its iCalendar `.ics` file, you can reflect those changes in Change Calendar. First, re-export the source calendar, and then import the new file into Change Calendar, which is a tool in AWS Systems Manager. Events in your change calendar will be updated to reflect the contents of the newer file. **To update all events from a third-party calendar provider** 1. In your third-party calendar, add or remove events as you want them to be reflected in Change Calendar, and then re-export the calendar to a new `.ics` file. 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. From the list of calendars, choose the calendar name from the list. 1. Choose **Choose file**, and then navigate to and select the replacement `.ics` file. 1. In response to the notification about overwriting the existing file, choose **Confirm**. # Deleting all events imported from a third-party calendar If you no longer want any of the events that you imported from a third-party provider included in your calendar, you can delete the imported iCalendar `.ics` file. **To delete all events imported from a third-party calendar** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. From the list of calendars, choose the calendar name from the list. 1. In the **Import calendar** area, under **My imported calendars**, locate the name of the imported calendar, and then choose the **X** in its card. 1. Choose **Save**. # Updating a change calendar You can update the description of a change calendar, but not its name. Although you can change the default state of a calendar, be aware that this reverses the behavior of change actions during events that are associated with the calendar. For example, if you change the state of a calendar from **Open by default** to **Closed by default**, unwanted changes might be made during event periods when the users who created the associated events aren't expecting changes. When you update a change calendar, you're editing the Change Calendar document that you created when you created the entry. Change Calendar is a tool in AWS Systems Manager. **To update a change calendar** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. In the list of calendars, choose the name of the calendar that you want to update. 1. On the calendar's details page, choose **Actions, Edit**. 1. In **Description**, you can change the description text. You can't edit the name of a change calendar. 1. To change the calendar state, in **Calendar type**, choose a different value. Be aware that this reverses the behavior of change actions during events that are associated with the calendar. Before you change the calendar type, you should verify with other Change Calendar users that changing the calendar type doesn't allow unwanted changes during events that they have created. + **Open by default** – The calendar is open (Automation actions can run until an event starts) then closed for the duration of an associated event. + **Closed by default** – The calendar is closed (Automation actions can't run until an event starts) but open for the duration of an associated event. 1. Choose **Save**. Your calendar can't prevent or allow any actions until you add at least one event. For information about how to add an event, see [Creating a Change Calendar event](change-calendar-create-event.md). # Sharing a change calendar You can share a calendar in Change Calendar, a tool in AWS Systems Manager, with other AWS accounts by using the AWS Systems Manager console. When you share a calendar, the calendar is read-only to users in the shared account. Maintenance windows, State Manager associations, and automations aren't shared. **To share a change calendar** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. In the list of calendars, choose the name of the calendar that you want to share. 1. On the calendar's details page, choose the **Sharing** tab. 1. Choose **Actions, Share**. 1. In **Share calendar**, for **Account ID**, enter the ID number of a valid AWS account, and then choose **Share**. Users of the shared account can read the change calendar, but they can't make changes. # Deleting a change calendar You can delete a calendar in Change Calendar, a tool in AWS Systems Manager, by using either the Systems Manager console or the AWS Command Line Interface (AWS CLI). Deleting a change calendar deletes all associated events. **To delete a change calendar** 1. Open the AWS Systems Manager console at [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. In the navigation pane, choose **Change Calendar**. 1. In the list of calendars, choose the name of the calendar that you want to delete. 1. On the calendar's details page, choose **Actions, Delete**. When you're prompted to confirm that you want to delete the calendar, choose **Delete**. # Getting the state of a change calendar You can get the overall state of a calendar or the state of a calendar at a specific time in Change Calendar, a tool in AWS Systems Manager. You can also show the next time that the calendar state changes from `OPEN` to `CLOSED`, or the reverse. **Note** For information about integrating Change Calendar with Amazon EventBridge for automated monitoring of calendar state changes, see [Change Calendar integration with Amazon EventBridge](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration). EventBridge integration provides event-driven notifications when calendar states transition, complementing the polling-based approach of the `GetCalendarState` API action. You can do this task only by using the `GetCalendarState` API operation. The procedure in this section uses the AWS Command Line Interface (AWS CLI). **To get the state of a change calendar** + Run the following command to show the state of one or more calendars at a specific time. The `--calendar-names` parameter is required, but `--at-time` is optional. Replace each *example resource placeholder* with your own information. ------ #### [ 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" ``` The following is an example. ``` 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" ``` The following is an example. ``` 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" ``` ------ The command returns information like the following. ``` { "State": "OPEN", "AtTime": "2020-07-30T16:18:18Z", "NextTransitionTime": "2020-07-31T00:00:00Z" } ``` The results show the state of the calendar (whether the calendar is of type `DEFAULT_OPEN` or `DEFAULT_CLOSED`) for the specified calendar entries that are owned by or shared with your account, at the time specified as the value of `--at-time`, and the time of the next transition. If you don't add the `--at-time` parameter, the current time is used. **Note** If you specify more than one calendar in a request, the command returns the status of `OPEN` only if all calendars in the request are open. If one or more calendars in the request are closed, the status returned is `CLOSED`. # Adding Change Calendar dependencies to Automation runbooks To make Automation actions adhere to Change Calendar, a tool in AWS Systems Manager, add a step in an Automation runbook that uses the [`aws:assertAwsResourceProperty`](automation-action-assertAwsResourceProperty.md) action. Configure the action to run `GetCalendarState` to verify that a specified calendar entry is in the state that you want (`OPEN` or `CLOSED`). The Automation runbook is only allowed to continue to the next step if the calendar state is `OPEN`. The following is a YAML-based sample excerpt of an Automation runbook that can't advance to the next step, `LaunchInstance`, unless the calendar state matches `OPEN`, the state specified in `DesiredValues`. The following is an example. ``` 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 ... ``` # Troubleshooting Change Calendar Use the following information to help you troubleshoot problems with Change Calendar, a tool in AWS Systems Manager. **Topics** + ['Calendar import failed' error](#change-manager-troubleshooting-1) ## 'Calendar import failed' error **Problem**: When importing an iCalendar (`.ics`) file, the system reports that the calendar import failed. + **Solution 1** – Ensure that you are importing a file that was exported from a supported third-party calendar provider, which include the following: + Google Calendar ([Export instructions](https://support.google.com/calendar/answer/37111)) + Microsoft Outlook ([Export instructions](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6)) + iCloud Calendar ([Export instructions](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac)) + **Solution 2** – If your source calendar contains any recurring events, ensure that no individual occurrences of the event have been canceled or deleted. Currently, Change Calendar doesn't support importing recurring events with individual cancellations. To resolve the issue, remove the recurring event from the source calendar, re-export the calendar and re-import it into Change Calendar, and then add the recurring event using the Change Calendar interface. For information, see [Creating a Change Calendar event](change-calendar-create-event.md). + **Solution 3** – Ensure that your source calendar contains at least one event. Uploads of `.ics` files that don't contain events don't succeed. + **Solution 4** – If the system reports that the import failed because the `.ics` is too large, ensure that you are exporting only basic details about your calendar entries. If necessary, reduce the length of the time period that you export. + **Solution 5** – If Change Calendar is unable to determine the time zone of your exported calendar when you attempt to import it from the **Events** tab, you might receive this message: "Calendar import failed. Change Calendar couldn't locate a valid time zone. You can import the calendar from the Edit menu." In this case, choose **Actions, Edit**, and then try importing the file from the **Edit calendar** page. + **Solution 6** – Don't edit the `.ics` file before import. Attempting to modify the contents of the file can corrupt the calendar data. If you have modified the file before attempting the import, export the calendar from the source calendar again, and then re-attempt the upload.