• 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). # Walkthrough: Automatically update SSM Agent with the AWS CLI O procedimento a seguir demonstra o processo de criação de uma associação do State Manager usando a AWS Command Line Interface. A associação atualiza automaticamente o SSM Agent de acordo com uma programação que você especifica. Para obter mais informações sobre o SSM Agent, consulte [Trabalhar com o SSM Agent](ssm-agent.md). Para personalizar o agendamento de atualização do SSM Agent usando o console, consulte [Atualizar automaticamente o SSM Agent](ssm-agent-automatic-updates.md#ssm-agent-automatic-updates-console). Para receber notificações sobre atualizações do SSM Agent, inscreva-se na página [Notas de versão do SSM Agent](https://github.com/aws/amazon-ssm-agent/blob/master/RELEASENOTES.md) no GitHub. **Antes de começar** Antes de concluir o procedimento a seguir, verifique se você tem pelo menos uma instância do Amazon Elastic Compute Cloud (Amazon EC2) para o Linux, macOS ou Windows Server em execução configurada para o Systems Manager. Para obter mais informações, consulte [Configurar nós gerenciados para o AWS Systems Manager](systems-manager-setting-up-nodes.md). Se você criar uma associação usando a AWS CLI ou o AWS Tools for Windows PowerShell, use o parâmetro `--Targets` para as instâncias de destino, conforme mostrado no exemplo a seguir. Não use o parâmetro `--InstanceID`. O parâmetro `--InstanceID` é um parâmetro legado. **Para criar uma associação para atualizar automaticamente o SSM Agent** 1. Instale e configure a AWS Command Line Interface (AWS CLI), caso ainda não o tenha feito. Para obter informações, consulte [Instalar ou atualizar a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html). 1. Execute o comando a seguir para criar uma associação com instâncias como destinos com etiquetas do Amazon Elastic Compute Cloud (Amazon EC2). Substitua cada {{espaço reservado para recurso de exemplo}} por suas próprias informações. O parâmetro `Schedule` define um agendamento para executar a associação todos os domingos de manhã às 2h. (UTC). State ManagerAs associações do , não comportam todas as expressões cron e de taxa. Para obter mais informações sobre como criar expressões cron e rate para associações, consulte [Referência: Expressões cron e rate para o Systems Manager](reference-cron-and-rate-expressions.md). ------ #### [ Linux & macOS ] ``` aws ssm create-association \ --targets Key=tag:{{tag_key}},Values={{tag_value}} \ --name AWS-UpdateSSMAgent \ --schedule-expression "cron(0 2 ? * SUN *)" ``` ------ #### [ Windows ] ``` aws ssm create-association ^ --targets Key=tag:{{tag_key}},Values={{tag_value}} ^ --name AWS-UpdateSSMAgent ^ --schedule-expression "cron(0 2 ? * SUN *)" ``` ------ Se você quiser, também poderá especificar várias instâncias de destino indicando os IDs de instâncias em uma lista separada por vírgulas. ------ #### [ Linux & macOS ] ``` aws ssm create-association \ --targets Key=instanceids,Values={{instance_ID,instance_ID,instance_ID}} \ --name AWS-UpdateSSMAgent \ --schedule-expression "cron(0 2 ? * SUN *)" ``` ------ #### [ Windows ] ``` aws ssm create-association ^ --targets Key=instanceids,Values={{instance_ID,instance_ID,instance_ID}} ^ --name AWS-UpdateSSMAgent ^ --schedule-expression "cron(0 2 ? * SUN *)" ``` ------ Você pode especificar a versão do SSM Agent para a qual deseja atualizar. ------ #### [ Linux & macOS ] ``` aws ssm create-association \ --targets Key=instanceids,Values={{instance_ID,instance_ID,instance_ID}} \ --name AWS-UpdateSSMAgent \ --schedule-expression "cron(0 2 ? * SUN *)" \ --parameters version={{ssm_agent_version_number}} ``` ------ #### [ Windows ] ``` aws ssm create-association ^ --targets Key=instanceids,Values={{instance_ID,instance_ID,instance_ID}} ^ --name AWS-UpdateSSMAgent ^ --schedule-expression "cron(0 2 ? * SUN *)" ^ --parameters version={{ssm_agent_version_number}} ``` ------ O sistema retorna informações como estas. ``` { "AssociationDescription": { "ScheduleExpression": "cron(0 2 ? * SUN *)", "Name": "AWS-UpdateSSMAgent", "Overview": { "Status": "Pending", "DetailedStatus": "Creating" }, "AssociationId": "123..............", "DocumentVersion": "$DEFAULT", "LastUpdateAssociationDate": 1504034257.98, "Date": 1504034257.98, "AssociationVersion": "1", "Targets": [ { "Values": [ "{{TagValue}}" ], "Key": "tag:{{TagKey}}" } ] } } ``` O sistema tenta criar a associação na(s) instância(s) e aplicar imediatamente o estado. O status da associação mostra `Pending`. 1. Execute o comando a seguir para visualizar um status atualizado da associação que você acabou de criar. ``` aws ssm list-associations ``` Se suas instâncias *não* estiverem executando a versão mais recente do SSM Agent, o status mostrará `Failed`. Quando uma nova versão do SSM Agent é publicada, a associação instala automaticamente o novo agente e o status mostra `Success`.