Configurar notificações ou acionar ações com base nos eventos do Parameter Store - AWS Systems Manager

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Configurar notificações ou acionar ações com base nos eventos do Parameter Store

Os tópicos desta seção explicam como usar o Amazon EventBridge e o Amazon Simple Notification Service (Amazon SNS) para receber notificações sobre alterações nos parâmetros do Systems Manager Você pode criar uma EventBridge regra do para notificá-lo quando um parâmetro ou uma versão de rótulo de parâmetro é criada, atualizada ou excluída. Eventos são emitidos com base no melhor esforço. Você pode ser notificado sobre alterações ou status relacionados às políticas do parâmetro, como quando um parâmetro expirar, a data de expiração dele ou se ele não tiver sido alterado por um período especificado.

nota

Políticas de parâmetros estão disponíveis apenas para parâmetros que usam o nível avançado de parâmetros. Há cobranças aplicáveis. Para obter mais informações, consulte Atribuir políticas de parâmetros e Gerenciar camadas de parâmetros.

Os tópicos a seguir também explicam como acionar outras ações em um destino para eventos específicos do parâmetros. Por exemplo, você pode executar uma função AWS Lambda para recriar um parâmetro automaticamente quando ele expira ou é excluído. Você também pode configurar uma notificação para acionar uma função do Lambda quando a senha do seu banco de dados for atualizada. A função Lambda pode forçar a redefinição das conexões do seu banco de dados ou a reconexão com a nova senha. O EventBridge também oferece suporte à execução de comandos do Executar comando e a execuções de automações, bem como a ações em muitos outros serviços da AWS Para mais informações, consulte o Guia do usuário do Amazon EventBridge.

Antes de começar

Crie todos os recursos necessários para especificar a ação de destino para a regra que você criar. Por exemplo, se a regra criada tem como objetivo enviar uma notificação, primeiramente, crie um tópico do Amazon SNS Para obter mais informações, consulte Conceitos básicos do Amazon SNS no Guia do desenvolvedor do Amazon Simple Notification Service.

Configurar o EventBridge para parâmetros

Este tópico explica como criar uma EventBridge regra do que invoca um destino com base em eventos que ocorrem em um ou mais parâmetros em sua AWS conta da .

Como configurar o EventBridge para parâmetros do Systems Manager

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

  2. No painel de navegação, escolha Rules (Regras) e Create rule (Criar regra).

    -ou-

    Se a página Amazon EventBridge inicial do for aberta primeiro, escolha Create rule (Criar regra).

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

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

  4. Em Define pattern (Definir padrão), selecione Event pattern (Padrão de evento).

  5. Em Event matching pattern (Padrão de correspondência de eventos), escolha Custom pattern (Padrão personalizado).

  6. Em Event pattern (Padrão de evento), cole o seguinte conteúdo na caixa:

    { "source": [ "aws.ssm" ], "detail-type": [ "Parameter Store Change" ], "detail": { "name": [ "parameter-1-name", "/parameter-2-name/level-2", "/parameter-3-name/level-2/level-3" ], "operation": [ "Create", "Update", "Delete", "LabelParameterVersion" ] } }
  7. Modifique o conteúdo dos parâmetros e operações nos quais você deseja realizar uma ação.

    Por exemplo, o seguinte conteúdo significa que uma ação é executada quando qualquer um dos parâmetros denominado /Oncall e /Project/Teamlead é atualizado:

    { "source": [ "aws.ssm" ], "detail-type": [ "Parameter Store Change" ], "detail": { "name": [ "/Oncall", "/Project/Teamlead" ], "operation": [ "Update" ] } }
  8. Escolha Save (Salvar).

  9. Em Select event bus (Selecionar barramento de eventos), escolha o barramento de eventos que você deseja associar a essa regra. Se você quiser que essa regra seja acionada em eventos correspondentes provenientes de sua própria conta da AWS, selecione AWS default event bus (Barramento de eventos padrão da AWS). Quando um serviço da AWS em sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.

  10. Em Select targets (Selecionar destinos), escolha um tipo de destino e um recurso compatível. Por exemplo, se você escolher SNS topic (Tópico do SNS), faça uma seleção para Topic (Tópico). Se você escolher CodePipeline , faça uma seleção para Pipeline ARN (ARN do pipeline).

  11. Expanda Configure input (Configurar entrada) e escolha uma opção. Depois forneça quaisquer outros detalhes de configuração exigidos pelo tipo de destino que você selecionou.

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

  13. Escolha Criar.

Configurar o EventBridge para políticas de parâmetros

Este tópico explica como criar regras do EventBridge que invocam destinos com base em eventos que ocorrem em uma ou mais políticas de parâmetro na sua conta da AWS Ao criar um parâmetro avançado, você especifica quando um parâmetro expira, quando receber notificação antes de um parâmetro expirar e quanto tempo aguardar antes de enviar uma notificação informando que um parâmetro não foi alterado. Você configura uma notificação para esses eventos usando o procedimento a seguir. Para obter mais informações, consulte Atribuir políticas de parâmetros e Gerenciar camadas de parâmetros.

Como configurar o EventBridge para políticas de parâmetro do Systems Manager

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

  2. No painel de navegação, escolha Rules (Regras) e Create rule (Criar regra).

    -ou-

    Se a página Amazon EventBridge inicial do for aberta primeiro, escolha Create rule (Criar regra).

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

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

  4. Em Define pattern (Definir padrão), selecione Event pattern (Padrão de evento).

  5. Em Event matching pattern (Padrão de correspondência de eventos), escolha Custom pattern (Padrão personalizado).

  6. Em Event pattern (Padrão de evento), cole o seguinte conteúdo na caixa:

    { "source": [ "aws.ssm" ], "detail-type": [ "Parameter Store Policy Action" ], "detail": { "parameter-name": [ "parameter-1-name", "/parameter-2-name/level-2", "/parameter-3-name/level-2/level-3" ], "policy-type": [ "Expiration", "ExpirationNotification", "NoChangeNotification" ] } }
  7. Modifique o conteúdo dos parâmetros e tipos de política nos quais você deseja realizar uma ação. Por exemplo, no seguinte conteúdo uma ação é executada sempre que o parâmetro chamado /OncallDuties expira e é excluído:

    { "source": [ "aws.ssm" ], "detail-type": [ "Parameter Store Policy Action" ], "detail": { "parameter-name": [ "/OncallDuties" ], "policy-type": [ "Expiration" ] } }
  8. Escolha Save (Salvar).

  9. Em Select event bus (Selecionar barramento de eventos), escolha o barramento de eventos que você deseja associar a essa regra. Se você quiser que essa regra seja acionada em eventos correspondentes provenientes de sua própria conta da AWS, selecione AWS default event bus (Barramento de eventos padrão da AWS). Quando um serviço da AWS em sua conta emite um evento, ele sempre vai para o barramento de eventos padrão da sua conta.

  10. Em Select targets (Selecionar destinos), escolha um tipo de destino e um recurso compatível. Por exemplo, se você escolher SNS topic (Tópico do SNS), faça uma seleção para Topic (Tópico). Se você escolher CodePipeline , faça uma seleção para Pipeline ARN (ARN do pipeline).

  11. Expanda Configure input (Configurar entrada) e escolha uma opção. Depois forneça quaisquer outros detalhes de configuração exigidos pelo tipo de destino que você selecionou.

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

  13. Escolha Criar.

Informações relacionadas