Cloud Storage-Abos

Ein Cloud Storage-Abo ist ein Exportabo, mit dem Nachrichten bei Erhalt in einen vorhandenen Cloud Storage-Bucket geschrieben werden. Du musst keinen separaten Abonnentenclient konfigurieren. Mit der Google Cloud Console, der Google Cloud CLI, den Clientbibliotheken oder der Pub/Sub API können Sie ein Cloud Storage-Abo erstellen, aktualisieren, auflisten, trennen oder löschen.

Ohne den Cloud Storage-Abotyp benötigen Sie ein Pull- oder Push-Abo und einen Abonnenten (z. B. Dataflow), der Nachrichten liest und in einen Cloud Storage-Bucket schreibt. Der Aufwand für das Ausführen eines Dataflow-Jobs ist nicht erforderlich, wenn Nachrichten keine zusätzliche Verarbeitung erfordern, bevor sie in einem Cloud Storage-Bucket gespeichert werden. Sie können stattdessen ein Cloud Storage-Abo verwenden.

Eine Dataflow-Pipeline wird jedoch weiterhin für Pub/Sub-Systeme empfohlen, bei denen eine Datentransformation erforderlich ist, bevor die Daten in einem Cloud Storage-Bucket gespeichert werden.

Informationen zum Streamen von Daten aus Pub/Sub nach Cloud Storage mit Transformation mithilfe von Dataflow finden Sie unter Nachrichten von Pub/Sub mit Dataflow streamen.

Hinweise

Machen Sie sich vor dem Lesen dieses Dokuments mit Folgendem vertraut:

Workflow für Cloud Storage-Abos

Die folgende Abbildung zeigt den Workflow zwischen einem Cloud Storage-Abo und Cloud Storage.

Nachrichtenfluss für ein Cloud Storage-Abo

Abbildung 1. Workflow für ein Cloud Storage-Abo

Es folgt eine kurze Beschreibung des Workflows, der auf Abbildung 1 verweist:

  1. Pub/Sub sendet über die Cloud Storage API Daten an den Cloud Storage-Bucket. Nach erfolgreichem Abschluss eines Schreibvorgangs gibt die API eine OK-Antwort zurück.

  2. Die Nachrichten werden in Batches an den Cloud Storage-Bucket gesendet. Ein einzelner Batch entspricht einem Objekt, das im Cloud Storage-Bucket gespeichert ist. Sie können die Batcheinstellungen anhand der Objektgröße und der seit der Erstellung des Objekts verstrichenen Zeit konfigurieren.

  3. Der Workflow zum Schreiben eines Objekts in einen Cloud Storage-Bucket erfordert zwei OK-Antworten. Die erste OK-Antwort wird gesendet, wenn eine Nachricht erfolgreich in ein Objekt geschrieben wurde. Die zweite OK-Antwort wird gesendet, wenn das Objekt, das die Nachricht enthält, abgeschlossen ist. Eine Nachricht wird erst dann im Bucket sichtbar, wenn das Cloud Storage-Objekt, das sie enthält, erfolgreich abgeschlossen wurde.

  4. Wenn während des Schreibvorgangs Fehler auftreten, wird die Pub/Sub-Nachricht selbst negativ quittiert. Die Nachricht wird dann noch einmal gesendet. Wenn der Schreibvorgang für Nachrichten häufig fehlschlägt und Sie für das Abo ein Thema für unzustellbare Nachrichten konfiguriert haben, wird die Nachricht in das Thema für unzustellbare Nachrichten verschoben.

Attribute eines Cloud Storage-Abos

Wenn Sie ein Cloud Storage-Abo erstellen, müssen Sie einige zusätzliche Attribute angeben. Dazu gehören allgemeine Abo-Attribute, Anforderungen an Dateinamen und -formate, Speicheranforderungen und mehr. Weitere Informationen zu diesen Attributen finden Sie unter Cloud Storage-Aboattribute.

Berechtigungen des Pub/Sub-Dienstkontos

Zum Erstellen eines Cloud Storage-Abos muss das Pub/Sub-Dienstkonto die Berechtigung zum Schreiben in den entsprechenden Cloud Storage-Bucket und zum Lesen der Bucket-Metadaten haben.

Weitere Informationen finden Sie unter Dem Pub/Sub-Dienstkonto Cloud Storage-Rollen zuweisen.

Fehler bei Nachrichten beheben

Wenn eine Pub/Sub-Nachricht nicht in einen Cloud Storage-Bucket geschrieben werden kann, kann die Nachricht nicht bestätigt werden. Konfigurieren Sie ein Thema für unzustellbare Nachrichten im Cloud Storage-Abo, um solche nicht zustellbaren Nachrichten weiterzuleiten.

Kontingente

Für den Cloud Storage-Abonnentendurchsatz pro Region gelten Kontingentbeschränkungen. Informationen zu den Kontingenten für Cloud Storage-Abos finden Sie unter Pub/Sub-Kontingente und -Limits.

Preise

Informationen zu den Preisen für Cloud Storage-Abos finden Sie auf der Seite Pub/Sub-Preise.

Nächste Schritte