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:
-
CodePipeline
-
Chamada de
CreateSnapshot
API do Amazon EBS -
EC2 Image Builder
-
Chamada de API
RebootInstances
do EC2 -
Chamada de API
StopInstances
do EC2 -
Chamada de API
TerminateInstances
do EC2 -
Fluxo de entrega do Firehose
-
Fluxo de trabalho do Glue
-
Modelo de avaliação do Inspector
-
Fluxo do Kinesis
-
Função Lambda (ASYNC)
-
Consultas da API de dados de cluster do Redshift
-
SageMakerGasoduto
-
Tópico do SNS
-
Fila do SQS
-
Máquina de estados do Step Functions (ASYNC)
-
Automação do Systems Manager
-
Systems Manager OpsItem
-
Run Command do Systems Manager
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
InputTransformer
objeto para garantir que os dados estejam estruturados corretamente. Se você quiser incluir a carga útil do evento original, referencie-a noInputTransformer
.) -
API Gateway (Os dados enviados para o API Gateway devem corresponder à estrutura da API. Você deve usar o
InputTransformer
objeto para garantir que os dados estejam estruturados corretamente. Se você quiser incluir a carga útil do evento original, referencie-a noInputTransformer
.) -
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:
-
HttpParameters
(excetoHeaderParameters
chaves)
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.