Questo documento spiega come creare, visualizzare ed eliminare un argomento Pub/Sub Lite.
Panoramica di un argomento Lite
Un servizio Pub/Sub Lite richiede un argomento a cui gli editori possono inviare messaggi in modo che i sottoscrittori possano riceverli. All'interno di Pub/Sub Lite, puoi scegliere di creare un argomento Lite a livello di zona o di regione.
Un argomento Lite a livello di zona e un argomento Lite a livello di regione si differenziano solo per il modo in cui replicano i dati. Tutte le altre proprietà dell'argomento sono le stesse descritte in una sezione successiva di questo documento.
Replica dei dati in un argomento Lite
Gli argomenti regionali Pub/Sub Lite archiviano i dati in due zone di una singola regione. Gli argomenti di zona Pub/Sub Lite replicano i dati all'interno di una sola zona. Pub/Sub Lite replica i dati in modo asincrono.
La disponibilità di Pub/Sub Lite dipende dalla disponibilità dei componenti sottostanti, che includono sia il frontend dell'applicazione sia l'archiviazione.
La disponibilità di un argomento a livello di zona di Pub/Sub Lite dipende dalla disponibilità sia del frontend dell'applicazione sia dello spazio di archiviazione nella zona configurata. Se il frontend o l'archiviazione dell'applicazione subisce un errore a livello di zona, l'argomento Lite di zona diventa non disponibile per la durata dell'interruzione.
La disponibilità di un argomento regionale di Pub/Sub Lite dipende dalla disponibilità del frontend dell'applicazione e dell'archiviazione nella regione configurata. Sono possibili i seguenti tipi di errore:
Se si verifica un errore di zona per l'archiviazione frontend o dell'applicazione, l'argomento Lite a livello di regione rimane disponibile.
Se si verifica un errore a livello di zona sia per il frontend dell'applicazione sia per l'archiviazione, l'argomento Lite a livello di regione rimane disponibile purché non si verifichino errori su entrambi i componenti contemporaneamente.
Se sia il frontend dell'applicazione che l'archiviazione hanno esito negativo contemporaneamente, l'argomento Lite a livello di regione rimane non disponibile per la durata dell'interruzione. Durante questo periodo, i client potrebbero non riuscire a pubblicare o utilizzare i messaggi, ma i messaggi vengono comunque recapitati nell'ordine corretto.
Un argomento Lite a livello di regione offre protezione dalla maggior parte dei tipi di errori a zona singola. Tuttavia, in alcuni rari casi, la natura asincrona della replica può causare un errore simultaneo di più componenti in una singola zona. Di conseguenza, un argomento Lite a livello di regione non è più disponibile.
Proprietà di un argomento Lite
Gli argomenti Lite hanno le seguenti proprietà:
Numero di partizioni. Una partizione è l'unità base di parallelismo in Pub/Sub Lite. Un argomento Lite può avere una o più partizioni.
Capacità di una partizione. La capacità di una partizione è descritta dalle seguenti tre proprietà:
Velocità effettiva di pubblicazione (MiBps). La frequenza massima con cui puoi pubblicare messaggi.
Velocità effettiva di sottoscrizione (MiBps). La frequenza massima con cui i messaggi vengono inoltrati alle sottoscrizioni Lite.
Spazio di archiviazione (GiB). La dimensione massima dei messaggi nella partizione. La capacità minima configurabile di una partizione è di 30 GiB.
Capacità di archiviazione di un argomento Lite. Tutte le partizioni di un argomento Lite hanno la stessa capacità di archiviazione configurata. La capacità di archiviazione totale di un argomento Lite è la somma della capacità di archiviazione di tutte le partizioni dell'argomento. Ad esempio, se un argomento Lite ha 8 partizioni e ogni partizione ha una dimensione di 30 GiB, la capacità di archiviazione totale dell'argomento Lite è di 240 GiB (8 x 30).
Capacità di velocità effettiva di un argomento Lite. La capacità di velocità effettiva è la capacità di velocità effettiva totale di pubblicazione e sottoscrizione di tutte le partizioni nell'argomento Lite. Anche se hai un argomento che, in forma aggregata, può supportare 1 GiBps di velocità effettiva di pubblicazione, è il limite di pubblicazione per partizione che limita effettivamente la velocità effettiva.
Limite di abbonamenti e client di abbonati. Pub/Sub Lite supporta un singolo client sottoscrittore per una singola partizione e una singola sottoscrizione. Ad esempio, una sottoscrizione a un argomento con 5 partizioni può avere, al massimo, 5 client sottoscrittori che consumano messaggi dall'argomento. Se vengono configurati più client sottoscrittori, i client in eccesso rimangono inattivi. Lo stesso argomento con 2 abbonamenti può avere fino a 10 client sottoscrittori, 5 client per ogni abbonamento.
Prenotazioni. La prenotazione è il modo più semplice per eseguire il provisioning e gestire la capacità di velocità effettiva. Il provisioning della capacità di velocità effettiva con le prenotazioni è obbligatorio per Lite a livello di regione ed è facoltativo per gli argomenti Lite di zona.
Se non utilizzi le prenotazioni per un argomento Lite a livello di zona, devi eseguire il provisioning esplicito della capacità di velocità effettiva di pubblicazione e sottoscrizione dell'argomento. Senza una prenotazione, tutte le partizioni in un argomento Lite hanno la stessa capacità di velocità effettiva configurata. Per saperne di più, consulta Configurare la capacità della velocità effettiva senza prenotazioni.
Configurazione dello spazio di archiviazione. Per configurare lo spazio di archiviazione, devi specificare sia la capacità di archiviazione sia, facoltativamente, il periodo di conservazione dei messaggi.
Periodo di conservazione dei messaggi. Il periodo di tempo massimo per cui un argomento Lite archivia i messaggi. Se non specifichi un periodo di conservazione dei messaggi, l'argomento Lite archivia i messaggi finché non superi la capacità di archiviazione.
Capacità di archiviazione. La capacità dell'argomento Pub/Sub Lite è determinata dal numero di partizioni nell'argomento e dalla capacità di archiviazione di ogni partizione. Lo spazio di archiviazione per partizione è la quantità di spazio di archiviazione, in byte, per ogni partizione. Tieni presente che gli argomenti Lite a livello di regione utilizzano due byte di capacità di archiviazione per ogni byte pubblicato. Gli argomenti Lite a livello di zona utilizzano un byte di capacità di archiviazione per ogni byte pubblicato.
Se superi la capacità di archiviazione, il servizio Pub/Sub Lite continua a pubblicare messaggi. Tuttavia, per creare maggiore capacità di archiviazione, vengono eliminati i messaggi meno recenti della partizione. I messaggi meno recenti vengono eliminati anche se rientrano nel periodo di conservazione dei messaggi. Il servizio non elimina mai i messaggi prima della scadenza del relativo TTL, a meno che la loro rimozione non sia necessaria per fare spazio ai nuovi messaggi pubblicati. Per informazioni sulla correlazione tra la capacità e i prezzi, vedi Prezzi di Pub/Sub Lite.
Linee guida per assegnare un nome a un argomento
Un nome risorsa Pub/Sub Lite identifica in modo univoco una risorsa Pub/Sub Lite, ad esempio un argomento, una sottoscrizione o una prenotazione. Il nome della risorsa deve rientrare nel seguente formato:
projects/project-identifier/collection/ID
project-identifier
: deve essere l'ID o il numero di progetto, disponibile nella console Google Cloud. Ad esempio,my-cool-project
è un ID progetto.123456789123
è un numero di progetto.collection
: deve esseretopics
,subscriptions
oreservations
.ID
: deve essere conforme alle seguenti linee guida:- Non iniziare con la stringa
goog
- Inizia con una lettera
- Contenere tra 3 e 255 caratteri
- Contenere solo i seguenti caratteri: lettere
[A-Za-z]
, numeri[0-9]
, trattini-
, trattini bassi_
, punti.
, tilde~
, segni più+
e segni di percentuale%
Puoi utilizzare i caratteri speciali dell'elenco precedente nei nomi delle risorse senza codifica URL. Tuttavia, devi assicurarti che tutti gli altri caratteri speciali siano codificati o decodificati correttamente quando li utilizzi negli URL. Ad esempio,
mi-tópico
è un ID non valido. Tuttavia,mi-t%C3%B3pico
è valido. Questo formato è importante quando esegui chiamate REST.- Non iniziare con la stringa
Aumenta la capacità di velocità effettiva di un argomento Lite
Se non utilizzi le prenotazioni Lite, puoi impostare la capacità di velocità effettiva di ogni partizione di qualsiasi argomento Lite della zona su un valore impostato in base ai seguenti limiti:
Velocità effettiva di pubblicazione compresa tra 4 e 16 MiBps
Velocità effettiva di sottoscrizione tra 4 e 32 MiBps
Questi limiti si applicano anche alle partizioni associate a una prenotazione Lite. Con le prenotazioni, ogni partizione può consumare qualsiasi capacità di velocità effettiva entro i limiti specificati, purché la capacità totale della prenotazione non venga superata. Facoltativamente, puoi impostare un limite inferiore alla velocità effettiva effettiva per partizione, in modo da rendere il traffico più prevedibile.
Puoi aumentare il numero di partizioni in un argomento per scalarlo orizzontalmente. Il numero di partizioni in un argomento non può essere diminuito.
Quando modifichi il numero di partizioni, l'ordine relativo dei messaggi non viene conservato. Internamente, i messaggi vengono assegnati alle partizioni mediante una funzione hash. L'aggiornamento del numero di partizioni in un argomento modifica questa funzione hash. I messaggi con la stessa chiave pubblicati dopo l'aggiornamento del conteggio delle partizioni sono probabilmente mappati a una partizione diversa da quelle pubblicate prima dell'aggiornamento.
Inoltre, la propagazione del ridimensionamento dell'argomento a tutti gli editori richiede alcuni secondi. C'è un breve periodo di tempo in cui alcuni editori utilizzano la nuova funzione hash e altri ancora quella vecchia.
Aumenta la capacità di archiviazione di un argomento Lite
Puoi aumentare o diminuire la quantità di spazio di archiviazione in un argomento Lite. L'argomento Lite esegue il provisioning della stessa quantità di spazio di archiviazione per ogni partizione. Se aumenta lo spazio di archiviazione a 60 GiB, ciascuna delle partizioni riceve 60 GiB di spazio di archiviazione.
Se riduci la quantità di spazio di archiviazione in un argomento Lite, il servizio Pub/Sub Lite rimuove prima i messaggi meno recenti.
Per informazioni sulla correlazione tra la capacità e i prezzi, vedi Prezzi di Pub/Sub Lite
Crea un argomento Lite
Puoi creare argomenti Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Per un elenco delle regioni e delle zone disponibili, vedi Località Pub/Sub Lite.
Console
Vai alla pagina Argomenti Lite.
Fai clic su Crea argomento Lite.
Per creare un argomento Lite a livello di zona, seleziona una regione e una zona al suo interno.
Per creare un argomento Lite a livello di regione, seleziona una regione.
Non puoi aggiornare la località dopo la creazione di un argomento.
Nella sezione Nome, inserisci un ID argomento Lite.
Il nome dell'argomento Lite include l'ID dell'argomento Lite, la località e il numero del progetto.
Nella sezione Velocità effettiva:
Seleziona o crea una prenotazione.
Facoltativo per un argomento Lite a livello di zona e obbligatorio per un argomento Lite a livello di regione.
Inserisci la velocità effettiva di pubblicazione massima e la velocità effettiva di sottoscrizione massima.
Alcune partizioni vengono impostate automaticamente in base ai tuoi input. Puoi modificare questo numero dopo aver salvato l'argomento.
Nella sezione Archiviazione messaggi:
Inserisci lo spazio di archiviazione per partizione.
Seleziona una delle due opzioni per il periodo di conservazione dei messaggi.
Rivedi le modifiche e fai clic su Crea.
gcloud
Per creare un argomento Lite, utilizza il comando 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]
Sostituisci quanto segue:
TOPIC_ID: l'ID dell'argomento Lite
LOCATION: il nome di una località supportata da Pub/Sub Lite
NUMBER_OF_PARTITIONS: un numero intero per il numero di partizioni nell'argomento Lite
STORAGE_PER_PARTITION: la quantità di spazio di archiviazione per ogni partizione, ad esempio
30GiB
RESERVATION_NAME: il percorso completo di una prenotazione Lite come
projects/123456789/locations/us-west1/reservations/my-reservation
MESSAGE_RETENTION_PERIOD: la quantità di tempo in cui l'argomento Lite archivia i messaggi, ad esempio
1d
o2w
Se la richiesta ha esito positivo, la riga di comando visualizza una conferma:
Created [TOPIC_ID].
Protocollo
Per creare un argomento Lite, invia una richiesta POST
come la seguente:
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui archiviare l'argomento Lite
PROJECT_NUMBER: il numero del progetto del progetto per creare l'argomento Lite in
LOCATION: il nome di una località supportata da Pub/Sub Lite
TOPIC_ID: l'ID dell'argomento Lite
Specifica i seguenti campi nel corpo della richiesta:
{ "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 } }
Sostituisci quanto segue:
NUMBER_OF_PARTITIONS: un numero intero per il numero di partizioni nell'argomento Lite
STORAGE_PER_PARTITION: la quantità di spazio di archiviazione per ogni partizione, ad esempio
30GiB
publish_CAPACITY: un numero intero per la capacità di velocità effettiva di pubblicazione di ogni partizione
subscribe_CAPACITY: un numero intero per la capacità di velocità effettiva di sottoscrizione di ogni partizione
MESSAGE_RETENTION_PERIOD: la quantità di tempo in cui l'argomento Lite archivia i messaggi, ad esempio
1d
o2w
RESERVATION_NAME: il percorso completo di una prenotazione Lite come
projects/123456789/locations/us-west1/reservations/my-reservation
Se la richiesta ha esito positivo, la risposta è l'argomento Lite in formato JSON:
{ "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 } }
Go
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go nelle librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java nelle librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python nelle librerie client di Pub/Sub Lite.
Dopo aver creato l'argomento Lite, puoi scalare la velocità effettiva per partizione e la capacità di archiviazione. Puoi anche aumentare, ma non diminuire il numero di partizioni.
Aggiorna un argomento Lite
Puoi aggiornare le seguenti proprietà di un argomento Lite:
La prenotazione associata all'argomento Lite
Il numero di partizioni nell'argomento (può solo essere aumentato)
Limiti di capacità di velocità effettiva di pubblicazione e sottoscrizione
Lo spazio di archiviazione per partizione
Il tipo di conservazione dei messaggi
Prima di scalare la capacità di velocità effettiva o la capacità di archiviazione di un argomento, consulta Scalare la capacità di velocità effettiva e Scalare la capacità di archiviazione.
Puoi aggiornare un argomento Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Argomenti Lite.
Fai clic sull'ID argomento Lite.
Fai clic su Modifica.
Puoi apportare uno o tutti i seguenti aggiornamenti:
- Usa un'altra prenotazione. Per gli argomenti a livello di zona, puoi scegliere di non utilizzare una prenotazione.
- Inserisci il numero di partizioni. Questo valore può essere aumentato, ma non diminuito.
- Abilita o disabilita la velocità effettiva massima di pubblicazione e sottoscrizione consentita.
- Per gli argomenti di zona, aggiorna la velocità effettiva di pubblicazione e sottoscrizione prenotata. Per gli argomenti con una prenotazione allegata, la velocità effettiva aggiornata riflette il nuovo limite massimo.
- Modifica la capacità di archiviazione per partizione.
- Modifica il periodo di conservazione dei messaggi.
Fai clic su Update (Aggiorna).
gcloud
Per aggiornare un argomento Lite, utilizza il comando gcloud pubsub lite-topics update
:
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
Sostituisci quanto segue:
TOPIC_ID: l'ID dell'argomento Lite
LOCATION: il nome della località in cui si trova l'argomento Lite
NUMBER_OF_PARTITIONS: il numero di partizioni da configurare per l'argomento Lite.
publish_CAPACITY: un numero intero per la capacità di velocità effettiva di pubblicazione di ogni partizione
subscribe_CAPACITY: un numero intero per la capacità di velocità effettiva di sottoscrizione di ogni partizione
STORAGE_PER_PARTITION: la quantità di spazio di archiviazione per ogni partizione, ad esempio
30GiB
MESSAGE_RETENTION_PERIOD: la quantità di tempo in cui l'argomento Lite archivia i messaggi, ad esempio
1d
o2w
Se la richiesta ha esito positivo, la riga di comando visualizza l'argomento Lite:
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
Protocollo
Per aggiornare un argomento Lite, invia una richiesta PATCH
come la seguente:
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)
Sostituisci quanto segue:
REGION: la regione in cui si trova l'argomento Lite
PROJECT_NUMBER: il numero del progetto con l'argomento Lite
LOCATION: il nome della località in cui si trova l'argomento Lite
TOPIC_ID: l'ID dell'argomento Lite
Specifica i seguenti campi nel corpo della richiesta:
{ "partitionConfig": { "count": NUMBER_OF_PARTITIONS, "capacity": { "publishMibPerSec": publish_CAPACITY, "subscribeMibPerSec": subscribe_CAPACITY, } }, "retentionConfig": { "perPartitionBytes": STORAGE_PER_PARTITION, "period": MESSAGE_RETENTION_PERIOD, }, }
Sostituisci quanto segue:
publish_CAPACITY: un numero intero per la capacità di velocità effettiva di pubblicazione di ogni partizione
subscribe_CAPACITY: un numero intero per la capacità di velocità effettiva di sottoscrizione di ogni partizione
STORAGE_PER_PARTITION: la quantità di spazio di archiviazione per ogni partizione, ad esempio
30GiB
MESSAGE_RETENTION_PERIOD: la quantità di tempo in cui l'argomento Lite archivia i messaggi, ad esempio
1d
o2w
NUMBER_OF_PARTITIONS: il numero di partizioni da configurare per l'argomento Lite.
Se la richiesta ha esito positivo, la risposta è l'argomento Lite in formato JSON:
{ "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, }, }
Go
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go nelle librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java nelle librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python nelle librerie client di Pub/Sub Lite.
Visualizza i dettagli dell'argomento Lite
Puoi ottenere i dettagli di un argomento Lite utilizzando la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Argomenti Lite.
Fai clic sull'ID argomento Lite.
gcloud
Per ottenere dettagli su un argomento Lite, utilizza il comando gcloud pubsub lite-topics describe
:
gcloud pubsub lite-topics describe TOPIC_ID \ --location=LOCATION
Sostituisci quanto segue:
TOPIC_ID: l'ID dell'argomento Lite
LOCATION: il nome della località in cui si trova l'argomento Lite
Se la richiesta ha esito positivo, la riga di comando visualizza l'argomento Lite:
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
Protocollo
Per ricevere dettagli su un argomento Lite, invia una richiesta GET
come la seguente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui si trova l'argomento Lite
PROJECT_NUMBER: il numero del progetto con l'argomento Lite
LOCATION: il nome della località in cui si trova l'argomento Lite
TOPIC_ID: l'ID dell'argomento Lite
Se la richiesta ha esito positivo, la risposta è l'argomento Lite in formato JSON:
{ "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, }, }
Go
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go nelle librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java nelle librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python nelle librerie client di Pub/Sub Lite.
Elenco di argomenti Lite
Puoi elencare gli argomenti Lite in un progetto utilizzando la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Per visualizzare un elenco degli argomenti Lite in un progetto, vai alla pagina Argomenti Lite.
gcloud
- Per elencare gli argomenti Lite in un progetto, utilizza il comando
gcloud pubsub lite-topics list
:
gcloud pubsub lite-topics list \ --location=LOCATION
Sostituisci LOCATION con il nome della posizione in cui si trova l'argomento Lite.
Se la richiesta ha esito positivo, la riga di comando visualizza gli argomenti Lite:
--- 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
Protocollo
Per elencare gli argomenti Lite in un progetto, invia una richiesta GET
come la seguente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/topics Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui si trova l'argomento Lite
PROJECT_NUMBER: il numero del progetto con l'argomento Lite
Se la richiesta ha esito positivo, la risposta è un elenco di argomenti Lite in formato JSON:
{ "topics": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID", } ] }
Go
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go nelle librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java nelle librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python nelle librerie client di Pub/Sub Lite.
Eliminare un argomento Lite
Puoi eliminare gli argomenti Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Argomenti Lite.
Fai clic sull'ID argomento Lite.
Nella pagina Dettagli argomento Lite, fai clic su Elimina.
Nel campo visualizzato, inserisci
delete
per confermare che vuoi eliminare l'argomento Lite.Fai clic su Elimina.
gcloud
Per eliminare un argomento Lite, utilizza il comando gcloud pubsub lite-topics delete
:
Esegui il comando
delete
:gcloud pubsub lite-topics delete TOPIC_ID \ --location=LOCATION
Sostituisci quanto segue:
TOPIC_ID: l'ID dell'argomento Lite
LOCATION: il nome della località in cui si trova l'argomento Lite
Per confermare, digita
Y
.
Se la richiesta ha esito positivo, la risposta è la seguente:
Deleted topic [TOPIC_ID].
Protocollo
Per eliminare un argomento Lite, invia una richiesta DELETE
come la seguente:
DELETE https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui si trova l'argomento Lite
PROJECT_NUMBER: il numero del progetto con l'argomento Lite
LOCATION: il nome della località in cui si trova l'argomento Lite
TOPIC_ID: l'ID dell'argomento Lite
Se la richiesta ha esito positivo, la risposta è un oggetto JSON vuoto.
Go
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go nelle librerie client di Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java nelle librerie client di Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python nelle librerie client di Pub/Sub Lite.
Se elimini un argomento Lite, non puoi pubblicare messaggi al suo interno. Le sottoscrizioni Lite all'argomento Lite esistono ancora, ma non puoi ricevere messaggi dalle sottoscrizioni Lite.
Passaggi successivi
- Pubblicare messaggi in un argomento Lite.
- Crea una sottoscrizione Lite a un argomento Lite.
- Ricevere messaggi da una sottoscrizione Lite.