Consulta i connettori supportati per Application Integration.

Trigger Cloud Pub/Sub

L'attivatore Cloud Pub/Sub ti consente di eseguire l'integrazione in base agli eventi nel middleware Pub/Sub.

Con questo trigger, puoi eseguire un'integrazione ogni volta che un publisher scrive un messaggio per l'argomento scelto. L'argomento può esistere nello stesso progetto Google Cloud dell'integrazione o in un altro progetto Google Cloud . Quando viene eseguito, questo attivatore scrive anche il messaggio pubblicato nella variabile di output CloudPubSubMessage. In base ai tuoi requisiti, puoi utilizzare questa variabile negli attivatori o nelle attività a valle.

Per scoprire come creare un'integrazione di esempio utilizzando l'Application Integration 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: non è necessario creare un abbonamento per il funzionamento dell'attivatore. L'Application Integration 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'Application Integration del 1° dicembre 2023, ti verranno addebitati gli abbonamenti in base alle tariffe di fatturazione di Pub/Sub. Gli abbonamenti per l'attivatore Cloud Pub/Sub esistente continueranno a funzionare come prima e non verranno fatturati. 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 ulteriori informazioni sulla gestione dell'accesso tramite i ruoli IAM, consulta Controllo dell'accesso.

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

Aggiungi un trigger 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 Integrazione delle applicazioni.

   Vai ad Application Integration

2. Nel menu di navigazione, fai clic su Integrations (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 di 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.

   Viene visualizzata l'integrazione nell'editor di integrazione.

4. Nella barra di navigazione dell'editor dell'integrazione, fai clic su Attivatori per visualizzare l'elenco degli attivatori disponibili.
5. Fai clic sull'elemento Trigger Cloud Pub/Sub e posizionalo nel designer.

Configurare un trigger Cloud Pub/Sub

Fai clic sull'elemento Trigger Cloud Pub/Sub nell'editor di integrazione per visualizzare il riquadro di configurazione dell'attivatore, 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 del tuo argomento Pub/Sub. L'argomento può trovarsi nello stesso progetto Google Cloud della tua integrazione o in un altro progetto Google Cloud .
2. Seleziona il 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 un indirizzo email dell'account di servizio con il 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'Application Integration 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 gli abbonamenti è 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 Concede 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 Service: [e-mail]	Editor Pub/Sub (roles/pubsub.editor) Utente dell'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 disporre del 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, l'attivatore Cloud Pub/Sub genera una variabile di output CloudPubSubMessage che puoi utilizzare nelle attività a valle. 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 questo comportamento di Pub/Sub, consulta la sezione Pubblicazione "almeno una volta". Pertanto, devi progettare l'integrazione in modo che sia idempotente, in modo da non consentire di scrivere un messaggio più volte in 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 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, 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

L'attivatore Cloud Pub/Sub dipende dal prodotto Pub/Sub. Poiché questa dipendenza è esterna all'Application Integration 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, consulta 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.