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à.

# Destinazioni API come destinazioni in Amazon EventBridge
<a name="eb-api-destinations"></a>

EventBridge Le *destinazioni API* sono endpoint HTTPS che è possibile richiamare come destinazione di una regola o pipe del bus di eventi, in modo simile a come si richiama un AWS servizio o una risorsa come destinazione. Utilizzando le destinazioni API, è possibile instradare [gli eventi](eb-events.md) tra AWS servizi, applicazioni SaaS (Software as a Service) integrate e applicazioni pubbliche o private utilizzando chiamate API. 

Quando specificate una destinazione API come regola o destinazione pipe, EventBridge richiama l'endpoint HTTPS per qualsiasi evento che corrisponde al [modello](eb-event-patterns.md) di evento specificato nella regola o nella pipe e quindi fornisce le informazioni sull'evento con la richiesta. Con EventBridge, puoi utilizzare qualsiasi metodo HTTP tranne CONNECT e TRACE per la richiesta. I metodi HTTP più comuni da utilizzare sono PUT e POST. 

È inoltre possibile utilizzare trasformatori di input per personalizzare l'evento in base ai parametri di uno specifico endpoint HTTP. Per ulteriori informazioni, consulta [Trasformazione degli EventBridge input di Amazon](eb-transform-target-input.md).

