En este documento, se describe cómo borrar un tema de Pub/Sub. Para borrar un puedes usar la consola de Google Cloud, 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
A fin de obtener los permisos que necesitas para borrar temas y administrarlos, haz lo siguiente:
solicita a tu administrador que te otorgue el
Editor de Pub/Sub(roles/pubsub.editor
)
IAM 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:
-
Crea un tema:
pubsub.topics.create
-
Para borrar un tema, haz lo siguiente:
pubsub.topics.delete
-
Desconecta una suscripción de un tema:
pubsub.topics.detachSubscription
-
Obtener un tema:
pubsub.topics.get
-
Obtén una lista de un tema:
pubsub.topics.list
-
Publicar en un tema:
pubsub.topics.publish
-
Actualizar un tema:
pubsub.topics.update
-
Obtén la política de IAM para un tema:
pubsub.topics.getIamPolicy
-
Configura la política de IAM para un tema:
pubsub.topics.setIamPolicy
También puedes obtener estos permisos con roles personalizados o con 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 vincularla 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. El
la lista de mensajes pendientes de la suscripción está disponible para los suscriptores. Después de borrar un tema, sus suscripciones tienen el nombre del tema _deleted-topic_
. Si intentas
para crear un tema con el mismo nombre que acabas de borrar.
un error durante un período breve.
Console
En la consola de Google Cloud, 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
delete
y, luego, haz clic en Borrar.
gcloud
-
In the Google Cloud console, activate Cloud Shell.
At the bottom of the Google 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.
-
Para borrar un tema, usa el comando
gcloud pubsub topics delete
:gcloud pubsub topics delete TOPIC_ID
REST
Para borrar un tema, usa el método projects.topics.delete
:
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í:
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 que se encuentran en el Guía de inicio rápido de Pub/Sub con bibliotecas cliente. Para obtener más información, consulta la API de C de Pub/Sub documentación de referencia.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
C#
Antes de probar esta muestra, sigue las instrucciones de configuración de C# que se encuentran en el Guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de C# de Pub/Sub.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Go
Antes de probar esta muestra, sigue las instrucciones de configuración de Go que se encuentran en el Guía de inicio rápido de Pub/Sub con bibliotecas cliente. Para obtener más información, consulta la API de Go de Pub/Sub documentación de referencia.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Java
Antes de probar esta muestra, sigue las instrucciones de configuración de Java que encontrarás en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Para obtener más información, consulta la API de Java de Pub/Sub documentación de referencia.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Node.js
Node.js
PHP
Antes de probar esta muestra, sigue las instrucciones de configuración de PHP que encontrarás en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de PHP de Pub/Sub.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Python
Antes de probar esta muestra, sigue las instrucciones de configuración de Python que encontrarás en la guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Python de Pub/Sub.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
Ruby
Antes de probar esta muestra, sigue las instrucciones de configuración de Ruby que se encuentran en el Guía de inicio rápido de Pub/Sub con bibliotecas cliente. Si quieres obtener más información, consulta la documentación de referencia de la API de Ruby de Pub/Sub.
Para autenticarte en Pub/Sub, configura las credenciales predeterminadas de la aplicación. Si deseas obtener más información, consulta Configura la autenticación para un entorno de desarrollo local.
¿Qué sigue?
Elige el tipo de suscripción de tu tema.
Crea una suscripción para tu tema: extracción, envío o BigQuery.
Crea o modifica un tema con gcloud CLI.
Crea o modifica un tema con las APIs de REST.