Cuando creas una suscripción, esta se adjunta a un tema y los suscriptores pueden recibir mensajes de la suscripción. Para que los suscriptores no reciban mensajes, puedes desconectar las suscripciones del tema.
Antes de comenzar
- Obtén información sobre las suscripciones.
- Crea una de las siguientes suscripciones: extracción, envío o BigQuery.
Roles y permisos requeridos
Para obtener el permiso que
necesitas para desconectar suscripciones,
pídele a tu administrador que te otorgue el
rol de IAM Editor de Pub/Sub (roles/pubsub.editor) en el tema.
Para obtener más información sobre cómo otorgar roles, consulta Administra el acceso a proyectos, carpetas y organizaciones.
Este rol predefinido contiene el
pubsub.topics.detachSubscription
permiso,
que se requiere para
desconectar suscripciones.
También puedes obtener este permiso 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.
Desconecta una suscripción de un tema
Puedes desconectar una suscripción de un tema con la Cloud de Confiance consola, la Google Cloud CLI, la biblioteca cliente o la API de Pub/Sub.
Console
Para desconectar una suscripción, sigue estos pasos:
En la Cloud de Confiance consola, ve a la página Temas.
Selecciona el tema del que deseas desconectar una suscripción.
En la pestaña Suscripciones, selecciona la suscripción que deseas desconectar.
En la página Detalles de la suscripción, haz clic en Desconectar.
En el cuadro de diálogo que aparecerá, vuelve a hacer clic en Desconectar.
gcloud
-
En la Cloud de Confiance consola, activa Cloud Shell.
En la parte inferior de la Cloud de Confiance consola, 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 desconectar una suscripción, usa el
gcloud pubsub topics detach-subscriptioncomando:gcloud pubsub topics detach-subscription SUBSCRIPTION_ID
Si la solicitud es exitosa, la línea de comandos muestra una confirmación:
Detached subscription [SUBSCRIPTION_ID].
REST
Para desconectar una suscripción, usa el projects.subscriptions.detachmétodo.
Solicitud:
La solicitud debe autenticarse con un token de acceso en el encabezado Authorization. Para obtener un token de acceso para las credenciales predeterminadas actuales de la aplicación, usa el
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
Aquí:
- PROJECT_ID es el ID del proyecto.
- SUBSCRIPTION_ID es el ID de la suscripción.
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.
El servicio de Pub/Sub podría tardar varios minutos en terminar de desconectar la suscripción del tema.
Una vez que el servicio de Pub/Sub desconecta la suscripción del tema, borra los mensajes que retiene para la suscripción. No puedes recuperar los mensajes de la suscripción ni volver a adjuntar la suscripción a un tema. Para liberar la cuota de tu Cloud de Confiance proyecto, borra la suscripción.
Si la suscripción y el tema están en proyectos diferentes, el servicio de Pub/Sub agrega una entrada a los registros de auditoría de ambos proyectos. Cloud de Confiance
¿Qué sigue?
- Crea o modifica una suscripción con
gcloudcomandos. - Crea o modifica una suscripción con las APIs de REST.