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 un abbonamento standard se disponi di un che deve leggere i messaggi dell'argomento Lite.
- Esporta abbonamento. Crea una sottoscrizione per l'esportazione quando è necessario Esportare messaggi Lite in Pub/Sub. Per ulteriori informazioni, vedi Esportare messaggi 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. Esempio di una località a livello di regione è
us-central1
; un esempio di posizione in una zona èus-central1-a
.Affidabilità. Consulta Replica dei dati in un argomento Lite per scoprire di più sulle differenze di affidabilità tra gli argomenti a livello di regione e di zona.
Requisito di recapito per i messaggi
Un errore temporaneo nella scrittura di un messaggio nello spazio di archiviazione fa sì che l'editore riprova a inviare il messaggio. Questi nuovi tentativi sono trasparenti per l'utente finale. Gli abbonamenti Lite hanno una proprietà per i requisiti di pubblicazione che cambia il modo in cui a questi nuovi messaggi. Puoi impostare questa proprietà a una delle seguenti due opzioni:
Recapitare i messaggi immediatamente. Con questa opzione abilitata, l'abbonato i client ricevono tutti i messaggi dopo che sono arrivati al server. Questo processo è non dipende dallo stato dei messaggi scritti su disco. Gli offset sono non viene riutilizzato, ma i messaggi con offset che non vengono scritti nello spazio di archiviazione potrebbero non saranno rileggibili a seguito di un'operazione seek.
Recapitare i messaggi dopo l'archiviazione. Con questa opzione abilitata, l'abbonato non riceve messaggi finché non vengono scritti su disco. I messaggi vengono la rileggibilità dopo un'operazione di ricerca è garantita. Attivazione di questa opzione aumenta la latenza end-to-end per la ricezione di messaggi dal publisher per l'abbonato.
Linee guida per assegnare un nome a una sottoscrizione
Un nome risorsa Pub/Sub Lite identifica in modo univoco Risorsa Pub/Sub Lite, ad esempio un argomento, una sottoscrizione 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 nel 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à 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à 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, consulta Esportare 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
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 allegare a Lite abbonamento
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 di progetto del per 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 JSON formato:
{ "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 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.
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
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 versione Lite abbonamento
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 JSON formato:
{ "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 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.
Visualizza i dettagli della sottoscrizione Lite
Puoi ottenere i dettagli di una sottoscrizione Lite utilizzando il 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
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 ricevere dettagli su una sottoscrizione Lite, invia una richiesta GET
come il
seguenti:
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 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", }
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 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
Puoi elencare Sottoscrizioni Lite in un progetto oppure le sottoscrizioni Lite a un argomento Lite.
Elenco di sottoscrizioni Lite in un progetto
Puoi elencare 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 la classe
gcloud pubsub lite-subscriptions list
:
gcloud pubsub lite-subscriptions list \ --location=LOCATION
Sostituisci LOCATION con il nome della località a cui si riferisce la sottoscrizione Lite disponibili.
Se la richiesta ha esito positivo, la riga di comando visualizza abbonamenti:
--- 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 seguenti:
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 versione Lite abbonamento
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" } ] }
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 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 delle sottoscrizioni Lite a un argomento Lite
Puoi elencare le sottoscrizioni Lite a un argomento Lite utilizzando 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 la classe
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 si riferisce la sottoscrizione Lite sono collegati
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
Se la richiesta ha esito positivo, la riga di comando visualizza abbonamenti:
--- 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 il seguenti:
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 versione Lite abbonamento
LOCATION: il nome della località in cui si trova la sottoscrizione Lite
TOPIC_ID: l'ID dell'argomento Lite a cui si riferisce la sottoscrizione Lite sono collegati
Se la richiesta ha esito positivo, la risposta è un elenco di sottoscrizioni 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 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.
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. la sottoscrizione Lite.
gcloud
Per eliminare una sottoscrizione Lite, utilizza
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 versione Lite abbonamento
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.
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 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
- Creare e gestire un argomento Lite.
- Pubblicare messaggi in un argomento Lite.
- Ricevere messaggi da una sottoscrizione Lite.