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á.
Metas de ônibus para eventos na Amazon EventBridge
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 destino. Para entregar dados do evento a um alvo, EventBridge precisa de permissão para acessar o recurso de destino. É possível definir até cinco destinos para cada regra.
Quando destinos novos são adicionados a uma regra, e essa regra associada é executada logo em seguida, destinos novos ou atualizados podem não ser invocados imediatamente. Permita um curto período para que as alterações entrem em vigor.
O vídeo a seguir aborda os conceitos básicos dos destinos:
Alvos de barramento de eventos disponíveis no EventBridge console
Você pode configurar os seguintes alvos para eventos no EventBridge console:
-
CodePipeline
-
Chamada de API
CreateSnapshot
do Amazon EBS -
EC2 Image Builder
-
EC2
RebootInstances
Chamada de API -
EC2
StopInstances
Chamada de API -
EC2
TerminateInstances
Chamada de API -
Fluxo de entrega do Firehose
-
Fluxo de trabalho do Glue
-
Modelo de avaliação do Inspector
-
Fluxo do Kinesis
-
Função do Lambda (ASYNC)
-
Consultas de API de dados de grupos de trabalho do Amazon Redshift sem servidor
-
SageMaker Pipeline de IA
-
Tópico do Amazon SNS
EventBridge não oferece suporte aos tópicos FIFO (primeiro a entrar, primeiro a sair) do Amazon SNS.
-
Fila do Amazon SQS
-
Máquina de estado do Step Functions (ASYNC)
-
Automação do Systems Manager
-
Systems Manager OpsItem
-
Run Command do Systems Manager
Parâmetros de destino
Alguns destinos não enviam as informações da carga do evento para o destino. Em vez disso, eles tratam o evento como um gatilho para invocar uma API específica. EventBridge usa os parâmetros do Target para determinar o que acontece com esse alvo. Incluindo o seguinte:
-
Destinos da API (os dados enviados para o destino da API devem corresponder à estrutura da API. É preciso usar o objeto
InputTransformer
para garantir que os dados sejam estruturados corretamente. Se quiser incluir a carga original do evento, faça referência a ela noInputTransformer
.) -
API Gateway (os dados enviados para o API Gateway devem corresponder à estrutura da API. É preciso usar o objeto
InputTransformer
para garantir que os dados sejam estruturados corretamente. Se quiser incluir a carga original do evento, faça referência a ela noInputTransformer
.) -
Amazon EC2 Image Builder
-
RedshiftDataParameters
(Clusters da API de dados do Amazon Redshift) -
SageMakerPipelineParameters
(Amazon SageMaker Runtime Model Building Pipelines)
nota
EventBridge não suporta toda a sintaxe do JSON Path e a avalia em tempo de execução. A sintaxe compatível inclui:
notação de pontos (por exemplo,
$.detail
)traços
sublinhados
caracteres alfanuméricos
índices de matriz
curingas (*)
Parâmetros dinâmicos do caminho
Alguns parâmetros de destino são compatíveis com a sintaxe de caminho JSON dinâmico opcional. Esta sintaxe permite especificar 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"
. Estes caminhos são substituídos dinamicamente em runtime 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 compatível com 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:
-
HttpParameters
(exceto chavesHeaderParameters
)
Permissões
Para fazer chamadas de API nos recursos que você possui, é EventBridge necessária a permissão apropriada. Para recursos do Amazon SNS AWS Lambda e do Amazon, EventBridge usa políticas baseadas em recursos. Por exemplo EC2 , os streams de dados do Kinesis e as máquinas de estado do Step Functions EventBridge usam funções do IAM que você especifica no RoleARN
parâmetro em. PutTargets
É possível invocar um endpoint do API Gateway com autorização do IAM configurada, mas o perfil é opcional se você não tiver configurado a autorização. Para obter mais informações, consulte Amazon EventBridge e AWS Identity and Access Management.
Se outra conta 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 Envio e recebimento de eventos entre AWS contas na Amazon EventBridge.
Se seu destino estiver criptografado, deverá incluir a seção a seguir em sua política de chave do KMS.
{ "Sid": "Allow EventBridge to use the key", "Effect": "Allow", "Principal": { "Service": "events.amazonaws.com" }, "Action": [ "kms:Decrypt", "kms:GenerateDataKey" ], "Resource": "*" }
AWS Batch filas de trabalhos como alvos
Certos parâmetros AWS Batch submitJob
podem ser configurados via BatchParameters.
Outros podem ser especificados na carga útil do evento. Se a carga útil do evento (transmitida ou via InputTransformers) contiver as seguintes chaves, elas serão mapeadas para os parâmetros de submitJob
solicitação:
ContainerOverrides: containerOverrides
nota
Isto inclui somente comando, ambiente, memória e vcpus
DependsOn: dependsOn
nota
Isto inclui apenas jobId
Parameters: parameters
CloudWatch Registra grupos como alvos
Se você não usar um InputTransformercom um destino de CloudWatch registros, a carga útil do evento será usada como a mensagem de registro e a origem do evento como o carimbo de data/hora. Se você usar um InputTransformer, o modelo deverá ser:
{"timestamp":<timestamp>,"message":<message>}
EventBridge agrupa as entradas enviadas para um fluxo de log; portanto, EventBridge pode entregar um ou vários eventos a um stream de log, dependendo do tráfego.
CodeBuild projetos como alvos
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 transmitidos para. codeBuild.StartBuild
Tarefas do Amazon ECS como destinos
Se você usar InputTransformerspara moldar o evento de entrada para um Target de acordo com a RunTask TaskOverrideestrutura do Amazon ECS, os parâmetros serão mapeados de 1 para 1 e transmitidos para. ecs.RunTask
Planos de resposta do Incident Manager como destinos
Se o evento correspondente veio de CloudWatch Alarmes, os detalhes da alteração do estado do alarme serão preenchidos nos detalhes do gatilho da StartIncidentRequest chamada para o Incident Manager.