Trigger HTTP (1ª generazione.)

In Cloud Functions, un trigger HTTP consente l'esecuzione di una funzione in risposta a richieste HTTP(S). Quando specifichi un trigger HTTP per una funzione, la funzione viene assegnato un URL al quale può ricevere le richieste. I trigger HTTP supportano 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 consentire chiamate non autenticate durante il deployment. Consulta Consentire la chiamata a funzione HTTP non autenticata per ulteriori informazioni.

Puoi utilizzare le funzioni HTTP per implementare Cloud Functions in grado di gestire le 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 Functions 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] \
...
  • La --trigger-http specifica che la funzione utilizza un trigger HTTP.
  • La --allow-unauthenticated specifica che la funzione può essere chiamata senza autenticazione. Se ometti questo flag, le chiamate alla funzione richiedono autenticazione. Consulta Autenticazione per le chiamate per ulteriori informazioni.
  • La --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 sia HTTP che HTTPS sono supportati. 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 in base a se vuoi consentire chiamate non autenticate dei tuoi personalizzata. 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.

Cloud Functions hanno URL assegnati con le seguenti caratteristiche: formato. Questi URL hanno un formato deterministico, il che significa che puoi prevedere come sarà l'URL prima di eseguire il deployment della funzione:

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

Puoi recuperare l'URL o gli URL della funzione come segue:

gcloud 

  gcloud functions describe YOUR_FUNCTION_NAME 

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

Console

  1. Vai alla pagina Panoramica di Cloud Functions nella console Google Cloud:

    Vai a Cloud Functions

  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