Consulta i connettori supportati per Application Integration.

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. L'argomento può trovarsi nello stesso progetto Google Cloud dell'integrazione oppure in un altro progetto Google Cloud. 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.

Per scoprire come creare un'integrazione di esempio utilizzando l'integrazione di applicazioni e l'trigger Cloud Pub/Sub, consulta Ascolta l'argomento Cloud Pub/Sub e invia un'email.

Prima di iniziare

Prima di configurare l'attivatore Cloud Pub/Sub, assicurati di eseguire le seguenti attività nel tuo progetto Google Cloud.

• Assegna il ruolo Project IAM Admin (roles/resourcemanager.projectIamAdmin) all'utente che crea questo trigger.
• Abilita l'API Pub/Sub per il progetto Google Cloud che contiene l'integrazione.
• 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.
  Nota: per il funzionamento del trigger non è necessario creare un abbonamento. L'integrazione delle applicazioni crea automaticamente una sottoscrizione per un argomento quando pubblichi l'integrazione e puoi visualizzare tutte le tue sottoscrizioni nella pagina delle sottoscrizioni Pub/Sub.

  A partire dalla release dell'integrazione delle applicazioni del 1° dicembre 2023, ti verranno addebitati gli abbonamenti in base alle tariffe di fatturazione di Pub/Sub. Sottoscrizioni per il trigger Cloud Pub/Sub esistente continuerà a funzionare come prima e non verrà addebitato alcun costo. Tuttavia, se aggiorni l'argomento di un trigger Cloud Pub/Sub esistente, la fatturazione Pub/Sub verrà applicata all'trigger Cloud Pub/Sub aggiornato.

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

Per informazioni sulla concessione dei ruoli alle entità, consulta Concedere, modificare e revocare l'accesso.

Aggiungi un trigger di Cloud Pub/Sub

Per aggiungere un trigger Cloud Pub/Sub a un'integrazione nuova o esistente, segui questi passaggi:

1. Nella console Google Cloud, vai alla pagina Application Integration.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrazioni.

   Viene visualizzata la pagina Elenco integrazioni, che elenca tutte le integrazioni disponibili nel progetto Google Cloud.

3. Seleziona un'integrazione esistente o fai clic su Crea integrazione per crearne una nuova.

   Se stai creando una nuova integrazione:

   1. Inserisci un nome e una descrizione nel riquadro Crea integrazione.
   2. Seleziona una regione per l'integrazione.
      Nota: il menu a discesa Regioni elenca solo le regioni di cui è stato eseguito il provisioning nel progetto Google Cloud. Per eseguire il provisioning di una nuova regione, fai clic su Attiva regione. Per ulteriori informazioni, consulta Attivare una nuova regione.
   3. Seleziona un account di servizio per l'integrazione. Puoi modificare o aggiornare i dettagli dell'account di servizio di un'integrazione in qualsiasi momento dal riquadro Riepilogo dell'integrazione nella barra degli strumenti dell'integrazione.
      Nota: l'opzione per selezionare un account di servizio viene visualizzata solo se hai attivato la governance dell'integrazione per la regione selezionata.
   4. Fai clic su Crea.

   L'integrazione viene aperta nell'editor dell'integrazione.

4. Nella barra di navigazione dell'editor di integrazione, fai clic su 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 di integrazione per visualizzare il riquadro di configurazione del trigger, quindi svolgi le seguenti attività:

1. Specifica l'argomento che l'attivatore deve ascoltare nel campo Argomento Pub/Sub nel seguente formato:

   projects/PROJECT_ID/topics/TOPIC_ID

   Per visualizzare tutti gli argomenti disponibili nel tuo progetto Google Cloud, consulta la colonna Nome argomento in Argomenti. Puoi anche selezionare un argomento da un altro progetto Google Cloud.

   Sostituisci quanto segue:
   • PROJECT_ID: il progetto Google Cloud in cui è stato creato l'argomento.
   • TOPIC_ID: l'ID dell'argomento Pub/Sub. L'argomento può trovarsi nello stesso progetto Google Cloud della tua integrazione o in un altro progetto Google Cloud.
