Abonnenten nutzen ein Lite-Abo, um Nachrichten von einem Lite-Thema Wenn Sie ein Lite-Abo erstellen, hängen Sie es an ein Lite-Thema an. Sie können mehrere Lite-Abos mit einem einzelnen Lite-Thema verknüpfen.
Es gibt zwei Arten von Abos:
- Standardabo. Erstellen Sie ein Standardabo, wenn Sie eine Client, der Nachrichten aus dem Lite-Thema lesen muss.
- Abo exportieren Erstellen Sie bei Bedarf ein Exportabo Lite-Nachrichten nach Pub/Sub exportieren. Weitere Informationen finden Sie unter Pub/Sub Lite-Nachrichten nach Pub/Sub exportieren
Eigenschaften eines Lite-Abos
Ein Abo für ein zonales Lite-Thema hat dieselben Attribute wie ein Abo für ein regionales Lite-Thema mit Ausnahme der folgenden:
Standorttyp, Zone oder Region, der im Ressourcennamen verwendet wird. Beispiel eines regionalen Standorts ist
us-central1
; Ein Beispiel für einen Zonenstandort istus-central1-a
.Zuverlässigkeit. Siehe Datenreplikation in einem Lite-Thema erfahren Sie mehr über die Zuverlässigkeitsunterschiede zwischen regionalen und zonalen Themen.
Zustellanforderung für Nachrichten
Ein vorübergehender Fehler beim Schreiben einer Nachricht in den Speicher führt dazu, dass der Publisher Senden Sie die Nachricht erneut. Diese Wiederholungsversuche sind für den Endnutzer transparent. Bei Lite-Abos gibt es eine Eigenschaft Zustellungsanforderung, die sich darauf auswirkt, wie Abos reagieren auf diese Wiederholungsversuche von Nachrichten. Sie können diese Eigenschaft festlegen auf eine der folgenden zwei Optionen:
Nachrichten sofort senden: Wenn diese Option aktiviert ist, Clients empfangen alle Nachrichten, nachdem sie beim Server ankommen. Dieser Prozess ist unabhängig vom Status der Nachrichten, die auf das Laufwerk geschrieben werden. Offsets sind nicht wiederverwendet, aber Nachrichten mit Offsets, die nicht in den Speicher geschrieben werden, nach einem seek-Vorgang nicht wieder lesbar sein.
Nachrichten nach dem Speichern senden. Wenn diese Option aktiviert ist, empfängt Nachrichten erst, wenn sie auf die Festplatte geschrieben werden. Die Nachrichten sind und sind nach einem Suchvorgang garantiert wieder lesbar. Diese Option aktivieren erhöht die End-to-End-Latenz für den Empfang von Nachrichten vom Publisher. an den Abonnenten.
Richtlinien für die Benennung von Abos
Ein Pub/Sub Lite-Ressourcenname identifiziert eindeutig eine Pub/Sub Lite-Ressource, z. B. ein Thema, ein Abo oder Reservierung. Der Ressourcenname muss das folgende Format haben:
projects/project-identifier/collection/ID
project-identifier
: Muss die Projekt-ID oder Projektnummer sein, die im Google Cloud Consolemy-cool-project
ist beispielsweise eine Projekt-ID.123456789123
ist eine Projektnummer.collection
: musstopics
,subscriptions
oderreservations
sein.ID
: Muss den folgenden Richtlinien entsprechen:- Sie dürfen nicht mit dem String „
goog
“ beginnen. - Muss mit einem Buchstaben beginnen
- Er muss zwischen 3 und 255 Zeichen lang sein
- Sie dürfen nur die folgenden Zeichen enthalten: Buchstaben
[A-Za-z]
, Ziffern[0-9]
, Bindestriche-
, Unterstriche_
, Punkte.
, Tilden~
, Pluszeichen+
und Prozentzeichen%
Sie können die Sonderzeichen in der vorherigen Liste in Ressourcennamen ohne URL-Codierung verwenden. Sie müssen jedoch darauf achten, dass alle anderen Sonderzeichen richtig codiert oder decodiert werden, wenn Sie sie in URLs verwenden.
mi-tópico
ist beispielsweise keine gültige ID.mi-t%C3%B3pico
ist jedoch gültig. Dieses Format ist wichtig, wenn Sie REST-Aufrufe durchführen.- Sie dürfen nicht mit dem String „
Lite-Abo erstellen
Ein Lite-Abo muss sich im selben Projekt und am selben Standort wie das Lite-Thema, mit dem das Lite-Abo verknüpft ist.
Lite-Thema erstellen und verwalten
Eine Liste der verfügbaren Standorte finden Sie unter Pub/Sub Lite-Standorte.
Sie können ein Lite-Abo mit der Google Cloud Console erstellen, die Google Cloud CLI oder Pub/Sub Lite API verwenden.
Informationen zum Erstellen eines Exportabos finden Sie unter Pub/Sub Lite-Nachrichten nach Pub/Sub exportieren
Console
Rufen Sie die Seite Lite-Abos auf.
Klicken Sie auf Lite-Abo erstellen.
Geben Sie eine Lite-Abo-ID ein.
Wählen Sie ein Lite-Thema aus, von dem Nachrichten empfangen werden sollen.
Wählen Sie Nachrichten sofort senden oder Nachrichten nach dem Speichern senden aus.
Wählen Sie als Typ Anfangsversatz aus.
Wählen Sie einen Zustellungstyp aus.
Klicken Sie auf Erstellen.
gcloud
Verwenden Sie den Befehl gcloud pubsub lite-subscriptions create
, um ein Lite-Abo zu erstellen:
gcloud pubsub lite-subscriptions create SUBSCRIPTION_ID \ --location=LOCATION \ --topic=TOPIC_ID \ --delivery-requirement=DELIVERY_REQUIREMENT
Dabei gilt:
SUBSCRIPTION_ID: die ID des Lite-Abos
LOCATION: der Name eines von Pub/Sub Lite unterstützten Standorts
TOPIC_ID: die ID des Lite-Themas, das an das Lite-Abo angehängt werden soll
DELIVERY_REQUIREMENT:
deliver-after-stored
oderdeliver-immediately
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile eine Bestätigung angezeigt:
Created [SUBSCRIPTION_ID].
Protokoll
Senden Sie zum Erstellen eines Lite-Abos eine POST
-Anfrage wie die folgende:
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Dabei gilt:
REGION: Region, in der das Lite-Abo gespeichert werden soll
PROJECT_NUMBER: Die Projektnummer des Projekts, in dem das Lite-Abo erstellt werden soll
LOCATION: der Name eines von Pub/Sub Lite unterstützten Standorts
SUBSCRIPTION_ID: die ID des Lite-Abos
Geben Sie im Anfragetext die folgenden Felder an:
{ "topic": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Ersetzen Sie DELIVERY_REQUIREMENT durch deliver-after-stored
oder deliver-immediately
.
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Abo im JSON-Format:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Go in Pub/Sub Lite-Clientbibliotheken
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Nachdem Sie ein Lite-Abo für ein Lite-Thema erstellt haben, können Sie Nachrichten vom Lite-Abo empfangen.
Lite-Abo aktualisieren
Lite-Abos können Sie über die Google Cloud Console aktualisieren, die Google Cloud CLI oder Pub/Sub Lite API verwenden.
Console
Rufen Sie die Seite Lite-Abos auf.
Klicken Sie auf die Lite-Abo-ID.
Klicken Sie auf der Seite Lite-Abonnementdetails auf Bearbeiten.
gcloud
Verwenden Sie zum Aktualisieren eines Lite-Abos den Befehl gcloud pubsub lite-subscriptions update
:
gcloud pubsub lite-subscriptions update SUBSCRIPTION_ID \ --location=LOCATION \ --delivery-requirement=DELIVERY_REQUIREMENT
Dabei gilt:
SUBSCRIPTION_ID: die ID des Lite-Abos
LOCATION: der Name des Standorts, an dem sich das Lite-Abo befindet
DELIVERY_REQUIREMENT:
deliver-after-stored
oderdeliver-immediately
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile das Lite-Abo angezeigt:
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokoll
Um ein Lite-Abo zu aktualisieren, senden Sie eine PATCH
-Anfrage wie die folgende:
PATCH https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID?updateMask=deliveryConfig.deliveryRequirement Authorization: Bearer $(gcloud auth print-access-token)
Dabei gilt:
REGION: Region, in der das Lite-Abo gespeichert werden soll
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Abo
LOCATION: der Name des Standorts, an dem sich das Lite-Abo befindet
SUBSCRIPTION_ID: die ID des Lite-Abos
Geben Sie im Anfragetext die folgenden Felder an:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Ersetzen Sie DELIVERY_REQUIREMENT durch deliver-after-stored
oder deliver-immediately
.
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Abo im JSON-Format:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Go in Pub/Sub Lite-Clientbibliotheken
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Details zum Lite-Abo ansehen
Details zu einem Lite-Abo erhalten Sie über die Google Cloud Console, die Google Cloud CLI oder Pub/Sub Lite API.
Console
Rufen Sie die Seite Lite-Abos auf.
Klicken Sie auf die Lite-Abo-ID.
Klicken Sie auf der Detailseite des Lite-Abos auf den Tab Details.
gcloud
Wenn Sie Details zu einem Lite-Abo abrufen möchten, verwenden Sie den Befehl gcloud pubsub lite-subscriptions describe
:
gcloud pubsub lite-subscriptions describe SUBSCRIPTION_ID \ --location=LOCATION
Dabei gilt:
SUBSCRIPTION_ID: die ID des Lite-Abos
LOCATION: der Name des Standorts, an dem sich das Lite-Abo befindet
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile das Lite-Thema angezeigt:
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokoll
Wenn Sie Details zu einem Lite-Abo erhalten möchten, senden Sie eine GET
-Anfrage wie die folgende:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Dabei gilt:
REGION: Region, in der das Lite-Abo gespeichert werden soll
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Abo
LOCATION: der Name des Standorts, an dem sich das Lite-Abo befindet
SUBSCRIPTION_ID: die ID des Lite-Abos
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Thema im JSON-Format:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }
Go
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Go in Pub/Sub Lite-Clientbibliotheken
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Lite-Abos auflisten
Sie können die Lite-Abos in einem Projekt oder die Lite-Abos für ein Lite-Thema auflisten.
Lite-Abos in einem Projekt auflisten
Sie können Lite-Abos in einem Projekt über die Google Cloud Console auflisten. die Google Cloud CLI oder Pub/Sub Lite API verwenden.
Console
Rufen Sie die Seite Lite-Abos auf.
gcloud
- Verwenden Sie den Befehl
gcloud pubsub lite-subscriptions list
, um die Lite-Abos in einem Projekt aufzulisten:
gcloud pubsub lite-subscriptions list \ --location=LOCATION
Ersetzen Sie LOCATION durch den Namen des Standorts, an dem sich die Lite-Abos befinden.
Wenn die Anfrage erfolgreich ist, werden in der Befehlszeile die Lite-Abos angezeigt:
--- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID --- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokoll
- Senden Sie eine
GET
-Anfrage wie die folgende, um die Lite-Abos in einem Projekt aufzulisten:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Dabei gilt:
REGION: Region, in der das Lite-Abo gespeichert werden soll
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Abo
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Thema im JSON-Format:
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" } ] }
Go
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Go in Pub/Sub Lite-Clientbibliotheken
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Lite-Abos für ein Lite-Thema auflisten
Sie können Lite-Abos für ein Lite-Thema mithilfe der Google Cloud Console, die Google Cloud CLI oder Pub/Sub Lite API.
Console
Rufen Sie die Seite Lite-Themen auf.
Eine Lite-Themen-ID auswählen.
Auf der Detailseite Lite-Themen enthält der Abschnitt Lite-Abos eine Liste der Lite-Abos für das Lite-Thema.
gcloud
- Verwenden Sie den Befehl
gcloud pubsub lite-topics list-subscriptions
, um die Lite-Abos für ein Thema aufzulisten:
gcloud pubsub lite-topics list-subscriptions TOPIC_ID \ --location=LOCATION
Dabei gilt:
TOPIC_ID: die ID des Lite-Themas, mit dem die Lite-Abos verknüpft sind
LOCATION: der Name des Standorts, an dem sich das Lite-Abo befindet
Wenn die Anfrage erfolgreich ist, werden in der Befehlszeile die Lite-Abos angezeigt:
--- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID --- deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protokoll
- Um die Lite-Abos für ein Lite-Thema aufzulisten, senden Sie eine
GET
-Anfrage wie die folgende:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/lite-topics/TOPIC_ID/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Dabei gilt:
REGION: Region, in der das Lite-Abo gespeichert werden soll
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Abo
LOCATION: der Name des Standorts, an dem sich das Lite-Abo befindet
TOPIC_ID: die ID des Lite-Themas, mit dem die Lite-Abos verknüpft sind
Wenn die Anfrage erfolgreich ist, ist die Antwort eine Liste von Lite-Abos im JSON-Format:
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" } ] }
Go
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Go in Pub/Sub Lite-Clientbibliotheken
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Lite-Abo löschen
Sie können Lite-Abos über die Google Cloud Console löschen: Google Cloud CLI oder Pub/Sub Lite API verwenden.
Console
Rufen Sie die Seite Lite-Abos auf.
Klicken Sie auf die Lite-Abo-ID.
Klicken Sie auf der Seite Lite-Abonnementdetails auf Löschen.
Klicken Sie im angezeigten Dialogfeld auf Löschen, um zu bestätigen, dass Sie das Lite-Abo löschen möchten.
gcloud
Verwenden Sie zum Löschen eines Lite-Abos den Befehl gcloud pubsub lite-subscriptions delete
:
Führen Sie den Befehl
delete
aus:gcloud pubsub lite-subscriptions delete SUBSCRIPTION_ID \ --location=LOCATION
Dabei gilt:
SUBSCRIPTION_ID: die ID des Lite-Abos
LOCATION: der Name des Standorts, an dem sich das Lite-Abo befindet
Zum Bestätigen geben Sie "
Y
" ein.
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile eine Bestätigung angezeigt:
Deleted subscription [SUBSCRIPTION_ID].
Protokoll
- Um ein Lite-Thema zu löschen, senden Sie eine
DELETE
-Anfrage wie die folgende:
DELETE https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Dabei gilt:
REGION: Region, in der das Lite-Abo gespeichert werden soll
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Abo
LOCATION: der Name des Standorts, an dem sich das Lite-Abo befindet
SUBSCRIPTION_ID: die ID des Lite-Abos
Wenn die Anfrage erfolgreich ist, ist die Antwort ein leeres JSON-Objekt.
Go
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Go in Pub/Sub Lite-Clientbibliotheken
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie den Schritten zur Einrichtung von Java in Pub/Sub Lite-Clientbibliotheken.
Weitere Informationen
- Lite-Thema erstellen und verwalten
- Nachrichten zu einem Lite-Thema veröffentlichen
- Nachrichten von einem Lite-Abo empfangen