In diesem Dokument wird erläutert, wie Sie ein Pub/Sub Lite-Thema erstellen, ansehen und löschen.
Übersicht über ein Lite-Thema
Für einen Pub/Sub Lite-Dienst ist ein Thema erforderlich, an das Verlage und Webpublisher Nachrichten senden können, damit Abonnenten diese Nachrichten empfangen können. In Pub/Sub Lite können Sie ein zonales oder regionales Lite-Thema erstellen.
Ein zonales Lite-Thema und ein regionales Lite-Thema unterscheiden sich nur in der Art und Weise, wie sie Daten replizieren. Alle anderen Themenattribute sind mit denen identisch, die in einem späteren Abschnitt dieses Dokuments beschrieben werden.
Datenreplikation in einem Lite-Thema
Regionale Pub/Sub Lite-Themen speichern Daten in zwei Zonen einer einzelnen Region. Zonale Pub/Sub Lite-Themen replizieren Daten in nur einer Zone. Pub/Sub Lite repliziert Daten asynchron.
Die Verfügbarkeit von Pub/Sub Lite hängt von der Verfügbarkeit der zugrunde liegenden Komponenten ab, zu denen sowohl das Frontend der Anwendung als auch der Speicher gehört.
Die Verfügbarkeit eines zonalen Pub/Sub Lite-Themas hängt von der Verfügbarkeit sowohl des Anwendungs-Front-Ends als auch des Speichers in der konfigurierten Zone ab. Wenn im Frontend oder Speicher der Anwendung ein zonaler Fehler auftritt, ist das zonale Lite-Thema für die Dauer des Ausfalls nicht verfügbar.
Die Verfügbarkeit eines regionalen Pub/Sub Lite-Themas hängt von der Verfügbarkeit des Frontends und des Speichers der Anwendung in der konfigurierten Region ab. Folgende Fehlertypen sind möglich:
Wenn im Front-End oder des Speichers der Anwendung ein zonaler Fehler auftritt, bleibt das regionale Lite-Thema verfügbar.
Wenn sowohl im Front-End als auch im Speicher der Anwendung ein zonaler Fehler auftritt, bleibt das regionale Lite-Thema verfügbar, solange nicht beide Komponenten gleichzeitig ausfallen.
Wenn sowohl das Frontend der Anwendung als auch der Speicher gleichzeitig ausfallen, bleibt das regionale Lite-Thema für die Dauer des Ausfalls nicht verfügbar. Während dieser Zeit kann es vorkommen, dass Clients keine Nachrichten veröffentlichen oder verarbeiten können, die Nachrichten aber trotzdem in der richtigen Reihenfolge zugestellt werden.
Ein regionales Lite-Thema bietet Schutz vor den meisten Arten von Ausfällen einzelner Zonen. In seltenen Fällen kann die asynchrone Replikation jedoch zu einem gleichzeitigen Ausfall mehrerer Komponenten in einer einzelnen Zone führen. Daher ist ein regionales Lite-Thema nicht mehr verfügbar.
Eigenschaften eines Lite-Themas
Lite-Themen haben die folgenden Eigenschaften:
Anzahl der Partitionen. Eine Partition ist die Basiseinheit der Parallelverarbeitung in Pub/Sub Lite. Ein Lite-Thema kann eine oder mehrere Partitionen haben.
Kapazität einer Partition: Die Kapazität einer Partition wird durch die folgenden drei Attribute beschrieben:
Durchsatz für Veröffentlichungen (MiBps): Die maximale Rate, mit der Sie Nachrichten veröffentlichen können.
Abodurchsatz (MiBps): Die maximale Rate, mit der Nachrichten an Lite-Abos weitergeleitet werden.
Speicher (GiB): Die maximale Größe der Nachrichten in der Partition. Die konfigurierbare Mindestkapazität einer Partition beträgt 30 GiB.
Speicherkapazität eines Lite-Themas: Alle Partitionen in einem Lite-Thema haben die gleiche konfigurierte Speicherkapazität. Die Gesamtspeicherkapazität eines Lite-Themas entspricht der Summe der Speicherkapazität aller Partitionen in dem Thema. Wenn ein Lite-Thema beispielsweise 8 Partitionen hat und jede Partition eine Größe von 30 GiB hat, beträgt die Gesamtspeicherkapazität des Lite-Themas 240 GiB (8 x 30).
Durchsatzkapazität eines Lite-Themas: Die Durchsatzkapazität umfasst die gesamte Durchsatzkapazität beim Veröffentlichen und Abonnieren aller Partitionen im Lite-Thema. Selbst wenn Sie ein Thema haben, das insgesamt 1 GiB/S an Veröffentlichungsdurchsatz unterstützen kann, ist es das Veröffentlichungslimit pro Partition, das den Durchsatz effektiv begrenzt.
Limit für Abonnentenclient und Abos: Pub/Sub Lite unterstützt einen einzelnen Abonnentenclient für eine einzelne Partition und ein einzelnes Abo. Ein Abo für ein Thema mit 5 Partitionen kann beispielsweise höchstens 5 Abonnentenclients haben, die Nachrichten aus diesem Thema abrufen. Wenn mehr Abonnentenclients konfiguriert sind, bleiben die überzähligen Clients inaktiv. Ein Thema mit zwei Abos kann bis zu 10 Abonnentenclients und 5 Clients pro Abo haben.
Reservierungen: Eine Reservierung ist die einfachste Möglichkeit, Durchsatzkapazität für eine Reihe von Themen bereitzustellen und zu verwalten. Die Bereitstellung von Durchsatzkapazität mit Reservierungen ist für regionale Lite-Ressourcen erforderlich und für zonale Lite-Themen optional.
Wenn Sie keine Reservierungen für ein zonales Lite-Thema verwenden, müssen Sie die Durchsatzkapazität für Veröffentlichungen und Abos explizit bereitstellen. Ohne Reservierung haben alle Partitionen in einem Lite-Thema die gleiche konfigurierte Durchsatzkapazität. Weitere Informationen finden Sie unter Durchsatzkapazität ohne Reservierungen konfigurieren.
Speicherkonfiguration: Zum Konfigurieren des Speichers müssen Sie sowohl die Speicherkapazität als auch optional die Aufbewahrungsdauer für Nachrichten angeben.
Aufbewahrungsdauer für Nachrichten. Der maximale Zeitraum, für den ein Lite-Thema Nachrichten speichert. Wenn Sie keine Aufbewahrungsdauer für Nachrichten angeben, werden Nachrichten vom Lite-Thema gespeichert, bis die Speicherkapazität überschritten wird.
Speicherkapazität: Die Kapazität eines Pub/Sub Lite-Themas wird durch die Anzahl der Partitionen im Thema und die Speicherkapazität jeder Partition bestimmt. "Speicher pro Partition" ist die Speichermenge in Byte für jede Partition. Regionale Lite-Themen verwenden für jedes veröffentlichte Byte zwei Byte an Speicherkapazität. Zonale Lite-Themen verwenden für jedes veröffentlichte Byte ein Byte an Speicherkapazität.
Wenn Sie die Speicherkapazität überschreiten, veröffentlicht der Pub/Sub Lite-Dienst weiterhin Nachrichten. Allerdings werden die ältesten Nachrichten aus der Partition gelöscht, um mehr Speicherkapazität zu schaffen. Die ältesten Nachrichten werden auch dann gelöscht, wenn die Nachrichtenaufbewahrungsdauer noch nicht abgelaufen ist. Der Dienst löscht Nachrichten niemals vor Ablauf ihrer TTL, es sei denn, sie müssen entfernt werden, um Platz für neu veröffentlichte Nachrichten zu schaffen. Informationen zum Verhältnis der Kapazität zu den Preisen finden Sie unter Pub/Sub Lite-Preise.
Richtlinien zur Benennung eines Themas
Ein Pub/Sub Lite-Ressourcenname identifiziert eine Pub/Sub Lite-Ressource eindeutig, z. B. ein Thema, ein Abo oder eine Reservierung. Der Ressourcenname muss das folgende Format haben:
projects/project-identifier/collection/ID
project-identifier
: Muss die Projekt-ID oder Projektnummer sein, die in der Google Cloud Console verfügbar ist.my-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. Alle anderen Sonderzeichen müssen jedoch bei ihrer Verwendung in URLs richtig codiert oder decodiert werden. Beispielsweise ist
mi-tópico
eine ungü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 „
Durchsatzkapazität eines Lite-Themas erhöhen
Wenn Sie keine Lite-Reservierungen verwenden, können Sie die Durchsatzkapazität jeder Partition eines zonalen Lite-Themas auf einen Wert festlegen, der durch die folgenden Limits festgelegt wird:
Veröffentlichungsdurchsatz zwischen 4 und 16 MiB/s
Abodurchsatz zwischen 4 und 32 MiB/s
Diese Limits gelten auch für Partitionen, die mit einer Lite-Reservierung verknüpft sind. Mit Reservierungen kann jede Partition eine beliebige Durchsatzkapazität innerhalb der angegebenen Limits nutzen, solange die Gesamtkapazität der Reservierung nicht überschritten wird. Optional können Sie ein Unterlimit für den tatsächlichen Durchsatz pro Partition festlegen, um den Traffic vorhersehbarer zu machen.
Sie können die Anzahl der Partitionen in einem Thema erhöhen, um es horizontal zu skalieren. Die Anzahl der Partitionen in einem Thema kann nicht verringert werden.
Wenn Sie die Anzahl der Partitionen ändern, wird die relative Reihenfolge der Nachrichten nicht beibehalten. Intern werden Nachrichten Partitionen mithilfe einer Hash-Funktion zugewiesen. Wenn Sie die Anzahl der Partitionen in einem Thema aktualisieren, ändert sich diese Hash-Funktion. Nachrichten mit demselben Schlüssel, der nach der Aktualisierung der Partitionsanzahl veröffentlicht wurde, werden wahrscheinlich einer anderen Partition zugeordnet als den vor der Aktualisierung veröffentlichten Nachrichten.
Außerdem dauert es einige Sekunden, bis die Größenanpassung des Themas an alle Publisher weitergegeben wird. Es gibt kurze Zeit, dass einige Verlage und Webpublisher die neue Hash-Funktion verwenden, andere aber noch die alte.
Speicherkapazität eines Lite-Themas erhöhen
Sie können den Speicherplatz in einem Lite-Thema erhöhen oder verringern. Das Lite-Thema stellt für jede Partition denselben Speicherplatz bereit. Wenn Sie den Speicher auf 60 GiB erhöhen, erhält jede Partition 60 GiB.
Wenn Sie den Speicherplatz in einem Lite-Thema verringern, entfernt der Pub/Sub Lite-Dienst zuerst die ältesten Nachrichten.
Informationen dazu, wie die Kapazität mit den Preisen zusammenhängt, finden Sie unter Pub/Sub Lite-Preise.
Lite-Thema erstellen
Sie können Lite-Themen mit der Google Cloud Console, der Google Cloud CLI oder der Pub/Sub Lite API erstellen.
Eine Liste der verfügbaren Regionen und Zonen finden Sie unter Pub/Sub Lite-Standorte.
Console
Rufen Sie die Seite Lite-Themen auf.
Klicken Sie auf Lite-Thema erstellen.
Wählen Sie zum Erstellen eines zonalen Lite-Themas eine Region und eine Zone innerhalb der Region aus.
Wählen Sie eine Region aus, um ein regionales Lite-Thema zu erstellen.
Sie können den Standort nicht mehr aktualisieren, nachdem ein Thema erstellt wurde.
Geben Sie im Abschnitt Name eine Lite-Themen-ID ein.
Der Name des Lite-Themas enthält die ID des Lite-Themas, den Ort und die Projektnummer.
Im Bereich Durchsatz:
Wählen Sie eine Reservierung aus oder erstellen Sie eine.
Dies ist bei einem zonalen Lite-Thema optional und bei einem regionalen Lite-Thema erforderlich.
Geben Sie den Spitzendurchsatz für Veröffentlichungen und Abos ein.
Basierend auf Ihren Eingaben werden automatisch eine Reihe von Partitionen festgelegt. Sie können diese Zahl bearbeiten, nachdem Sie das Thema gespeichert haben.
Im Abschnitt Nachrichtenspeicher:
Geben Sie den Speicherplatz pro Partition ein.
Wählen Sie eine der beiden Optionen für die Nachrichtenaufbewahrungsdauer aus.
Prüfen Sie die Änderungen und klicken Sie auf Erstellen.
gcloud
Verwenden Sie zum Erstellen eines Lite-Themas den Befehl gcloud pubsub lite-topics create
:
gcloud pubsub lite-topics create TOPIC_ID \ --location=LOCATION \ --partitions=NUMBER_OF_PARTITIONS \ --per-partition-bytes=STORAGE_PER_PARTITION \ [--throughput-reservation=RESERVATION_NAME \] [--message-retention-period=MESSAGE_RETENTION_PERIOD]
Ersetzen Sie Folgendes:
TOPIC_ID: die ID des Lite-Themas
LOCATION: der Name eines von Pub/Sub Lite unterstützten Standorts
NUMBER_OF_PARTITIONS: eine Ganzzahl für die Anzahl der Partitionen im Lite-Thema
STORAGE_PER_PARTITION: die Speichermenge für jede Partition, z. B.
30GiB
RESERVATION_NAME: der voll qualifizierte Pfad einer Lite-Reservierung wie
projects/123456789/locations/us-west1/reservations/my-reservation
MESSAGE_RETENTION_PERIOD: die Zeit, die das Lite-Thema Nachrichten speichert, z. B.
1d
oder2w
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile eine Bestätigung angezeigt:
Created [TOPIC_ID].
Protokoll
Senden Sie zum Erstellen eines Lite-Themas eine POST
-Anfrage wie die folgende:
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Ersetzen Sie Folgendes:
REGION: Region, in der das Lite-Thema gespeichert werden soll
PROJECT_NUMBER: die Projektnummer des Projekts, mit dem das Lite-Thema erstellt werden soll
LOCATION: der Name eines von Pub/Sub Lite unterstützten Standorts
TOPIC_ID: die ID des Lite-Themas
Geben Sie im Anfragetext die folgenden Felder an:
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, "reservationConfig": { "throughputReservation": RESERVATION_NAME } }
Ersetzen Sie Folgendes:
NUMBER_OF_PARTITIONS: eine Ganzzahl für die Anzahl der Partitionen im Lite-Thema
STORAGE_PER_PARTITION: die Speichermenge für jede Partition, z. B.
30GiB
publish_CAPACITY: Eine Ganzzahl für die Durchsatzkapazität beim Veröffentlichen jeder Partition
subscribe_CAPACITY: Eine Ganzzahl für die Durchsatzkapazität beim Abonnieren jeder Partition
MESSAGE_RETENTION_PERIOD: die Zeit, die das Lite-Thema Nachrichten speichert, z. B.
1d
oder2w
RESERVATION_NAME: der voll qualifizierte Pfad einer Lite-Reservierung wie
projects/123456789/locations/us-west1/reservations/my-reservation
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Thema im JSON-Format:
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, "reservationConfig": { "throughputReservation": RESERVATION_NAME } }
Einfach loslegen (Go)
Bevor Sie dieses Beispiel ausführen, folgen Sie der Einrichtungsanleitung für Go unter Pub/Sub Lite-Clientbibliotheken.
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Java unter Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Python unter Pub/Sub Lite-Clientbibliotheken.
Nachdem Sie das Lite-Thema erstellt haben, können Sie den Durchsatz und die Speicherkapazität pro Partition skalieren. Sie können die Anzahl der Partitionen auch erhöhen, aber nicht verringern.
Lite-Thema aktualisieren
Sie können die folgenden Eigenschaften eines Lite-Themas aktualisieren:
Die mit dem Lite-Thema verknüpfte Reservierung
Die Anzahl der Partitionen im Thema (kann nur erhöht werden)
Durchsatzkapazitätslimits für Veröffentlichungen und Abos
Der Speicherplatz pro Partition
Die Art der Nachrichtenaufbewahrung
Bevor Sie die Durchsatzkapazität oder die Speicherkapazität eines Themas skalieren, lesen Sie die Informationen unter Durchsatzkapazität skalieren und Speicherkapazität skalieren.
Sie können ein Lite-Thema mit der Google Cloud Console, der Google Cloud CLI oder der Pub/Sub Lite API aktualisieren.
Console
Rufen Sie die Seite Lite-Themen auf.
Klicken Sie auf die Lite-Themen-ID.
Klicken Sie auf Bearbeiten.
Sie können eine oder alle der folgenden Aktualisierungen vornehmen:
- Verwenden Sie eine andere Reservierung. Bei zonalen Themen können Sie sich dafür entscheiden, keine Reservierung zu verwenden.
- Geben Sie die Anzahl der Partitionen ein. Dieser Wert kann erhöht, aber nicht verringert werden.
- Aktivieren oder deaktivieren Sie den maximal zulässigen Durchsatz für Veröffentlichungen und Abos.
- Aktualisieren Sie bei zonalen Themen den Durchsatz für reservierte Veröffentlichungen und Abos. Bei Themen mit angehängter Reservierung spiegelt der aktualisierte Durchsatz das neue Höchstlimit wider.
- Bearbeiten Sie die Speicherkapazität pro Partition.
- Aufbewahrungsdauer für Nachrichten bearbeiten.
Klicken Sie auf Aktualisieren.
gcloud
Verwenden Sie den Befehl gcloud pubsub lite-topics update
, um ein Lite-Thema zu aktualisieren:
gcloud pubsub lite-topics update TOPIC_ID \ --location=LOCATION \ --partitions=NUMBER_OF_PARTITIONS \ --per-partition-publish-mib=publish_CAPACITY \ --per-partition-subscribe-mib=subscribe_CAPACITY \ --per-partition-bytes=STORAGE_PER_PARTITION \ --message-retention-period=MESSAGE_RETENTION_PERIOD
Ersetzen Sie Folgendes:
TOPIC_ID: die ID des Lite-Themas
LOCATION: der Name des Standorts, an dem sich das Lite-Thema befindet
NUMBER_OF_PARTITIONS: die Anzahl der Partitionen, die für das Lite-Thema konfiguriert werden sollen
publish_CAPACITY: Eine Ganzzahl für die Durchsatzkapazität beim Veröffentlichen jeder Partition
subscribe_CAPACITY: Eine Ganzzahl für die Durchsatzkapazität beim Abonnieren jeder Partition
STORAGE_PER_PARTITION: die Speichermenge für jede Partition, z. B.
30GiB
MESSAGE_RETENTION_PERIOD: die Zeit, die das Lite-Thema Nachrichten speichert, z. B.
1d
oder2w
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile das Lite-Thema angezeigt:
name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOD
Protokoll
Senden Sie zum Aktualisieren eines Lite-Themas eine PATCH
-Anfrage wie die folgende:
PATCH https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID?updateMask=partitionConfig.capacity,retentionConfig.perPartitionBytes,retentionConfig.period,partitionConfig.count Authorization: Bearer $(gcloud auth print-access-token)
Ersetzen Sie Folgendes:
REGION: Region, in der sich das Lite-Thema befindet
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Thema
LOCATION: der Name des Standorts, an dem sich das Lite-Thema befindet
TOPIC_ID: die ID des Lite-Themas
Geben Sie im Anfragetext die folgenden Felder an:
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Ersetzen Sie Folgendes:
publish_CAPACITY: Eine Ganzzahl für die Durchsatzkapazität beim Veröffentlichen jeder Partition
subscribe_CAPACITY: Eine Ganzzahl für die Durchsatzkapazität beim Abonnieren jeder Partition
STORAGE_PER_PARTITION: die Speichermenge für jede Partition, z. B.
30GiB
MESSAGE_RETENTION_PERIOD: die Zeit, die das Lite-Thema Nachrichten speichert, z. B.
1d
oder2w
NUMBER_OF_PARTITIONS: die Anzahl der Partitionen, die für das Lite-Thema konfiguriert werden sollen
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Thema im JSON-Format:
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Einfach loslegen (Go)
Bevor Sie dieses Beispiel ausführen, folgen Sie der Einrichtungsanleitung für Go unter Pub/Sub Lite-Clientbibliotheken.
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Java unter Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Python unter Pub/Sub Lite-Clientbibliotheken.
Details zum Lite-Thema ansehen
Sie können Details zu einem Lite-Thema über die Google Cloud Console, die Google Cloud CLI oder die Pub/Sub Lite API abrufen.
Console
Rufen Sie die Seite Lite-Themen auf.
Klicken Sie auf die Lite-Themen-ID.
gcloud
Mit dem Befehl gcloud pubsub lite-topics describe
können Sie Details zu einem Lite-Thema abrufen:
gcloud pubsub lite-topics describe TOPIC_ID \ --location=LOCATION
Ersetzen Sie Folgendes:
TOPIC_ID: die ID des Lite-Themas
LOCATION: der Name des Standorts, an dem sich das Lite-Thema befindet
Wenn die Anfrage erfolgreich ist, wird in der Befehlszeile das Lite-Thema angezeigt:
name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOD
Protokoll
Wenn Sie Details zu einem Lite-Thema abrufen möchten, senden Sie eine GET
-Anfrage wie die folgende:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Ersetzen Sie Folgendes:
REGION: Region, in der sich das Lite-Thema befindet
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Thema
LOCATION: der Name des Standorts, an dem sich das Lite-Thema befindet
TOPIC_ID: die ID des Lite-Themas
Wenn die Anfrage erfolgreich ist, ist die Antwort das Lite-Thema im JSON-Format:
{ "name": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Einfach loslegen (Go)
Bevor Sie dieses Beispiel ausführen, folgen Sie der Einrichtungsanleitung für Go unter Pub/Sub Lite-Clientbibliotheken.
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Java unter Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Python unter Pub/Sub Lite-Clientbibliotheken.
Lite-Themen auflisten
Sie können Lite-Themen in einem Projekt mit der Google Cloud Console, der Google Cloud CLI oder der Pub/Sub Lite API auflisten.
Console
Wenn Sie sich eine Liste der Lite-Themen in einem Projekt ansehen möchten, rufen Sie die Seite Lite-Themen auf.
gcloud
- Verwenden Sie den Befehl
gcloud pubsub lite-topics list
, um die Lite-Themen in einem Projekt aufzulisten:
gcloud pubsub lite-topics list \ --location=LOCATION
Ersetzen Sie LOCATION durch den Namen des Standorts, an dem sich das Lite-Thema befindet.
Wenn die Anfrage erfolgreich ist, werden in der Befehlszeile die Lite-Themen angezeigt:
--- name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOND --- name: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID partitionConfig: count: NUMBER_OF_PARTITIONS capacity: publishMibPerSec: publish_CAPACITY subscribeMibPerSec: subscribe_CAPACITY retentionConfig: perPartitionBytes: STORAGE_PER_PARTITION period: MESSAGE_RETENTION_PERIOND
Protokoll
Um die Lite-Themen in einem Projekt aufzulisten, senden Sie eine GET
-Anfrage wie die folgende:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/topics Authorization: Bearer $(gcloud auth print-access-token)
Ersetzen Sie Folgendes:
REGION: Region, in der sich das Lite-Thema befindet
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Thema
Wenn die Anfrage erfolgreich ist, ist die Antwort eine Liste von Lite-Themen im JSON-Format:
{ "topics": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", } ] }
Einfach loslegen (Go)
Bevor Sie dieses Beispiel ausführen, folgen Sie der Einrichtungsanleitung für Go unter Pub/Sub Lite-Clientbibliotheken.
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Java unter Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Python unter Pub/Sub Lite-Clientbibliotheken.
Lite-Thema löschen
Sie können Lite-Themen mit der Google Cloud Console, der Google Cloud CLI oder der Pub/Sub Lite API löschen.
Console
Rufen Sie die Seite Lite-Themen auf.
Klicken Sie auf die Lite-Themen-ID.
Klicken Sie auf der Seite Lite-Themendetails auf Löschen.
Geben Sie im angezeigten Feld
delete
ein, um zu bestätigen, dass Sie das Lite-Thema löschen möchten.Klicken Sie auf Löschen.
gcloud
Verwenden Sie den Befehl gcloud pubsub lite-topics delete
, um ein Lite-Thema zu löschen:
Führen Sie den Befehl
delete
aus:gcloud pubsub lite-topics delete TOPIC_ID \ --location=LOCATION
Ersetzen Sie Folgendes:
TOPIC_ID: die ID des Lite-Themas
LOCATION: der Name des Standorts, an dem sich das Lite-Thema befindet
Zum Bestätigen geben Sie "
Y
" ein.
Wenn die Anfrage erfolgreich ist, lautet die Antwort folgendermaßen:
Deleted topic [TOPIC_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/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Ersetzen Sie Folgendes:
REGION: Region, in der sich das Lite-Thema befindet
PROJECT_NUMBER: die Projektnummer des Projekts mit dem Lite-Thema
LOCATION: der Name des Standorts, an dem sich das Lite-Thema befindet
TOPIC_ID: die ID des Lite-Themas
Wenn die Anfrage erfolgreich ist, ist die Antwort ein leeres JSON-Objekt.
Einfach loslegen (Go)
Bevor Sie dieses Beispiel ausführen, folgen Sie der Einrichtungsanleitung für Go unter Pub/Sub Lite-Clientbibliotheken.
Java
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Java unter Pub/Sub Lite-Clientbibliotheken.
Python
Bevor Sie dieses Beispiel ausführen, folgen Sie der Anleitung zur Einrichtung von Python unter Pub/Sub Lite-Clientbibliotheken.
Wenn Sie ein Lite-Thema löschen, können Sie darin keine Nachrichten veröffentlichen. Die Lite-Abos für das Lite-Thema sind noch vorhanden, aber Sie können keine Nachrichten von den Lite-Abos empfangen.
Weitere Informationen
- Nachrichten zu einem Lite-Thema veröffentlichen
- Erstellen Sie ein Lite-Abo für ein Lite-Thema.
- Nachrichten von einem Lite-Abo empfangen