• O AWS Systems Manager CloudWatch Dashboard não estará mais disponível a partir de 30 de abril de 2026. Os clientes podem continuar usando o console do Amazon CloudWatch para visualizar, criar e gerenciar os painéis do Amazon CloudWatch exatamente como fazem hoje. Para obter mais informações, consulte a [documentação do Amazon CloudWatch](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html). # AWS Systems Manager Change Calendar O Change Calendar, uma ferramenta do AWS Systems Manager, permite configurar intervalos de data e hora quando as ações especificadas (por exemplo, em runbooks do [Systems Manager Automation](systems-manager-automation.md)) podem ou não ser executadas em sua Conta da AWS. No Change Calendar, esses intervalos são chamados de *eventos*. Ao criar uma entrada do Change Calendar, você está criando um [documento do Systems Manager](documents.md) do tipo `ChangeCalendar`. No Change Calendar, o documento armazena dados do [iCalendar 2.0](https://icalendar.org/) em formato de texto simples. Os eventos adicionados à entrada do Change Calendar tornam-se parte do documento. Para começar a usar o Change Calendar, abra o [Systems Manager console](https://console.aws.amazon.com//systems-manager/change-calendar) (Console do gerenciador de sistemas). No painel de navegação, escolha **Change Calendar**. Você pode criar um calendário e seus eventos no console do Systems Manager. Você pode também importar um arquivo do iCalendar (`.ics`) que você exportou de um provedor de calendário de terceiros compatível, para adicionar seus eventos ao calendário. Os provedores compatíveis incluem o Google Agenda, o Microsoft Outlook e o Calendário do iCloud. Uma entrada do Change Calendar pode ser de dois tipos: **`DEFAULT_OPEN`**, ou Aberto por padrão Todas as ações podem ser executadas por padrão, exceto durante eventos do calendário. Durante eventos, o estado de um calendário `DEFAULT_OPEN` é `CLOSED` e os eventos são bloqueados para execução. **`DEFAULT_CLOSED`**, ou Fechado por padrão Todas as ações são bloqueadas por padrão, exceto durante eventos do calendário. Durante eventos, o estado de um calendário `DEFAULT_CLOSED` é `OPEN` e as ações podem ser executadas. Você pode optar por ter todos os fluxos de trabalho do Automation, janelas de manutenção e associações do State Manager agendados adicionados automaticamente a um calendário. Também é possível remover qualquer um desses tipos individuais da exibição de calendário. ## Quem deve usar o Change Calendar? **Mudança de disponibilidade do Change Manager** O AWS Systems Manager Change Manager não estará mais disponível para novos clientes a partir de 7 de novembro de 2025. Se quiser usar o Change Manager, inscreva-se antes dessa data. Os clientes atuais podem continuar usando o serviço normalmente. Para obter mais informações, consulte [mudança de disponibilidade do AWS Systems Manager Change Manager](https://docs.aws.amazon.com/systems-manager/latest/userguide/change-manager-availability-change.html). + Clientes da AWS que realizam os seguintes tipos de ação: + Crie ou execute runbooks do Automation. + Crie solicitações de alteração no Change Manager. + Executar janelas de manutenção. + Crie associações no State Manager. Automation, Change Manager, Maintenance Windows e State Manager são ferramentas do AWS Systems Manager. Ao integrar essas ferramentas ao Change Calendar, você poderá permitir ou bloquear esses tipos de ações dependendo do estado atual do calendário de alterações que associar a cada um deles. + Administradores responsáveis por manter as configurações dos nós gerenciados pelo Systems Manager consistentes, estáveis e funcionais. ## Benefícios do Change Calendar Veja a seguir alguns benefícios do Change Calendar. + **Revisar as alterações antes de serem aplicadas** Uma entrada do Change Calendar pode ajudar a garantir que alterações potencialmente destrutivas em seu ambiente sejam analisadas antes de serem aplicadas. + **Aplicar alterações somente nas horas apropriadas** Change CalendarO ajuda a manter seu ambiente estável durante os horários dos eventos. Por exemplo, é possível criar uma entrada do Change Calendar para bloquear alterações quando você espera uma alta demanda em seus recursos, como durante uma conferência ou promoção de marketing pública. Uma entrada de calendário também pode bloquear alterações quando você espera suporte limitado do administrador, como durante férias ou feriados. É possível usar uma entrada de calendário para permitir alterações, exceto em determinadas horas do dia ou da semana, quando há suporte limitado do administrador para solucionar problemas de ações ou implantações com falha. + **Obter o estado atual ou futuro do calendário** Você pode executar a operação da API `GetCalendarState` do Systems Manager para mostrar o estado atual do calendário, o estado em uma hora especificada ou a próxima vez que o estado do calendário estiver programado para alterar. **nota** A API `GetCalendarState` tem uma cota de dez solicitações por segundo. Para obter informações sobre as cotas do System Manager, consulte [Systems Manager service quotas](https://docs.aws.amazon.com/general/latest/gr/ssm.html#limits_ssm) no *Referência geral da Amazon Web Services*. + **Suporte ao EventBridge** Essa ferramenta do Systems Manager pode ser usada como um tipo de *evento* nas regras do Amazon EventBridge. Para obter informações, consulte [Monitorar eventos do Systems Manager com o Amazon EventBridge](monitoring-eventbridge-events.md) e [Referência: padrões e tipos de eventos do Amazon EventBridge para o Systems Manager](reference-eventbridge-events.md). **Topics** + [Quem deve usar o Change Calendar?](#systems-manager-change-calendar-who) + [Benefícios do Change Calendar](#systems-manager-change-calendar-benefits) + [Configurar o Change Calendar](systems-manager-change-calendar-prereqs.md) + [Trabalhar com o Change Calendar](systems-manager-change-calendar-working.md) + [Adicionar dependências do Change Calendar para runbooks do Automation](systems-manager-change-calendar-automations.md) + [Solução de problemas do Change Calendar](change-calendar-troubleshooting.md) # Configurar o Change Calendar Conclua o seguinte antes de usar o Change Calendar, uma ferramenta do AWS Systems Manager. ## Instalar as ferramentas de linha de comando mais recentes Instale as ferramentas de linha de comando mais recentes para obter informações de estado sobre calendários. | Requisito | Descrição | | --- | --- | | AWS CLI | (Opcional) Para usar a AWS Command Line Interface (AWS CLI) para obter informações de estado sobre calendários, instale a versão mais recente da AWS CLI no computador local. Para obter mais informações sobre como instalar ou atualizar a CLI, consulte [Instalar, atualizar e desinstalar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html) no *Guia do usuário da AWS Command Line Interface*. | | Ferramentas da AWS para PowerShell | (Opcional) Para usar o Tools for PowerShell para obter informações de estado sobre calendários, instale a versão mais recente do Tools for PowerShell no computador local. Para obter mais informações sobre como instalar ou atualizar a Tools for PowerShell, consulte [Instalar a Ferramentas da AWS para PowerShell](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html) no *Guia do usuário da Ferramentas da AWS para PowerShell*. | ## Configurar permissões Se seu usuário, grupo ou perfil tiver permissões de administrador atribuídas, você terá acesso total ao Change Calendar. Se você não tiver permissões de administrador, um administrador deverá conceder as permissões ao atribuir a política gerenciada `AmazonSSMFullAccess` ou ao atribuir uma política que forneça as permissões necessárias para seu usuário, grupo ou perfil. As seguintes permissões são necessárias para trabalhar com o Change Calendar. **Entradas do Change Calendar** Para criar, atualizar ou excluir uma entrada do Change Calendar, incluindo adicionar e remover eventos da entrada, uma política anexada ao usuário, perfil ou grupo deve permitir as seguintes ações: + `ssm:CreateDocument` + `ssm:DeleteDocument` + `ssm:DescribeDocument` + `ssm:DescribeDocumentPermission` + `ssm:GetCalendar` + `ssm:ListDocuments` + `ssm:ModifyDocumentPermission` + `ssm:PutCalendar` + `ssm:UpdateDocument` + `ssm:UpdateDocumentDefaultVersion` **Estado do calendário** Para obter informações sobre o estado atual ou futuro do calendário, uma política anexada ao usuário, grupo ou perfil deve permitir a seguinte ação: + `ssm:GetCalendarState` **Eventos operacionais** Para visualizar eventos operacionais, como janelas de manutenção, associações e automações planejadas, a política anexada ao usuário, grupo ou perfil deve permitir estas ações: + `ssm:DescribeMaintenanceWindows` + `ssm:DescribeMaintenanceWindowExecution` + `ssm:DescribeAutomationExecutions` + `ssm:ListAssociations` **nota** Change CalendarAs entradas do que são de propriedade das (ou seja, criadas por) contas que não sejam suas são somente leitura, mesmo que compartilhadas com sua conta. Janelas de manutenção, associações do State Manager e automações não são compartilhadas. # Trabalhar com o Change Calendar É possível usar o console do AWS Systems Manager para adicionar, gerenciar ou excluir entradas no Change Calendar, uma ferramenta do AWS Systems Manager. Você também pode importar eventos de provedores de calendário de terceiros compatíveis, importando um arquivo do iCalendar (`.ics`) exportado do calendário de origem. E você pode usar a operação API `GetCalendarState` ou o comando `get-calendar-state` da AWS Command Line Interface (AWS CLI) para obter informações sobre o estado do Change Calendar em um horário específico. **Topics** + [Criar um calendário de alterações](change-calendar-create.md) + [Criar e gerenciar eventos no Change Calendar](change-calendar-events.md) + [Importar e gerenciar eventos de calendários de terceiros](third-party-events.md) + [Atualizar um calendário de alterações](change-calendar-update.md) + [Compartilhar um calendário de alterações](change-calendar-share.md) + [Excluir um calendário de alterações](change-calendar-delete.md) + [Obter o estado de um calendário de alterações](change-calendar-getstate.md) # Criar um calendário de alterações Quando você cria uma entrada no Change Calendar, uma ferramenta do AWS Systems Manager, você está criando um documento do Systems Manager (documento SSM) que usa o formato `text`. **Para criar um calendário de alterações** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Escolha **Create calendar (Criar calendário)**. - ou - Se a página inicial **Change Calendar** abrir primeiro, escolha **Create change calendar** (Criar calendário de alterações). 1. Na página **Create calendar (Criar calendário)** em **Calendar details (Detalhes do calendário)**, insira um nome para a entrada do calendário. Nomes de entradas do calendário podem conter letras, números, pontos, traços e sublinhados. O nome deve ser específico o suficiente para identificar rapidamente a finalidade da entrada do calendário. Um exemplo é **support-off-hours**. Não é possível atualizar esse nome depois de criar a entrada do calendário. 1. Em **Description** (Descrição), insira uma descrição para a sua entrada do calendário. 1. (Opcional) Na área **Import calendar** (Importar calendário), selecione **Choose file** (Escolher arquivo) para selecionar um arquivo do iCalendar (`.ics`) exportado de um provedor de calendário terceirizado. Importar o arquivo adicionará seus eventos ao seu calendário. Os provedores compatíveis incluem o Google Agenda, o Microsoft Outlook e o Calendário do iCloud. Para ter mais informações, consulte [Importar eventos de provedores de calendário de terceiros](change-calendar-import.md). 1. Em **Calendar type (Tipo de calendário)**, escolha uma das seguintes opções. + **Open by default** (Aberto por padrão): o calendário é aberto (as ações de automação podem ser executadas até que um evento seja iniciado) e fechado logo depois pela duração de um evento associado. + **Closed by default** (Fechado por padrão) - o calendário está fechado (as ações do Automation não podem ser executadas até que um evento seja iniciado), mas é aberto durante um evento associado. 1. (Opcional) Em **Eventos de gerenciamento de alterações**, selecione **Adicionar eventos de gerenciamento de alterações ao calendário**. Essa seleção exibe todas as janelas de manutenção programada, associações do State Manager, fluxos de trabalho do Automation e solicitações de alterações do Change Manager na exibição do calendário mensal. **dica** Depois, caso você queira remover permanentemente esses tipos de eventos da exibição do calendário, edite o calendário, desmarque essa caixa de seleção e escolha **Salvar**. 1. Escolha **Create calendar (Criar calendário)**. Depois que a entrada do calendário for criada, o Systems Manager exibirá a entrada do calendário na lista **Change Calendar**. As colunas exibem a versão do calendário e o número de conta da Conta da AWS do proprietário do calendário. Sua entrada do calendário não pode prevenir ou permitir nenhuma ação até que você adicione pelo menos um evento. Para obter mais informações sobre como criar um evento, consulte [Criar um evento do Change Calendar](change-calendar-create-event.md). Para obter mais informações sobre a importação de eventos, consulte [Importar eventos de provedores de calendário de terceiros](change-calendar-import.md). # Criar e gerenciar eventos no Change Calendar Depois de criar um calendário no AWS Systems Manager Change Calendar, você poderá criar, atualizar e excluir eventos incluídos no calendário aberto ou fechado. O Change Calendar é uma ferramenta do AWS Systems Manager. **dica** Como alternativa à criação de eventos diretamente no console do Systems Manager, você pode importar um iCalendar (`.ics`) de uma aplicação de calendário de terceiros compatível. Para mais informações, consulte [Importar e gerenciar eventos de calendários de terceiros](third-party-events.md). **Topics** + [Criar um evento do Change Calendar](change-calendar-create-event.md) + [Atualizar um evento do Change Calendar](change-calendar-update-event.md) + [Excluir um evento do Change Calendar](change-calendar-delete-event.md) # Criar um evento do Change Calendar Ao adicionar um evento a uma entrada do Change Calendar, uma ferramenta do AWS Systems Manager, você está especificando um período durante o qual a ação padrão da entrada do calendário está suspensa. Por exemplo, se o tipo de entrada do calendário for fechado por padrão, o calendário estará aberto para alterações durante eventos. (Alternativamente, você pode criar um evento consultivo, que cumpre uma função informativa apenas no calendário.) Atualmente, só é possível pode criar um evento do Change Calendar usando o console. Os eventos são adicionados ao documento do Change Calendar criado quando você cria uma entrada do Change Calendar. **Para criar um evento do Change Calendar** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Na lista de calendários, escolha o nome da entrada do calendário à qual você deseja adicionar um evento. 1. Na página de detalhes da entrada do calendário, escolha **Create event (Criar evento)**. 1. Na página **Create scheduled event (Criar evento programado)** em **Event details (Detalhes do evento)**, insira um nome de exibição para seu evento. Nomes de eventos podem conter letras, números, pontos, traços e sublinhados. O nome deve ser específico o suficiente para identificar a finalidade do evento. Um exemplo é **nighttime-hours**. 1. Em **Description** (Descrição), insira uma descrição para o seu evento. Por exemplo, **The support team isn't available during these hours**. 1. (Opcional) Se você quiser que este evento sirva como uma notificação visual ou lembrete apenas, selecione a opção **Advisory** (Consultivo). Eventos consultivos não desempenham nenhum papel funcional em seu calendário. Eles servem para fins informativos apenas para aqueles que visualizam seu calendário. 1. Em **Event start date** (Data de início do evento), insira ou escolha um dia no formato `MM/DD/YYYY` para iniciar o evento e insira uma hora no dia especificada no formato `hh:mm:ss` (horas, minutos e segundos) para iniciar o evento. 1. Em **Event end date** (Data de término do evento), insira ou escolha um dia no formato `MM/DD/YYYY` para encerrar o evento e insira uma hora no dia especificada no formato `hh:mm:ss` (horas, minutos e segundos) para encerrar o evento. 1. Em **Schedule time zone** (Fuso horário da programação), escolha um fuso horário que se aplique às horas de início e término do evento. É possível inserir parte de um nome de cidade ou diferença de fuso horário de Greenwich Mean Time (GMT) para encontrar um fuso horário mais rapidamente. O padrão é o Tempo Universal Coordenado (UTC). 1. (Opcional) Para criar um evento que se repita diariamente, semanalmente ou mensalmente, ative **Recurrence** (Recorrência) e, em seguida, especifique a frequência e a data final opcional para a recorrência. 1. Escolha **Create scheduled event (Criar evento programado)**. O novo evento é adicionado à entrada do calendário e é exibido na guia **Events (Eventos)** da página de detalhes da entrada do calendário. # Atualizar um evento do Change Calendar Use o procedimento a seguir para atualizar um evento do Change Calendar no console do AWS Systems Manager. O Change Calendar é uma ferramenta do AWS Systems Manager. **Para atualizar um evento do Change Calendar** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Na lista de calendários, escolha o nome da entrada do calendário para a qual você deseja editar um evento. 1. Na página de detalhes da entrada do calendário, escolha **Events (Eventos)**. 1. Na página do calendário, escolha o evento que deseja editar. **dica** Use os botões no canto superior esquerdo para se mover para atrás ou para frente de um ano e de um mês. Altere o fuso horário, se necessário, escolhendo o fuso horário correto na lista no canto superior direito. 1. Em **Event details** (Detalhes do evento), escolha **Edit** (Editar). Para alterar o nome e a descrição do evento, adicione ou substitua os valores de texto atuais. 1. Para alterar o valor da **Event start date** (Data de início do evento), escolha a data de início atual e escolha uma nova data no calendário. Para alterar a hora de início, escolha a hora de início atual e escolha uma nova hora na lista. 1. Para alterar o valor da **Event end date** (Data de término do evento), escolha a data de término atual e escolha uma nova data no calendário. Para alterar a hora de término, escolha a hora de término atual e escolha uma nova hora na lista. 1. Para alterar o valor de **Schedule time zone** (Fuso horário da programação), escolha um fuso horário que se aplique às horas de início e término do evento. É possível inserir parte de um nome de cidade ou diferença de fuso horário de Greenwich Mean Time (GMT) para encontrar um fuso horário mais rapidamente. O padrão é o Tempo Universal Coordenado (UTC). 1. (Opcional) Se você quiser que este evento sirva como uma notificação visual ou lembrete apenas, selecione a opção **Advisory** (Consultivo). Eventos consultivos não desempenham nenhum papel funcional em seu calendário. Eles servem para fins informativos apenas para aqueles que visualizam seu calendário. 1. Escolha **Salvar**. Suas alterações são exibidas na guia **Events (Eventos)** da página de detalhes da entrada do calendário. Escolha o evento atualizado para exibir suas alterações. # Excluir um evento do Change Calendar É possível excluir um evento de cada vez no Change Calendar, uma ferramenta do AWS Systems Manager, usando o Console de gerenciamento da AWS. **dica** Caso selecione **Adicionar eventos de gerenciamento de alterações ao calendário** ao criar o calendário, você poderá fazer o seguinte: Para ocultar um tipo de evento de gerenciamento de alterações na exibição do calendário *temporariamente*, escolha o **X** para o tipo na parte superior da pré-visualização mensal. Para remover esses tipos da exibição do calendário *permanentemente*, edite o calendário, desmarque a caixa de seleção **Adicionar eventos de gerenciamento de alterações ao calendário**, e escolha **Salvar**. Remover os tipos da exibição do calendário não os excluirá da conta. **Para excluir um evento do Change Calendar** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Na lista de calendários, escolha o nome da entrada do calendário da qual você deseja excluir um evento. 1. Na página de detalhes da entrada do calendário, escolha **Events (Eventos)**. 1. Na página do calendário, escolha o evento que você deseja excluir. **dica** Use os botões no canto superior esquerdo para retroceder ou avançar o calendário em um ano ou um mês. Altere o fuso horário, se necessário, escolhendo o fuso horário correto na lista no canto superior direito. 1. Na página **Event details (Detalhes do evento)**, escolha **Delete (Excluir)**. Quando for solicitado, confirme que você deseja excluir o evento, escolhendo **Confirm** (Confirmar). # Importar e gerenciar eventos de calendários de terceiros Como alternativa à criação de eventos diretamente no console do AWS Systems Manager, você pode importar um iCalendar (`.ics`) de uma aplicação de calendário de terceiros compatível. Seu calendário pode incluir eventos importados e eventos que você cria no Change Calendar, uma ferramenta do AWS Systems Manager. **Antes de começar** Antes de tentar importar um arquivo de calendário, revise os seguintes requisitos e restrições: Formato de arquivo do calendário Somente arquivos iCalendar válidos (`.ics`) são compatíveis. Fornecedores de calendário compatíveis Somente os arquivos `.ics` exportados dos provedores de calendário de terceiros a seguir são compatíveis. + Calendário do Google ([Instruções de exportação](https://support.google.com/calendar/answer/37111)) + Microsoft Outlook ([Instruções de exportação](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6)) + Calendário do iCloud ([Instruções de exportação](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac)) Tamanho do arquivo Você pode importar qualquer número de arquivos `.ics` válidos. No entanto, o tamanho total de todos os arquivos importados para cada calendário não pode exceder 64 KB. Para minimizar o tamanho do arquivo `.ics`, verifique se você está exportando somente detalhes básicos sobre suas entradas do calendário. Se necessário, reduza a duração do período de exportação. Fuso horário Além de um nome de calendário, um provedor de calendário e pelo menos um evento, o arquivo `.ics` exportado também deve indicar o fuso horário do calendário. Se isso não acontecer, ou se houver um problema ao identificar o fuso horário, você será solicitado a especificar um depois de importar o arquivo. Limitação de eventos recorrentes O arquivo exportado `.ics` pode incluir eventos recorrentes. No entanto, se uma ou mais ocorrências de um evento recorrente tiverem sido excluídas no calendário de origem, a importação falhará. **Topics** + [Importar eventos de provedores de calendário de terceiros](change-calendar-import.md) + [Atualizar todos os eventos de um provedor de calendário de terceiros](change-calendar-import-add-remove.md) + [Excluir todos os eventos importados de um calendário de terceiros](change-calendar-delete-ics.md) # Importar eventos de provedores de calendário de terceiros Use o procedimento a seguir para importar um iCalendar (`.ics`) de uma aplicação de calendário de terceiros compatível. Os eventos contidos no arquivo são incorporados às regras do seu calendário aberto ou fechado. Você pode importar um arquivo para um novo calendário que está criando com o Change Calendar (uma ferramenta do AWS Systems Manager) ou para um calendário existente. Depois de importar o arquivo `.ics`, você poderá remover eventos individuais dele usando a interface Change Calendar. Para mais informações, consulte [Excluir um evento do Change Calendar](change-calendar-delete-event.md). Você também pode excluir todos os eventos do calendário de origem excluindo o arquivo `.ics`. Para mais informações, consulte [Excluir todos os eventos importados de um calendário de terceiros](change-calendar-delete-ics.md). **Para importar eventos de provedores de calendário de terceiros** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Para começar com um novo calendário, escolha **Create calendar** (Criar calendário). Na área **Import calendar** (Importar calendário), selecione **Choose file** (Escolher arquivo). Para obter informações sobre outras etapas para criar um novo calendário, consulte [Criar um calendário de alterações](change-calendar-create.md). - ou - Para importar eventos de terceiros para um calendário existente, escolha o nome de um calendário existente para abri-lo. 1. Selecione **Actions, Edit** (Ações, Editar), e depois, na área **Import calendar** (Importar calendário), escolha **Choose file** (Escolher arquivo). 1. Acesse e selecione o arquivo `.ics` exportado em seu computador local. 1. Caso solicitado, para **Select a time zone** (Selecione um fuso horário), selecione o fuso horário que se aplica ao calendário. 1. Escolha **Salvar**. # Atualizar todos os eventos de um provedor de calendário de terceiros Se vários eventos forem adicionados ou removidos do calendário de origem depois de importar o arquivo `.ics` do iCalendar, você poderá refletir essas alterações no Change Calendar. Primeiro, exporte novamente o calendário de origem e, em seguida, importe o novo arquivo para o Change Calendar, que é uma ferramenta do AWS Systems Manager. Os eventos no calendário de alterações serão atualizados para refletir o conteúdo do arquivo mais recente. **Para atualizar todos os eventos de um provedor de calendário de terceiros** 1. No calendário de terceiros, adicione ou remova eventos conforme você deseja que eles sejam refletidos no Change Calendar e, em seguida, reexporte o calendário para um novo arquivo `.ics`. 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Na lista de calendários, escolha o nome do calendário na lista. 1. Selecione **Escolher arquivo** e, em seguida, acesse e selecione o arquivo `.ics` de substituição. 1. Em resposta à notificação sobre a substituição do arquivo existente, escolha**Confirm** (Confirme). # Excluir todos os eventos importados de um calendário de terceiros Se você não quiser mais nenhum dos eventos importados de um provedor de terceiros incluído no calendário, exclua o arquivo `.ics` importado do iCalendar. **Para excluir todos os eventos importados de um calendário de terceiros** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Na lista de calendários, escolha o nome do calendário na lista. 1. Na área **Import calendar** (Importar calendário), em **My imported calendars** (Meus calendários importados), localize o nome do calendário importado e marque **X** no cartão dele. 1. Escolha **Salvar**. # Atualizar um calendário de alterações Você pode atualizar a descrição de um calendário de alterações, mas não o nome dele. Embora seja possível alterar o estado padrão de uma entrada de calendário, esteja ciente de que isso reverte o comportamento das ações de alteração durante eventos associados à entrada do calendário. Por exemplo, se você alterar o estado de um calendário de **Open by default** (Aberto por padrão) para **Closed by default**(Fechado por padrão), as alterações indesejadas poderão ser feitas durante períodos do evento em que os usuários que criaram os eventos associados não estiverem esperando alterações. Ao atualizar um calendário de alterações, você está editando o documento do Change Calendar criado quando você criou a entrada. O Change Calendar é uma ferramenta do AWS Systems Manager. **Para atualizar um calendário de alterações** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Na lista de calendários, escolha o nome do calendário que você deseja atualizar. 1. Na página de detalhes do calendário, escolha **Actions, Edit** (Ações, Editar). 1. Em **Description (Descrição)**, é possível alterar o texto da descrição. Não é possível editar o nome de um calendário de alteração. 1. Para alterar o estado do calendário, em **Calendar type (Tipo de calendário)**, escolha um valor diferente. Observe que isso reverte o comportamento das ações de alteração durante eventos associados ao calendário. Antes de alterar o tipo do calendário, verifique com outros usuários do Change Calendar se a alteração do tipo do calendário não permite alterações indesejadas durante os eventos criados. + **Open by default (Aberto por padrão)**: o calendário é aberto (as ações do Automation podem ser executadas até que um evento seja iniciado) e fechado logo depois pela duração de um evento associado. + **Closed by default** (Fechado por padrão) - o calendário está fechado (as ações do Automation não podem ser executadas até que um evento seja iniciado), mas é aberto durante um evento associado. 1. Escolha **Salvar**. Sua entrada do calendário não pode prevenir ou permitir ações até que você adicione pelo menos um evento. Para obter informações sobre como adicionar um evento, consulte [Criar um evento do Change Calendar](change-calendar-create-event.md). # Compartilhar um calendário de alterações Você pode compartilhar um calendário no Change Calendar, uma ferramenta do AWS Systems Manager, com outras Contas da AWS usando o console do AWS Systems Manager. Ao compartilhar um calendário, o calendário é somente leitura para usuários na conta compartilhada. Janelas de manutenção, associações do State Manager e automações não são compartilhadas. **Para compartilhar um calendário de alterações** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Na lista de calendários, escolha o nome do calendário que você deseja compartilhar. 1. Na página de detalhes do calendário, escolha a guia **Sharing** (Compartilhamento). 1. Escolha **Actions, Share** (Ações, Compartilhar). 1. Em **Share calendar** (Compartilhar calendário), para **Account ID** (ID da conta), insira o número de ID de uma Conta da AWS válida e escolha **Share** (Compartilhar). Os usuários da conta compartilhada podem ler o calendário de alterações, mas não podem fazer alterações. # Excluir um calendário de alterações Você pode excluir um calendário no Change Calendar, uma ferramenta do AWS Systems Manager, usando o console do Systems Manager ou a AWS Command Line Interface (AWS CLI). A exclusão de um calendário de alterações exclui todos os eventos associados. **Para excluir um calendário de alterações** 1. Abra o console AWS Systems Manager em [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/). 1. No painel de navegação, escolha **Change Calendar**. 1. Na lista de calendários, escolha o nome do calendário que você deseja excluir. 1. Na página de detalhes do calendário, escolha **Actions, Delete** (Ações, Excluir). Quando for solicitado, confirme que você deseja excluir a entrada do calendário escolhendo **Delete** (Excluir). # Obter o estado de um calendário de alterações Você pode obter o estado geral de um calendário ou o estado de um calendário em um horário específico no Change Calendar, uma ferramenta do AWS Systems Manager. Também é possível mostrar a próxima vez em que o estado do calendário muda de `OPEN` para `CLOSED` ou vice-versa. **nota** Para obter informações sobre a integração do Change Calendar com o Amazon EventBridge para monitoramento automatizado das mudanças de estado do calendário, consulte [Integração do Change Calendar com o Amazon EventBridge](monitoring-systems-manager-event-examples.md#change-calendar-eventbridge-integration). A integração com o EventBridge fornece notificações orientadas por eventos quando os estados do calendário fazem a transição, complementando a abordagem baseada em polling da ação da API `GetCalendarState`. Você só pode fazer essa tarefa usando a API `GetCalendarState`. O procedimento nesta seção usa a AWS Command Line Interface (AWS CLI). **Para obter o estado de um calendário de alterações** + Execute o seguinte comando para mostrar o estado de um ou mais calendários em um horário específico. O parâmetro `--calendar-names` é obrigatório, mas `--at-time` é opcional. Substitua cada *espaço reservado para recurso de exemplo* por suas próprias informações. ------ #### [ 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" ``` Veja um exemplo a seguir. ``` 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" ``` Veja um exemplo a seguir. ``` 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" ``` ------ O comando retorna informações como as seguintes. ``` { "State": "OPEN", "AtTime": "2020-07-30T16:18:18Z", "NextTransitionTime": "2020-07-31T00:00:00Z" } ``` Os resultados mostram o estado do calendário (se o calendário é do tipo `DEFAULT_OPEN` ou `DEFAULT_CLOSED`) para as entradas de calendário especificadas que são propriedade ou compartilhadas com sua conta, na hora especificada como o valor `--at-time` e a hora da próxima transição. Se você não adicionar o parâmetro `--at-time`, a hora atual será usada. **nota** Se você especificar mais de um calendário em uma solicitação, o comando retornará o status `OPEN` somente se todos os calendários na solicitação estiverem abertos. Se um ou mais calendários na solicitação forem fechados, o status retornado será `CLOSED`. # Adicionar dependências do Change Calendar para runbooks do Automation Para garantir que as ações do Automation sigam o Change Calendar, uma ferramenta do AWS Systems Manager, adicione uma etapa em um runbook do Automation que use a ação [`aws:assertAwsResourceProperty`](automation-action-assertAwsResourceProperty.md). Configure a ação para executar `GetCalendarState` a fim de verificar se uma entrada de calendário especificada está no estado desejado (`OPEN` ou `CLOSED`). O runbook do Automation só poderá passar para a próxima etapa se o estado do calendário for `OPEN`. Veja a seguir um trecho de exemplo baseado em YAML de um runbook do Automation que não pode prosseguir para a próxima etapa, `LaunchInstance`, a menos que o estado do calendário corresponda a `OPEN`, o estado especificado em `DesiredValues`. Veja um exemplo a seguir. ``` 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 ... ``` # Solução de problemas do Change Calendar Use as informações a seguir para obter ajuda para solucionar problemas com o Change Calendar, uma ferramenta do AWS Systems Manager. **Topics** + [Erro 'Falha na importação do calendário'](#change-manager-troubleshooting-1) ## Erro 'Falha na importação do calendário' **Problema**: ao importar um arquivo do iCalendar (`.ics`), o sistema informa que a importação do calendário falhou. + **Solução 1**: verifique se você está importando um arquivo que foi exportado de um provedor de calendário de terceiros compatível, que inclua o seguinte: + Calendário do Google ([Instruções de exportação](https://support.google.com/calendar/answer/37111)) + Microsoft Outlook ([Instruções de exportação](https://support.microsoft.com/en-us/office/export-an-outlook-calendar-to-google-calendar-662fa3bb-0794-4b18-add8-9968b665f4e6)) + Calendário do iCloud ([Instruções de exportação](https://support.apple.com/guide/calendar/import-or-export-calendars-icl1023/mac)) + **Solução 2**: se o calendário de origem incluir eventos recorrentes, verifique se nenhuma ocorrência individual do evento foi cancelada ou excluída. No momento, o Change Calendar não suporta a importação de eventos recorrentes com cancelamentos individuais. Para resolver o problema, remova o evento recorrente do calendário de origem, exporte novamente o calendário, importe-o novamente para o Change Calendar e, em seguida, adicione o evento recorrente usando a interface do Change Calendar. Para mais informações, consulte [Criar um evento do Change Calendar](change-calendar-create-event.md). + **Solução 3**: verifique se o calendário de origem contém pelo menos um evento. Os carregamentos de arquivos `.ics` que não contêm eventos não têm êxito. + **Solução 4**: se o sistema relatar que a importação falhou porque a propriedade `.ics` é muito grande, verifique se você está exportando somente os detalhes básicos sobre suas entradas de calendário. Se necessário, reduza a duração do período de exportação. + **Solução 5**: se o Change Calendar não conseguir determinar o fuso horário do calendário exportado quando você tenta importá-lo da guia **Events** (Eventos), você poderá receber esta mensagem: “Falha na importação do calendário. O Change Calendar não localizou um fuso horário válido’’. Você pode importar o calendário do menu Edit (Editar). Nesse caso, escolha **Actions, Edit** (Ações, Editar) e, em seguida, tente importar o arquivo da página **Edit calendar** (Editar calendário). + **Solução 6**: não edite o arquivo `.ics` antes da importação. A tentativa de modificar o conteúdo do arquivo pode corromper os dados do calendário. Se você modificou o arquivo antes de tentar a importação, exporte o calendário do calendário de origem novamente e tente fazer o upload novamente.