Trigger HTTP (1ª generazione.)
In Cloud Functions, un trigger HTTP consente l'esecuzione di una funzione in risposta alle richieste HTTP(S). Quando specifichi un trigger HTTP per una funzione, alla funzione viene assegnato un URL a 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 le chiamate non autenticate durante il deployment. Per ulteriori informazioni, consulta Consentire la chiamata a funzione HTTP non autenticata.
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 Eseguire il deployment di una funzione Cloud Functions per istruzioni generali su come eseguire il deployment di una funzione e questa sezione per ulteriori informazioni specifiche sulla configurazione dei trigger HTTP durante il deployment.
gcloud
Se stai eseguendo il deployment utilizzando gcloud CLI, i flag mostrati qui sono utilizzati per configurare i trigger HTTP:
gcloud functions deploy YOUR_FUNCTION_NAME \ --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 ulteriori informazioni, consulta Autenticazione per le chiamate. - Il flag
--security-level
consente di stabilire se l'endpoint della funzione richiede HTTPS. Il valoresecure-always
indica che HTTPS è obbligatorio e le richieste HTTP non SSL non sono supportate. Il valoresecure-optional
indica che sono supportati sia 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:
- Nel campo Tipo di trigger, seleziona HTTP.
- Nel campo Autenticazione, seleziona un'opzione che dipende da se vuoi consentire chiamate non autenticate della tua funzione. Per impostazione predefinita, l'autenticazione è obbligatoria. Per ulteriori informazioni, consulta la sezione Autenticazione per le chiamate.
- Seleziona o deseleziona la casella di controllo Richiedi HTTPS per controllare se l'endpoint della funzione richiede HTTPS. Se questa opzione è deselezionata, sono supportati sia HTTP che HTTPS.
URL funzione
Dopo il deployment della funzione con un trigger HTTP, puoi recuperare l'URL che ti è stato assegnato.
Cloud Functions ha URL assegnati con il formato seguente. 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 l'URL o gli URL della funzione come segue:
gcloud
gcloud functions describe YOUR_FUNCTION_NAME
--format="value(httpsTrigger.url)"
Console
Vai alla pagina Panoramica di Cloud Functions nella console Google Cloud:
Fai clic sul nome della funzione di cui vuoi recuperare l'URL.
Fai clic sulla scheda Modifica.
Visualizza l'URL della funzione nella sezione Trigger.
Passaggi successivi
- Scopri come scrivere funzioni HTTP.
- Scopri come eseguire il deployment di una funzione Cloud Functions.
- Vedi il tutorial sulle funzioni HTTP per un esempio di scrittura, deployment e chiamata di una funzione HTTP.