Quando crei una sottoscrizione, la colleghi a un argomento e gli abbonati possono ricevere messaggi dalla sottoscrizione. Per impedire agli abbonati di ricevere messaggi, puoi scollegare le sottoscrizioni dall'argomento.
Prima di iniziare
- Scopri di più sulle sottoscrizioni.
- Crea una delle seguenti sottoscrizioni: pull, push o BigQuery.
Ruoli e autorizzazioni richiesti
Per ottenere l'autorizzazione necessaria per scollegare le sottoscrizioni, chiedi all'amministratore di concederti il ruolo IAM Pub/Sub Editor (roles/pubsub.editor) nell'argomento.
Per saperne di più sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene l'
autorizzazione,
necessaria per
scollegare le sottoscrizioni.
pubsub.topics.detachSubscription
Potresti anche ottenere questa autorizzazione con ruoli personalizzati o altri ruoli predefiniti.
Puoi configurare il controllo dell'accesso a livello di progetto e a livello di singola risorsa. Puoi creare una sottoscrizione in un progetto e collegarla a un argomento che si trova in un altro progetto. Assicurati di disporre delle autorizzazioni necessarie per ogni progetto.
Scollegare una sottoscrizione da un argomento
Puoi scollegare una sottoscrizione da un argomento utilizzando la Cloud de Confiance console, la Google Cloud CLI, la libreria client o l'API Pub/Sub.
Console
Per scollegare una sottoscrizione:
Nella Cloud de Confiance console, vai alla pagina Argomenti.
Seleziona l'argomento da cui vuoi scollegare una sottoscrizione.
Nella scheda Sottoscrizioni, seleziona la sottoscrizione da scollegare.
Nella pagina Dettagli sottoscrizione, fai clic su Scollega.
Nella finestra di dialogo che compare, fai di nuovo clic su Scollega.
gcloud
-
Nella Cloud de Confiance console, attiva Cloud Shell.
Nella parte inferiore della Cloud de Confiance console viene avviata una sessione di Cloud Shell e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già inclusa e installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.
-
Per scollegare una sottoscrizione, utilizza il
gcloud pubsub topics detach-subscriptioncomando:gcloud pubsub topics detach-subscription SUBSCRIPTION_ID
Se la richiesta va a buon fine, la riga di comando mostra una conferma:
Detached subscription [SUBSCRIPTION_ID].
REST
Per scollegare una sottoscrizione, utilizza il projects.subscriptions.detachmetodo.
Richiesta:
La richiesta deve essere autenticata con un token di accesso nell'intestazione Authorization. Per ottenere un token di accesso per le credenziali predefinite dell'applicazione corrente, utilizza il
gcloud auth application-default print-access-token comando.
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/subscriptions/SUBSCRIPTION_ID:detach Authorization: Bearer ACCESS_TOKEN
Dove:
- PROJECT_ID è l'ID progetto.
- SUBSCRIPTION_ID è l'ID sottoscrizione.
Risposta:
Se la richiesta va a buon fine, la risposta è un oggetto JSON vuoto.
C++
Prima di provare questo esempio, segui le istruzioni di configurazione di C++ in Guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub C++ .
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# in Guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub C# .
Go
L'esempio seguente utilizza la versione principale della libreria client Go Pub/Sub (v2). Se utilizzi ancora la libreria v1, consulta la guida alla migrazione alla v2. Per visualizzare un elenco di esempi di codice della versione 1, consulta gli esempi di codice deprecati.
Prima di provare questo esempio, segui le istruzioni di configurazione di Go in Guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Go.
Java
Prima di provare questo esempio, segui le istruzioni di configurazione di Java in Guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Java.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js in guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Node.js.
Node.ts
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js in guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Node.js.
PHP
Prima di provare questo esempio, segui le istruzioni di configurazione di PHP in guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub PHP.
Python
Prima di provare questo esempio, segui le istruzioni di configurazione di Python in Guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Python.
Ruby
L'esempio seguente utilizza la libreria client Ruby Pub/Sub v3. Se utilizzi ancora la libreria v2, consulta la guida alla migrazione alla v3. Per visualizzare un elenco di esempi di codice Ruby v2, consulta gli esempi di codice deprecati.
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby in Guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Ruby.
Il servizio Pub/Sub potrebbe impiegare alcuni minuti per completare lo scollegamento della sottoscrizione dall'argomento.
Dopo che il servizio Pub/Sub scollega la sottoscrizione dall'argomento, elimina tutti i messaggi che conserva per la sottoscrizione. Non puoi recuperare questi messaggi dalla sottoscrizione o ricollegare la sottoscrizione a un argomento. Per liberare la quota del Cloud de Confiance progetto, elimina la sottoscrizione.
Se la sottoscrizione e l'argomento si trovano in progetti diversi, il servizio Pub/Sub aggiunge una voce ai log di audit di entrambi i progetti. Cloud de Confiance
Passaggi successivi
- Crea o modifica una sottoscrizione con
gcloudcomandi. - Crea o modifica una sottoscrizione con le API REST.