

• El panel de AWS Systems Manager CloudWatch dejará de estar disponible después del 30 de abril de 2026. Los clientes pueden seguir utilizando la consola de Amazon CloudWatch para ver, crear y administrar sus paneles de Amazon CloudWatch, tal y como lo hacen actualmente. Para obtener más información, consulte la [documentación del panel de Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). 

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

Change Calendar, una herramienta de AWS Systems Manager, le permite configurar intervalos de fecha y hora cuando las acciones que especifique (por ejemplo, en manuales de procedimientos de [Automatización de Systems Manager](systems-manager-automation.md)) pueden llevarse a cabo o no en su Cuenta de AWS. En Change Calendar, estos intervalos se denominan *eventos*. Cuando crea una entrada de Change Calendar, está creando un [documento de Systems Manager](documents.md) del tipo `ChangeCalendar`. En Change Calendar, el documento almacena datos [iCalendar 2.0](https://icalendar.org/) en texto sin formato. Los eventos que añada a la entrada de Change Calendar pasan a formar parte del documento. Para comenzar a utilizar Change Calendar, abra la [consola de Systems Manager](https://console.aws.amazon.com//systems-manager/change-calendar). En el panel de navegación, elija **Change Calendar**.

Puede crear un calendario y sus eventos en la consola de Systems Manager. También puede importar un iCalendar (`.ics`) que ha exportado desde un proveedor de calendario de terceros compatible para agregar los eventos al calendario. Los proveedores compatibles incluyen Google Calendar, Microsoft Outlook y iCloud Calendar.

Una entrada de Change Calendar puede ser de dos tipos:

**`DEFAULT_OPEN`**, o abierta de forma predeterminada  
Todas las acciones se pueden ejecutar de forma predeterminada, excepto durante los eventos del calendario. Durante los eventos, el estado de un calendario `DEFAULT_OPEN` es `CLOSED` y los eventos están bloqueados para que se ejecuten.

**`DEFAULT_CLOSED`**, o cerrada de forma predeterminada  
Todas las acciones están bloqueadas de forma predeterminada, excepto durante los eventos del calendario. Durante los eventos, el estado de un calendario `DEFAULT_CLOSED` es `OPEN` y se permite ejecutar acciones.

Puede elegir que todos los flujos de trabajo de automatización programados, los períodos de mantenimiento y las asociaciones de State Manager se agreguen automáticamente a un calendario. También puede eliminar cualquiera de esos tipos individuales de la pantalla del calendario. 

## ¿Quién debe utilizar Change Calendar?
<a name="systems-manager-change-calendar-who"></a>

**Cambio en la disponibilidad de Change Manager**  
Change Manager de AWS Systems Manager dejará de estar disponible para nuevos clientes a partir del 7 de noviembre de 2025. Si desea utilizar Change Manager, regístrese antes de esa fecha. Los clientes existentes pueden seguir utilizando el servicio con normalidad. Para obtener más información, consulte [Cambio en la disponibilidad de Change Manager de AWS Systems Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html). 
+ Los clientes de AWS que realizan los siguientes tipos de acciones:
  + Cree o ejecute manuales de procedimientos de automatización.
  + Cree una solicitud de cambio en Change Manager.
  + Ejecute los periodos de mantenimiento.
  + Cree una asociación en State Manager.

  Automatización, Change Manager, Maintenance Windows y State Manager son herramientas de AWS Systems Manager. Mediante la integración de estas herramientas a Change Calendar, puede permitir o bloquear estos tipos de acciones en función del estado actual del calendario de cambios que asocie a cada uno.
+ Lo deben utilizar los administradores responsables de que las configuraciones de los nodos administrados de Systems Manager sean coherentes, estables y funcionales en todo momento.

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

A continuación se describen los beneficios de Change Calendar.
+ **Revisión de los cambios antes de aplicarlos**

  Una entrada de Change Calendar puede ayudar a garantizar que los cambios potencialmente destructivos para el entorno se revisen antes de aplicarlos.
+ **Aplicación de cambios solo durante los momentos apropiados**

  Change CalendarLas entradas de ayudan a mantener el entorno estable durante los eventos. Por ejemplo, puede crear una entrada de Change Calendar para impedir los cambios cuando espere una gran demanda de recursos; por ejemplo, durante una conferencia o una promoción de marketing pública. Una entrada de calendario también puede impedir los cambios mientras esté previsto que el soporte de administradores sea limitado; por ejemplo, durante las vacaciones o los días festivos. Puede usar una entrada de calendario para permitir los cambios excepto en determinados momentos del día o de la semana en los que disponga de soporte de administradores limitado para solucionar problemas de acciones o implementaciones fallidas.
+ **Obtener el estado actual o próximo del calendario**

  Puede ejecutar la operación `GetCalendarState` de la API de Systems Manager para mostrar el estado actual del calendario, el estado a una hora determinada o la próxima vez programada para cambiar el estado del calendario.
**nota**  
La API `GetCalendarState` tiene una cuota de 10 solicitudes por segundo. Para obtener más información sobre las cuotas de Systems Manager, consulte [Service Quotas de Systems Manager](https://docs.aws.amazon.com/general/latest/gr/ssm.html#limits_ssm) en *Referencia general de Amazon Web Services*.
+ 

**Compatibilidad con EventBridge**  
Esta herramienta de Systems Manager se admite como un tipo de *evento* en las reglas de Amazon EventBridge. Para obtener más información, consulte [Cómo monitorear eventos de Systems Manager con Amazon EventBridge](monitoring-eventbridge-events.md) y [Referencia: patrones y tipos de eventos de Amazon EventBridge para Systems Manager](reference-eventbridge-events.md).

**Topics**
+ [¿Quién debe utilizar Change Calendar?](#systems-manager-change-calendar-who)
+ [Ventajas de Change Calendar](#systems-manager-change-calendar-benefits)
+ [Cómo configurar Change Calendar](systems-manager-change-calendar-prereqs.md)
+ [Uso de Change Calendar](systems-manager-change-calendar-working.md)
+ [Agregado de dependencias de Change Calendar a manuales de procedimientos de Automation](systems-manager-change-calendar-automations.md)
+ [Resolución de problemas de Change Calendar](change-calendar-troubleshooting.md)

# Cómo configurar Change Calendar
<a name="systems-manager-change-calendar-prereqs"></a>

Complete lo siguiente antes de usar Change Calendar, una herramienta de AWS Systems Manager.

## Instalar las herramientas de línea de comandos más recientes
<a name="change-calendar-prereqs-tools"></a>

Instale las herramientas de línea de comandos más recientes para obtener información de estado acerca de los calendarios.


| Requisito | Descripción | 
| --- | --- | 
|  AWS CLI  |  (Opcional) Para utilizar la AWS Command Line Interface (AWS CLI) con el fin de obtener información de estado acerca de los calendarios, instale la versión más reciente de la AWS CLI en el equipo local. Para obtener más información acerca de cómo se instala o actualiza la CLI, consulte [Instalación, actualización y desinstalación de AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) en la *Guía del usuario de AWS Command Line Interface*.  | 
|  Herramientas de AWS para PowerShell  |  (Opcional) Para utilizar Tools for PowerShell con el fin de obtener información de estado acerca de los calendarios, instale la versión más reciente de Tools for PowerShell en el equipo local. Para obtener más información acerca de cómo se instala o actualiza Tools for PowerShell, consulte [Instalación de Herramientas de AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) en la *Guía del usuario de Herramientas de AWS para PowerShell*.  | 

## Configuración de permisos
<a name="change-calendar-prereqs-permissions"></a>

Si el usuario, grupo o rol tiene asignados permisos de administrador, entonces tiene acceso a Change Calendar. Si no tiene permisos de administrador, un administrador debe concederle permiso mediante la asignación de la política administrada `AmazonSSMFullAccess` o de una política que proporcione permisos comparables a su usuario, grupo o rol.

Los siguientes permisos son necesarios para utilizar Change Calendar.

**Entradas de Change Calendar**  
Para crear, actualizar o eliminar una entrada de Change Calendar, incluida la adición y eliminación de eventos de la entrada, debe tener una política adjunta a su usuario, grupo o rol que permita las siguientes acciones:  
+ `ssm:CreateDocument`
+ `ssm:DeleteDocument`
+ `ssm:DescribeDocument`
+ `ssm:DescribeDocumentPermission`
+ `ssm:GetCalendar`
+ `ssm:ListDocuments`
+ `ssm:ModifyDocumentPermission`
+ `ssm:PutCalendar`
+ `ssm:UpdateDocument`
+ `ssm:UpdateDocumentDefaultVersion`

**Estado del calendario**  
Para obtener información sobre el estado actual o próximo del calendario, debe tener una política adjunta a su usuario, grupo o rol que permita la siguiente acción:  
+ `ssm:GetCalendarState`

**Eventos operativos**  
Para ver los eventos operativos, como los periodos de mantenimiento, las asociaciones y las automatizaciones planificadas, la política asociada al usuario, grupo o rol debe permitir las siguientes acciones:  
+ `ssm:DescribeMaintenanceWindows`
+ `ssm:DescribeMaintenanceWindowExecution`
+ `ssm:DescribeAutomationExecutions`
+ `ssm:ListAssociations`

**nota**  
Change CalendarLas entradas de que son propiedad de (es decir, que se han creado mediante) cuentas distintas de las suyas serán de solo lectura, aunque se compartan con su cuenta. Los periodos de mantenimiento, las asociaciones de State Manager y las automatizaciones no se comparten.

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

Puede usar la consola de AWS Systems Manager para agregar, administrar o eliminar entradas de Change Calendar, una herramienta de AWS Systems Manager. También puede importar eventos de proveedores de calendarios de terceros admitidos mediante la importación de un archivo de iCalendar (`.ics`) que exportó desde el calendario fuente. Puede utilizar la operación de la API `GetCalendarState` o el comando `get-calendar-state` de AWS Command Line Interface (AWS CLI) para obtener información acerca del estado de Change Calendar en un momento específico.

**Topics**
+ [Creación de un calendario de cambios](change-calendar-create.md)
+ [Creación y administración de eventos en Change Calendar](change-calendar-events.md)
+ [Importación y administración de eventos desde calendarios de terceros](third-party-events.md)
+ [Actualización de un calendario de cambios](change-calendar-update.md)
+ [Uso compartido de un calendario de cambios](change-calendar-share.md)
+ [Eliminación de un calendario de cambios](change-calendar-delete.md)
+ [Obtención del estado de un calendario de cambios](change-calendar-getstate.md)

# Creación de un calendario de cambios
<a name="change-calendar-create"></a>

Cuando crea una entrada en Change Calendar, una herramienta de AWS Systems Manager, está creando un documento de Systems Manager (documento de SSM) que utiliza el formato `text`.

**Para crear un calendario de cambios**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. Elija **Create calendar (Crear calendario)**.

   -o bien-

   Si se abre la página de inicio **Change Calendar** primero, elija **Create change calendar** (Creación de calendario de cambios).

1. En la página **Create calendar (Crear calendario)**, en **Calendar details (Detalles del calendario)**, escriba un nombre para la entrada de calendario. Los nombres de entradas de calendario solo pueden incluir letras, números, puntos, guiones y guiones bajos. El nombre debe ser lo bastante específico como para identificar el propósito de la entrada de calendario de un vistazo. Un ejemplo es **support-off-hours**. Este nombre no se puede actualizar después de haber creado la entrada de calendario.

1. (Opcional) En **Description** (Descripción), escriba una descripción para la entrada de calendario.

1. (Opcional) En el área **Import calendar** (Importa calendario), elija **Choose file** (Elegir archivo) para seleccionar un archivo de iCalendar (`.ics`) que ha exportado desde un proveedor de calendario de terceros. Al importar el archivo, los eventos al calendario se agregarán.

   Los proveedores compatibles incluyen Google Calendar, Microsoft Outlook y iCloud Calendar.

   Para obtener más información, consulte [Importación de eventos de proveedores de calendarios de terceros](change-calendar-import.md).

1. En **Calendar type (Tipo de calendario)**, elija una de las opciones siguientes:
   + **Open by default** (Abierto de forma predeterminada): el calendario se abre (las acciones de Automation se pueden ejecutar hasta que se inicie un evento) y, a continuación, se cierra durante el tiempo de un evento asociado.
   + **Closed by default** (Cerrado de forma predeterminada): el calendario se cierra (las acciones de Automation no se pueden ejecutar hasta que se inicie un evento), pero se abre durante el tiempo de un evento asociado.

1. (Opcional) En **Eventos de administración de cambios**, seleccione **Agregar eventos de administración de cambios al calendario**. En esta selección se muestran todos los periodos de mantenimiento programado, las asociaciones de State Manager, los flujos de trabajo de automatización y las solicitudes de cambios de Change Manager en la visualización del calendario mensual.
**sugerencia**  
Si más adelante desea eliminar permanentemente estos tipos de eventos de la visualización del calendario, edite el calendario, desactive esta casilla y, a continuación, elija **Guardar**.

1. Elija **Create calendar (Crear calendario)**.

   Una vez creada la entrada de calendario, Systems Manager muestra la entrada de calendario en la lista **Change Calendar**. Las columnas muestran la versión del calendario y el número de la Cuenta de AWS del propietario del calendario. La entrada de calendario no puede impedir ni permitir ninguna acción hasta que haya agregado al menos un evento. Para obtener más información sobre cómo se crea un evento, consulte [Creación de un evento de Change Calendar](change-calendar-create-event.md). Para obtener información sobre la importación de eventos, consulte [Importación de eventos de proveedores de calendarios de terceros](change-calendar-import.md).

# Creación y administración de eventos en Change Calendar
<a name="change-calendar-events"></a>

Después de crear un calendario en AWS Systems Manager Change Calendar, puede crear, actualizar y eliminar eventos incluidos en el calendario abierto o cerrado. Change Calendar es una herramienta de AWS Systems Manager.

**sugerencia**  
Como alternativa a crear eventos directamente en la consola de Systems Manager, puede importar un archivo de iCalendar (`.ics`) de una aplicación de calendario de terceros compatible. Para obtener más información, consulte [Importación y administración de eventos desde calendarios de terceros](third-party-events.md).

**Topics**
+ [Creación de un evento de Change Calendar](change-calendar-create-event.md)
+ [Actualización de un evento de Change Calendar](change-calendar-update-event.md)
+ [Eliminación de un evento de Change Calendar](change-calendar-delete-event.md)

# Creación de un evento de Change Calendar
<a name="change-calendar-create-event"></a>

Cuando agrega un evento a una entrada de Change Calendar, una herramienta de AWS Systems Manager, especifica un periodo durante el cual se suspende la acción predeterminada de la entrada de calendario. Por ejemplo, si el tipo de entrada de calendario es cerrado de forma predeterminada, el calendario estará abierto para realizar cambios durante los eventos. (Alternativamente, puede crear un evento de asesoramiento, que solo cumple un rol informativo en el calendario).

Actualmente, solo puede crear un evento de Change Calendar mediante la consola. Los eventos se agregan al documento de Change Calendar que crea cuando crea una entrada de Change Calendar.

**Para crear un evento de Change Calendar**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. En la lista de calendarios, elija el nombre de la entrada de calendario a la que desea agregar un evento.

1. En la página de detalles de la entrada de calendario, seleccione **Create event (Crear evento)**.

1. En la página **Create scheduled event (Crear evento programado)**, en **Event details (Detalles del evento)** escriba el un nombre para mostrar del evento. Los nombres de eventos solo pueden incluir letras, números, puntos, guiones y guiones bajos. El nombre debe ser lo bastante específico para identificar el propósito del evento. Un ejemplo es **nighttime-hours**.

1. En **Description** (Descripción), escriba una descripción del evento. Por ejemplo, **The support team isn't available during these hours**.

1. (Opcional) Si desea que este evento sirva solo como notificación visual o recordatorio, seleccione la casilla de verificación **Advisory** (Recordatorio). Los eventos de recordatorio no cumplen ningún rol funcional en su calendario. Solo sirven para fines informativos para aquellos que ven su calendario.

1. En **Event start date** (Fecha de inicio del evento), ingrese o elija un día con el formato `MM/DD/YYYY` para iniciar el evento e indique una hora en el día especificado con el formato `hh:mm:ss` (horas, minutos y segundos) para iniciar el evento.

1. En **Event end date (Fecha de finalización del evento)**, ingrese o elija un día con el formato `MM/DD/YYYY` para finalizar el evento e indique una hora en el día especificado con el formato `hh:mm:ss` (horas, minutos y segundos) para finalizar el evento.

1. En **Schedule time zone (Programar zona horaria)**, elija la zona horaria aplicable a las horas de inicio y finalización del evento. Puede introducir parte del nombre de una ciudad o la diferencia de zona horaria con respecto a la hora media de Greenwich (GMT) para encontrar una zona horaria más rápidamente. El valor predeterminado es la Hora Universal Coordinada (UTC).

1. (Opcional) Para crear un evento que se repita con periodicidad diaria, semanal o mensual, active **Recurrence** (Recurrencia) y, a continuación, especifique la frecuencia y la fecha de finalización opcionales de la repetición.

1. Elija **Create scheduled event (Crear evento programado)**. El nuevo evento se agrega a la entrada de calendario y se muestra en la pestaña **Events (Eventos)** de la página de detalles de la entrada de calendario.

# Actualización de un evento de Change Calendar
<a name="change-calendar-update-event"></a>

Utilice el siguiente procedimiento para actualizar un evento Change Calendar en la consola de AWS Systems Manager. Change Calendar es una herramienta de AWS Systems Manager.

**Para actualizar un evento de Change Calendar**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. En la lista de calendarios, elija el nombre de la entrada de calendario cuyo evento desea editar.

1. En la página de detalles de la entrada de calendario, seleccione **Events (Eventos)**.

1. En la página del calendario, elija el evento que desea editar.
**sugerencia**  
Utilice los botones de la parte superior izquierda para avanzar o retroceder un año o un mes. Si es preciso cambiar la zona horaria, elija la que sea correcta en la lista ubicada en la parte superior derecha.

1. En **Event details** (Detalles del evento), elija **Edit** (Editar).

   Para cambiar el nombre y la descripción del evento, agregue o reemplace los valores de texto actuales.

1. Para cambiar el valor **Event start date** (Fecha de inicio del evento), elija la fecha de inicio actual y, a continuación, elija una nueva fecha del calendario. Para cambiar la hora de inicio, elija la hora de inicio actual y, a continuación, elija una nueva hora de la lista.

1. Para cambiar el valor **Event end date** (Fecha de finalización del evento), elija la fecha actual y, a continuación, elija una nueva fecha de finalización del calendario. Para cambiar la hora de finalización, elija la hora de finalización actual y, a continuación, elija una nueva hora de la lista.

1. Para cambiar el valor de **Schedule time zone** (Programar zona horaria), seleccione la zona horaria aplicable a la hora de inicio y de finalización del evento. Puede introducir parte del nombre de una ciudad o la diferencia de zona horaria con respecto a la hora media de Greenwich (GMT) para encontrar una zona horaria más rápidamente. El valor predeterminado es la Hora Universal Coordinada (UTC).

1. (Opcional) Si desea que este evento sirva solo como notificación visual o recordatorio, seleccione la casilla de verificación **Advisory** (Recordatorio). Los eventos de recordatorio no cumplen ningún rol funcional en su calendario. Solo sirven para fines informativos para aquellos que ven su calendario.

1. Seleccione **Guardar**. Los cambios se muestran en la pestaña **Events (Eventos)** de la página de detalles de la entrada de calendario. Elija el evento que ha actualizado para ver los cambios.

# Eliminación de un evento de Change Calendar
<a name="change-calendar-delete-event"></a>

Puede eliminar un evento a la vez en Change Calendar, una herramienta de AWS Systems Manager, mediante la Consola de administración de AWS. 

**sugerencia**  
Si cuando creó el calendario seleccionó **Agregar eventos de administración de cambios al calendario**, puede hacer lo siguiente:  
Para ocultar *temporalmente* un tipo de evento de administración de cambios de la visualización del calendario, seleccione la **X** para el tipo en la parte superior de la vista previa mensual.
Para eliminar *permanentemente* estos tipos de la visualización del calendario, edite el calendario, desactive la casilla **Agregar eventos de administración de cambios al calendario** y, a continuación, seleccione **Guardar**. Si elimina los tipos de la visualización del calendario, no se eliminarán de la cuenta.

**Para eliminar un evento de Change Calendar**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. En la lista de calendarios, elija el nombre de la entrada de calendario cuyo evento desea eliminar.

1. En la página de detalles de la entrada de calendario, seleccione **Events (Eventos)**.

1. En la página del calendario, elija el evento que desea eliminar.
**sugerencia**  
Utilice los botones de la parte superior izquierda para avanzar o retroceder un año o un mes en el calendario. Si es preciso cambiar la zona horaria, elija la que sea correcta en la lista ubicada en la parte superior derecha.

1. En la página **Event details (Detalles del evento)**, seleccione **Delete (Eliminar)**. Cuando se le pida que confirme que desea eliminar el evento, elija **Confirm** (Confirmar).

# Importación y administración de eventos desde calendarios de terceros
<a name="third-party-events"></a>

Como alternativa a la creación de eventos directamente en la consola de AWS Systems Manager, puede importar un archivo de iCalendar (`.ics`) de una aplicación de calendario de terceros compatible. El calendario puede incluir eventos importados y eventos que cree en Change Calendar, que es una herramienta de AWS Systems Manager.

**Antes de empezar**  
Antes de intentar importar un archivo de calendario, revise los siguientes requisitos y restricciones:

Formato del archivo del calendario  
Solo son compatibles los archivos de iCalendar válidos (`.ics`).

Proveedores de calendarios compatibles  
Solo se admiten los archivos `.ics` exportados de los siguientes proveedores de calendarios de terceros:  
+ Calendario de Google ([Instrucciones de exportación](https://support.google.com/calendar/answer/37111))
+ Microsoft Outlook ([Instrucciones de exportación](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6))
+ Calendario de iCloud ([Instrucciones de exportación](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac))

Tamaño del archivo  
Puede importar cualquier número de archivos `.ics` válidos. Sin embargo, el tamaño total de todos los archivos importados de cada calendario no puede superar los 64 KB.  
Para minimizar el tamaño del archivo `.ics`, asegúrese de exportar solo los detalles básicos sobre las entradas del calendario. Si es necesario, reduzca la duración del período de tiempo que va a exportar.

Zona horaria  
Además de un nombre de calendario, un proveedor de calendario y al menos un evento, el archivo `.ics` que se exporta debe indicar también la zona horaria del calendario. Si no lo hace o hay un problema al identificar la zona horaria, se le pedirá que especifique una después de importar el archivo.

Limitación de eventos periódicos  
El archivo `.ics` que exportó puede incluir eventos recurrentes. Sin embargo, si se ha eliminado una o varias apariciones de un evento recurrente en el calendario fuente, se produce un error en la importación.

**Topics**
+ [Importación de eventos de proveedores de calendarios de terceros](change-calendar-import.md)
+ [Actualización de todos los eventos de un proveedor de calendario de terceros](change-calendar-import-add-remove.md)
+ [Eliminación de todos los eventos importados de un calendario de terceros](change-calendar-delete-ics.md)

# Importación de eventos de proveedores de calendarios de terceros
<a name="change-calendar-import"></a>

Utilice el siguiente procedimiento para importar un archivo de iCalendar (`.ics`) de una aplicación de calendario de terceros compatible. Los eventos que están en el archivo se incorporan a las reglas del calendario abierto o cerrado. Puede importar un archivo a un nuevo calendario que esté creando con Change Calendar (una herramienta de AWS Systems Manager) o en un calendario existente.

Después de importar el archivo `.ics`, puede eliminar eventos individuales de este mediante el la interfaz de Change Calendar. Para obtener más información, consulte [Eliminación de un evento de Change Calendar](change-calendar-delete-event.md). También puede eliminar todos los eventos del calendario fuente mediante la eliminación del archivo `.ics`. Para obtener más información, consulte [Eliminación de todos los eventos importados de un calendario de terceros](change-calendar-delete-ics.md).

**Importación de eventos de proveedores de calendarios de terceros**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. Para empezar con un calendario nuevo, elija **Create calendar** (Crear calendario). En el área **Import calendar** (Importar calendario), elija **Choose file** (Elegir archivo). Para obtener información sobre otros pasos para crear un calendario nuevo, consulte [Creación de un calendario de cambios](change-calendar-create.md).

   -o bien-

   Para importar eventos de terceros a un calendario existente, elija el nombre de un calendario existente para abrirlo.

1. Elija **Actions, Edit** (Acciones, Editar) y, a continuación, en el área **Import calendar** (Importar calendario), elija **Choose file** (Elegir archivo).

1. Busque y seleccione el archivo `.ics` exportado en su equipo local.

1. Si se le pregunta, en **Select a time zone** (Seleccionar una zona horaria), seleccione qué zona horaria se aplica al calendario.

1. Seleccione **Save**.

# Actualización de todos los eventos de un proveedor de calendario de terceros
<a name="change-calendar-import-add-remove"></a>

Si se agregan o eliminan varios eventos del calendario fuente después de haber importado el archivo `.ics` de iCalendar, puede reflejar esos cambios en Change Calendar. En primer lugar, vuelva a exportar el calendario de origen y, a continuación, importe el archivo nuevo a Change Calendar, que es una herramienta de AWS Systems Manager. Los eventos del calendario de cambios se actualizarán para reflejar el contenido del archivo más reciente.

**Para actualizar todos los eventos de un proveedor de calendario de terceros**

1. En el calendario de terceros, agregue o elimine eventos tal como desee que se reflejen en Change Calendar y, a continuación, vuelva a exportar el calendario a un archivo `.ics` nuevo.

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. Elija el nombre del calendario de la lista desde la lista de calendarios.

1. Seleccione **Elegir archivo** y, a continuación, busque y seleccione el archivo `.ics` de reemplazo.

1. En respuesta a la notificación sobre el reemplazo del archivo existente, elija **Confirm** (Confirmar).

# Eliminación de todos los eventos importados de un calendario de terceros
<a name="change-calendar-delete-ics"></a>

Si ya no desea que ninguno de los eventos importados de un proveedor de terceros se incluya en el calendario, puede eliminar el archivo `.ics` importado de iCalendar.

**Para eliminar todos los eventos importados de un calendario de terceros**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. Elija el nombre del calendario de la lista desde la lista de calendarios.

1. En el área **Import calendar** (Importar calendario), bajo **My imported calendars** (Mis calendarios importados), busque el nombre del calendario importado y, a continuación, elija la **X**en la tarjeta.

1. Seleccione **Save**.

# Actualización de un calendario de cambios
<a name="change-calendar-update"></a>

Puede actualizar la descripción de un calendario de cambios, pero no el nombre. Aunque puede cambiar el estado predeterminado de un calendario, tenga en cuenta que esto invierte el comportamiento de las acciones de cambio durante los eventos asociados a la entrada del calendario. Por ejemplo, si cambia el estado de un calendario de **Open by default** (Abierto de forma predeterminada) a **Closed by default** (Cerrado de forma predeterminada), es posible que se realicen cambios no deseados durante los periodos de eventos durante los cuales los usuarios que crearon los eventos asociados no hayan previsto que se produzcan cambios.

Cuando actualiza un calendario de cambios, edita el documento Change Calendar que creó al crear la entrada. Change Calendar es una herramienta de AWS Systems Manager.

**Actualización de un calendario de cambios**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. En la lista de calendarios, elija el nombre del calendario que desee actualizar.

1. En la página de detalles del calendario, elija **Actions, Edit** (Acciones, Editar).

1. En **Description (Descripción)**, puede cambiar el texto de la descripción. No es posible editar el nombre de un calendario de cambios.

1. Para cambiar el estado del calendario, elija un valor diferente en **Calendar type (Tipo de calendario)**. Tenga en cuenta que esto invierte el comportamiento de las acciones de cambio durante los eventos asociados al calendario. Antes de cambiar el tipo de calendario, debe confirmar con los demás usuarios de Change Calendar que cambiar el tipo de calendario no permitirá cambios no deseados durante los eventos que ellos han creado.
   + **Open by default** (Abierto de forma predeterminada): el calendario se abre (las acciones de Automation se pueden ejecutar hasta que se inicie un evento) y, a continuación, se cierra durante el tiempo de un evento asociado.
   + **Closed by default** (Cerrado de forma predeterminada): el calendario se cierra (las acciones de Automation no se pueden ejecutar hasta que se inicie un evento), pero se abre durante el tiempo de un evento asociado.

1. Seleccione **Guardar**.

   El calendario no puede impedir ni permitir ninguna acción hasta que haya agregado al menos un evento. Para obtener información sobre cómo agregar un disco, consulte [Creación de un evento de Change Calendar](change-calendar-create-event.md).

# Uso compartido de un calendario de cambios
<a name="change-calendar-share"></a>

Puede compartir un calendario en Change Calendar, una herramienta de AWS Systems Manager, con otras Cuentas de AWS mediante el uso de la consola de AWS Systems Manager. Cuando se comparte un calendario, el calendario es de solo lectura para los usuarios de la cuenta compartida. Los periodos de mantenimiento, las asociaciones de State Manager y las automatizaciones no se comparten.

**Uso compartido de un calendario de cambios**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. En la lista de calendarios, elija el nombre del calendario que desee compartir.

1. En la página de detalles del calendario, elija la pestaña **Sharing** (Compartir).

1. Elija **Action, Share** (Acciones, Compartir).

1. En **Share Calendar** (Compartir calendario), para **Account ID** (ID de cuenta), ingrese el número de ID de una Cuenta de AWS válida y luego elija **Share** (Compartir).

   Los usuarios de la cuenta compartida pueden leer el calendario de cambios, pero no pueden realizar cambios.

# Eliminación de un calendario de cambios
<a name="change-calendar-delete"></a>

Puede eliminar un calendario en Change Calendar, una herramienta de AWS Systems Manager, mediante la consola de Systems Manager o AWS Command Line Interface (AWS CLI). Al eliminar un calendario de cambios, se eliminan todos los eventos asociados.

**Eliminación de un calendario de cambios**

1. Abra la consola de AWS Systems Manager en [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).

1. En el panel de navegación, elija **Change Calendar**.

1. En la lista de calendarios, elija el nombre del calendario que desee eliminar.

1. En la página de detalles del calendario, seleccione **Actions, Delete** (Acciones, Eliminar). Cuando se le pida la confirmación para eliminar el calendario, elija **Delete** (Eliminar).

# Obtención del estado de un calendario de cambios
<a name="change-calendar-getstate"></a>

Puede obtener el estado general de un calendario o el estado de un calendario en un momento específico en Change Calendar, una herramienta de AWS Systems Manager. También puede mostrar la próxima vez que el estado del calendario va a cambiar de `OPEN` a `CLOSED`, o a la inversa.

**nota**  
Para obtener información sobre la integración de Change Calendar en Amazon EventBridge para la supervisión automática de los cambios de estado del calendario, consulte [Integración de Change Calendar en Amazon Eventbridge](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration). La integración de EventBridge proporciona notificaciones basadas en eventos cuando los estados del calendario cambian, lo que complementa el enfoque basado en sondeos de la acción de la API `GetCalendarState`.

Esta tarea solo se puede realizar mediante la operación `GetCalendarState` de la API. En el procedimiento de esta sección se utiliza la AWS Command Line Interface (AWS CLI).

**Para obtener el estado de un calendario de cambios**
+ Ejecute el siguiente comando para mostrar el estado de uno o más calendarios en un momento específico. El parámetro `--calendar-names` es obligatorio, pero `--at-time` es opcional. Reemplace cada *example resource placeholder* con su propia información.

------
#### [ 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"
  ```

  A continuación se muestra un ejemplo.

  ```
  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"
  ```

  A continuación se muestra un ejemplo.

  ```
  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"
  ```

------

  El comando devuelve información similar a la siguiente.

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

  Los resultados muestran el estado del calendario (si el calendario es de tipo `DEFAULT_OPEN` o `DEFAULT_CLOSED`) de las entradas de calendario especificadas que son propiedad de la cuenta o compartidas con ella, en el momento especificado como valor de `--at-time`, así como en el momento de la siguiente transición. Si no agrega el parámetro `--at-time`, se utiliza la hora actual.
**nota**  
Si especifica más de un calendario en una solicitud, el comando regresa el estado `OPEN` solo si todos los calendarios de la solicitud están abiertos. Si se cierran uno o más calendarios de la solicitud, el estado regresado es `CLOSED`.

# Agregado de dependencias de Change Calendar a manuales de procedimientos de Automation
<a name="systems-manager-change-calendar-automations"></a>

Para que las acciones de Automatización se adhieran a Change Calendar, una herramienta de AWS Systems Manager, deberá agregar un paso en un manual de procedimientos de Automatización que utilice la acción [`aws:assertAwsResourceProperty`](automation-action-assertAwsResourceProperty.md). Configure la acción para que ejecute `GetCalendarState`, con el fin de comprobar que una entrada de calendario especificada está en el estado que desea (`OPEN` o `CLOSED`). El manual de procedimientos de Automation solo puede continuar con el siguiente paso si el estado del calendario es `OPEN`. A continuación se muestra un extracto de ejemplo basado en YAML de un manual de procedimientos de Automation que no puede avanzar al siguiente paso, `LaunchInstance`, a menos que el estado del calendario coincida con `OPEN`, que es el estado especificado en `DesiredValues`.

A continuación se muestra un ejemplo.

```
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 
...
```

# Resolución de problemas de Change Calendar
<a name="change-calendar-troubleshooting"></a>

Utilice la siguiente información como ayuda para solucionar problemas con Change Calendar, una herramienta de AWS Systems Manager.

**Topics**
+ [Error ‘Error en la importación del calendario’](#change-manager-troubleshooting-1)

## Error ‘Error en la importación del calendario’
<a name="change-manager-troubleshooting-1"></a>

**Problema**: Al importar un archivo de iCalendar (`.ics`), el sistema informa que ocurrió un error en la importación del calendario.
+ **Solución 1**: Asegúrese de importar un archivo que se ha exportado desde un proveedor de calendario de terceros compatible, que incluya lo siguiente:
  + Calendario de Google ([Instrucciones de exportación](https://support.google.com/calendar/answer/37111))
  + Microsoft Outlook ([Instrucciones de exportación](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6))
  + Calendario de iCloud ([Instrucciones de exportación](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac))
+ **Solución 2**: Si el calendario fuente contiene eventos recurrentes, asegúrese de que no se haya cancelado o eliminado ninguna ocurrencia individual del evento. En la actualidad, Change Calendar no admite la importación de eventos recurrentes con cancelaciones individuales. Para resolver el problema, elimine el evento recurrente del calendario fuente, vuelva a exportar el calendario y vuelva a importarlo en Change Calendar y, a continuación, agregue el evento recurrente mediante la interfaz de Change Calendar. Para obtener más información, consulte [Creación de un evento de Change Calendar](change-calendar-create-event.md).
+ **Solución 3**: Asegúrese de que el calendario fuente contenga al menos un evento. Las cargas de los archivos `.ics` que no contienen eventos no se realizan correctamente.
+ **Solución 4**: Si el sistema informa de que la importación ha fallado porque el `.ics` es demasiado grande, asegúrese de exportar solo detalles básicos sobre las entradas del calendario. Si es necesario, reduzca la duración del período de tiempo que exporta.
+ **Solución 5**: Si Change Calendar no puede determinar la zona horaria del calendario exportado cuando intenta importarlo desde la pestaña **Events** (Eventos), puede que reciba este mensaje: “Falló la importación del calendario. Change Calendar no se ha podido localizar una zona horaria válida. Puede importar el calendario desde el menú Edit (Editar)”. En este caso, seleccione **Accions, Edit** (Acciones, Editar) y, a continuación, intente importar el archivo desde la página **Edit calendar** (Editar calendario).
+ **Solución 6**: No edite el archivo `.ics` antes de importar. Si se intenta modificar el contenido del archivo, se pueden dañar los datos del calendario. Si ha modificado el archivo antes de intentar importar, vuelva a exportar el calendario desde el calendario fuente y, a continuación, vuelva a intentar la carga.