Eventos y activadores

En esta página, se describe el concepto de eventos en el contexto de Google Cloud Functions. También se explica cómo crear y asociar activadores con funciones para que se ejecuten cuando se activa un evento.

Eventos

Los eventos son procesos que ocurren en tu entorno de nube para los que se recomienda tomar medidas. Pueden ser cambios en la información de la base de datos, la adición de archivos a un sistema de almacenamiento o la creación de una nueva instancia de máquina virtual. Actualmente, Cloud Functions admite eventos de los siguientes proveedores:

Si deseas ver ejemplos de cómo asociar los activadores con las funciones para que se ejecuten cuando se activa un evento, consulta los instructivos.

Datos de eventos

Cuando un evento activa la ejecución de la función de Cloud Functions, los datos asociados con el evento se pasan mediante los parámetros de la función. El tipo de evento determina los parámetros que se pasan a tu función. Los eventos de solicitud HTTP activan las funciones de HTTP, y los demás tipos de eventos activan las funciones en segundo plano.

Node.js 8/10

En los entornos de ejecución de Node.js 8 y Node.js 10, las funciones toman los siguientes parámetros:

  • Funciones de HTTP

    A tu función se le pasan los parámetros de ExpressJS (request, response). Usa el parámetro response para enviar una respuesta.

  • Funciones en segundo plano

    A tu función se le pasan los parámetros (data, context, callback). Consulta Funciones en segundo plano para obtener más detalles sobre estos parámetros.

Node.js 6 (obsoleto)

En el entorno de ejecución de Node.js 6, las funciones toman los siguientes parámetros:

  • Funciones de HTTP

    A tu función se le pasan los parámetros de ExpressJS (request, response). Usa el parámetro response para enviar una respuesta.

  • Funciones en segundo plano

    A tu función se le pasan los parámetros (event, callback). Consulta Funciones en segundo plano para obtener más detalles sobre estos parámetros.

Python

En el entorno de ejecución de Python, las funciones toman los siguientes parámetros:

  • Funciones de HTTP

    A tu función se le pasa un solo parámetro, (request), que es un objeto Flask Request. Muestra cualquier valor de tu función que puede controlarse con el método Flask make_response. El resultado será la respuesta HTTP.

  • Funciones en segundo plano

    A tu función se le pasan los parámetros (data, context). Consulta Funciones en segundo plano para obtener más detalles sobre estos parámetros.

Go

En el entorno de ejecución de Go, las funciones tienen los siguientes parámetros:

Activadores

La creación de una respuesta a un evento se realiza con un activador. Un activador es una declaración de tu interés en un evento o conjunto de eventos determinado. Cuando vinculas una función con un activador, puedes capturar eventos y reaccionar a ellos.

A continuación, se muestra una tabla de los tipos de activadores admitidos y las marcas que se usan para especificarlos durante la implementación mediante línea de comandos.

Activador Marca de línea de comandos
HTTP --trigger-http
Google Cloud Storage --trigger-bucket BUCKET_NAME
Google Cloud Pub/Sub --trigger-topic TOPIC_NAME
Otras fuentes (p. ej., Firebase) --trigger-event EVENT_TYPE --trigger-resource RESOURCE

Para obtener más información sobre los marcadores de línea de comandos, consulta la referencia gcloud functions deploy.

La vinculación de activadores con funciones se produce en el momento de la implementación mediante la herramienta de línea de comandos de gcloud, la IU o la API de Cloud Functions. Las funciones y los activadores están vinculados entre sí sobre una base de varios a uno. En otras palabras, no puedes vincular la misma función a más de un activador a la vez. Sin embargo, puedes hacer que el mismo activador ejecute varias funciones. Para ello, simplemente implementa dos funciones diferentes con el mismo activador.

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...

Documentación de Cloud Functions