Trigger HTTP (1ª generazione.)

Nelle funzioni Cloud Run, un attivatore HTTP consente di eseguire una funzione in risposta alle richieste HTTP(S). Quando specifichi un attivatore HTTP per una funzione, a questa viene assegnato un URL a cui può ricevere richieste. Gli attivatori 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 authentication. Puoi scegliere di consentire le chiamate non autenticate durante il deployment. Consulta: Consentire la chiamata a funzione HTTP non autenticata per ulteriori informazioni.

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 esegui il deployment utilizzando l'interfaccia a riga di comando gcloud, i flag mostrati qui vengono utilizzati per configurare gli attivatori HTTP:

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • La --trigger-http 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 l'autenticazione. Per ulteriori informazioni, consulta Autenticazione per l'invocazione.
  • Il flag --security-level controlla se l'endpoint della funzione richiede HTTPS. Il valore secure-always indica che è necessario il protocollo HTTPS e le richieste HTTP non SSL non sono supportati. Il valore secure-optional indica che sono supportati sia HTTP sia HTTPS. Il valore predefinito è secure-always.

Console

Se tramite 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 se vuoi consentire chiamate non autenticate della funzione. Per impostazione predefinita, l'autenticazione è obbligatoria. Consulta: Autenticazione per le chiamate per ulteriori informazioni.
  3. Seleziona o deseleziona la casella di controllo Richiedi HTTPS per controllare se l'endpoint della funzione richiede HTTPS. Se deselezionata, sia HTTP che Sono supportati i protocolli HTTPS.

URL funzione

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

Alle funzioni Cloud Run 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

Puoi recuperare gli URL della 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 Attivazione.

Passaggi successivi