Abonnements Cloud Storage

Un abonnement Cloud Storage est un type d'abonnement à l'exportation qui écrit les messages dans un bucket Cloud Storage existant à mesure qu'ils sont reçus. Vous n'avez pas besoin de configurer un client abonné distinct. Utilisez la console Google Cloud, la Google Cloud CLI, les bibliothèques clientes ou l'API Pub/Sub pour créer, mettre à jour, répertorier, dissocier ou supprimer un abonnement Cloud Storage.

Sans le type d'abonnement Cloud Storage, vous avez besoin d'un abonnement pull ou push, et d'un abonné (tel que Dataflow) qui lit les messages et les écrit dans un bucket Cloud Storage. Les frais généraux liés à l'exécution d'un job Dataflow ne sont pas nécessaires lorsque les messages ne nécessitent pas de traitement supplémentaire avant de les stocker dans un bucket Cloud Storage. Vous pouvez utiliser un abonnement Cloud Storage à la place.

Toutefois, un pipeline Dataflow est toujours recommandé pour les systèmes Pub/Sub qui nécessitent une transformation des données avant leur stockage dans un bucket Cloud Storage.

Pour savoir comment diffuser des données en flux continu depuis Pub/Sub vers Cloud Storage avec transformation à l'aide de Dataflow, consultez la section Diffuser des messages en flux continu depuis Pub/Sub à l'aide de Dataflow.

Avant de commencer

Avant de lire ce document, assurez-vous d'avoir pris connaissance des points suivants:

Workflow d'abonnement Cloud Storage

L'image suivante illustre le workflow entre un abonnement Cloud Storage et Cloud Storage.

Flux de messages pour un abonnement Cloud Storage

Figure 1 : Workflow pour un abonnement Cloud Storage

Voici une brève description du workflow qui fait référence à la figure 1:

  1. Pub/Sub utilise l'API Cloud Storage pour envoyer des données au bucket Cloud Storage. Après une opération d'écriture réussie, l'API renvoie une réponse OK.

  2. Les messages sont envoyés par lots au bucket Cloud Storage. Un seul lot correspond à un objet stocké dans le bucket Cloud Storage. Vous pouvez configurer les paramètres de traitement par lot en fonction de la taille de l'objet et du temps écoulé depuis sa création.

  3. Le workflow d'écriture d'un objet dans un bucket Cloud Storage nécessite deux réponses OK. La première réponse OK est envoyée lorsqu'un message a bien été écrit dans un objet. La deuxième réponse OK est envoyée lorsque l'objet contenant le message est finalisé. Un message n'est visible dans le bucket qu'une fois que l'objet Cloud Storage qui le contient a été correctement finalisé.

  4. En cas d'échec lors de l'opération d'écriture, le message Pub/Sub lui-même est confirmé par la négative. Le message est ensuite renvoyé. Si l'opération d'écriture du message échoue suffisamment de fois et qu'un sujet de lettres mortes est configuré sur l'abonnement, le message est déplacé vers ce sujet.

Propriétés d'un abonnement Cloud Storage

Lorsque vous créez un abonnement Cloud Storage, vous devez spécifier des propriétés supplémentaires. Ces propriétés incluent les propriétés d'abonnement courantes, les exigences concernant les noms de fichiers et le format, les exigences de stockage, etc. Pour en savoir plus sur ces propriétés, consultez la page Propriétés de l'abonnement Cloud Storage.

Autorisations de compte de service Pub/Sub

Pour créer un abonnement Cloud Storage, le compte de service Pub/Sub doit être autorisé à écrire dans le bucket Cloud Storage spécifique et à lire les métadonnées du bucket.

Pour en savoir plus, consultez la section Attribuer des rôles Cloud Storage au compte de service Pub/Sub.

Gérer les échecs de message

Lorsqu'un message Pub/Sub ne peut pas être écrit dans un bucket Cloud Storage, il ne peut pas être confirmé. Pour transférer ces messages impossibles à distribuer, configurez un sujet de lettre morte sur l'abonnement Cloud Storage.

Quotas

Les limites de quota s'appliquent au débit d'abonné Cloud Storage pour chaque région. Pour en savoir plus sur les quotas des abonnements Cloud Storage, consultez les limites de quota d'exportation des abonnés dans la section Quotas et limites de Pub/Sub.

Tarification

Pour en savoir plus sur les tarifs des abonnements Cloud Storage, consultez la page Tarifs de Pub/Sub.

Étapes suivantes