Activadores HTTP (1ª gen.)

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.

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 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 \
--no-gen2 \
--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. Consulta Autentica para la invocación a fin de obtener más información.
  • La marca --security-level controla si el extremo de la función requiere HTTPS. El valor secure-always significa que se requiere HTTPS y que no se admiten solicitudes HTTP que no sean SSL. El valor secure-optional significa que se admite HTTP y HTTPS. El valor predeterminado es secure-always.

Console

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

  1. En el campo Activador, selecciona HTTP.
  2. 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 a fin de obtener más información.
  3. Selecciona o desmarca la casilla de verificación Requerir HTTPS para controlar si el extremo de la función requiere HTTPS. Si no se selecciona, se admite HTTP y HTTPS.

URL de función

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

Cloud Run Functions tienen asignadas URL con 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

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

gcloud 

  gcloud functions describe YOUR_FUNCTION_NAME 

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

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