En este documento, se describe cómo borrar un tema de Pub/Sub. Para borrar un tema, puedes usar la Cloud de Confiance consola de , la CLI de Google, la biblioteca cliente, o la API de Pub/Sub.
Antes de comenzar
- Obtén información sobre los temas y el flujo de trabajo de publicación de mensajes.
- Crea un tema.
Roles y permisos requeridos
Para obtener los permisos que
necesitas para borrar temas y administrarlos,
pídele a tu administrador que te otorgue el
rol de IAM de Editor de Pub/Sub(roles/pubsub.editor)
en tu tema o proyecto.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene los permisos necesarios para borrar temas y administrarlos. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para borrar temas y administrarlos:
-
Crear un tema:
pubsub.topics.create -
Borrar un tema:
pubsub.topics.delete -
Desconectar una suscripción de un tema:
pubsub.topics.detachSubscription -
Obtener un tema:
pubsub.topics.get -
Enumerar un tema:
pubsub.topics.list -
Publicar en un tema:
pubsub.topics.publish -
Actualizar un tema:
pubsub.topics.update -
Obtener la política de IAM para un tema:
pubsub.topics.getIamPolicy -
Configurar la política de IAM para un tema:
pubsub.topics.setIamPolicy
También puedes obtener estos permisos con roles personalizados o otros roles predefinidos.
Puedes configurar el control de acceso a nivel de proyecto y a nivel de los recursos individuales. Puedes crear una suscripción en un proyecto y adjuntarla a un tema ubicado en un proyecto diferente. Asegúrate de tener los permisos necesarios para cada proyecto.
Borra un tema
Cuando borras un tema, no se borran sus suscripciones. Las tareas pendientes de mensajes de la suscripción están disponibles para los suscriptores. Después de borrar un tema, sus suscripciones tienen el nombre del tema _deleted-topic_. Si intentas crear un tema con el mismo nombre que acabas de borrar, es probable que aparezca un error durante un breve período.
Console
En la Cloud de Confiance consola de, ve a la página Temas de Pub/Sub.
Selecciona un tema y haz clic en Más acciones.
Haz clic en Borrar.
Aparecerá la ventana Borrar tema.
Ingresa
deletey, luego, haz clic en Borrar.
gcloud
-
En la Cloud de Confiance consola de, activa Cloud Shell.
En la parte inferior de la Cloud de Confiance consola de, se inicia una sesión de Cloud Shell en la que se muestra una ventana de línea de comandos. Cloud Shell es un entorno de shell con Google Cloud CLI ya instalada y con valores ya establecidos para el proyecto actual. La sesión puede tardar unos segundos en inicializarse.
-
Para borrar un tema, usa el
gcloud pubsub topics deletecomando:gcloud pubsub topics delete TOPIC_ID
REST
Para borrar un tema, usa el
projects.topics.delete
método:
Solicitud:
La solicitud debe autenticarse con un token de acceso en el encabezado Authorization. A fin de obtener un token de acceso para las credenciales predeterminadas actuales de la aplicación
, usa el siguiente comando: gcloud auth application-default print-access-token.
DELETE https://pubsub.googleapis.com/v1/projects/PROJECT_ID/topics/TOPIC_ID Authorization: Bearer ACCESS_TOKEN
Aquí:
- PROJECT_ID es el ID del proyecto.
- TOPIC_ID es el ID del tema.
Respuesta:
Si la solicitud es correcta, la respuesta es un objeto JSON vacío.
C++
Antes de probar esta muestra, sigue las instrucciones de configuración de C++ en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para C++ .
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para C#.
Go
En la siguiente muestra, se usa la versión principal de la biblioteca cliente de Pub/Sub de Go (v2). Si aún usas la biblioteca v1, consulta la guía de migración a la v2. Para ver una lista de muestras de código de la v1, consulta las muestras de código obsoletas.
Antes de probar esta muestra, sigue las instrucciones de configuración de Go en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Go.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Java .
Node.js
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Node.js.
Node.ts
Antes de probar esta muestra, sigue las instrucciones de configuración de Node.js en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Node.js.
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para PHP .
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Python de Pub/Sub .
Ruby
En la siguiente muestra, se usa la biblioteca cliente de Pub/Sub de Ruby v3. Si aún usas la biblioteca v2, consulta la guía de migración a la v3. Para ver una lista de muestras de código de la v2 de Ruby, consulta las muestras de código obsoletas.
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby en la guía de inicio rápido sobre el uso de bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Pub/Sub para Ruby.
¿Qué sigue?
Elige el tipo de suscripción para tu tema.
Crea una suscripción para tu tema: extracción, envío o BigQuery.
Crea o modifica un tema con la CLI de gcloud.
Crea o modifica un tema con las APIs de REST.