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 di Amazon EventBridge Pipes
Puoi inviare i dati presenti nella tua pipe a una destinazione specifica. È possibile configurare i seguenti obiettivi quando si imposta una pipe in EventBridge:
+ [Destinazione API](eb-api-destinations.md)
+ [API Gateway](eb-api-gateway-target.md)
+ [Coda di processi batch](#pipes-targets-specifics-batch)
+ [CloudWatch gruppo di log](#pipes-targets-specifics-cwl)
+ [Attività ECS](#pipes-targets-specifics-ecs-task)
+ [Bus di eventi nello stesso account e nella stessa Regione](#pipes-targets-specifics-eventbridge)
+ Flussi di distribuzione Firehose
+ Modello di valutazione di Inspector
+ Flusso di Kinesis
+ [Funzione Lambda (SYNC o ASYNC)](#pipes-targets-specifics-lambda-stepfunctions)
+ Query sull'API dati del cluster Redshift
+ SageMaker Pipeline AI
+ Argomento Amazon SNS (argomenti FIFO SNS non supportati)
+ Coda Amazon SQS
+ [Macchina a stati di Step Functions](#pipes-targets-specifics-lambda-stepfunctions)
+ Flussi di lavoro Express (SYNC o ASYNC)
+ Flussi di lavoro standard (ASYNC)
+ [Timestream per tavolo LiveAnalytics ](#pipes-targets-specifics-timestream)
## Parametri di destinazione
Alcuni servizi di destinazione non inviano il payload dell'evento alla destinazione, ma trattano l'evento come un trigger per richiamare un'API specifica. EventBridge utilizza il [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html)per specificare quali informazioni vengono inviate a quell'API. Questi sono i seguenti:
+ Destinazioni API: i dati inviati a una destinazione API devono corrispondere alla struttura dell'API. È necessario utilizzare l'oggetto [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate) per assicurarsi che i dati siano strutturati correttamente. Se vuoi includere il payload dell'evento originale, fai riferimento a esso in [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate).
+ Gateway API: i dati inviati a Gateway API devono corrispondere alla struttura dell'API. È necessario utilizzare l'oggetto [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate) per assicurarsi che i dati siano strutturati correttamente. Se vuoi includere il payload dell'evento originale, fai riferimento a esso in [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetParameters.html#pipes-Type-PipeTargetParameters-InputTemplate).
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetRedshiftDataParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetRedshiftDataParameters.html) (cluster delle API dati di Amazon Redshift)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetSageMakerPipelineParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetSageMakerPipelineParameters.html)(Pipeline di creazione SageMaker di modelli Amazon Runtime)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetBatchJobParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetBatchJobParameters.html) (AWS Batch)
**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 (\*)
barre in avanti
### Parametri di percorso dinamici
EventBridge I parametri di destinazione di Pipes supportano la sintassi del percorso JSON dinamico opzionale. È possibile utilizzare questa sintassi per specificare percorsi JSON anziché valori statici (ad esempio `$.detail.state`). L'intero valore deve essere un percorso JSON, non solo una parte di esso. Ad esempio, `RedshiftParameters.Sql` può essere `$.detail.state` ma non può essere `"SELECT * FROM $.detail.state"`. Questi percorsi vengono sostituiti dinamicamente al runtime con i dati del payload di eventi nel percorso specificato. I parametri di percorso dinamici non possono fare riferimento a valori nuovi o trasformati risultanti dalla trasformazione dell'input. La sintassi supportata per i percorsi JSON dei parametri dinamici è la stessa utilizzata per la trasformazione dell'input. Per ulteriori informazioni, consulta [Trasformazione degli input di Amazon EventBridge Pipes](eb-pipes-input-transformation.md).
La sintassi dinamica può essere utilizzata su tutti i campi di tipo stringa non enum di tutti i parametri di arricchimento e di destinazione di EventBridge Pipes, ad eccezione di:
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetCloudWatchLogsParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetCloudWatchLogsParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetEventBridgeEventBusParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetEventBridgeEventBusParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeEnrichmentHttpParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeEnrichmentHttpParameters.html)
+ [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetHttpParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetHttpParameters.html)
[Ad esempio, per impostare il target Kinesis `PartitionKey` di una pipe su una chiave personalizzata dal tuo evento di origine, imposta il. KinesisTargetParameter PartitionKey](https://docs.aws.amazon.com/)a:
+ `"$.data.{{someKey}}"` per un'origine Kinesis
+ `"$.body.{{someKey}}"` per un'origine Amazon SQS
Quindi, se il payload dell'evento è una stringa JSON valida, ad esempio`{"{{someKey}}":"{{someValue}}"}`, EventBridge estrae il valore dal percorso JSON e lo utilizza come parametro di destinazione. In questo esempio, EventBridge imposterebbe Kinesis `PartitionKey` su "»{{someValue}}.
## Permissions
Per effettuare chiamate API sulle risorse che possiedi, EventBridge Pipes necessita dell'autorizzazione appropriata. EventBridge PIpes utilizza il ruolo IAM specificato nella pipe per le chiamate di arricchimento e di destinazione utilizzando il principale `pipes.amazonaws.com` IAM.
## Richiamo di destinazioni
EventBridge ha i seguenti modi per richiamare un target:
+ In **modo sincrono** (tipo di invocazione impostato su`REQUEST_RESPONSE`): EventBridge attende una risposta dal target prima di procedere.
+ In modo **asincrono** (tipo di chiamata impostato su`FIRE_AND_FORGET`): non attende una risposta prima di procedere. EventBridge
Per impostazione predefinita, per le pipe con sorgenti ordinate, EventBridge richiama le destinazioni in modo sincrono perché è necessaria una risposta dalla destinazione prima di passare all'evento successivo.
Se un'origine non impone l'ordine, ad esempio una coda Amazon SQS standard, può richiamare una destinazione supportata in modo EventBridge sincrono o asincrono.
Con le funzioni Lambda e le macchine a stati Step Functions, puoi configurare il tipo di invocazione.
**Nota**
Per le macchine a stati Step Functions, i [Flussi di lavoro standard](https://docs.aws.amazon.com/step-functions/latest/dg/concepts-standard-vs-express.html) devono essere richiamati in modo asincrono.
## Limiti di dimensione del payload
EventBridge Pipes supporta payload fino a 6 MB. Tuttavia, il limite effettivo della dimensione del payload è determinato da quello più piccolo: il limite di Pipes di 6 MB o la dimensione massima del payload del servizio di destinazione. Esempio:
+ Le funzioni Lambda supportano payload fino a 6 MB, quindi il limite effettivo per una pipe destinata a Lambda è di 6 MB.
+ EventBridge i bus di eventi supportano payload fino a 1 MB, quindi il limite effettivo per una pipe destinata a un bus di eventi è di 1 MB.
+ Le macchine a stati Step Functions supportano payload fino a 256 KB, quindi il limite effettivo per una pipe destinata a Step Functions è 256 KB.
Durante la configurazione della pipe, assicuratevi che le dimensioni del payload, incluse le trasformazioni applicate mediante arricchimento o trasformazione in input, non superino la dimensione massima del payload del target.
## AWS Batch code di lavoro, specifiche dell'obiettivo
Tutti i AWS Batch `submitJob` parametri sono configurati in modo esplicito con e`BatchParameters`, come tutti i parametri Pipe, possono essere dinamici utilizzando un percorso JSON verso il payload dell'evento in entrata.
## CloudWatch Registra le specifiche del target del gruppo
Indipendentemente che si utilizzi o meno un trasformatore di input, il payload di eventi viene utilizzato come messaggio di log. Puoi impostare `Timestamp` (o `LogStreamName` esplicito della tua destinazione) tramite `CloudWatchLogsParameters` in `PipeTarget`. Come tutti i parametri pipe, questi parametri possono essere dinamici quando si utilizza un percorso JSON al payload di eventi in entrata.
## Specifiche degli obiettivi delle attività di Amazon ECS
Tutti i parametri `runTask` di Amazon ECS sono configurati esplicitamente tramite `EcsParameters`. Come tutti i parametri pipe, questi parametri possono essere dinamici quando si utilizza un percorso JSON al payload di eventi in entrata.
## Specifiche del target delle funzioni Lambda e del flusso di lavoro Step Functions
Lambda e Step Functions non dispongono di un'API batch. Per elaborare batch di eventi da un'origine pipe, il batch viene convertito in un array JSON e passato come input alla destinazione Lambda o Step Functions. Per ulteriori informazioni, consulta [Dosaggio e concorrenza di Amazon EventBridge Pipes](eb-pipes-batching-concurrency.md).
## Timestream per le specifiche degli obiettivi LiveAnalytics della tabella
Le considerazioni da prendere in considerazione quando si specifica una LiveAnalytics tabella Timestream for come destinazione del tubo includono:
+ Gli stream Apache Kafka (inclusi quelli provenienti da Amazon MSK fornitori terzi) non sono attualmente supportati come sorgenti pipe.
+ Se hai specificato uno DynamoDB stream Kinesis or come sorgente pipe, devi specificare il numero di tentativi di nuovo tentativo.
Per ulteriori informazioni, consulta [Configurazione delle impostazioni della pipe](eb-pipes-create.md#pipes-configure-pipe-settings).
## EventBridge specifiche della destinazione del bus di eventi
Quando configurate un bus di EventBridge eventi come destinazione della pipe, il payload proveniente dalla pipe viene automaticamente inserito nella `detail` sezione dell' EventBridge evento. [https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetEventBridgeEventBusParameters.html](https://docs.aws.amazon.com/eventbridge/latest/pipes-reference/API_PipeTargetEventBridgeEventBusParameters.html)Utilizzato per configurare gli eventi `source` e i `detail-type` campi. Entrambi i campi supportano la sintassi dinamica del percorso JSON per estrarre valori dal payload dell'evento. Ad esempio, imposta su o su`Source`. `$.body.source` `DetailType` `$.data.eventType` È inoltre possibile utilizzare trasformatori di input per modificare la struttura dell'evento prima che venga inserito nel `detail` campo. Per ulteriori informazioni, consulta [Trasformazione degli input di Amazon EventBridge Pipes](eb-pipes-input-transformation.md).