Déclencheurs Cloud Functions

Vous pouvez configurer Cloud Functions pour qu'il s'exécute en réponse à divers scénarios en spécifiant un déclencheur pour votre fonction. Les déclencheurs peuvent être des requêtes HTTP(S) ou l'un des événements compatibles. Cette page présente les déclencheurs compatibles avec Cloud Functions.

De manière générale, les déclencheurs appartiennent à deux catégories:

• Les déclencheurs HTTP, qui réagissent aux requêtes HTTP(S) et correspondent aux fonctions HTTP.

• Les déclencheurs d'événements, qui réagissent aux événements au sein de votre projet Google Cloud et correspondent aux fonctions basées sur des événements.

Vous spécifiez des déclencheurs lors du déploiement de la fonction. Vous ne pouvez pas lier la même fonction à plusieurs déclencheurs à la fois, mais le même événement peut entraîner l'exécution de plusieurs fonctions en déployant plusieurs fonctions avec les mêmes paramètres de déclencheur.

Remarque : La liaison de déclencheur ne se produit pas instantanément. Le déclenchement d'une fonction déployée sur des événements entrants peut prendre plusieurs minutes.

Déclencheurs compatibles avec Cloud Functions (2e génération)

Cloud Functions (2e génération) est compatible avec les types de déclencheurs suivants:

• Déclencheurs HTTP
• Déclencheurs d'événements :
  • Déclencheurs Pub/Sub
  • Déclencheurs Cloud Storage
  • Déclencheurs Firestore
  • Déclencheurs Eventarc généralisés
    • Compatible avec tous les types d'événements compatibles avec Eventarc, y compris plus de 90 sources d'événements via Cloud Audit Logging

Toutes les fonctions basées sur des événements dans Cloud Functions (2e génération) utilisent Eventarc pour la diffusion d'événements. Dans Cloud Functions (2e génération), les déclencheurs Pub/Sub et Cloud Storage sont mis en œuvre en tant que types particuliers de déclencheurs Eventarc.

Remarque : Eventarc n'est actuellement pas compatible avec les événements directs de Google Analytics pour Firebase ou Firebase Authentication. Utilisez Cloud Functions (1re génération) pour utiliser ces événements.

Déclencheurs compatibles avec Cloud Functions (1re génération)

Cloud Functions (1re génération) est compatible avec les types de déclencheurs suivants:

• Déclencheurs HTTP
• Déclencheurs d'événements :
  • Déclencheurs Pub/Sub
  • Déclencheurs Cloud Storage
  • Déclencheurs Firestore
  • Déclencheurs Google Analytics pour Firebase
  • Déclencheurs Firebase Realtime Database
  • Déclencheurs Firebase Authentication
  • Déclencheurs Firebase Remote Config

Déclencheurs supplémentaires via Pub/Sub et les webhooks

Cloud Functions pouvant être déclenché par des messages sur un sujet Pub/Sub, vous pouvez intégrer Cloud Functions avec n'importe quel service Google compatible avec Pub/Sub en tant que bus d'événement. En outre, l'utilisation de déclencheurs HTTP vous permet également de les intégrer à tout service fournissant des rappels HTTP (webhooks). Les sections suivantes décrivent quelques exemples d'intégrations.

Cloud Logging

Cloud Logging peut acheminer les journaux vers un sujet Pub/Sub, où ils peuvent être utilisés par Cloud Functions. Pour en savoir plus, consultez la page Configurer et gérer les récepteurs dans la documentation Cloud Logging.

Cloud Scheduler

Les tâches Cloud Scheduler peuvent envoyer des messages à un sujet Pub/Sub, où ils peuvent ensuite être lus par Cloud Functions. Pour en savoir plus, consultez le tutoriel Cloud Scheduler Utiliser Pub/Sub pour déclencher une fonction Cloud Functions.

Cloud Tasks

Les tâches HTTP Target de Cloud Tasks vous permettent d'exécuter des gestionnaires de tâches sur n'importe quel point de terminaison HTTP. Vous pouvez donc utiliser une fonction Cloud Functions avec un déclencheur HTTP comme gestionnaire de tâches. Vous pouvez également utiliser des tâches pour limiter les appels de fonction. Consultez la section Créer des tâches HTTP Target dans la documentation Cloud Tasks pour en savoir plus.

Gmail

À l'aide de l'API Push Notification de Gmail, vous pouvez envoyer des événements Gmail à un sujet Pub/Sub et les utiliser avec Cloud Functions.