I sottoscrittori utilizzano una sottoscrizione Lite per leggere i messaggi da un argomento Lite. Quando crei una sottoscrizione Lite, la colleghi a un argomento Lite. Puoi collegare molte sottoscrizioni Lite a un singolo argomento Lite.
Esistono due tipi di abbonamento:
- Abbonamento standard. Crea una sottoscrizione standard se hai un client che deve leggere i messaggi dell'argomento Lite.
- Esporta abbonamento. Creare una sottoscrizione per l'esportazione quando devi esportare messaggi Lite in Pub/Sub. Per maggiori informazioni, consulta Esportare i messaggi Pub/Sub Lite in Pub/Sub.
Proprietà di una sottoscrizione Lite
Un abbonamento per un argomento Lite a livello di zona ha proprietà identiche a quelle di una sottoscrizione per un argomento Lite a livello di regione, ad eccezione di quanto segue:
Tipo di località, una zona o una regione, utilizzato nel nome della risorsa. Un esempio di località a livello di regione è
us-central1
; un esempio di località in una zona èus-central1-a
.Affidabilità. Per saperne di più sulle differenze di affidabilità tra argomenti a livello di regione e zona, consulta Replica dei dati in un argomento Lite.
Requisito di recapito per i messaggi
In caso di errore temporaneo nella scrittura di un messaggio nello spazio di archiviazione, l'editore prova di nuovo a inviare il messaggio. Questi nuovi tentativi sono trasparenti per l'utente finale. Le sottoscrizioni Lite hanno una proprietà di requisito di recapito che modifica il modo in cui le sottoscrizioni reagiscono a questi nuovi tentativi di invio dei messaggi. Puoi impostare la proprietà su una delle due opzioni seguenti:
Recapitare i messaggi immediatamente. Con questa opzione abilitata, i client sottoscrittori ricevono tutti i messaggi dopo aver raggiunto il server. Questo processo non dipende dallo stato dei messaggi scritti su disco. Gli offset non vengono riutilizzati, ma i messaggi con offset che non vengono scritti nello spazio di archiviazione potrebbero non essere rileggibili dopo un'operazione seek.
Recapitare i messaggi dopo l'archiviazione. Con questa opzione abilitata, il sottoscrittore non riceve messaggi finché non vengono scritti su disco. I messaggi sono garantiti per essere rileggibili dopo un'operazione di ricerca. L'abilitazione di questa opzione aumenta la latenza end-to-end per la ricezione di messaggi dall'editore al sottoscrittore.
Linee guida per assegnare un nome a una sottoscrizione
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
Crea una sottoscrizione Lite
Una sottoscrizione Lite deve trovarsi nello stesso progetto e nella stessa località dell'argomento Lite a cui è collegata la sottoscrizione Lite.
Per creare un argomento Lite, vedi Creare e gestire un argomento Lite.
Per un elenco delle località disponibili, vedi Località di Pub/Sub Lite.
Puoi creare un abbonamento Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Per informazioni sulla creazione di una sottoscrizione di esportazione, vedi Esportare i messaggi Pub/Sub Lite in Pub/Sub.
Console
Vai alla pagina Abbonamenti Lite.
Fai clic su Crea sottoscrizione Lite.
Inserisci un ID abbonamento Lite.
Scegli un argomento Lite da cui ricevere messaggi.
Scegli Recapita immediatamente i messaggi o Recapita i messaggi dopo l'archiviazione.
Scegli un tipo di Offset iniziale.
Scegli un Tipo di recapito.
Fai clic su Crea.
gcloud
Per creare una sottoscrizione Lite, utilizza il comando gcloud pubsub lite-subscriptions create
:
gcloud pubsub lite-subscriptions create SUBSCRIPTION_ID \ --location=LOCATION \ --topic=TOPIC_ID \ --delivery-requirement=DELIVERY_REQUIREMENT
Sostituisci quanto segue:
SUBSCRIPTION_ID: l'ID della sottoscrizione Lite
LOCATION: il nome di una località supportata da Pub/Sub Lite
TOPIC_ID: l'ID dell'argomento Lite da collegare alla sottoscrizione Lite
DELIVERY_REQUIREMENT:
deliver-after-stored
oppuredeliver-immediately
Se la richiesta ha esito positivo, la riga di comando visualizza una conferma:
Created [SUBSCRIPTION_ID].
Protocollo
Per creare una sottoscrizione Lite, invia una richiesta POST
come la seguente:
POST https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui archiviare la sottoscrizione Lite
PROJECT_NUMBER: il numero del progetto del progetto in cui creare la sottoscrizione Lite
LOCATION: il nome di una località supportata da Pub/Sub Lite
SUBSCRIPTION_ID: l'ID della sottoscrizione Lite
Specifica i seguenti campi nel corpo della richiesta:
{ "topic": projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID, "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Sostituisci DELIVERY_REQUIREMENT con deliver-after-stored
o
deliver-immediately
.
Se la richiesta ha esito positivo, la risposta è la sottoscrizione Lite in formato JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "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.
Dopo aver creato una sottoscrizione Lite a un argomento Lite, puoi ricevere messaggi dalla sottoscrizione Lite.
Aggiorna una sottoscrizione Lite
Puoi aggiornare gli abbonamenti Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Abbonamenti Lite.
Fai clic sull'ID sottoscrizione Lite.
Nella pagina Dettagli abbonamento Lite, fai clic su Modifica.
gcloud
Per aggiornare una sottoscrizione Lite, utilizza il comando gcloud pubsub lite-subscriptions update
:
gcloud pubsub lite-subscriptions update SUBSCRIPTION_ID \ --location=LOCATION \ --delivery-requirement=DELIVERY_REQUIREMENT
Sostituisci quanto segue:
SUBSCRIPTION_ID: l'ID della sottoscrizione Lite
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
DELIVERY_REQUIREMENT:
deliver-after-stored
oppuredeliver-immediately
Se la richiesta ha esito positivo, la riga di comando visualizza la sottoscrizione Lite:
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protocollo
Per aggiornare una sottoscrizione Lite, invia una richiesta PATCH
come la seguente:
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)
Sostituisci quanto segue:
REGION: la regione in cui archiviare la sottoscrizione Lite
PROJECT_NUMBER: il numero del progetto con la sottoscrizione Lite
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
SUBSCRIPTION_ID: l'ID della sottoscrizione Lite
Specifica i seguenti campi nel corpo della richiesta:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } }
Sostituisci DELIVERY_REQUIREMENT con deliver-after-stored
o
deliver-immediately
.
Se la richiesta ha esito positivo, la risposta è la sottoscrizione Lite in formato JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "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.
Visualizza i dettagli della sottoscrizione Lite
Puoi ottenere i dettagli di un abbonamento Lite utilizzando la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Abbonamenti Lite.
Fai clic sull'ID sottoscrizione Lite.
Nella pagina dei dettagli della sottoscrizione Lite, fai clic sulla scheda Dettagli.
gcloud
Per ottenere i dettagli di una sottoscrizione Lite, utilizza il comando gcloud pubsub lite-subscriptions describe
:
gcloud pubsub lite-subscriptions describe SUBSCRIPTION_ID \ --location=LOCATION
Sostituisci quanto segue:
SUBSCRIPTION_ID: l'ID della sottoscrizione Lite
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
Se la richiesta ha esito positivo, la riga di comando visualizza l'argomento Lite:
deliveryConfig: deliveryRequirement: DELIVERY_REQUIREMENT name: projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID topic: projects/PROJECT_NUMBER/locations/LOCATION/topics/TOPIC_ID
Protocollo
Per ottenere i dettagli di un abbonamento Lite, invia una richiesta GET
come la seguente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui archiviare la sottoscrizione Lite
PROJECT_NUMBER: il numero del progetto con la sottoscrizione Lite
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
SUBSCRIPTION_ID: l'ID della sottoscrizione Lite
Se la richiesta ha esito positivo, la risposta è l'argomento Lite in formato JSON:
{ "deliveryConfig": { "deliveryRequirement": DELIVERY_REQUIREMENT, } "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID", "topic": "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.
Elenco di sottoscrizioni Lite
Puoi elencare le sottoscrizioni Lite in un progetto o le sottoscrizioni Lite a un argomento Lite.
Elenco di sottoscrizioni Lite in un progetto
Puoi elencare gli abbonamenti Lite in un progetto utilizzando la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Abbonamenti Lite.
gcloud
- Per elencare le sottoscrizioni Lite in un progetto, utilizza il comando
gcloud pubsub lite-subscriptions list
:
gcloud pubsub lite-subscriptions list \ --location=LOCATION
Sostituisci LOCATION con il nome della località in cui si trovano le sottoscrizioni Lite.
Se la richiesta ha esito positivo, la riga di comando visualizza le sottoscrizioni Lite:
--- 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
Protocollo
- Per elencare le sottoscrizioni Lite in un progetto, invia una richiesta
GET
come la seguente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui archiviare la sottoscrizione Lite
PROJECT_NUMBER: il numero del progetto con la sottoscrizione Lite
Se la richiesta ha esito positivo, la risposta è l'argomento Lite in formato JSON:
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_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.
Elenco delle sottoscrizioni Lite a un argomento Lite
Puoi elencare le sottoscrizioni Lite a un argomento Lite utilizzando la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Argomenti Lite.
Seleziona un ID argomento Lite.
Nella pagina dei dettagli degli argomenti Lite, la sezione Sottoscrizioni Lite include un elenco di sottoscrizioni Lite all'argomento Lite.
gcloud
- Per elencare le sottoscrizioni Lite a un argomento, utilizza il comando
gcloud pubsub lite-topics list-subscriptions
:
gcloud pubsub lite-topics list-subscriptions TOPIC_ID \ --location=LOCATION
Sostituisci quanto segue:
TOPIC_ID: l'ID dell'argomento Lite a cui sono collegate le sottoscrizioni Lite
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
Se la richiesta ha esito positivo, la riga di comando visualizza le sottoscrizioni Lite:
--- 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
Protocollo
- Per elencare le sottoscrizioni Lite a un argomento Lite, invia una richiesta
GET
come la seguente:
GET https://REGION-pubsublite.googleapis.com/v1/admin/projects/PROJECT_NUMBER/lite-topics/TOPIC_ID/subscriptions Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui archiviare la sottoscrizione Lite
PROJECT_NUMBER: il numero del progetto con la sottoscrizione Lite
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
TOPIC_ID: l'ID dell'argomento Lite a cui sono collegate le sottoscrizioni Lite
Se la richiesta ha esito positivo, la risposta è un elenco di abbonamenti Lite in formato JSON:
{ "subscriptions": [ { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_ID" }, { "name": "projects/PROJECT_NUMBER/locations/LOCATION/subscriptions/SUBSCRIPTION_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.
Elimina una sottoscrizione Lite
Puoi eliminare gli abbonamenti Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Console
Vai alla pagina Abbonamenti Lite.
Fai clic sull'ID sottoscrizione Lite.
Nella pagina dei dettagli dell'abbonamento Lite, fai clic su Elimina.
Nella finestra di dialogo visualizzata, fai clic su Elimina per confermare che vuoi eliminare l'abbonamento Lite.
gcloud
Per eliminare una sottoscrizione Lite, utilizza il comando gcloud pubsub lite-subscriptions delete
:
Esegui il comando
delete
:gcloud pubsub lite-subscriptions delete SUBSCRIPTION_ID \ --location=LOCATION
Sostituisci quanto segue:
SUBSCRIPTION_ID: l'ID della sottoscrizione Lite
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
Per confermare, digita
Y
.
Se la richiesta ha esito positivo, la riga di comando visualizza una conferma:
Deleted subscription [SUBSCRIPTION_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/subscriptions/SUBSCRIPTION_ID Authorization: Bearer $(gcloud auth print-access-token)
Sostituisci quanto segue:
REGION: la regione in cui archiviare la sottoscrizione Lite
PROJECT_NUMBER: il numero del progetto con la sottoscrizione Lite
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
SUBSCRIPTION_ID: l'ID della sottoscrizione 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.
Passaggi successivi
- Creare e gestire un argomento Lite.
- Pubblicare messaggi in un argomento Lite.
- Ricevere messaggi da una sottoscrizione Lite.