2. Seleziona l'account di servizio che vuoi utilizzare per richiamare l'integrazione. Puoi anche scegliere una variabile di configurazione che hai creato nell'integrazione. Il valore della variabile di configurazione deve essere l'indirizzo email di un account di servizio nel seguente formato: [e-mail]. Ad esempio: [e-mail].

   Per informazioni su come creare una variabile di configurazione, vedi Creare una variabile e su come creare un account di servizio, vedi Creare un account di servizio.

   Se scegli una variabile di configurazione, devi concedere i ruoli richiesti all'account di servizio a cui fa riferimento la variabile di configurazione. Per ulteriori informazioni su come concedere i ruoli, consulta Ruoli IAM richiesti.

   Se non sono presenti account di servizio, creane uno facendo clic su Crea nuovo. nell'elenco Account di servizio.

   Nota: a partire dalla release dell'integrazione delle applicazioni del 1° dicembre 2023, quando configuri l'attivatore Cloud Pub/Sub, devi specificare un account di servizio per l'attivatore. Gli attivatori Pub/Sub esistenti a cui non è associato alcun account servizio continueranno a funzionare come prima. Tuttavia, se vuoi modificare uno degli attivatori Pub/Sub esistenti, devi configurare un account di servizio per continuare a utilizzarli.

Per impostazione predefinita, l'opzione del periodo di scadenza per le iscrizioni è impostata su never expire. Se vuoi impostare la scadenza su un altro valore, nella console Google Cloud vai alla pagina dell'abbonamento Pub/Sub e modifica l'abbonamento.

Ruoli IAM richiesti per gli account di servizio

Se fai clic su Concedi quando selezioni un account di servizio, vengono assegnati automaticamente i seguenti ruoli ai vari account di servizio.

Service account	Ruolo IAM concesso
Account di servizio predefinito di Application Integration: [e-mail]	Editor Pub/Sub (roles/pubsub.editor) Utente account di servizio (roles/iam.serviceAccountUser) Se il progetto Google Cloud dell'argomento Pub/Sub è diverso dal progetto Google Cloud dell'integrazione, l'account di servizio predefinito deve avere il ruolo Editor Pub/Sub nel progetto Google Cloud dell'argomento.
Account di servizio selezionato per questo trigger	Application Integration Invoker (roles/integrations.integrationInvoker)

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 la struttura PubsubMessage.

Considerazioni

• La dimensione massima di un messaggio Pub/Sub è 10 MB. Per comprendere tutte le limitazioni 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 un messaggio su un argomento più di una volta.

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

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

Creare una sottoscrizione con filtro per l'integrazione

Se vuoi impostare un filtro per l'abbonamento Pub/Sub in modo che elabori eventi specifici nell'integrazione:

1. Pubblica l'integrazione con l'trigger Cloud Pub/Sub configurato. Questo passaggio crea l'abbonamento nel progetto di integrazione.
2. Nella console Google Cloud, vai alla pagina Abbonamenti.

   Vai ad Abbonamenti

3. Apri l'abbonamento e copia tutti i dettagli, incluso il nome.
4. Elimina l'abbonamento esistente.
5. Crea un nuovo abbonamento con tutti i dettagli dell'abbonamento eliminato, incluso il nome dell'abbonamento che hai copiato nel passaggio 3, e aggiungi un filtro nel nuovo abbonamento.

   L'iscrizione appena creata attiva l'integrazione con i messaggi filtrati.

Esclusioni SLA

Il trigger di Cloud Pub/Sub dipende da Pub/Sub prodotto. Poiché questa dipendenza è esterna all'integrazione dell'applicazione, i termini e le condizioni dell'Accordo sul livello del servizio (SLA) per l'integrazione dell'applicazione sono applicabili solo quando l'attivatore Cloud Pub/Sub avvia correttamente l'esecuzione di un'integrazione active.

Prezzi

L'attivatore Cloud Pub/Sub e l'attivatore Salesforce non richiedono la creazione di un connettore. Tuttavia, se utilizzi l'attività Connettori per connetterti a Pub/Sub o Salesforce, ti verrà addebitato l'utilizzo del connettore. Per informazioni sui prezzi, vedi Prezzi di Application Integration.

Quote e limiti

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

Passaggi successivi

• Scopri di più su tutte le attività e gli attivatori.
• Scopri come testare e pubblicare un'integrazione.
• Scopri di più sulla gestione degli errori.
• Scopri di più sui log di esecuzione dell'integrazione.