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 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
.
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 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 funzioni Cloud Run 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 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] \ ...
- 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, che è l'impostazione predefinita. Consulta: Autenticazione per le chiamate per ulteriori informazioni.
Console
Se tramite la console Google Cloud, puoi configurare un trigger HTTP nella sezione Trigger:
- In HTTPS, nel campo Autenticazione, seleziona un'opzione a seconda che tu voglia consentire le chiamate non autenticate la tua funzione. Per impostazione predefinita, l'autenticazione è obbligatoria. Consulta: Autenticazione per la chiamata per ulteriori informazioni.
URL funzione
Dopo il deployment della funzione con un trigger HTTP, puoi recuperarne all'URL assegnato.
Le funzioni 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
Le funzioni hanno anche un URL assegnato che è associato dal servizio Cloud Run sottostante. Questi URL non hanno una proprietà deterministica , ovvero poiché il secondo campo è un hash casuale, non puoi prevedere quale sarà l'URL prima di eseguire il deployment della funzione. Una volta eseguito il deployment 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 in
esattamente allo stesso modo. Sono intercambiabili.
Puoi recuperare l'URL o gli URL della funzione come segue:
gcloud
gcloud functions describe YOUR_FUNCTION_NAME \ --region=YOUR_FUNCTION_REGION \ --format="value(serviceConfig.uri)" \ ...
Console
Vai alla pagina di riepilogo delle funzioni di Cloud Run 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 Run.
- Consulta il tutorial sulle funzioni HTTP per esempio di scrittura, deployment e chiamata di una funzione HTTP.