Activadores de Cloud Storage (1ª gen.)

En Cloud Run Functions, un activador de Cloud Storage permite que se llame a una función en respuesta a los cambios en Cloud Storage. Cuando especificas un activador de Cloud Storage para una función, eliges un tipo de evento y especificas un bucket de Cloud Storage. Se llamará a tu función cada vez que se produzca un cambio en un objeto (archivo) dentro del bucket especificado.

Se admiten los siguientes tipos de eventos de Cloud Storage:

Evento Tipo de evento Descripción
Objeto finalizado
  • google.storage.object.finalize
 Ocurre cuando se crea un objeto nuevo o se reemplaza un objeto existente y se crea una generación nueva de ese objeto.
Objeto borrado
  • google.storage.object.delete
 Ocurre cuando un objeto se borra de forma permanente. Para obtener más información, consulta Borra de forma no definitiva.
Objecto archivado
  • google.storage.object.archive
 Ocurre cuando una versión publicada de un objeto se convierte en una versión no actual. Para obtener más información, consulta Control de versiones de objetos.
Metadatos de objetos actualizados
  • google.storage.object.metadataUpdate
 Se envía cuando cambian los metadatos de un objeto existente.

Para que una función use un activador de Cloud Storage, debe implementarse como una función controlada por eventos:

El repositorio de Eventos de Google contiene recursos adicionales para trabajar con datos de eventos.

Implementación

Puedes especificar un activador de Cloud Storage cuando implementes una función. Consulta Implementa una función de Cloud Run para obtener instrucciones generales sobre cómo implementar una función y, además, consulta la siguiente información adicional que está destinada específicamente a la configuración de activadores de Cloud Storage durante la implementación.

gcloud

Si implementas con gcloud CLI, puedes usar el tipo de evento Objeto finalizado de Cloud Storage con las siguientes marcas:

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-bucket=YOUR_STORAGE_BUCKET \
[--retry] \
...
  • La marca --trigger-bucket especifica el bucket de Cloud Storage que supervisará el activador. Los eventos Objeto finalizado dentro de este bucket activarán llamadas a tu función.
  • La marca --retry controla si se reintentan automáticamente las llamadas a funciones con errores. Consulta Reintenta las funciones controladas por eventos para obtener más información.

Para usar tipos de eventos que no sean Objeto finalizado, usa las siguientes marcas:

  gcloud functions deploy YOUR_FUNCTION_NAME 

  --no-gen2 

  --trigger-event=EVENT_TYPE 

  --trigger-resource=YOUR_STORAGE_BUCKET 

  ...

Eventos heredados de Cloud Storage

Las funciones heredadas en Cloud Run Functions (1ª gen.) usan notificaciones de cambio de objeto heredadas para los activadores de Cloud Storage:

gcloud functions deploy YOUR_FUNCTION_NAME \
--no-gen2 \
--trigger-event=providers/cloud.storage/eventTypes/object.change \
--trigger-resource=YOUR_STORAGE_BUCKET \
...

Este tipo de evento es compatible con funciones heredadas que ya consumen estos eventos. Sin embargo, no recomendamos usar este tipo de evento porque podría quitarse en una fecha futura.

Consola

Si haces una implementación con la consola de Google Cloud , puedes configurar un activador de Cloud Storage en la sección Activador:

  1. En el campo Tipo de activador, elige Cloud Storage.
  2. En el campo Tipo de evento, elige un tipo de evento.
  3. En el campo Bucket , haz clic en Explorar para elegir un bucket de Cloud Storage y que el activador lo supervise. Los cambios en los objetos dentro de este bucket activarán llamadas a tu función.
  4. Elige o anula la selección de la casilla de verificación Volver a intentar en caso de error para controlar si las llamadas a funciones con errores se reintentan automáticamente. Consulta Reintenta las funciones controladas por eventos para obtener más información.

Entrega de eventos

Los activadores de Cloud Storage se implementan con las notificaciones de Pub/Sub para Cloud Storage. Los eventos están sujetos a las garantías de entrega de notificaciones de Pub/Sub.

Un bucket de Cloud Storage puede tener hasta 10 parámetros de configuración de notificación definidos para activarse con un evento específico. Si superas los límites de notificaciones del bucket, se producirá un error como el siguiente cuando se implementen más funciones:

Cloud Storage bucket ...: Pub/Sub notification limit reached

Puedes solucionar esta limitación administrando tu propio tema de Pub/Sub y registrándolo para las notificaciones de Cloud Storage del tipo al que quieres que responda tu función. Por ejemplo, puedes configurar una sola notificación para el evento que elijas (como la creación de objetos) en un tema de Pub/Sub. Luego, ten tantos suscriptores de funciones como sean necesarios para que el tema procese el evento y lo distribuya a varios destinos. Por ejemplo:

  1. Crea tu propio tema de Pub/Sub.
  2. Crea una sola configuración de notificación en tu bucket de Cloud Storage que se active con un evento específico (como OBJECT_FINALIZE para la creación de objetos) y envíe el evento a tu único tema de Pub/Sub.
  3. Crea una o más funciones activadas por tu tema de Pub/Sub.

Consulta Cuotas y límites de Cloud Storage para obtener más información sobre las limitaciones de Cloud Storage.

Próximos pasos