Trigger HTTP

Nelle funzioni di Cloud Run, un trigger HTTP consente l'esecuzione di una funzione in risposta a richieste HTTP(S). Quando specifichi un attivatore HTTP per una funzione, a questa viene assegnato un URL a cui può ricevere richieste. Gli trigger HTTP supportano i metodi di richiesta GET, POST, PUT, DELETE e OPTIONS.

Nelle funzioni di Cloud Run, le richieste all'URL di una funzione richiedono sempre HTTPS.

Per impostazione predefinita, le richieste a una funzione con un attivatore HTTP richiedono autenticazione. Puoi scegliere di consentire le chiamate non autenticate durante il deployment. Per saperne di più, consulta Consentire la chiamata delle funzioni HTTP non autenticate.

Utilizza le funzioni HTTP per implementare funzioni Cloud Run in grado di gestire richieste HTTP(S) generiche.

Deployment

Puoi specificare un trigger HTTP quando esegui il deployment di una funzione. Consulta: Esegui il deployment di una funzione Cloud Run per le istruzioni generali su come eseguire il deployment di una funzione, e questa sezione e ulteriori informazioni specifiche per la configurazione dei trigger HTTP durante il deployment.

gcloud

Se con gcloud CLI, i flag mostrati qui vengono usati per configurare i trigger HTTP:

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • Il --trigger-http flag specifica che la funzione utilizza un trigger HTTP.
  • Il --allow-unauthenticated flag specifica che la funzione può essere chiamata senza autenticazione. Se ometti questo flag, le chiamate alla funzione richiedono di autenticazione, che è l'impostazione predefinita. Consulta: Autenticazione per le chiamate per ulteriori informazioni.

Console

Se esegui il deployment utilizzando la console Google Cloud, puoi configurare un trigger HTTP nella sezione Trigger:

  • In HTTPS, nel campo Autenticazione, seleziona un'opzione in base a se vuoi consentire chiamate non autenticate della tua funzione. Per impostazione predefinita, l'autenticazione è obbligatoria. Per ulteriori informazioni, consulta Autenticare per l'invocazione.

URL funzione

Dopo il deployment della funzione con un trigger HTTP, puoi recuperarne all'URL assegnato.

Alle funzioni sono assegnati URL con il seguente formato. Questi URL hanno un formato deterministico, il che significa che puoi prevedere qual sarà l'URL prima di eseguire il deployment della funzione:

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

Le funzioni hanno anche un URL assegnato che è associato dal servizio Cloud Run sottostante. Questi URL non hanno un formato deterministico, il che significa che, poiché il secondo campo è un hash casuale, non puoi predire quale sarà l'URL prima di implementare la funzione. Una volta eseguita il deployment della funzione, l'URL rimarrà stabile, tuttavia:

https://FUNCTION_NAME-RANDOM_HASH-REGION.a.run.app

L'URL cloudfunctions.net e l'URL run.app di una funzione si comporteranno esattamente allo stesso modo. Sono intercambiabili.

Puoi recuperare gli URL della funzione nel seguente modo:

gcloud 

gcloud functions describe YOUR_FUNCTION_NAME \
--region=YOUR_FUNCTION_REGION \
--format="value(serviceConfig.uri)" \
...

Console

  1. Vai alla pagina Panoramica delle funzioni Cloud Run nella console Google Cloud:

    Vai alle funzioni Cloud Run

  2. Fai clic sul nome della funzione di cui vuoi recuperare l'URL.

  3. Fai clic sulla scheda Modifica.

  4. Visualizza l'URL della funzione nella sezione Trigger.

Passaggi successivi