Trigger HTTP (1ª gen.)

In Cloud Run Functions, un trigger HTTP consente a una funzione di essere eseguita in risposta a richieste HTTP(S). Quando specifichi un trigger HTTP per una funzione, alla funzione viene assegnato un URL in cui può ricevere richieste. I trigger HTTP supportano i metodi di richiesta GET, POST, PUT, DELETE e OPTIONS.

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

Utilizzi le funzioni HTTP per implementare funzioni Cloud Run Functions in grado di gestire richieste HTTP(S) generali.

Deployment

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

gcloud

Se esegui il deployment utilizzando gcloud CLI, i flag mostrati qui vengono utilizzati per configurare i trigger HTTP:

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • Il flag --trigger-http specifica che la funzione utilizza un trigger HTTP.
  • Il flag --allow-unauthenticated specifica che la funzione può essere chiamata senza autenticazione. Se ometti questo flag, le chiamate alla funzione richiedono l'autenticazione. Per saperne di più, consulta Autenticazione per le chiamate.
  • Il flag --security-level controlla se l'endpoint della funzione richiede HTTPS. Il valore secure-always indica che è richiesto HTTPS e le richieste HTTP non SSL non sono supportate. Il valore secure-optional indica che sono supportate sia le richieste HTTP che HTTPS. Il valore predefinito è secure-always.

Console

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

  1. Nel campo Tipo di trigger, seleziona HTTP.
  2. Nel campo Autenticazione, seleziona un'opzione a seconda che tu voglia consentire chiamate non autenticate della tua funzione. Per impostazione predefinita, l'autenticazione è obbligatoria. Per saperne di più, consulta Autenticazione per le chiamate.
  3. Seleziona o deseleziona la casella di controllo Richiedi HTTPS per controllare se l'endpoint della funzione richiede HTTPS. Se deselezionata, sono supportate sia le richieste HTTP che HTTPS.

URL della funzione

Dopo il deployment della funzione con un trigger HTTP, puoi recuperare l'URL assegnato.

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

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

Puoi recuperare gli URL della tua funzione nel seguente modo:

gcloud 

  gcloud functions describe YOUR_FUNCTION_NAME 

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

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