I sottoscrittori utilizzano una sottoscrizione Lite per leggere i messaggi di un argomento Lite. Quando crei una sottoscrizione Lite, la colleghi a un argomento Lite. Puoi allegare molte sottoscrizioni Lite a un singolo argomento Lite.
Esistono due tipi di abbonamenti:
- Abbonamento standard. Crea una sottoscrizione standard quando hai un client che deve leggere i messaggi dall'argomento Lite.
- Esporta abbonamento. Crea una sottoscrizione di esportazione quando devi esportare i messaggi Lite in Pub/Sub. Per ulteriori informazioni, consulta la sezione Esportare i messaggi di Pub/Sub Lite in Pub/Sub.
Proprietà di una sottoscrizione Lite
Una sottoscrizione per un argomento Lite a livello di zona ha proprietà identiche a 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à di una regione è
us-central1
; un esempio di località di una zona èus-central1-a
.Affidabilità. Consulta Replicazione dei dati in un argomento Lite per scoprire di più sulle differenze di affidabilità tra gli argomenti a livello di regione e a livello di zona.
Requisito di recapito per i messaggi
Un errore temporaneo nella scrittura di un messaggio nello spazio di archiviazione fa sì che il publisher ritenti di inviare il messaggio. Questi tentativi sono trasparenti per l'utente finale. Le sottoscrizioni Lite hanno una proprietà Requisito di recapito che modifica il modo in cui le sottoscrizioni reagiscono a questi tentativi di invio dei messaggi. Puoi impostare questa proprietà su una delle due seguenti opzioni:
Invia i messaggi immediatamente. Con questa opzione attivata, i client degli abbonati ricevono tutti i messaggi dopo che arrivano sul server. Questo processo non dipende dallo stato dei messaggi in fase di scrittura 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 di ricerca.
Recapita i messaggi dopo l'archiviazione. Con questa opzione attivata, l'abbonato non riceve i messaggi finché non vengono scritti su disco. È garantito che i messaggi siano nuovamente leggibili dopo un'operazione di ricerca. L'abilitazione di questa opzione aumenta la latenza end-to-end per la ricezione dei messaggi dal publisher all'abbonato.
Linee guida per assegnare un nome a un abbonamento
Un nome della 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 avere il seguente formato:
projects/project-identifier/collection/ID
project-identifier
: deve essere l'ID progetto o il numero del 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 deve iniziare con la stringa
goog
- Inizia con una lettera
- Contenere da 3 a 255 caratteri
- Contenere solo i seguenti caratteri: lettere
[A-Za-z]
, numeri[0-9]
, trattini-
, trattini bassi_
, punti.
, tildi~
, segni più+
e segni di percentuale%
Puoi utilizzare i caratteri speciali nell'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 deve iniziare con la stringa
Creare una sottoscrizione Lite
Una sottoscrizione Lite deve trovarsi nello stesso progetto e nella stessa località dell'argomento Lite a cui è collegata.
Per creare un argomento Lite, vedi Creare e gestire un argomento Lite.
Per un elenco delle località disponibili, consulta Località di Pub/Sub Lite.
Puoi creare una sottoscrizione Lite con la console Google Cloud, Google Cloud CLI o l'API Pub/Sub Lite.
Per informazioni sulla creazione di una sottoscrizione di esportazione, consulta Esportare i messaggi Pub/Sub Lite in Pub/Sub.
Console
Vai alla pagina Abbonamenti Lite.
Fai clic su Crea sottoscrizione Lite.
Inserisci un ID sottoscrizione Lite.
Scegli un argomento Lite da cui ricevere messaggi.
Scegli Invia messaggi immediatamente o Invia messaggi dopo l'archiviazione.
Scegli un tipo di Spostamento iniziale.
Scegli un Tipo di pubblicazione.
Fai clic su Crea.
gcloud
Per creare un abbonamento 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 dell'abbonamento 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
odeliver-immediately
Se la richiesta va a buon fine, la riga di comando mostra una conferma:
Created [SUBSCRIPTION_ID].
Protocollo
Per creare un abbonamento 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 l'abbonamento Lite
PROJECT_NUMBER: il numero di progetto del progetto in cui creare l'abbonamento Lite
LOCATION: il nome di una località supportata da Pub/Sub Lite
SUBSCRIPTION_ID: l'ID dell'abbonamento 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 riesce, la risposta è l'abbonamento 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", }
Vai
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go in Librerie client Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java riportate in Librerie client Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client Pub/Sub Lite.
Dopo aver creato una sottoscrizione Lite a un argomento Lite, puoi ricevere messaggi dalla sottoscrizione Lite.
Aggiornare una sottoscrizione Lite
Puoi aggiornare le sottoscrizioni 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 abbonamento Lite.
Nella pagina Dettagli dell'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 dell'abbonamento Lite
LOCATION: il nome della località in cui si trova l'abbonamento Lite
DELIVERY_REQUIREMENT:
deliver-after-stored
odeliver-immediately
Se la richiesta va a buon fine, la riga di comando mostra l'abbonamento 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 l'abbonamento Lite
PROJECT_NUMBER: il numero del progetto con l'abbonamento Lite
LOCATION: il nome della località in cui si trova l'abbonamento Lite
SUBSCRIPTION_ID: l'ID dell'abbonamento 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 riesce, la risposta è l'abbonamento 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", }
Vai
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go in Librerie client Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java riportate in Librerie client Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client Pub/Sub Lite.
Visualizzare i dettagli dell'abbonamento 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 abbonamento Lite.
Nella pagina dei dettagli dell'abbonamento Lite, fai clic sulla scheda Dettagli.
gcloud
Per visualizzare i dettagli di un abbonamento 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 dell'abbonamento Lite
LOCATION: il nome della località in cui si trova l'abbonamento Lite
Se la richiesta riesce, 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 recuperare 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 l'abbonamento Lite
PROJECT_NUMBER: il numero del progetto con l'abbonamento Lite
LOCATION: il nome della località in cui si trova l'abbonamento Lite
SUBSCRIPTION_ID: l'ID dell'abbonamento Lite
Se la richiesta riesce, 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", }
Vai
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go in Librerie client Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java riportate in Librerie client Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client Pub/Sub Lite.
Elenco di abbonamenti Lite
Puoi elencare le sottoscrizioni Lite in un progetto o le sottoscrizioni Lite a un argomento Lite.
Elenco di abbonamenti Lite in un progetto
Puoi elencare le sottoscrizioni 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 gli abbonamenti Lite.
Se la richiesta riesce, la riga di comando visualizza gli abbonamenti 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 iscrizioni 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 l'abbonamento Lite
PROJECT_NUMBER: il numero del progetto con l'abbonamento Lite
Se la richiesta riesce, 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" } ] }
Vai
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go in Librerie client Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java riportate in Librerie client Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client Pub/Sub Lite.
Elenco di 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 Abbonamenti Lite include un elenco di abbonamenti 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 associate le sottoscrizioni Lite
LOCATION: il nome della località in cui si trova l'abbonamento Lite
Se la richiesta va a buon fine, la riga di comando visualizza gli abbonamenti 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 l'abbonamento Lite
PROJECT_NUMBER: il numero del progetto con l'abbonamento Lite
LOCATION: il nome della località in cui si trova l'abbonamento Lite
TOPIC_ID: l'ID dell'argomento Lite a cui sono associate le sottoscrizioni Lite
Se la richiesta riesce, 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" } ] }
Vai
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go in Librerie client Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java riportate in Librerie client Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client Pub/Sub Lite.
Eliminare una sottoscrizione Lite
Puoi eliminare le sottoscrizioni 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 abbonamento Lite.
Nella pagina 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 un abbonamento 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 dell'abbonamento Lite
LOCATION: il nome della località in cui si trova l'abbonamento Lite
Per confermare, digita
Y
.
Se la richiesta va a buon fine, la riga di comando mostra 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 l'abbonamento Lite
PROJECT_NUMBER: il numero del progetto con l'abbonamento Lite
LOCATION: il nome della località in cui si trova l'abbonamento Lite
SUBSCRIPTION_ID: l'ID dell'abbonamento Lite
Se la richiesta riesce, la risposta è un oggetto JSON vuoto.
Vai
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Go in Librerie client Pub/Sub Lite.
Java
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Java riportate in Librerie client Pub/Sub Lite.
Python
Prima di eseguire questo esempio, segui le istruzioni di configurazione di Python in Librerie client Pub/Sub Lite.
Passaggi successivi
- Crea e gestisci un argomento Lite.
- Pubblicare messaggi in un argomento Lite.
- Ricevere messaggi da una sottoscrizione Lite.