Como adiciono parâmetros quando registro uma tarefa de Automação nas janelas de manutenção do Systems Manager?

Breve descrição

Ao registrar uma tarefa de Automação da janela de manutenção, você deve fornecer valores de parâmetros de entrada que passem para a tarefa quando a tarefa é executada. Os parâmetros de entrada necessários são os mesmos definidos no conteúdo do documento de Automação. Você pode usar valores de pseudoparâmetros nos campos de parâmetros de entrada necessários para referenciar dinamicamente os IDs de recursos direcionados pela janela de manutenção. Os pseudoparâmetros, como {{RESOURCE\ _ID}}, permitem segmentar vários recursos para que você não precise inserir individualmente cada ID de recurso.

Por exemplo, o documento AWS-StopEC2Instance fornecido pela Amazon exige que você insira o ID da instância como parâmetro. Use um pseudoparâmetro para que a janela de manutenção tenha como destino várias instâncias ou quando você não souber o ID da instância.

Observação: Para o tipo de destino INSTANCE, os pseudoparâmetros {{TARGET_ID}} e {{RESOURCE_ID}} fornecem somente o ID da instância. No entanto, para o tipo de destino RESOURCE_GROUP, {{TARGET_ID}} e {{RESOURCE_ID}} retornam o ID em formatos diferentes. Para obter mais informações e uma lista de pseudoparâmetros disponíveis, consulte Uso de pseudoparâmetros ao registrar tarefas da janela de manutenção.

Resolução

Você pode usar o console do Systems Manager ou a AWS Command Line Interface (AWS CLI) para registrar tarefas de Automação da janela de manutenção com pseudoparâmetros.

Use o console do Systems Manager

Conclua as seguintes etapas:

1. Abra o console do Systems Manager.
2. No painel de navegação, escolha Janelas de manutenção e selecione sua janela de manutenção.
3. Na página Tarefas, escolha Registrar tarefas e, em seguida, escolha Registrar tarefa de automação.
4. Na página da tarefa Automação do Registro, insira as seguintes informações:
   Em Documento de automação, selecione o documento que você deseja que a tarefa execute.
   Em Destinos, especifique suas informações de destino.
   Em Parâmetros de entrada, insira um valor de pseudoparâmetro. Por exemplo, insira TARGET_ID ou RESOURCE_ID para o parâmetro que exige um ID de recurso.
   Para Controle de tarifa, especifique suas informações de tarifa.
   Em perfil de serviço do IAM, selecione um perfil do AWS Identity and Access Management (AWS IAM).
5. Escolha Registrar tarefa de Automação.

Usar a AWS CLI

Observação: se você receber erros ao executar comandos da AWS CLI, consulte Solucionar erros da AWS CLI. Além disso, verifique se você está usando a versão mais recente da AWS CLI.

Execute o comando register-task-with-maintenance-window.

O comando de exemplo a seguir registra uma tarefa de automação que inclui o parâmetro {{RESOURCE_ID}}:

aws ssm register-task-with-maintenance-window --window-id mw-1234567890EXAMPLE --targets Key=WindowTargetIds,Values=6c226ea3-463a-4533-8a2d-EXAMPLE --task-arn AWS-StopEC2Instance --task-type AUTOMATION --name MyMaintenanceWindowTask --max-concurrency 10 --max-errors 5 --task-invocation-parameters={\"Automation\":{\"Parameters\":{\"InstanceId\":[\"{{RESOURCE_ID}}\"]}}} --service-role-arn YOUR_SERVICE_ROLE_ARN

Quando a tarefa da janela de manutenção é executada, a ID de Recurso para cada destino passa para o sistema. No exemplo anterior, o parâmetro InstanceId recebe o ID da instância para cada destino no grupo de destino.

Informações relacionadas

Pseudoparâmetros com suporte

Opções de parâmetros para o comando register-task-with-maintenance-windows