Trigger di Cloud Functions (2ª generazione.)

Nota: questi contenuti si applicano solo a Cloud Functions (2nd gen). Per ulteriori informazioni, consulta il confronto delle versioni di Cloud Functions.

Per la versione 1ª generazione. di questo documento, consulta Trigger di Cloud Functions (1ª generazione.).

Puoi configurare l'esecuzione di Cloud Functions in risposta a vari scenari specificando un trigger per la tua funzione. I trigger possono essere richieste HTTP(S) o uno di una serie di eventi supportati. Questa pagina fornisce una panoramica degli attivatori supportati da Cloud Functions.

In generale, gli attivatori rientrano in due categorie:

• Trigger HTTP, che reagiscono alle richieste HTTP(S) e corrispondono alle funzioni HTTP.

• Trigger di eventi, che reagiscono agli eventi all'interno del tuo progetto Google Cloud e corrispondono alle funzioni basate su eventi.

Puoi specificare i trigger come parte del deployment delle funzioni. Non puoi associare la stessa funzione a più di un trigger alla volta, ma puoi fare in modo che lo stesso evento provochi l'esecuzione di più funzioni eseguendo il deployment di più funzioni con le stesse impostazioni di trigger.

Nota: l'associazione dell'attivatore non avviene immediatamente. Potrebbero essere necessari diversi minuti prima che una funzione di cui è stato eseguito il deployment inizi l'attivazione per gli eventi in entrata.

Trigger supportati

Cloud Functions supporta i seguenti tipi di trigger:

• Trigger HTTP
• Trigger di eventi:
  • Trigger di Pub/Sub
  • Trigger di Cloud Storage
  • Trigger di Firestore
  • Trigger Eventarc generalizzati
    • Supporta qualsiasi tipo di evento supportato da Eventarc, tra cui oltre 90 origini di eventi tramite Cloud Audit Logs

Tutte le funzioni basate su eventi utilizzano Eventarc per la distribuzione degli eventi. I trigger di Pub/Sub e di Cloud Storage sono implementati come particolari tipi di trigger Eventarc.

Nota: Eventarc al momento non supporta gli eventi diretti di Google Analytics for Firebase o di Firebase Authentication.

Trigger aggiuntivi tramite Pub/Sub e webhook

Poiché Cloud Functions può essere attivato da messaggi su un argomento Pub/Sub, puoi integrare Cloud Functions con qualsiasi altro servizio Google che supporti Pub/Sub come bus di eventi. Inoltre, utilizzando i trigger HTTP puoi anche eseguire l'integrazione con qualsiasi servizio che fornisce callback HTTP (webhook). Le seguenti sezioni descrivono alcuni esempi di integrazioni.

Cloud Logging

Cloud Logging può instradare i log a un argomento Pub/Sub, dove potranno essere utilizzati da Cloud Functions. Per ulteriori informazioni, consulta Configurare e gestire i sink nella documentazione di Cloud Logging.

Cloud Scheduler

Puoi pianificare una funzione Cloud Functions HTTP creando un job Cloud Scheduler che attiva un'azione tramite HTTP. Per ulteriori informazioni, nella documentazione di Cloud Scheduler, consulta Pianificare una funzione Cloud Functions HTTP.

Puoi pianificare una funzione basata su eventi quando la tua funzione deve essere attivata direttamente in risposta a eventi all'interno del tuo progetto Google Cloud, ad esempio quando un messaggio viene pubblicato in un argomento Pub/Sub. Per ulteriori informazioni, nella documentazione di Cloud Scheduler, consulta Pianificare una funzione Cloud Functions basata su eventi.

Cloud Tasks

Le attività di destinazione HTTP di Cloud Tasks consentono di eseguire gestori di attività su qualsiasi endpoint HTTP, pertanto una Cloud Function con un trigger HTTP può essere utilizzata come gestore di attività. Puoi utilizzare le attività anche per limitare le chiamate alle funzioni di limitazione della frequenza. Per ulteriori informazioni, consulta Creare attività di destinazione HTTP nella documentazione di Cloud Tasks.

Gmail

Utilizzando l'API Notifiche push di Gmail, puoi inviare eventi Gmail a un argomento Pub/Sub e utilizzarli con Cloud Functions.