Activadores HTTP (1.ª gen.)

En las funciones de Cloud Run, 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 permitir llamadas sin autenticar durante la implementación. Consulta más información en el artículo sobre permitir la invocación de funciones HTTP no autenticadas.

Puedes usar funciones HTTP para implementar funciones de Cloud Run que puedan gestionar solicitudes HTTP(S) generales.

Implementación

Puedes especificar un activador HTTP al desplegar una función. Consulta las instrucciones generales para desplegar una función de Cloud Run y esta sección para obtener información adicional específica sobre cómo configurar activadores HTTP durante el despliegue.

gcloud

Si despliega con la CLI de gcloud, las marcas que se muestran aquí 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. Si se omite esta marca, las llamadas a la función requerirán autenticación. Consulta Autenticación para la invocación para obtener más información.
  • La marca --security-level controla si el endpoint de la función requiere HTTPS. El valor secure-always significa que se requiere HTTPS y que no se admiten solicitudes HTTP no SSL. El valor secure-optional significa que se admiten tanto HTTP como HTTPS. El valor predeterminado es secure-always.

Consola

Si despliega mediante la Google Cloud consola, puede configurar un activador HTTP en la sección Activador:

  1. En el campo Tipo de activador, selecciona HTTP.
  2. En el campo Authentication (Autenticación), selecciona una opción en función de si quieres permitir invocaciones no autenticadas de tu función. De forma predeterminada, se requiere autenticación. Consulta Autenticación para la invocación para obtener más información.
  3. Marca o desmarca la casilla Require HTTPS (Requerir HTTPS) para controlar si el endpoint de la función requiere HTTPS. Si se desmarca, se admiten tanto HTTP como HTTPS.

URL de la función

Una vez que hayas desplegado tu función con un activador HTTP, podrás obtener la URL asignada.

Las funciones de Cloud Run tienen URLs asignadas con el siguiente formato. Estas URLs 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)"

Consola

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

    Ir a Cloud Run Functions

  2. Haz clic en el nombre de la función cuya URL quieras obtener.

  3. Haz clic en la pestaña Editar.

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

Pasos siguientes