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:
Funktionsweise von Pub/Sub und die verschiedenen Pub/Sub-Begriffe
Welche Arten von Abos gibt es und warum sollten Sie ein Cloud Storage-Abo verwenden?
Funktionsweise von Cloud Storage
Workflow für Cloud Storage-Abos
Die folgende Abbildung zeigt den Workflow zwischen einem Cloud Storage-Abo und Cloud Storage.
Abbildung 1. Workflow für ein Cloud Storage-Abo
Es folgt eine kurze Beschreibung des Workflows, der auf Abbildung 1 verweist:
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.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.
Der Workflow zum Schreiben eines Objekts in einen Cloud Storage-Bucket erfordert zwei
OK
-Antworten. Die ersteOK
-Antwort wird gesendet, wenn eine Nachricht erfolgreich in ein Objekt geschrieben wurde. Die zweiteOK
-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.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
Erstellen Sie ein Cloud Storage-Abo.
Erkunden Sie Pub/Sub-Konfigurationstools: