Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.
# Obiettivi degli Event Bus in Amazon EventBridge
Un *target* è una risorsa o un endpoint che EventBridge invia un [evento](eb-events.md) quando l'evento corrisponde al modello di evento definito per una [regola](eb-rules.md). **La regola elabora i dati dell'[evento](eb-events.md) e invia le informazioni pertinenti alla destinazione. Per inviare i dati degli eventi a una destinazione, è EventBridge necessaria l'autorizzazione per accedere alla risorsa di destinazione. Puoi definire fino a cinque destinazioni per ciascuna regola.
Quando si aggiungono destinazioni a una regola e la regola viene eseguita subito dopo, le destinazioni nuove o aggiornate potrebbero non essere richiamate immediatamente. È necessario un breve periodo di tempo affinché vengano applicate le modifiche.
## Target del bus degli eventi disponibili nella EventBridge console
È possibile configurare i seguenti tipi di oggetto per le regole nella EventBridge console:
+ Destinazioni API
Le destinazioni API sono endpoint HTTPS che è possibile richiamare come destinazione di una regola del bus degli eventi. Quando specificate una destinazione API come destinazione della regola, EventBridge richiama l'endpoint HTTPS per qualsiasi evento che corrisponde al modello di evento specificato nella regola, quindi fornisce le informazioni sull'evento con la richiesta. Per ulteriori informazioni, consulta [Destinazioni API](eb-api-destinations.md).
+ Bus per eventi
È possibile specificare altri bus di eventi come destinazioni per le regole. Ciò include i bus di eventi nello stesso account o in AWS account diversi.
+ [Bus di eventi tra più account come obiettivi](eb-cross-account.md)
+ [Gli stessi bus di eventi dell'account sono gli stessi obiettivi](eb-bus-to-bus.md)
+ AWS servizi
È possibile EventBridge inviare eventi a diverse risorse di AWS servizio. Ciò include:
+ [API Gateway](eb-api-gateway-target.md)
+ [AWS AppSync](target-appsync.md)
+ [Coda di processi batch](#targets-specifics-batch)
+ [CloudWatch gruppo di log](#targets-specifics-cwl)
+ [CodeBuild project](#targets-specifics-codebuild)
+ CodePipeline
+ Chiamata API `CreateSnapshot` di Amazon EBS
+ EC2 Image Builder
+ Chiamata API `RebootInstances` di EC2
+ Chiamata API `StopInstances` di EC2
+ Chiamata API `TerminateInstances` di EC2
+ [Attività ECS](#targets-specifics-ecs-task)
+ Flussi di distribuzione Firehose
+ Workflow di Glue
+ [Piano di risposta dello strumento di gestione degli incidenti](https://docs.aws.amazon.com//incident-manager/latest/userguide/incident-creation.html#incident-tracking-auto-eventbridge)
+ Modello di valutazione di Inspector
+ Flusso di Kinesis
+ Funzione Lambda (ASYNC)
+ [Query sull'API dati del cluster Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api-calling-event-bridge.html)
+ [Query sull'API dati del gruppo di lavoro Amazon Redshift serverless](https://docs.aws.amazon.com/redshift/latest/mgmt/data-api-calling-event-bridge.html)
+ SageMaker Pipeline AI
+ Argomento di Amazon SNS
+ [Code standard, fair e FIFO di Amazon SQS](#targets-specifics-sqs)
+ Macchine a stati di Step Functions (ASYNC)
+ Systems Manager Automation
+ Systems Manager OpsItem
+ Run Command di Systems Manager
## Parametri di destinazione
Alcune destinazioni non inviano le informazioni nel payload dell'evento alla destinazione, ma trattano l'evento come un trigger per richiamare un'API specifica. EventBridge utilizza i parametri [Target](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html) per determinare cosa succede con quell'obiettivo. Questi sono i seguenti:
+ Destinazioni API
I dati inviati a una destinazione API devono corrispondere alla struttura dell'API. Usa l'[https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html)oggetto per assicurarti che i dati siano strutturati correttamente. Se desideri includere il payload dell'evento originale, fai riferimento a esso in. [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html)
+ Gateway API
I dati inviati ad API Gateway devono corrispondere alla struttura dell'API. Utilizza l'[https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html)oggetto per assicurarti che i dati siano strutturati correttamente. Se desideri includere il payload dell'evento originale, fai riferimento a esso in. [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
+ Cluster Amazon Redshift Data API
Utilizza [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RedshiftDataParameters.html).
+ Pipeline di creazione SageMaker di modelli Amazon Runtime
Utilizza [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SageMakerPipelineParameters.html).
+ Fiera Amazon SQS e code FIFO
Consente [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_SqsParameters.html)di specificare il gruppo di messaggi da utilizzare come destinazione.
+ Run Command di Systems Manager
Utilizzare [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html)per specificare il documento SSM e le istanze di destinazione. Per ulteriori informazioni, vedere [Systems Manager Run Command as a target](#targets-specifics-ssm-run-command).
**Nota**
EventBridge non supporta tutta la sintassi di JSON Path e la valuta in fase di esecuzione. La sintassi supportata include:
notazione a punti (ad esempio, `$.detail`)
trattini
caratteri di sottolineatura
caratteri alfanumerici
indici array
caratteri jolly (\$1)
barre in avanti
### Parametri di percorso dinamici
I parametri del percorso dinamico consentono di utilizzare la sintassi del percorso JSON per fare riferimento ai dati degli eventi in fase di esecuzione anziché ai valori statici.
È possibile utilizzare la sintassi dinamica del percorso JSON con i parametri di destinazione per specificare percorsi JSON anziché valori statici (ad esempio,). `$.detail.state`
#### Requisiti
L'intero valore deve essere un percorso JSON, non solo una parte di esso. Esempio:
+ ✓ Corretto: `RedshiftParameters.Sql` può essere `$.detail.state`
+ ✗ Errato: `RedshiftParameters.Sql` non può essere `"SELECT * FROM $.detail.state"`
EventBridge sostituisce questi percorsi in fase di esecuzione con i dati del payload dell'evento nel percorso specificato.
#### Limitazioni
I parametri del percorso dinamico non possono fare riferimento a valori nuovi o trasformati derivanti dalla trasformazione di input. La sintassi del percorso JSON è la stessa della sintassi di trasformazione in ingresso. Per ulteriori informazioni, consulta [Amazon EventBridge input transformation](eb-transform-target-input.md).
#### Parametri supportati
Puoi utilizzare la sintassi dinamica su tutti i campi stringhe non enum con questi parametri:
+ [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) (tranne le chiavi `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)
## Permissions
Per effettuare chiamate API sulle risorse di tua proprietà, sono EventBridge necessarie le autorizzazioni appropriate. Specificate un ruolo di esecuzione IAM [utilizzando la EventBridge console](eb-create-rule-wizard.md#eb-create-rule-target) o impostando il `RoleARN` parametro in [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_PutTargets.html).
Ad esempio, la seguente policy definisce l'autorizzazione a inviare messaggi a una coda 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 la seguente politica di fiducia consente di EventBridge assumere il ruolo:
------
#### [ JSON ]
****
```
{
"Version":"2012-10-17",
"Statement": [
{
"Effect": "Allow",
"Principal": {
"Service": "events.amazonaws.com"
},
"Action": "sts:AssumeRole"
}
]
}
```
------
Puoi richiamare un endpoint Gateway API con l'autorizzazione IAM configurata, ma il ruolo è facoltativo se non hai configurato l'autorizzazione. Per ulteriori informazioni, consulta [Amazon EventBridge e AWS Identity and Access Management](eb-iam.md).
Se un altro account si trova nella stessa Regione e ti ha concesso l'autorizzazione, puoi inviare eventi a quell'account.
Per ulteriori informazioni, consulta [Invio e ricezione di eventi tra AWS account in Amazon EventBridge](eb-cross-account.md).
Se la tua destinazione, ad esempio una coda Amazon SQS, utilizza la crittografia AWS Key Management Service (AWS KMS), devi includere la seguente sezione nella tua politica delle chiavi KMS:
```
{
"Sid": "Allow EventBridge to use the key",
"Effect": "Allow",
"Principal": {
"Service": "events.amazonaws.com"
},
"Action": [
"kms:Decrypt",
"kms:GenerateDataKey"
],
"Resource": "*"
}
```
## AWS Batch le code di lavoro come obiettivi
Alcuni parametri AWS Batch `submitJob` possono essere configurati tramite [BatchParameters](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_BatchParameters.html).
Altri possono essere specificati nel payload di eventi. Se il payload dell'evento (trasmesso o trasmesso [InputTransformers](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)) contiene le seguenti chiavi, queste vengono mappate in base ai parametri di `submitJob` [richiesta](https://docs.aws.amazon.com/batch/latest/APIReference/API_SubmitJob.html#API_SubmitJob_RequestSyntax):
+ `ContainerOverrides: containerOverrides`
**Nota**
Include solo comando, ambiente, memoria e vcpu
+ `DependsOn: dependsOn`
**Nota**
Include solo jobId
+ `Parameters: parameters`
## CloudWatch Registra i gruppi come obiettivi
Se non si utilizza un oggetto [InputTransformer](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)con un obiettivo CloudWatch Logs, il payload dell'evento viene utilizzato come messaggio di registro e l'origine dell'evento come timestamp. Se si utilizza un InputTransformer, il modello deve essere:
`{"timestamp":,"message":}`
EventBridge raggruppa in batch le voci inviate a un flusso di log; pertanto, EventBridge può inviare uno o più eventi a un flusso di log, a seconda del traffico.
## CodeBuild progetti come obiettivi
EventBridge supporta sia le build standard che quelle in batch come obiettivi.
Se si utilizza un [trasformatore di input](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html) per modellare l'evento di origine in modo che corrisponda alla [StartBuildRequest](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuild.html#API_StartBuild_RequestSyntax)struttura prima che venga consegnato a una CodeBuild destinazione, i parametri verranno mappati 1 a 1 e passati a per impostazione predefinita. `codeBuild.StartBuild`
Per passare `codeBuild.StartBuildBatch` invece i parametri a, trasformate l'evento di origine in modo che corrisponda alla [StartBuildBatchRequest](https://docs.aws.amazon.com/codebuild/latest/APIReference/API_StartBuildBatch.html#API_StartBuildBatch_RequestSyntax)struttura e aggiungete la key/value coppia seguente alla radice dell'evento trasformato:
`"buildType": "BATCH"`
## Le attività di Amazon ECS come obiettivi
Se lo utilizzi [InputTransformers](https://docs.aws.amazon.com/eventbridge/latest/userguide/eb-transform-target-input.html)per modellare l'evento di input su un Target in modo che corrisponda alla RunTask [TaskOverride](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_TaskOverride.html)struttura di Amazon ECS, i parametri verranno mappati 1 a 1 e passati a. `ecs.RunTask`
## I piani di risposta di Incident Manager come obiettivi
Se l'evento corrispondente proviene da CloudWatch Alarms, i dettagli della modifica dello stato dell'allarme vengono inseriti nei dettagli del trigger della StartIncidentRequest chiamata a Incident Manager.
## Systems Manager Run Command come destinazione
Quando si specifica Systems Manager Run Command come destinazione, EventBridge chiama l'[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 per conto dell'utente. Configura la destinazione utilizzando [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_RunCommandParameters.html), che specifica il documento SSM da eseguire e le istanze o i tag di destinazione.
`RunCommandParameters`contiene i seguenti campi:
+ `RunCommandTargets`— (Obbligatorio) Un elenco di coppie chiave-valore che specificano le istanze di destinazione. Utilizza `Key` set to `InstanceIds` con un elenco di istanze IDs o `Key` set to `tag:tag-name` with tag per indirizzare le istanze per tag. È possibile specificare da 1 a 5 obiettivi del comando di esecuzione.
Per specificare quale documento SSM eseguire e passargli i parametri, utilizzate il `Input` campo sull'[https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_Target.html)oggetto. Il `Input` valore deve essere un oggetto JSON con la seguente struttura:
```
{
"DocumentName": "document-name",
"DocumentVersion": "version",
"Parameters": {
"parameter-key": ["parameter-value"]
}
}
```
Dove:
+ `DocumentName`— Il nome o l'ARN del documento SSM da eseguire.
+ `DocumentVersion`— (Facoltativo) La versione del documento. Se omesso, viene utilizzata la versione predefinita.
+ `Parameters`— (Facoltativo) Una mappa dei nomi dei parametri agli array di valori, che corrisponde ai parametri definiti nel documento SSM.
Ad esempio, il AWS CLI comando seguente crea una regola che esegue il `AWS-RunShellScript` documento su un'istanza specifica quando un EventBridge evento corrisponde:
```
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**
Il `Input` campo sull'`Target`oggetto viene utilizzato per passare il nome e i parametri del documento a Systems Manager Run Command. Questo è diverso da [https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html](https://docs.aws.amazon.com/eventbridge/latest/APIReference/API_InputTransformer.html), che trasforma il payload dell'evento. Quando utilizzate Systems Manager Run Command come destinazione, impostate i parametri del documento `Input` e specificate le istanze di destinazione in`RunCommandParameters`.
## Le code di Amazon SQS come destinazioni
EventBridge non supporta l'utilizzo di code Amazon SQS crittografate con un. Chiave di proprietà di AWS Ciò include le destinazioni, nonché le code Amazon SQS specificate come code di lettera morta per le destinazioni. *Per ulteriori informazioni Chiavi di proprietà di AWS, consulta la sezione [AWS Owned Keys](https://docs.aws.amazon.com/kms/latest/developerguide/concepts.html#aws-owned-cmk) nella Developer Guide.AWS Key Management Service *