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, a dicha 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 de HTTP no autenticadas para obtener más información.

Usas funciones de HTTP para implementar Cloud Run Functions que puedan 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 con la 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 si deseas 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. La configuración predeterminada es secure-always.

Consola

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

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

URL de la función

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

Cloud Run Functions tienen URLs asignadas con el siguiente formato. Estas URLs tienen un formato determinístico, 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)"

Consola

  1. Ve a la página Resumen de Cloud Run Functions en la consola de Google Cloud .

    Ir a Cloud Run Functions

  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