Suscripciones a Cloud Storage

Una suscripción a Cloud Storage es un tipo de suscripción de exportación que escribe mensajes en un bucket de Cloud Storage existente como en los que se reciben. No es necesario que configures otro cliente suscriptor. Usa la consola de Google Cloud, Google Cloud CLI, las bibliotecas cliente o la API de Pub/Sub para crear, actualizar, enumerar, desconectar o borrar suscripción a Cloud Storage.

Sin el tipo de suscripción a Cloud Storage, necesitas una suscripción de extracción o de envío y un suscriptor (como Dataflow) que lee los mensajes y los escribe en un bucket de Cloud Storage. La sobrecarga de ejecutar un El trabajo de Dataflow no es necesario cuando los mensajes no requieren procesamiento adicional antes de almacenarlos en un bucket de Cloud Storage puedes usar una suscripción a Cloud Storage.

Sin embargo, aún se recomienda una canalización de Dataflow para Sistemas de Pub/Sub en los que se requiere cierta transformación de datos antes de que los datos se almacenen en un bucket de Cloud Storage.

Para aprender a transmitir datos de Pub/Sub a Cloud Storage con transformación a través de Dataflow, consulta Transmite mensajes desde Pub/Sub mediante Dataflow.

Antes de comenzar

Antes de leer este documento, asegúrate de estar familiarizado con la siguiente información:

Flujo de trabajo de las suscripciones a Cloud Storage

En la siguiente imagen, se muestra el flujo de trabajo entre una Cloud Storage suscripción y Cloud Storage.

Flujo de mensajes para una suscripción a Cloud Storage

Figura 1. Flujo de trabajo para una suscripción a Cloud Storage

Esta es una breve descripción del flujo de trabajo que hace referencia a la Figura 1:

  1. Pub/Sub usa la API de Cloud Storage para enviar datos al bucket de Cloud Storage. Después de completar con éxito un de escritura, la API muestra una respuesta OK.

  2. Los mensajes se envían por lotes al bucket de Cloud Storage. Un solo lote corresponde a un objeto que se almacena en la bucket de Cloud Storage. Puedes establecer la configuración de los lotes según el tamaño del objeto y el tiempo transcurrido desde que se creó.

  3. El flujo de trabajo para escribir un objeto en un bucket de Cloud Storage requiere dos respuestas OK. La primera respuesta OK se envía cuando se envía un mensaje se escribió correctamente en un objeto. La segunda respuesta OK se envía cuando el objeto que contiene el mensaje finaliza. Un mensaje solo se hace visible en el bucket después de que el objeto de Cloud Storage que lo contiene se hayan finalizado con éxito.

  4. Si hay alguna falla durante la operación de escritura, el El mensaje de Pub/Sub se confirma de forma negativa. Luego, se vuelve a enviar el mensaje. Si la operación de escritura del mensaje falla varias veces y tienes configurado un tema de mensajes no entregados en la suscripción el mensaje se mueve al tema de mensajes no entregados.

Propiedades de una suscripción a Cloud Storage

Cuando creas una suscripción a Cloud Storage, debes especificar algunas propiedades adicionales. Estas propiedades incluyen suscripciones comunes, propiedades, requisitos de nombre de archivo y formato, requisitos de almacenamiento y mucho más. Para obtener más información sobre estas propiedades, consulta Propiedades de suscripción de Cloud Storage.

Permisos de la cuenta de servicio de Pub/Sub

Para crear una suscripción a Cloud Storage, el La cuenta de servicio de Pub/Sub debe tener permiso para escribir en el en un bucket específico de Cloud Storage y leer los metadatos del bucket.

Para obtener más información, consulta Asigna funciones de Cloud Storage a la cuenta de servicio de Pub/Sub.

Maneja los errores de los mensajes

Cuando un mensaje de Pub/Sub no se puede escribir en un bucket de Cloud Storage, no se puede confirmar el mensaje. Para reenviar estos mensajes que no se pueden entregar, configura una tema de mensajes no entregados en la suscripción a Cloud Storage.

Si Pub/Sub no puede escribir mensajes en Cloud Storage, Pub/Sub cancela la entrega de mensajes de manera similar a comportamiento de retirada de envío.

Cuotas

Las limitaciones de cuota se aplican a la capacidad de procesamiento del suscriptor de Cloud Storage. para cada región. Para obtener información sobre las cuotas de Cloud Storage consulta los límites de cuota de exportación de suscriptores en Cuotas y límites de Pub/Sub.

Precios

Para obtener información sobre los precios de Cloud Storage, , consulta la página de precios de Pub/Sub.

¿Qué sigue?