Activadores HTTP

En Cloud Run Functions, un activador HTTP permite que una función se ejecute en respuesta a solicitudes HTTP(S). Cuando especificas un activador HTTP para una función, se le asigna una URL en la que puede recibir solicitudes. Los activadores HTTP admiten los métodos de solicitud GET, POST, PUT, DELETE y OPTIONS.

En Cloud Run Functions, las solicitudes a una URL de función siempre requieren HTTPS.

De forma predeterminada, las solicitudes a una función con un activador HTTP requieren autenticación. Puedes elegir permitir llamadas no autenticadas durante la implementación. Consulta Permite la invocación de funciones HTTP no autenticadas para obtener más información.

Usas funciones de HTTP para implementar Cloud Run Functions que pueden controlar solicitudes HTTP(S) generales.

Implementación

Puedes especificar un activador HTTP cuando implementes una función. Consulta Implementa una función de Cloud Run para obtener instrucciones generales acerca de cómo implementar una función y esta sección para obtener información adicional específica sobre la configuración de activadores HTTP durante la implementación.

gcloud

Si implementas mediante gcloud CLI, las marcas que se muestran a continuación se usan para configurar los activadores HTTP:

gcloud functions deploy YOUR_FUNCTION_NAME \
--trigger-http \
[--allow-unauthenticated] \
[--security-level=SECURITY_LEVEL] \
...
  • La marca --trigger-http especifica que la función usa un activador HTTP.
  • La marca --allow-unauthenticated especifica que se puede llamar a la función sin autenticación. Omitir esta marca significa que las llamadas a la función requieren autenticación, que es la configuración predeterminada. Consulta Autentica para la invocación a fin de obtener más información.

Console

Si realizas una implementación con la consola de Google Cloud, puedes configurar un activador HTTP en la sección Activador.

  • En HTTPS, en el campo Autenticación, selecciona una opción según si deseas permitir invocaciones no autenticadas de tu función. De forma predeterminada, se requiere autenticación. Consulta Autentica para la invocación para obtener más información.

URL de función

Después de implementar tu función con un activador HTTP, puedes recuperar su URL asignada.

A las funciones se les asignan URLs que tienen el siguiente formato. Estas URL tienen un formato determinista, lo que significa que puedes predecir cuál será la URL antes de implementar la función:

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

Las funciones también tienen una URL asignada que está asociada con el servicio subyacente de Cloud Run. Estas URLs no tienen un formato determinista, lo que significa que, debido a que el segundo campo es un hash aleatorio, no podrás predecir cuál será la URL antes de implementar la función. Sin embargo, una vez que implementes la función, la URL permanecerá estable:

https://FUNCTION_NAME-RANDOM_HASH-REGION.a.run.app

La URL cloudfunctions.net y la URL run.app de una función se comportarán de la misma manera. Son intercambiables.

Puedes recuperar las URLs de tu función de la siguiente manera:

gcloud 

gcloud functions describe YOUR_FUNCTION_NAME \
--region=YOUR_FUNCTION_REGION \
--format="value(serviceConfig.uri)" \
...

Console

  1. Ve a la página Descripción general de Cloud Run Functions en la consola de Google Cloud.

    Ve a las funciones de Cloud Run

  2. Haz clic en el nombre de la función cuya URL deseas recuperar.

  3. Haz clic en la pestaña Editar.

  4. Consulta la URL de tu función en la sección Activador.

Próximos pasos