![\[Le destinazioni API utilizzano una connessione con parametri di autorizzazione per inviare eventi agli endpoint HTTP.\]](http://docs.aws.amazon.com/it_it/eventbridge/latest/userguide/images/api-destinations-overview_eventbridge_conceptual.svg)


EventBridge Le destinazioni API utilizzano *le connessioni* per definire il metodo di autorizzazione, le credenziali e la connettività di rete EventBridge da utilizzare per la connessione a un determinato endpoint HTTPS. Le connessioni supportano sia il pubblico che il privato. APIs Per ulteriori informazioni, consulta [Connessioni](eb-target-connection.md).

**Nota**  
EventBridge Le destinazioni API attualmente supportano solo nomi di dominio pubblico con certificati pubblicamente attendibili per endpoint HTTPS quando vengono utilizzati in modalità privata APIs. Le destinazioni API non supportano il TLS reciproco (MTL).

**Importante**  
EventBridge le richieste verso un endpoint di destinazione API devono avere un timeout di esecuzione del client massimo di 5 secondi. Se l'endpoint di destinazione impiega più di 5 secondi per rispondere, la richiesta scade in EventBridge timeout. EventBridge i nuovi tentativi hanno determinato il timeout delle richieste fino ai valori massimi configurati nella politica di ripetizione dei tentativi.   
Per gli event bus, per impostazione predefinita, i valori massimi sono 24 ore e 185 volte.
Per le pipe, vengono determinati i nuovi tentativi, il tipo di origine della tubazione e la relativa configurazione. EventBridge riproverà fino alla scadenza dell'evento dall'origine o fino al raggiungimento dell'età massima dell'evento o dei tentativi di nuovo tentativo configurati.
Dopo l'esecuzione del numero massimo di tentativi, gli eventi vengono inviati alla [coda DLQ](eb-rule-dlq.md) se esistente. In caso contrario, l'evento viene abbandonato.

 Il video seguente illustra l'uso delle destinazioni API:




## Ruolo collegato a un servizio per le destinazioni API
<a name="eb-api-destination-slr"></a>

Quando crei una connessione per una destinazione API, il ruolo collegato al servizio [AmazonEventBridgeApiDestinationsServiceRolePolicy](eb-use-identity-based.md#api-destination-slr-policy) viene aggiunto al tuo account. EventBridge utilizza questo ruolo collegato al servizio per creare e archiviare un segreto in Secrets Manager. Per concedere le autorizzazioni necessarie al ruolo collegato al servizio, associa la policy al ruolo EventBridge. **AmazonEventBridgeApiDestinationsServiceRolePolicy** La policy limita le autorizzazioni concesse solo a quelle necessarie affinché il ruolo interagisca con il segreto della connessione. Non sono incluse altre autorizzazioni e il ruolo può interagire solo con le connessioni presenti nell'account per la gestione del segreto.

Per ulteriori informazioni sui ruoli collegati al servizio, consulta [Utilizzo dei ruoli collegati al servizio](https://docs.aws.amazon.com//IAM/latest/UserGuide/using-service-linked-roles.html) nella *Guida per l'utente IAM*.

## Intestazioni incluse nelle richieste a destinazioni API
<a name="eb-api-destination-headers"></a>

La sezione seguente descrive in dettaglio come EventBridge gestisce le intestazioni HTTP nelle richieste alle destinazioni API.

### Intestazioni incluse nelle richieste a destinazioni API
<a name="eb-api-destination-headers-included"></a>

Oltre alle intestazioni di autorizzazione definite per la connessione utilizzata per una destinazione API, EventBridge include le seguenti intestazioni in ogni richiesta.


| Chiave intestazione | Valore intestazione | 
| --- | --- | 
|  User-Agent  |  Amazon/EventBridge/ApiDestinations  | 
|  Content-Type  |  Se non viene specificato alcun valore Content-Type personalizzato, EventBridge include il seguente valore predefinito come Content-Type: application/json; charset=utf-8  | 
|  Intervallo  |  bytes=0-1048575  | 
|  Accept-Encoding  |  gzip,deflate  | 
|  Connessione  |  close  | 
|  Content-Length  |  Un'intestazione di entità che indica la dimensione del corpo dell'entità, in byte, inviata al destinatario.  | 
|  Host  |  Un'intestazione di richiesta che specifica l'host e il numero di porta del server a cui viene inviata la richiesta.  | 

### Intestazioni che non possono essere sovrascritte nelle richieste verso destinazioni API
<a name="eb-api-destination-headers-no-override"></a>

EventBridge non consente di sovrascrivere le seguenti intestazioni:
+ User-Agent
+ Intervallo

### Le intestazioni vengono EventBridge rimosse dalle richieste alle destinazioni API
<a name="eb-api-destination-headers-removed"></a>

EventBridge rimuove le seguenti intestazioni per tutte le richieste di destinazione API:
+ A-IM
+ Accept-Charset
+ Accept-Datetime
+ Accept-Encoding
+ Cache-Control
+ Connessione
+ Content-Encoding
+ Content-Length
+ Contenuto- MD5
+ Data
+ Expect
+ Forwarded
+ Da
+ Host
+ HTTP2-Impostazioni
+ If-Match
+ If-Modified-Since
+ If-None-Match
+ If-Range
+ If-Unmodified-Since
+ Max-Forwards
+ Origin
+ Pragma
+ Proxy-Authorization
+ Intervallo
+ Referente
+ TE
+ Trailer
+ Transfer-Encoding
+ User-Agent
+ Upgrade
+ Via
+ Attenzione

## Codici di errore delle destinazioni API
<a name="eb-api-destination-error-codes"></a>

Quando EventBridge tenta di inviare un evento a una destinazione API e si verifica un errore, EventBridge esegue le seguenti operazioni:
+ Riprova gli eventi associati ai codici di errore `401``407`,, `409``429`, e`5xx`.
+ Non riprova gli eventi associati ai codici di errore`1xx`, `2xx``3xx`, e `4xx` (diversi da quelli sopra indicati).

EventBridge Le destinazioni API leggono l'intestazione di risposta HTTP standard `Retry-After` per scoprire quanto tempo attendere prima di effettuare una richiesta di follow-up. Per i bus di eventi, EventBridge sceglie il valore più conservativo tra la politica di ripetizione definita e l'intestazione. `Retry-After` Se `Retry-After` il valore è negativo, EventBridge interrompe il nuovo tentativo di consegna per quell'evento.

## Impatto della frequenza di invocazione sulla distribuzione degli eventi
<a name="eb-api-destination-event-delivery"></a>

Se imposti la frequenza di invocazione al secondo su un valore molto inferiore al numero di invocazioni generate, gli eventi potrebbero non essere distribuiti entro il tempo di ripetizione di 24 ore per gli eventi. Ad esempio, se imposti la frequenza di invocazione su 10 chiamate al secondo, ma vengono generati migliaia di eventi al secondo, avrai rapidamente un backlog di eventi da distribuire che supera le 24 ore. Per essere certo che nessun evento vada perso, imposta una coda DLQ a cui inviare gli eventi con invocazioni non riuscite in modo da poterli elaborare in un secondo momento. Per ulteriori informazioni, consulta [Utilizzo di code di lettere non recapitate per elaborare eventi non consegnati in EventBridge](eb-rule-dlq.md).

## Disponibilità nelle regioni
<a name="eb-api-destination-regions"></a>

Le destinazioni API verso gli endpoint HTTPS pubblici sono supportate nelle seguenti regioni: AWS 
+ Stati Uniti orientali (Virginia settentrionale)
+ Stati Uniti orientali (Ohio)
+ Stati Uniti occidentali (California settentrionale)
+ Stati Uniti occidentali (Oregon)
+ Africa (Città del Capo)
+ Asia Pacifico (Hong Kong)
+ Asia Pacifico (Tokyo)
+ Asia Pacifico (Seoul)
+ Asia Pacifico (Osaka)
+ Asia Pacifico (Mumbai)
+ Asia Pacifico (Hyderabad)
+ Asia Pacifico (Singapore)
+ Asia Pacifico (Sydney)
+ Asia Pacifico (Giacarta)
+ Canada (Centrale)
+ Cina (Pechino)
+ Cina (Ningxia)
+ Europa (Francoforte)
+ Europa (Zurigo)
+ Europa (Stoccolma)
+ Europa (Milano)
+ Europa (Spagna)
+ Europa (Irlanda)
+ Europa (Londra)
+ Europa (Parigi)
+ Medio Oriente (Emirati Arabi Uniti)
+ Medio Oriente (Bahrein)
+ Sud America (San Paolo)

# Crea una destinazione API in Amazon EventBridge
<a name="eb-api-destination-create"></a>

La creazione di una destinazione API consente di specificare un endpoint HTTP come destinazione di una regola.

Ogni destinazione API richiede una connessione. Una *connessione* specifica il tipo di autorizzazione e le credenziali da utilizzare per l'autorizzazione con l'endpoint di destinazione API. Puoi scegliere una connessione esistente o creare una connessione quando crei una destinazione API. Per ulteriori informazioni, consulta [Connessioni per destinazioni API in Amazon EventBridge](eb-target-connection.md)

**Per creare una destinazione API utilizzando la console EventBridge**

1. Accedi AWS utilizzando un account con le autorizzazioni necessarie per gestire EventBridge e aprire la [EventBridgeconsole](https://console.aws.amazon.com/events).

1. Nel riquadro di navigazione, scegli **Destinazioni API**.

1. Scorri verso il basso fino alla tabella delle **destinazioni API**, quindi scegli **Crea una destinazione API**.

1. Nella pagina **Crea destinazione API**, inserisci un **nome** e una descrizione per la destinazione API. 

   Il nome deve essere univoco per l'account nella Regione corrente. Puoi utilizzare fino a 64 caratteri maiuscoli o minuscoli, numeri, punti (.), trattini (-) o caratteri di sottolineatura (\$1).
**Importante**  
Quando crei una nuova destinazione API per la tua connessione, assicurati che la connessione raggiunga lo stato AUTORIZZATO prima di creare la destinazione API.

1. Immetti un **Endpoint di destinazione API** per la destinazione API. 

   L'**endpoint di destinazione API** è una destinazione endpoint di invocazione HTTP per gli eventi. Le informazioni di autorizzazione che includi nella connessione utilizzata per questa destinazione API vengono utilizzate per l’autorizzazione in base a questo endpoint. L'URL deve utilizzare HTTPS.

1. Immetti il **Metodo HTTP** da utilizzare per la connessione all'**Endpoint di destinazione API**.

1. (Facoltativo) In **Limite di velocità di invocazione al secondo**, immetti il numero massimo di invocazioni al secondo da inviare all'endpoint di destinazione API.

   Il limite di velocità che imposti può influire sulla modalità di EventBridge erogazione degli eventi. Per ulteriori informazioni, consulta [Impatto della frequenza di invocazione sulla distribuzione degli eventi](eb-api-destinations.md#eb-api-destination-event-delivery).

1. In **Connessione**, esegui una delle seguenti operazioni:
   + Scegli **Utilizza una connessione esistente**, quindi seleziona la connessione da utilizzare per questa destinazione API.
   + Scegli **Crea una nuova connessione**, quindi immetti i dettagli della connessione da creare. 

     Per istruzioni dettagliate, vedi [Creazione di connessioni](eb-target-connection-create.md).

1. Scegli **Create** (Crea).

# Creazione di regole che inviano eventi a una destinazione API in EventBridge
<a name="eb-create-rule-api-destination-target"></a>

Dopo aver creato una destinazione API, puoi selezionarla come destinazione di una [regola](eb-rules.md). Per utilizzare una destinazione API come destinazione, devi fornire le autorizzazioni appropriate a un ruolo IAM. Per ulteriori informazioni, consulta [Autorizzazioni necessarie per accedere EventBridge agli obiettivi utilizzando i ruoli IAM](eb-events-iam-roles.md#eb-target-permissions)

La selezione di una destinazione API come destinazione fa parte della creazione della regola.

**Per creare una regola che invii eventi a una destinazione API utilizzando la console**

1. Segui i passaggi nella procedura [Creazione di regole in Amazon EventBridge](eb-create-rule-visual.md).

1. Nella [Selezionare le destinazioni](eb-create-rule-wizard.md#eb-create-rule-target) fase, quando viene richiesto di scegliere una destinazione API come tipo di destinazione:

   1. Seleziona la **destinazione EventBridge dell'API**.

   1. Esegui una delle seguenti operazioni:
      + Scegli **Usa una destinazione API esistente** e seleziona una destinazione API esistente
      + Scegli **Crea una nuova destinazione API** e specifica l'impostazione necessaria per definire la tua nuova destinazione API.

        Per ulteriori informazioni sulla specificazione delle impostazioni richieste, consulta[Crea una destinazione API in Amazon EventBridge](eb-api-destination-create.md).

   1. (Facoltativo): per specificare i parametri di intestazione per l'evento, in Parametri dell'**intestazione scegliete **Aggiungi** parametro di intestazione**.

      Quindi, specificate la chiave e il valore per il parametro di intestazione.

   1. (Facoltativo): per specificare i parametri della stringa di query per l'evento, in **Parametri della stringa di query** scegliete **Aggiungi parametro della stringa di query**.

      Quindi, specificate la chiave e il valore per il parametro della stringa di query.

1. Completa la creazione della regola seguendo i [passaggi della procedura](eb-create-rule-visual.md).

# Invio di CloudEvents eventi a destinazioni API
<a name="eb-api-destinations-cloudevents"></a>

CloudEvents è una specifica indipendente dal fornitore per la formattazione degli eventi, con l'obiettivo di fornire l'interoperabilità tra servizi, piattaforme e sistemi. È possibile utilizzarlo EventBridge per trasformare gli eventi AWS di servizio CloudEvents prima che vengano inviati a una destinazione, ad esempio una destinazione API.

**Nota**  
La procedura seguente spiega come trasformare gli eventi di origine in modalità * CloudEventsstrutturata*. Nella CloudEvents specifica, un messaggio in modalità strutturata è un messaggio in cui l'intero evento (attributi e dati) viene codificato nel payload dell'evento.

[Per ulteriori informazioni sulle specifiche, consulta cloudevents.io CloudEvents .](https://cloudevents.io/)

**Per trasformare AWS gli eventi nel formato utilizzando la console CloudEvents**

Per trasformare gli eventi nel CloudEvents formato precedente alla consegna a un target, iniziate creando una regola del bus degli eventi. Come parte della definizione della regola, utilizzate un trasformatore di input per disporre degli eventi di EventBridge trasformazione prima di inviarli alla destinazione specificata.

1. Segui i passaggi nella procedura [Creazione di regole in Amazon EventBridge](eb-create-rule-visual.md).

1. Nella [Selezionare le destinazioni](eb-create-rule-wizard.md#eb-create-rule-target) fase, quando viene richiesto di scegliere una destinazione API come tipo di destinazione:

   1. Seleziona la **destinazione EventBridge dell'API**.

   1. Esegui una delle seguenti operazioni:
      + Scegli **Usa una destinazione API esistente** e seleziona una destinazione API esistente
      + Scegli **Crea una nuova destinazione API** e specifica l'impostazione necessaria per definire la tua nuova destinazione API.

        Per ulteriori informazioni sulla specificazione delle impostazioni richieste, consulta[Crea una destinazione API in Amazon EventBridge](eb-api-destination-create.md).

   1. Specificate i parametri di intestazione Content-Type necessari per gli eventi: CloudEvents 
      + **In Parametri di **intestazione scegli Aggiungi parametro** di intestazione.**
      + Per **chiave, specifica**. `Content-Type` 

        Per **valore**, specificare`application/cloudevents+json; charset=UTF-8`.

1. Specificate un ruolo di esecuzione per il vostro obiettivo.

1. Definisci un trasformatore di input per trasformare i dati dell'evento di origine nel CloudEvents formato:

   1. In **Impostazioni aggiuntive**, per **Configura l'input di destinazione**, scegli **Trasformatore di ingresso**.

      Quindi scegli **Configura trasformatore di ingresso**.

   1. In **Target input transformer**, specifica il percorso **di input**.

      Nel percorso di input riportato di seguito, l'attributo region è un *attributo di estensione* personalizzato del CloudEvents formato. In quanto tale, non è necessario per il rispetto delle CloudEvents specifiche.

      CloudEvents consente di utilizzare e creare attributi di estensione non definiti nella specifica di base. Per ulteriori informazioni, incluso un elenco di attributi di estensione noti, vedete [Attributi di CloudEvents estensione](https://github.com/cloudevents/spec/tree/main/cloudevents/extensions) nella [documentazione delle CloudEvents specifiche](https://github.com/cloudevents/spec/tree/main) su GitHub.

      ```
      {
        "detail": "$.detail",
        "detail-type": "$.detail-type",
        "id": "$.id",
        "region": "$.region",
        "source": "$.source",
        "time": "$.time"
      }
      ```

   1. Per **Template**, inserite il modello per trasformare i dati dell'evento di origine nel CloudEvents formato. 

      Nel modello seguente, non `region` è strettamente obbligatorio, poiché l'`region`attributo nel percorso di input è un attributo di estensione della CloudEvents specifica.

      ```
      {
        "specversion":"1.0",
        "id":<id>,
        "source":<source>,
        "type":<detail-type>,
        "time":<time>,
        "region":<region>,
        "data":<detail>
      }
      ```

1. Completa la creazione della regola seguendo i [passaggi della procedura](eb-create-rule-visual.md).

# Partner di destinazione API in Amazon EventBridge
<a name="eb-api-destination-partners"></a>

Utilizza le informazioni fornite dai seguenti AWS partner per configurare una destinazione e una connessione API per il loro servizio o applicazione.

## Osservabilità nel cloud di Cisco
<a name="eb-api-destination-cisco-cloud-observability"></a>

**URL dell'endpoint di invocazione della destinazione API:**  
`https://tenantName.observe.appdynamics.com/rest/awsevents/aws-eventbridge-integration/endpoint`

**Tipi di autorizzazione supportati:**   
OAuth credenziali del cliente  
OAuth i token vengono aggiornati quando viene restituita una risposta 401 o 407

**Parametri di autorizzazione aggiuntivi necessari:**  
Cisco AppDynamics Client ID e Client Secret  
OAuth endpoint:  
`https://tenantName.observe.appdynamics.com/auth/tenantId/default/oauth2/token`  
I seguenti parametri della coppia OAuth chiave/valore:      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/eventbridge/latest/userguide/eb-api-destination-partners.html)

** AppDynamics Documentazione Cisco:**  
[AWS ingestione di eventi](https://docs.appdynamics.com/display/CLOUD/AWS+Events+Ingestion)

**Operazioni API di uso comune:**  
Non applicabile

**Informazioni aggiuntive:**  
Scegliendo **Cisco AppDynamics** dal menu a discesa **Partner destination** vengono precompilate OAuth le informazioni necessarie, incluse le coppie header e body necessarie per le chiamate API. key/value   
*Per ulteriori informazioni, consulta l'inserimento [AWS degli eventi](https://docs.appdynamics.com/display/CLOUD/AWS+Events+Ingestion) nella documentazione di Cisco. AppDynamics*

## Confluent
<a name="api-destination-confluent"></a>

**URL dell'endpoint di invocazione della destinazione API:**  
In genere il seguente formato:  
`https://random-id.region.aws.confluent.cloud:443/kafka/v3/clusters/cluster-id/topics/topic-name/records`  
Per ulteriori informazioni, consulta [Trova l'indirizzo dell'endpoint REST e l'ID del cluster](https://docs.confluent.io/cloud/current/kafka-rest/krest-qs.html#step-1-find-the-rest-endpoint-address-and-cluster-id) nella documentazione di Confluent.

**Tipi di autorizzazione supportati:**   
Di base

**Parametri di autorizzazione aggiuntivi necessari:**  
Non applicabile

**Documentazione Confluent:**  
[Produrre dischi](https://docs.confluent.io/cloud/current/api.html#tag/Records-(v3)/operation/produceRecord)  
[Proxy REST Confluent per Apache Kafka](https://docs.confluent.io/platform/current/kafka-rest/api.html#records-v3)

**Operazioni API di uso comune:**  
`POST`

**Informazioni aggiuntive:**  
[Per trasformare i dati dell'evento in un messaggio che l'endpoint può elaborare, crea un trasformatore di input di destinazione.](eb-transform-target-input.md)  
+ Per generare un record senza specificare una chiave di partizionamento Kafka, utilizzate il seguente modello per il trasformatore di input. Non è richiesto alcun percorso di input. 

  ```
  {
    "value":{
        "type":"JSON",
        "data":aws.events.event.json
    },
  }
  ```
+ Per generare un record utilizzando un campo di dati di eventi come chiave di partizionamento Kafka, segui il percorso di input e l'esempio di modello di seguito. Questo esempio definisce il percorso di input per il `orderId` campo e quindi specifica quel campo come chiave di partizione.

  Innanzitutto, definisci il percorso di input per il campo di dati dell'evento:

  ```
  {
    "orderId":"$.detail.orderId"
  }
  ```

  Quindi, usa il modello di trasformatore di input per specificare il campo dati come chiave di partizione:

  ```
  {
    "value":{
      "type":"JSON",
      "data":aws.events.event.json
    },
    "key":{
      "data":"<orderId>",
      "type":"STRING"
    }
  }
  ```

## Coralogix
<a name="eb-api-destination-coralogix"></a>

**URL dell'endpoint di invocazione della destinazione API**  
Per un elenco completo degli endpoint, consulta [Coralogix API Reference](https://coralogix.com/docs/log-query-simply-retrieve-data/).

**Tipi di autorizzazione supportati**   
Chiave API

**Parametri di autorizzazione aggiuntivi necessari**  
Intestazione `"x-amz-event-bridge-access-key"`, il valore è la chiave API Coralogix

**Documentazione di Coralogix**  
[ EventBridgeAutenticazione Amazon](https://coralogix.com/docs/amazon-eventbridge/)

**Operazioni API di uso comune**  
Stati Uniti: https://ingress.coralogix. us/aws/event-ponte  
Singapore: ponte https://ingress.coralogixsg.com/aws/ degli eventi  
Irlanda https://ingress.coralogix.com/aws/: event-bridge  
Stoccolma: ponte per eventi https://ingress.eu2.coralogix.com/aws/  
India: https://ingress.coralogix. in/aws/event-ponte

**Informazioni aggiuntive**  
Gli eventi vengono archiviati come voci di log con `applicationName=[AWS Account]` e `subsystemName=[event.source]`.

## Datadog
<a name="eb-api-destination-datadog"></a>

**URL dell'endpoint di invocazione della destinazione API**  
Per un elenco completo degli endpoint, consulta [Datadog API Reference](https://docs.datadoghq.com/api/latest/).

**Tipi di autorizzazione supportati**   
Chiave API

**Parametri di autorizzazione aggiuntivi necessari**  
Nessuno

**Documentazione di Datadog**  
[Autenticazione](https://docs.datadoghq.com/api/latest/authentication/)

**Operazioni API di uso comune**  
POST v1/eventi https://api.datadoghq.com/api/  
Ingresso POST https://http-intake.logs.datadoghq.com/v1/

**Informazioni aggiuntive**  
Gli endpoint URLs variano a seconda della posizione dell'organizzazione Datadog. Per l'URL corretto per la tua organizzazione, consulta la [documentazione](https://docs.datadoghq.com/api/latest/).

## Dynatrace
<a name="api-destination-dynatrace"></a>

**URL dell'endpoint di invocazione della destinazione API:**  
+ Registri: https://.live.dynatrace. *environment-id* com/api/v2/logs/ingest
+ Eventi Davis: https://*environment-id*.live.dynatrace. com/platform/ingest/v1/events
+ Eventi SDLC: https://*environment-id*.live.dynatrace. com/platform/ingest/v1/events.sdlc
+ Eventi di sicurezza: https://*environment-id*.live.dynatrace. com/platform/ingest/v1/events.sicurezza

**Tipi di autorizzazione supportati:**   
Chiave API

**Parametri di autorizzazione aggiuntivi necessari:**      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/eventbridge/latest/userguide/eb-api-destination-partners.html)

**Documentazione Dynatrace:**  
+ [Inserimento di log](https://docs.dynatrace.com/docs/observe-and-explore/logs/lma-log-ingestion)
+ [Come importare dati (eventi)](https://docs.dynatrace.com/docs/platform/openpipeline/getting-started/how-to-ingestion)
+ [Acquisisci i risultati delle vulnerabilità e gli eventi di scansione di Amazon ECR](https://docs.dynatrace.com/docs/platform-modules/application-security/security-events-ingest/ingest-aws-ecr-data)

**Operazioni API di uso comune:**  
POST

**Informazioni aggiuntive:**  
Ogni tipo di endpoint ha il proprio ambito di token, necessario per una corretta autenticazione. Per ulteriori informazioni, consulta [Ingestion APIs](https://docs.dynatrace.com/docs/platform/openpipeline/reference/api-ingestion-reference) nella documentazione di Dynatrace.

## Freshworks
<a name="eb-api-destination-freshworks"></a>

**URL dell'endpoint di invocazione della destinazione API**  
Per un elenco degli endpoint, vedere [https://developers.freshworks.com/documentation/](https://developers.freshworks.com/documentation/)

**Tipi di autorizzazione supportati**   
Base, Chiave API

**Parametri di autorizzazione aggiuntivi necessari**  
Non applicabile

**Documentazione di Freshworks**  
[Autenticazione](https://developers.freshdesk.com/api/#authentication)

**Operazioni API di uso comune**  
https://developers.freshdesk.com/api/\$1create\$1ticket  
https://developers.freshdesk.com/api/\$1update\$1ticket  
https://developer.freshsales.io/api/\$1create\$1lead  
https://developer.freshsales.io/api/\$1update\$1lead

**Informazioni aggiuntive**  
Nessuno

## MongoDB
<a name="eb-api-destination-mongodb"></a>

**URL dell'endpoint di invocazione della destinazione API**  
https://data.mongodb-api.com/app/*App ID*/punto di fine/

**Tipi di autorizzazione supportati**   
Chiave API  
E-mail/password  
Autenticazione JWT personalizzata

**Parametri di autorizzazione aggiuntivi necessari**  
Nessuno

**Documentazione di MongoDB**  
[Atlas Data API](https://www.mongodb.com/docs/atlas/app-services/data-api/)  
[Endpoints](https://www.mongodb.com/docs/atlas/app-services/data-api/generated-endpoints/#endpoints)  
[Custom HTTPS Endpoints](https://www.mongodb.com/docs/atlas/app-services/data-api/custom-endpoints/)  
[Autenticazione](https://www.mongodb.com/docs/atlas/app-services/data-api/generated-endpoints/#authentication)

**Operazioni API di uso comune**  
Nessuno

**Informazioni aggiuntive**  
Nessuno

## Momento
<a name="api-destination-momento"></a>

**URL dell'endpoint di invocazione della destinazione API:**  
https://api.cache. *region*.prod.a.momentohq.com/cache/ *cacheName*  
https://api.cache. *region*.prod.a.momentohq.com/topics//*cacheName**topicName*

**Tipi di autorizzazione supportati:**   
Chiave API

**Parametri di autorizzazione aggiuntivi necessari:**      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/eventbridge/latest/userguide/eb-api-destination-partners.html)

**Documentazione Momento:**  
[Momento\$1 Amazon EventBridge](https://docs.momentohq.com/cache/integrations/amazon-eventbridge)  
[Utilizzo dell'API Momento Topics](https://docs.momentohq.com/topics/develop/api-reference)  
[Riferimento API per Momento Cache](https://docs.momentohq.com/cache/develop/api-reference)

**Operazioni API di uso comune:**  
Per le cache:`PUT`, `DELETE`  
Per argomenti: `POST`

**Informazioni aggiuntive:**  
Quando aggiorni o elimini una cache, includi i seguenti parametri della stringa di query nella configurazione dell'obiettivo della regola:   
+ La chiave che vuoi aggiornare nella cache di Momento
+ Il Time-To-Live (TTL) per l'elemento della cache
Ad esempio, se l'evento di input includeva un `details` campo con questi valori:  
`key: $.details.key ttl_seconds: $.details.ttl_seconds`

## New Relic
<a name="api-destination-new-relic"></a>

**URL dell'endpoint di invocazione della destinazione API**  
Per ulteriori informazioni, consulta [Our EU and US region data centers](https://docs.newrelic.com/docs/using-new-relic/welcome-new-relic/get-started/our-eu-us-region-data-centers/).  
**Eventi**  
**Stati Uniti:** https://insights-collector.newrelic.com/v1/ accounts/ /events *YOUR\$1NEW\$1RELIC\$1ACCOUNT\$1ID*  
**UE— https://insights-collector.eu01.nr-data**. net/v1/accounts/*YOUR\$1NEW\$1RELIC\$1ACCOUNT\$1ID*/eventi  
**Parametri**  
**Stati Uniti— v1** https://metric-api.newrelic.com/metric/  
**UE— v1** https://metric-api.eu.newrelic.com/metric/  
**Log**  
**Stati Uniti— v1** https://log-api.newrelic.com/log/  
**UE— v1** https://log-api.eu.newrelic.com/log/  
**Tracce**  
**Stati Uniti— v1** https://trace-api.newrelic.com/trace/  
**UE— v1** https://trace-api.eu.newrelic.com/trace/

**Tipi di autorizzazione supportati**   
Chiave API

**Documentazione di New Relic**  
[Metric API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/report-metrics-metric-api/)  
[Event API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/introduction-event-api/)  
[Log API](https://docs.newrelic.com/docs/logs/log-management/log-api/introduction-log-api/)  
[Trace API](https://docs.newrelic.com/docs/understand-dependencies/distributed-tracing/trace-api/introduction-trace-api/)

**Operazioni API di uso comune**  
[Metric API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/report-metrics-metric-api/)  
[Event API](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/introduction-event-api/)  
[Log API](https://docs.newrelic.com/docs/logs/log-management/log-api/introduction-log-api/)  
[Trace API](https://docs.newrelic.com/docs/understand-dependencies/distributed-tracing/trace-api/introduction-trace-api/)

**Informazioni aggiuntive**  
[Metric API limits](https://docs.newrelic.com/docs/telemetry-data-platform/get-data/apis/metric-api-limits-restricted-attributes/)  
[Event API limits](https://docs.newrelic.com/docs/telemetry-data-platform/ingest-manage-data/ingest-apis/introduction-event-api/#limits)  
[Log API limits](https://docs.newrelic.com/docs/logs/log-management/log-api/introduction-log-api/#limits)  
[Trace API limits](https://docs.newrelic.com/docs/understand-dependencies/distributed-tracing/trace-api/trace-api-general-requirements-limits/)

## Operata
<a name="api-destination-operata"></a>

**URL dell'endpoint di invocazione della destinazione API:**  
https://api.operata. io/v2/aws/events/contact-registrazione

**Tipi di autorizzazione supportati:**   
Di base

**Parametri di autorizzazione aggiuntivi necessari:**  
Nessuno

**Documentazione di Operata:**  
[How do I create, view, change and revoke API Tokens?](https://help.operata.com/en/articles/5542797-how-do-i-create-view-change-and-revoke-api-tokens)  
[AWS Integrazione di Operata tramite Amazon EventBridge Scheduler Pipes](https://docs.operata.com/docs/aws-integration)

**Operazioni API di uso comune:**  
`POST https://api.operata.io/v2/aws/events/contact-record`

**Informazioni aggiuntive:**  
`username` è l'ID gruppo Operata e la password è il tuo token API.

## Salesforce
<a name="api-destination-salesforce"></a>

**URL dell'endpoint di invocazione della destinazione API**  
**Oggetto: https://.my.salesforce**. *myDomainName* com/services/data/*SobjectEndpoint*/oggetti*versionNumber*//\$1  
**Eventi della piattaforma personalizzati: https://.my.salesforce**. *myDomainName* com/services/data*versionNumber*/*customPlatformEndpoint*/sobjects/ /\$1  
Per un elenco completo di endpoint, consulta [Riferimento API di Salesforce](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/resources_list.htm)

**Tipi di autorizzazione supportati**   
OAuth credenziali del client  
I token OAUTH vengono aggiornati quando viene restituita una risposta 401 o 407.

**Parametri di autorizzazione aggiuntivi necessari**  
SalesforceID client e segreto client dell'[app connessa ](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_oauth_and_connected_apps.htm).  
Uno dei seguenti endpoint di autorizzazione:  
+ **Produzione: https:**//*MyDomainName*.my.salesforce.com. /services/oauth2/token
+ **Sandbox senza domini avanzati—** https://*MyDomainName*-- * SandboxName* .my. salesforce. com/services /oauth2/token
+ **Sandbox con domini avanzati: https://*MyDomainName*-** .sandbox.my.salesforce. * SandboxName* com/services/oauth2/token
La key/value coppia seguente:      
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/eventbridge/latest/userguide/eb-api-destination-partners.html)

**Documentazione di Salesforce**  
[REST API Developer Guide](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/intro_what_is_rest_api.htm)

**Operazioni API di uso comune**  
[Working with Object Metadata](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/using_resources_working_with_object_metadata.htm)  
[Working with Records](https://developer.salesforce.com/docs/atlas.en-us.api_rest.meta/api_rest/using_resources_working_with_records.htm)

**Informazioni aggiuntive**  
Per un tutorial che spiega come utilizzare la EventBridge console per creare una connessioneSalesforce, una destinazione API e una regola a cui indirizzare le informazioniSalesforce, consulta[Tutorial: invia eventi a Salesforce da Amazon EventBridge](eb-tutorial-salesforce.md).

## Slack
<a name="eb-api-destination-slack"></a>

**URL dell'endpoint di invocazione della destinazione API**  
Per un elenco di endpoint e altre risorse, consulta [Using the Slack Web API](https://api.slack.com/web)

**Tipi di autorizzazione supportati**   
OAuth 2.0  
I token OAUTH vengono aggiornati quando viene restituita una risposta 401 o 407.  
Quando crei un'Slackapplicazione e la installi nel tuo spazio di lavoro, verrà creato un token OAuth bearer per tuo conto da utilizzare per l'autenticazione delle chiamate tramite la tua connessione di destinazione API.

**Parametri di autorizzazione aggiuntivi necessari**  
Non applicabile

**Documentazione di Slack**  
[Basic app setup](https://api.slack.com/authentication/basics)  
[Installazione con OAuth](https://api.slack.com/authentication/oauth-v2)  
[Retrieving messages](https://api.slack.com/messaging/retrieving)  
[Invio di messaggi](https://api.slack.com/messaging/sending)  
[Sending messages using Incoming Webhooks](https://api.slack.com/messaging/webhooks)

**Operazioni API di uso comune**  
https://slack.com/api/chat. Pubblica messaggio

**Informazioni aggiuntive**  
Quando si configura la EventBridge regola, ci sono due configurazioni da evidenziare:  
+ Includi un parametro di intestazione che definisca il tipo di contenuto come "application/json;charset=utf-8".
+ Utilizzate un trasformatore di input per mappare l'evento di input all'output previsto per l'SlackAPI, ovvero assicuratevi che il payload inviato all'SlackAPI abbia coppie «canale» e «testo». key/value 

## Shopify
<a name="eb-api-destination-shopify"></a>

**URL dell'endpoint di invocazione della destinazione API**  
[Per un elenco di endpoint e altre risorse e metodi, consulta Endpoints and requests](https://shopify.dev/api/admin-rest#endpoints)

**Tipi di autorizzazione supportati**   
OAuth, Chiave API  
I token OAUTH vengono aggiornati quando viene restituita una risposta 401 o 407.

**Parametri di autorizzazione aggiuntivi necessari**  
Non applicabile

**Documentazione di Shopify**  
[Authentication and authorization overview](https://shopify.dev/apps/auth)

**Operazioni API di uso comune**  
POST - admin/api/2022-01/products /.json  
OTTIENI -admin/api/2022-01/products/\$1product\$1id\$1 .json  
INSERISCI -admin/api/2022-01/products/\$1product\$1id\$1 .json  
ELIMINA -admin/api/2022-01/products/\$1product\$1id\$1 .json

**Informazioni aggiuntive**  
[Create an app](https://shopify.dev/apps/getting-started/create)  
[Consegna EventBridge tramite Amazon webhook](https://shopify.dev/apps/webhooks/configuration/eventbridge)  
[Access tokens for custom apps in the Shopify admin](https://shopify.dev/apps/auth/admin-app-access-tokens)  
[Product](https://shopify.dev/api/admin-rest/2021-10/resources/product#top)  
[Shopify Admin API](https://shopify.dev/api/admin)

## Splunk
<a name="api-destination-splunk"></a>

**URL dell'endpoint di invocazione della destinazione API**  
https://*SPLUNK\$1HEC\$1ENDPOINT*:*optional\$1port*/services/collector/raw

**Tipi di autorizzazione supportati**   
Base, Chiave API

**Parametri di autorizzazione aggiuntivi necessari**  
Nessuno

**Documentazione di Splunk**  
Per entrambi i tipi di autorizzazione, è necessario un ID token HEC. Per ulteriori informazioni, consulta [Set up and use HTTP Event Collector in Splunk Web](https://help.splunk.com/en/data-management/collect-http-event-data/use-hec-in-splunk-cloud-platform/set-up-and-use-http-event-collector-in-splunk-web).

**Operazioni API di uso comune**  
POST https://*SPLUNK\$1HEC\$1ENDPOINT*:*optional\$1port*/services/collector/raw

**Informazioni aggiuntive**  
Chiave API: quando si configura l'endpoint per EventBridge, il nome della chiave API è «Autorizzazione» e il valore è l'ID del token Splunk HEC.  
Basic (nome utente/password): quando si configura l'endpoint per EventBridge, il nome utente è «Splunk» e la password è l'ID del token Splunk HEC.

## Sumo Logic
<a name="api-destination-sumologic"></a>

**URL dell'endpoint di invocazione della destinazione API**  
Gli endpoint HTTP Log e Metric Source saranno diversi per ogni utente. URLs Per ulteriori informazioni, consulta [ HTTP Logs and Metrics Source](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/HTTP-Source).

**Tipi di autorizzazione supportati**   
Sumo Logic non richiede l'autenticazione per le relative origini HTTP perché nell'URL è presente una chiave univoca. Per questo motivo, devi assicurarti di trattare l'URL come segreto.  
Quando si configura la destinazione dell' EventBridge API, è richiesto un tipo di autorizzazione. Per soddisfare questo requisito, seleziona la chiave API e assegnale il nome di chiave "dummy-key" e un valore di chiave "dummy-value".

**Parametri di autorizzazione aggiuntivi necessari**  
Non applicabile

**Documentazione di Sumo Logic**  
Sumo Logicha già creato sorgenti ospitate per raccogliere log e metriche da molti AWS servizi e puoi utilizzare le informazioni sul loro sito Web per lavorare con tali fonti. Per ulteriori informazioni, consulta [Amazon Web Services](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/Amazon-Web-Services).  
Se stai generando eventi personalizzati da un'applicazione e desideri inviarli Sumo Logic come log o metriche, utilizza EventBridge API Destinations e gli endpoint Sumo Logic HTTP Log e Metric Source.  
+ Per effettuare la registrazione e creare un'istanza Sumo Logic gratuita, consulta [Start your free trial today](https://www.sumologic.com/sign-up/).
+ Per ulteriori informazioni sull'uso di Sumo Logic, consulta [HTTP Logs and Metrics Source](https://help.sumologic.com/03Send-Data/Sources/02Sources-for-Hosted-Collectors/HTTP-Source).

**Operazioni API di uso comune**  
POST v1/http/ https://endpoint4.collection.us2.sumologic.com/receiver/ *UNIQUE\$1ID\$1PER\$1COLLECTOR*

**Informazioni aggiuntive**  
Nessuno

## TriggerMesh
<a name="eb-api-destination-triggermesh"></a>

**URL dell'endpoint di invocazione della destinazione API**  
Utilizza le informazioni nell'argomento [Event Source for HTTP](https://docs.triggermesh.io/concepts/sources) per formulare l'URL dell'endpoint. L'URL di un endpoint include il nome dell'origine dell'evento e lo spazio dei nomi utente nel seguente formato:  
https://. *source-name* *user-namespace*.cloud.triggermesh.io  
Includi i parametri dell'autorizzazione Base nella richiesta all'endpoint.

**Tipi di autorizzazione supportati**   
Di base

**Parametri di autorizzazione aggiuntivi necessari**  
Nessuno

**Documentazione di TriggerMesh**  
[Event Source for HTTP](https://docs.triggermesh.io/concepts/sources)

**Operazioni API di uso comune**  
Non applicabile

**Informazioni aggiuntive**  
Nessuno

## Zendesk
<a name="eb-api-destination-zendesk"></a>

**URL dell'endpoint di invocazione della destinazione API**  
https://developer.zendesk.com/rest\$1api/docs/support/tickets

**Tipi di autorizzazione supportati**   
Base, Chiave API

**Parametri di autorizzazione aggiuntivi necessari**  
Nessuno

**Documentazione di Zendesk**  
[Security and Authentication](https://developer.zendesk.com/rest_api/docs/support/introduction#security-and-authentication)

**Operazioni API di uso comune**  
POST https:///*your\$1Zendesk\$1subdomain*api/v2/tickets

**Informazioni aggiuntive**  
Le richieste API EventBridge vengono conteggiate ai limiti delle API Zendesk. Per informazioni sui limiti di Zendesk per il tuo piano, consulta [Usage limits](https://developer.zendesk.com/rest_api/docs/support/usage_limits).   
Per proteggere meglio il tuo account e i tuoi dati, ti consigliamo di utilizzare una chiave API anziché l'autenticazione di base con credenziali di accesso.