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á.
# Objetivos de ônibus para eventos na Amazon EventBridge
Um *destino* é um recurso ou endpoint que EventBridge envia um [evento](eb-events.md) para quando o evento corresponde ao padrão de evento definido para uma [regra](eb-rules.md). **A regra processa os dados do [evento](eb-events.md) 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.
## Alvos de barramento de eventos disponíveis no EventBridge console
Você pode configurar os seguintes tipos de alvo para regras no EventBridge console:
+ Destinos de API
Os destinos de API são endpoints HTTP que você pode invocar como o destino de uma regra do barramento de eventos. Quando você especifica um destino de API como alvo de regra, EventBridge invoca o endpoint HTTPS para qualquer evento que corresponda ao padrão de evento especificado na regra e, em seguida, entrega as informações do evento com a solicitação. Para obter mais informações, consulte [Destinos de API](eb-api-destinations.md).
+ Barramentos de eventos
Você pode especificar outros barramentos de eventos como destinos para regras. Isso inclui ônibus de eventos na mesma conta ou em AWS contas diferentes.
+ [Barramentos de eventos entre contas como destinos](eb-cross-account.md)
+ [Barramentos de eventos na mesma conta como destinos](eb-bus-to-bus.md)
+ AWS serviços
Você pode EventBridge enviar eventos para vários recursos de AWS serviço. Isso inclui:
+ [API Gateway](eb-api-gateway-target.md)
+ [AWS AppSync](target-appsync.md)
+ [Fila de trabalhos em lote](#targets-specifics-batch)
+ [CloudWatch grupo de registros](#targets-specifics-cwl)
+ [CodeBuild project](#targets-specifics-codebuild)
+ CodePipeline
+ Chamada de API `CreateSnapshot` do Amazon EBS
+ EC2 Image Builder
+ Chamada de API `RebootInstances` do EC2
+ Chamada de API `StopInstances` do EC2
+ Chamada de API `TerminateInstances` do EC2
+ [Tarefa do ECS](#targets-specifics-ecs-task)
+ Fluxo de entrega do Firehose
+ Fluxo de trabalho do Glue
+ [Plano de resposta do Incident Manager](https://docs.aws.amazon.com//incident-manager/latest/userguide/incident-creation.html#incident-tracking-auto-eventbridge)
+ Modelo de avaliação do Inspector
+ Fluxo do Kinesis
+ Função do Lambda (ASYNC)
+ [Consultas de API de dados do cluster do Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api-calling-event-bridge.html)
+ [Consultas de API de dados de grupos de trabalho do Amazon Redshift sem servidor](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api-calling-event-bridge.html)
+ SageMaker Pipeline de IA
+ Tópico do Amazon SNS
+ [Filas padrão, justas e FIFO do Amazon SQS](#targets-specifics-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](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html) para determinar o que acontece com esse alvo. Incluindo o seguinte:
+ Destinos de API
Os dados enviados para um destino da API devem corresponder à estrutura da API. Use o objeto [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html) para garantir que os dados estejam estruturados corretamente. Se você quiser incluir a carga útil original do evento, referencie-a no [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html).
+ API Gateway
Os dados enviados para o gateway da API devem corresponder à estrutura da API. Use o objeto [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html) para garantir que os dados estejam estruturados corretamente. Se você quiser incluir a carga útil original do evento, referencie-a no [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html).
+ Amazon EC2 Image Builder
+ Clusters da API de dados do Amazon Redshift
Use [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html).
+ Pipelines de construção do Amazon SageMaker Runtime Model
Use [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html).
+ Amazon SQS fair e filas FIFO
Use [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html) para especificar o grupo de mensagens a ser usado como o destino.
+ Run Command do Systems Manager
Use [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html)para especificar o documento SSM e as instâncias de destino. Para obter mais informações, consulte [Systems Manager Run Command as a target](#targets-specifics-ssm-run-command).
**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 (\*)
barras dianteiras
### Parâmetros dinâmicos do caminho
Os parâmetros de caminho dinâmico permitem que você use a sintaxe de caminho JSON para referenciar dados de eventos em tempo de execução em vez de valores estáticos.
Você pode usar a sintaxe de caminho JSON dinâmico com parâmetros de destino para especificar caminhos JSON em vez de valores estáticos (por exemplo,). `$.detail.state`
#### Requisitos
O valor inteiro deve ser um caminho JSON, não apenas parte dele. Por exemplo:
+ ✓ Correto: `RedshiftParameters.Sql` pode ser `$.detail.state`
+ ✗ Incorreto: `RedshiftParameters.Sql` não pode ser `"SELECT * FROM $.detail.state"`
EventBridge substitui esses caminhos em tempo de execução por dados da carga útil do evento no caminho especificado.
#### Limitações
Os parâmetros do caminho dinâmico não podem referenciar valores novos ou transformados da transformação de entrada. A sintaxe do caminho JSON é igual à sintaxe de transformação de entrada. Para obter mais informações, consulte [Transformação EventBridge de entradas da Amazon](eb-transform-target-input.md).
#### Parâmetros compatíveis
Você pode usar a sintaxe dinâmica em todos os campos de string, não enumerados, desses parâmetros:
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_EcsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_EcsParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_HttpParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_HttpParameters.html) (exceto chaves `HeaderParameters`)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html)
## Permissões
Para fazer chamadas de API nos recursos que você possui, EventBridge precisa de permissões apropriadas. Especifique uma função de execução [do IAM usando o EventBridge console](eb-create-rule-wizard.md#eb-create-rule-target) ou definindo o `RoleARN` parâmetro em [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html).
Por exemplo, a seguinte política define a permissão para enviar mensagens a uma fila do Amazon SQS:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Action": [
"sqs:SendMessage"
],
"Resource": [
"arn:aws:sqs:{{us-east-1}}:{{111122223333}}:{{sqs-queue-name}}"
]
}
]
}
```
------
E a seguinte política de confiança EventBridge permite assumir a função:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "events.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
É 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](eb-iam.md).
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 [Enviar e receber eventos entre AWS contas na Amazon EventBridge](eb-cross-account.md).
Se seu destino, como uma fila do Amazon SQS, usa criptografia AWS Key Management Service (AWS KMS), você deve incluir a seguinte seção 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": "*"
}
```
## AWS Batch filas de trabalhos como alvos
Certos parâmetros AWS Batch `submitJob` podem ser configurados via [BatchParameters](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_BatchParameters.html).
Outros podem ser especificados na carga útil do evento. Se a carga útil do evento (transmitida ou via [InputTransformers](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)) contiver as seguintes chaves, elas serão mapeadas para os parâmetros de `submitJob` [solicitação](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html#API_SubmitJob_RequestSyntax):
+ `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 [InputTransformer](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)com 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":,"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
EventBridge suporta compilações padrão e em lote como destinos.
Se você usar um [transformador de entrada](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html) para moldar o evento de origem para corresponder à [StartBuildRequest](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html#API_StartBuild_RequestSyntax)estrutura antes de ser entregue a um CodeBuild alvo, os parâmetros serão mapeados de 1 a 1 e transmitidos por padrão. `codeBuild.StartBuild`
Para passar os parâmetros para, `codeBuild.StartBuildBatch` em vez disso, transforme o evento de origem para corresponder à [StartBuildBatchRequest](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_RequestSyntax)estrutura e adicione o seguinte key/value par à raiz do evento transformado:
`"buildType": "BATCH"`
## Tarefas do Amazon ECS como destinos
Se você usar [InputTransformers](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)para moldar o evento de entrada para um Target de acordo com a RunTask [TaskOverride](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TaskOverride.html)estrutura 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.
## Systems Manager Run Command como alvo
Quando você especifica o Systems Manager Run Command como destino, EventBridge chama a [https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html](https://docs.aws.amazon.com/systems-manager/latest/APIReference/API_SendCommand.html)API em seu nome. Configure o destino usando [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html), que especifica o documento SSM a ser executado e as instâncias ou tags de destino.
`RunCommandParameters`contém os seguintes campos:
+ `RunCommandTargets`— (Obrigatório) Uma lista de pares de valores-chave que especificam as instâncias de destino. Use `Key` set to `InstanceIds` com uma lista de instâncias IDs ou `Key` set to `tag:{{tag-name}}` com valores de tag para segmentar instâncias por tag. Você pode especificar entre 1 e 5 destinos de comando de execução.
Para especificar qual documento SSM executar e passar parâmetros para ele, use o `Input` campo no [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html)objeto. O `Input` valor deve ser um objeto JSON com a seguinte estrutura:
```
{
"DocumentName": "{{document-name}}",
"DocumentVersion": "{{version}}",
"Parameters": {
"{{parameter-key}}": ["{{parameter-value}}"]
}
}
```
Em que:
+ `DocumentName`— O nome ou ARN do documento SSM a ser executado.
+ `DocumentVersion`— (Opcional) A versão do documento. Se for omitida, a versão padrão será usada.
+ `Parameters`— (Opcional) Um mapa de nomes de parâmetros para matrizes de valores, correspondendo aos parâmetros definidos no documento SSM.
Por exemplo, o AWS CLI comando a seguir cria uma regra que executa o `AWS-RunShellScript` documento em uma instância específica quando um EventBridge evento coincide:
```
aws events put-targets --rule "my-rule" --targets '[{
"Id": "ssm-target-1",
"Arn": "arn:aws:ssm:{{region}}:{{account-id}}:document/AWS-RunShellScript",
"RoleArn": "arn:aws:iam::{{account-id}}:role/{{EventBridgeSSMRole}}",
"Input": "{\\"Parameters\\":{\\"commands\\":[\\"echo Hello from EventBridge\\"]}}",
"RunCommandParameters": {
"RunCommandTargets": [{
"Key": "InstanceIds",
"Values": ["{{i-0123456789abcdef0}}"]
}]
}
}]'
```
**nota**
O `Input` campo no `Target` objeto é usado para passar o nome e os parâmetros do documento para o Systems Manager Run Command. Isso é diferente do [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html), que transforma a carga útil do evento. Ao usar o Systems Manager Run Command como destino, defina os parâmetros do documento `Input` e especifique as instâncias de destino em`RunCommandParameters`.
## Filas do Amazon SQS como destinos
EventBridge não suporta o uso de filas do Amazon SQS que são criptografadas com um. Chave pertencente à AWS Isso inclui destinos, bem como filas do Amazon SQS especificadas como filas de mensagens não entregues. Para obter mais informações sobre Chaves pertencentes à AWS, consulte [chaves AWS próprias](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) no *Guia do AWS Key Management Service desenvolvedor*.