EventBridgeAlvos da Amazon - Amazon EventBridge

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á.

EventBridgeAlvos da Amazon

Um destino é um recurso ou endpoint que EventBridge envia um evento para quando o evento corresponde ao padrão de evento definido para uma regra. A regra processa os dados do evento e envia as informações pertinentes ao alvo. Para entregar dados de eventos a um alvo, EventBridge precisa de permissão para acessar o recurso de destino. É possível definir até cinco metas para cada regra.

Quando destinos novos são adicionados a uma regra e essa regra é executada logo em seguida, qualquer destino novo ou atualizado pode não ser chamado imediatamente. Permita um curto período para que as alterações entrem em vigor.

O vídeo a seguir aborda os conceitos básicos das metas:

Alvos disponíveis no EventBridge console

Você pode configurar os seguintes destinos para eventos no EventBridge console:

Parâmetros alvo

Alguns destinos não enviam as informações da carga do evento para o destino. Em vez disso, tratam o evento como um gatilho para invocar uma API específica. EventBridgeusa os parâmetros do Target para determinar o que acontece com esse alvo. Incluindo o seguinte:

  • Destinos da API (Os dados enviados para um destino de API devem corresponder à estrutura da API. Você deve usar o InputTransformerobjeto para garantir que os dados estejam estruturados corretamente. Se você quiser incluir a carga útil do evento original, referencie-a no InputTransformer.)

  • API Gateway (Os dados enviados para o API Gateway devem corresponder à estrutura da API. Você deve usar o InputTransformerobjeto para garantir que os dados estejam estruturados corretamente. Se você quiser incluir a carga útil do evento original, referencie-a no InputTransformer.)

  • Amazon EC2 Image Builder

  • RedshiftDataParameters(Clusters da API de dados do Amazon Redshift)

  • SageMakerPipelineParameters(Pipelines de construção de SageMaker modelos da Amazon)

nota

EventBridgenão suporta toda a sintaxe do JSON Path e a avalia em tempo de execução. A sintaxe suportada inclui:

  • notação de pontos (por exemplo,$.detail)

  • traços

  • sublinha

  • caracteres alfanuméricos

  • índices de matriz

  • curingas (*)

Parâmetros do caminho dinâmico

Alguns parâmetros de destino oferecem suporte à sintaxe de caminho JSON dinâmico opcional. Essa sintaxe permite que você especifique caminhos JSON em vez de valores estáticos (por exemplo$.detail.state). O valor inteiro precisa ser um caminho JSON, não apenas parte dele. Por exemplo, RedshiftParameters.Sql pode ser$.detail.state, mas não pode ser"SELECT * FROM $.detail.state". Esses caminhos são substituídos dinamicamente em tempo de execução por dados da própria carga do evento no caminho especificado. Os parâmetros do caminho dinâmico não podem referenciar valores novos ou transformados resultantes da transformação de entrada. A sintaxe suportada para caminhos JSON de parâmetros dinâmicos é a mesma da transformação da entrada. Para ter mais informações, consulte Transformação EventBridge de insumos da Amazon.

A sintaxe dinâmica pode ser usada em todos os campos de string, não enumerados, desses parâmetros:

Permissões

Para fazer chamadas de API nos seus próprios recursos, EventBridge precisa da permissão apropriada. Para recursos do AWS Lambda e do Amazon SNS, EventBridge usa políticas baseadas em recurso. Para instâncias do EC2, fluxos de dados do Kinesis e máquinas de estado do Step Functions, EventBridge usa funções do IAM que você especifica no RoleARN parâmetro em. PutTargets Você pode invocar um endpoint do API Gateway com autorização configurada do IAM, mas a função é opcional se você não tiver configurado a autorização. Para obter mais informações, consulte AmazonEventBridge eAWS Identity and Access Management.

Se outra conta da estiver na mesma região e tiver concedido permissão para você, será possível enviar eventos para essa conta. Para obter mais informações, consulte Enviar e receber EventBridge eventos da Amazon entre AWS contas.

Se seu destino estiver criptografado, você deverá incluir a seção a seguir em sua política de chaves do KMS.

{ "Sid": "Allow EventBridge to use the key", "Effect": "Allow", "Principal": { "Service": "events.amazonaws.com" }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "*" }

EventBridgeespecificidades do alvo

AWS Batchfilas de trabalhos

Alguns parâmetros AWS Batch submitJob podem ser configurados por meio de BatchParameters.

Outros podem ser especificados na carga do evento. Se a carga útil do evento (transmitida ou via InputTransformers) contiver as seguintes chaves, elas serão mapeadas para os parâmetros da submitJob solicitação:

  • ContainerOverrides: containerOverrides

    nota

    Isso inclui somente comando, ambiente, memória e vcpus

  • DependsOn: dependsOn

    nota

    Isso inclui apenas jobId

  • Parameters: parameters

CloudWatchGrupo de registros

Se você não usar um InputTransformercom um destino de CloudWatch Logs, a carga do evento será usada como a mensagem de registro e a origem do evento como o carimbo de data/hora. Se você usar umInputTransformer, o modelo deverá ser:

{"timestamp":<timestamp>,"message":<message>}

Projeto CodeBuild

Se você usar InputTransformerspara moldar o evento de entrada em um Target para corresponder à CodeBuild StartBuildRequestestrutura, os parâmetros serão mapeados de 1 para 1 e passados para. codeBuild.StartBuild

Tarefa do Amazon ECS

Se você usar InputTransformerspara moldar o evento de entrada em um Target para corresponder à RunTask TaskOverrideestrutura do Amazon ECS, os parâmetros serão mapeados de 1 para 1 e passados para. ecs.RunTask

Plano de resposta do gerente de incidentes

Se o evento correspondente for proveniente de CloudWatch Alarmes, os detalhes da alteração do estado do alarme serão preenchidos nos detalhes do acionador da StartIncidentRequest chamada para o Gerenciador de Incidentes.