Questo documento descrive come eliminare un argomento Pub/Sub. Per eliminare un argomento, puoi utilizzare la console Trusted Cloud , Google CLI, la libreria client o l'API Pub/Sub.
Prima di iniziare
- Scopri di più sugli argomenti e sul flusso di lavoro per la pubblicazione dei messaggi.
- Crea un argomento.
Ruoli e autorizzazioni richiesti
Per ottenere le autorizzazioni necessarie per eliminare gli argomenti e gestirli, chiedi all'amministratore di concederti il ruolo IAM Editor Pub/Sub(roles/pubsub.editor
) nell'argomento o nel progetto.
Per ulteriori informazioni sulla concessione dei ruoli, consulta Gestisci l'accesso a progetti, cartelle e organizzazioni.
Questo ruolo predefinito contiene le autorizzazioni necessarie per eliminare gli argomenti e gestirli. Per vedere quali sono esattamente le autorizzazioni richieste, espandi la sezione Autorizzazioni obbligatorie:
Autorizzazioni obbligatorie
Per eliminare gli argomenti e gestirli sono necessarie le seguenti autorizzazioni:
-
Crea un argomento:
pubsub.topics.create
-
Eliminare un argomento:
pubsub.topics.delete
-
Scollega un abbonamento da un argomento:
pubsub.topics.detachSubscription
-
Trovare un argomento:
pubsub.topics.get
-
Elenca un argomento:
pubsub.topics.list
-
Pubblica in un argomento:
pubsub.topics.publish
-
Aggiorna un argomento:
pubsub.topics.update
-
Recupera il criterio IAM per un argomento:
pubsub.topics.getIamPolicy
-
Configura il criterio IAM per un argomento:
pubsub.topics.setIamPolicy
Potresti anche ottenere queste autorizzazioni 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.
Eliminare un argomento
Quando elimini un argomento, i relativi abbonamenti non vengono eliminati. Il
backlog di messaggi della sottoscrizione è disponibile per gli abbonati. Dopo l'eliminazione di un argomento, le relative sottoscrizioni hanno il nome dell'argomento _deleted-topic_
. Se provi
a creare un argomento con lo stesso nome di quello che hai appena eliminato, prevedi
un errore per un breve periodo.
Console
Nella console Trusted Cloud , vai alla pagina Argomenti di Pub/Sub.
Seleziona un argomento e fai clic su
Altre azioni.Fai clic su Elimina.
Viene visualizzata la finestra Elimina argomento.
Inserisci
delete
e poi fai clic su Elimina.
gcloud
-
In the Trusted Cloud console, activate Cloud Shell.
At the bottom of the Trusted Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.
-
Per eliminare un argomento, utilizza il comando
gcloud pubsub topics delete
:gcloud pubsub topics delete TOPIC_ID
- PROJECT_ID è l'ID progetto.
- TOPIC_ID è l'ID argomento.
REST
Per eliminare un argomento, utilizza il
metodo
projects.topics.delete
:
Richiesta:
La richiesta deve essere autenticata con un token di accesso nell'intestazione
Authorization
. Per ottenere un token di accesso per le attuali
Credenziali predefinite dell'applicazione: gcloud auth application-default print-access-token
.
DELETE https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID Authorization: Bearer ACCESS_TOKEN
Dove:
Risposta:
Se la richiesta ha esito positivo, la risposta è un oggetto JSON vuoto.
C++
Prima di provare questo esempio, segui le istruzioni di configurazione di C++ nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub C++.
C#
Prima di provare questo esempio, segui le istruzioni di configurazione di C# nella guida rapida all'utilizzo delle librerie client. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Pub/Sub C#.
Vai
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 ritirati.
Prima di provare questo esempio, segui le istruzioni di configurazione di Go nella 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 nella guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Java di Pub/Sub.
Node.js
Prima di provare questo esempio, segui le istruzioni di configurazione di Node.js nella 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 nella 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 nella 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 nella guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Python.
Ruby
Il seguente esempio 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 ritirati.
Prima di provare questo esempio, segui le istruzioni di configurazione di Ruby nella guida rapida all'utilizzo delle librerie client. Per saperne di più, consulta la documentazione di riferimento dell'API Pub/Sub Ruby.
Passaggi successivi
Scegli il tipo di abbonamento per l'argomento.
Crea una sottoscrizione per l'argomento: pull, push o BigQuery.
Crea o modifica un argomento con gcloud CLI.
Crea o modifica un argomento con le API REST.