Déclencheurs HTTP (1re génération)

Dans Cloud Run Functions, un déclencheur HTTP permet à une fonction de s'exécuter en réponse aux requêtes HTTP(S). Lorsque vous spécifiez un déclencheur HTTP pour une fonction, une URL est attribuée à cette fonction pour la réception des requêtes. Les déclencheurs HTTP acceptent les méthodes de requête GET, POST, PUT, DELETE et OPTIONS.

Par défaut, les requêtes adressées à une fonction avec un déclencheur HTTP nécessitent une authentification. Vous pouvez choisir d'autoriser les appels non authentifiés pendant le déploiement. Pour en savoir plus, consultez la section Autoriser l'appel de fonctions HTTP sans authentification.

Utilisez des fonctions HTTP pour mettre en œuvre des fonctions Cloud Run capables de gérer des requêtes HTTP(S) générales.

Déploiement

Vous pouvez spécifier un déclencheur HTTP lorsque vous déployez une fonction. Consultez la page Déployer une fonction Cloud Run pour obtenir des instructions générales sur le déploiement d'une fonction. Consultez cette section pour obtenir des informations supplémentaires spécifiques à la configuration des déclencheurs HTTP lors du déploiement.

gcloud

Si vous déployez à l'aide de gcloud CLI, les options ci-dessous permettent de configurer les déclencheurs HTTP :

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • L'option --trigger-http indique que la fonction utilise un déclencheur HTTP.
  • L'option --allow-unauthenticated indique que la fonction peut être appelée sans authentification. Si vous omettez cette option, les appels à la fonction nécessitent une authentification. Pour en savoir plus, consultez la page Authentification pour l'appel.
  • L'option --security-level détermine si le point de terminaison de la fonction requiert HTTPS. La valeur secure-always signifie que HTTPS est requis et que les requêtes HTTP non-SSL ne sont pas acceptées. La valeur secure-optional signifie que HTTP et HTTPS sont tous deux acceptés. La valeur par défaut est secure-always.

Console

Si vous effectuez un déploiement à l'aide de la console Google Cloud, vous pouvez configurer un déclencheur HTTP dans la section Déclencheur.

  1. Dans le champ Trigger (Déclencheur), sélectionnez HTTP.
  2. Dans le champ Authentification, sélectionnez une option selon que vous souhaitez autoriser les appels non authentifiés de votre fonction. Par défaut, l'authentification est requise. Pour en savoir plus, consultez la page Authentification pour l'appel.
  3. Cochez ou décochez la case Exiger le protocole HTTPS pour déterminer si le point de terminaison de la fonction requiert HTTPS. Si cette option n'est pas sélectionnée, les protocoles HTTP et HTTPS sont tous deux acceptés.

URL de la fonction

Une fois votre fonction déployée avec un déclencheur HTTP, vous pouvez récupérer son URL attribuée.

Les fonctions Cloud Run ont des URL attribuées au format suivant. Ces URL ont un format déterministe, ce qui signifie que vous pouvez prédire l'URL avant de déployer la fonction :

https://REGION-PROJECT_ID.cloudfunctions.net/FUNCTION_NAME

Vous pouvez récupérer la ou les URL de votre fonction comme suit :

gcloud

  gcloud functions describe YOUR_FUNCTION_NAME 

  --format="value(httpsTrigger.url)"

Console

  1. Accédez à la page de présentation de Cloud Run Functions dans la console Google Cloud :

    Accéder aux fonctions Cloud Run

  2. Cliquez sur le nom de la fonction dont vous souhaitez récupérer l'URL.

  3. Cliquez sur l'onglet Modifier.

  4. Affichez l'URL de votre fonction dans la section Déclencheur.

Étapes suivantes