Trigger di Cloud Pub/Sub

Il trigger di Cloud Pub/Sub consente di eseguire l'integrazione in base agli eventi in il tuo middleware Pub/Sub.

Utilizzando questo attivatore, puoi eseguire un'integrazione ogni volta che un publisher scrive un messaggio all'argomento che hai scelto. Quando questo trigger viene eseguito, scrive anche il messaggio pubblicato in la variabile di output CloudPubSubMessage. In base ai tuoi requisiti, puoi utilizzare questa variabile negli attivatori o nelle attività downstream.

Prima di iniziare

Assicurati di eseguire le attività seguenti nel progetto Google Cloud prima di configurare il trigger di Cloud Pub/Sub.

  • Assegna i seguenti ruoli IAM all'account di servizio predefinito (service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com):
  • Verifica di avere un argomento Pub/Sub. Per creare un nuovo argomento Pub/Sub:
    1. Vai alla pagina degli argomenti Pub/Sub nella console Cloud.

      Vai alla pagina degli argomenti Pub/Sub

    2. Fai clic su Crea un argomento.
    3. Nel campo ID argomento, fornisci un nome univoco per l'argomento.
    4. Fai clic su Salva.
    di Gemini Advanced.

Per saperne di più sulla gestione degli accessi mediante i ruoli IAM, consulta Controllo dell'accesso.

Per informazioni sulla concessione dei ruoli alle entità, vedi Concessione, modifica e revoca dell'accesso.

Aggiungi un trigger di Cloud Pub/Sub

Per aggiungere un trigger di Cloud Pub/Sub a un'integrazione nuova o esistente, segui questi passaggi:
  1. Nell'UI di Apigee, seleziona la tua organizzazione Apigee.
  2. Fai clic su Sviluppo > Integrazioni.
  3. Seleziona un'integrazione esistente o creane una nuova facendo clic su Crea integrazione.

    Se stai creando una nuova integrazione:

    1. Inserisci un nome e una descrizione nella finestra di dialogo Crea integrazione.
    2. Seleziona una regione per l'integrazione dall'elenco delle regioni supportate.
    3. Fai clic su Crea.

    Viene aperta l'integrazione nel designer dell'integrazione.

  4. Nella barra di navigazione del designer dell'integrazione, fai clic su +Aggiungi un'attività/un attivatore > Trigger per visualizzare l'elenco degli attivatori disponibili.
  5. Fai clic sull'elemento trigger Cloud Pub/Sub e posizionalo nel designer.

configura un trigger di Cloud Pub/Sub

Fai clic sull'elemento Trigger Cloud Pub/Sub nell'editor dell'integrazione per visualizzare la configurazione del trigger ed eseguire le seguenti attività:

Specifica l'argomento che il trigger deve ascoltare nel campo Argomento Pub/Sub nel formato seguente:

projects/PROJECT_ID/topics/TOPIC_ID

Per visualizzare tutti gli argomenti disponibili nel tuo progetto Google Cloud, consulta la colonna Nome argomento in Argomenti.

Sostituisci quanto segue:

  • PROJECT_ID: il progetto Google Cloud in cui viene creato l'argomento.
  • TOPIC_ID: l'ID dell'argomento Pub/Sub.

Output trigger

Per ogni evento, il trigger di Cloud Pub/Sub genera una variabile di output CloudPubSubMessage che puoi utilizzare nelle attività downstream. La variabile è in formato JSON e ha il valore PubsubMessage alla struttura del centro di costo.

Considerazioni

  • La dimensione massima di un messaggio Pub/Sub è 10 MB. Per comprendere tutti i limiti di Pub/Sub, consulta Quote e limiti di Pub/Sub.
  • È possibile che Pub/Sub scriva lo stesso messaggio più di una volta in un argomento. Per comprendere il comportamento di Pub/Sub, consulta Consegna "at-least-Once". Pertanto, devi progettare l'integrazione in modo che sia idempotente in modo che non consenta scrivere più volte un messaggio su un argomento.

    Il campo message_id nell'intestazione del messaggio identifica in modo univoco un messaggio Pub/Sub.

  • Se annulli la pubblicazione di un'integrazione, la sottoscrizione Pub/Sub non viene eliminata per evitare la perdita di messaggi. Tuttavia, se elimini la versione pubblicata o tutte le versioni di integrazione di un'integrazione, viene eliminata anche la sottoscrizione Pub/Sub.

Quote e limiti

Per informazioni su quote e limiti, consulta Quote e limiti.

Passaggi successivi