En este documento, se muestra cómo borrar revisiones de esquemas de Pub/Sub temas. La operación de eliminación de un esquema también borra todas las revisiones asociados con el esquema.
Antes de comenzar
- Comprender cómo funcionan los esquemas de Pub/Sub
- Crea un esquema.
Roles y permisos requeridos
Para obtener los permisos que necesitas para borrar y administrar las revisiones de esquemas,
pídele a tu administrador que te otorgue el rol de IAM de
Editor de Pub/Sub (roles/pubsub.editor
) en tu 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 y administrar revisiones de esquemas. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para borrar y administrar revisiones de esquemas:
-
Crea un esquema:
pubsub.schemas.create
-
Adjunta un esquema al tema:
pubsub.schemas.attach
-
Confirma una revisión del esquema:
pubsub.schemas.commit
-
Borra un esquema o una revisión de esquema:
pubsub.schemas.delete
-
Obtén un esquema o revisiones de esquema:
pubsub.schemas.get
-
Esquemas de lista:
pubsub.schemas.list
-
Enumera las revisiones de esquema:
pubsub.schemas.listRevisions
-
Revierte un esquema:
pubsub.schemas.rollback
-
Valida un mensaje:
pubsub.schemas.validate
-
Obtén la política de IAM de un esquema:
pubsub.schemas.getIamPolicy
-
Configura la política de IAM para un esquema:
pubsub.schemas.setIamPolicy
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
Puedes otorgar roles y permisos a principales, como usuarios, grupos, dominios o cuentas de servicio. Puedes crear un esquema en un proyecto y vincularlo a un tema ubicado en un proyecto diferente. Asegúrate de tener los permisos necesarios para cada proyecto.
Borra una revisión de esquema
A continuación, se incluyen algunos lineamientos importantes para borrar una revisión de esquema:
Puedes borrar una o varias revisiones de un esquema.
Si el esquema solo tiene una revisión, no puedes borrarla. En su lugar, borra el esquema.
La operación de eliminación de un esquema también borra todas las revisiones asociados con el esquema.
Si borras un esquema, fallará la publicación de mensajes en los temas asociados con ese esquema.
Si borras una revisión de esquema y se especifica como la primera revisión de un tema, se usará la siguiente revisión para la validación.
Si la revisión del esquema borrada se especifica como la última revisión de un se usará la revisión anterior del esquema para la validación.
Si la revisión del esquema borrada se encuentra dentro del rango de revisión especificado para un tema de validación, se omite la revisión.
Puedes borrar una revisión del esquema con el La consola de Google Cloud, gcloud CLI, la API de Pub/Sub, o las bibliotecas cliente de Cloud.
Console
En la consola de Google Cloud, ve a la página Esquemas de Pub/Sub.
Haz clic en el nombre de un esquema existente.
Se abrirá la página Detalles del esquema del esquema.
Selecciona la revisión que quieres borrar. También puedes seleccionar varias revisiones.
Haz clic en Borrar revisión.
Confirma la operación de eliminación.
gcloud
gcloud pubsub schemas delete-revision SCHEMA_NAME@REVISION_ID
Aquí:
- REVISION_ID es la revisión a la que deseas revertir.
REST
Para borrar una revisión del esquema, envía una solicitud DELETE como la siguiente:
POST https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID@REVISION_ID:deleteRevision Authorization: Bearer $(gcloud auth application-default print-access-token) Content-Type: application/json --data @response-body.json
El cuerpo de la respuesta debe contener una representación JSON del recurso de esquema borrado.
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
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.
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 Pub/Sub para Python.
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.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.
¿Qué sigue?
- Cómo borrar un esquema
- Enumera los esquemas
- Enumera las revisiones de un esquema
- Suscríbete a un tema con un esquema