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

# 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 utilizzando Enhanced Builder](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).