Transferência de dados para o Automation usando transformadores de entrada - AWS Systems Manager

Transferência de dados para o Automation usando transformadores de entrada

Este tutorial do AWS Systems Manager Automation mostra como usar o recurso transformador de entrada do Amazon EventBridge para extrair o instance-id de uma instância do Amazon Elastic Compute Cloud (Amazon EC2) de um evento de alteração de estado da instância. O Automation é um recurso do AWS Systems Manager. Usamos o transformador de entrada para passar esses dados ao destino do runbook do AWS-CreateImage, como o parâmetro de entrada do InstanceId. A regra será acionada quando qualquer instância for alterada para o estado stopped.

Para obter mais informações sobre como trabalhar com transformadores de entrada, consulte Tutorial: Use o transformador de entrada para personalizar o que o EventBridge passa para o destino do evento no Manual do usuário do Amazon EventBridge.

Antes de começar

Verifique se adicionou as permissões necessárias e a política de confiança para o EventBridge para a função de serviço do Systems Manager Automation. Para obter mais informações, consulte Visão geral do gerenciamento de permissões de acesso aos recursos do EventBridge no Manual do usuário do Amazon EventBridge.

Como usar transformadores de entrada com automação

  1. Abra o console do Amazon EventBridge em https://console.aws.amazon.com/events/.

  2. No painel de navegação, escolha Regras.

  3. Selecione Criar regra.

  4. Insira um nome e uma descrição para a regra.

    Uma regra não pode ter o mesmo nome que outra na mesma Região e barramento de eventos.

  5. Em Barramento de eventos, selecione o barramento de eventos que você deseja associar a essa regra. Se você quiser que essa regra responda a eventos correspondentes provenientes da sua Conta da AWS, selecione default (padrão). Quando um AWS service (Serviço da AWS) na sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.

  6. Em Rule type (Tipo de regra), selecione Rule with an event pattern (Regra com um padrão de evento).

  7. Escolha Next (Próximo).

  8. Em Event source (Origem do evento), selecione Eventos da AWS ou eventos de parceiro do EventBridge.

  9. Na seção Event patter (Padrão de evento), selecione Event pattern form (Formulário de padrão de evento).

  10. Em Event source (Origem do evento), escolha AWS services (Serviços da ).

  11. Em Serviço da AWS, escolha EC2.

  12. Para Event Type (Tipo de evento), escolha EC2 Instance State-change Notification (Notificação de alteração de estado da instância do EC2).

  13. Para Specific state(s) (Estados específicos), escolha stopped (parado).

  14. Escolha Next (Avançar).

  15. Em Tipos de destino, escolha Serviço da AWS.

  16. Para Select a target (Selecionar um destino), escolha Systems Manager Automation (Automation do Systems Manager).

  17. Em Document (Documento), escolha AWS-CreateImage.

  18. Na seção Configure automation parameter(s) (Configurar parâmetros de automação), escolha Input Transformer (Transformador de entrada).

  19. Para Input path (Caminho de entrada), insira {"instance":"$.detail.instance-id"}.

  20. Para Template (Modelo), insira {"InstanceId":[<instance>]}.

  21. Para Execution role, escolha Use existing role (Usar função existente) e escolha sua função de serviço do Automation.

  22. Escolha Próximo.

  23. (Opcional) Insira uma ou mais tags para a regra. Para obter mais informações, consulte Marcar recursos do Amazon EventBridge no Guia do usuário do Amazon EventBridge.

  24. Escolha Próximo.

  25. Analise os detalhes da regra e selecione Criar regra.