Borrar un registro de esquemas es una acción irreversible. Se borrarán de forma permanente todos los temas, esquemas y versiones que contiene el registro. Antes de continuar, asegúrate de que no haya clientes de Kafka activos que dependan de este registro.
Roles y permisos requeridos
Para obtener los permisos que
necesitas para borrar un registro de esquema,
pídele a tu administrador que te otorgue el rol de IAM
Editor del registro de esquema de Kafka administrado (roles/managedkafka.schemaRegistryEditor)
en la instancia del registro de esquema.
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 un registro de esquema. Para ver los permisos exactos que son necesarios, expande la sección Permisos requeridos:
Permisos necesarios
Se requieren los siguientes permisos para borrar un registro de esquema:
-
Otorga el siguiente permiso en el registro de esquemas:
managedkafka.schemaRegistries.delete -
Otorga el siguiente permiso para que los usuarios de la consola puedan enumerar los registros de esquemas:
managedkafka.schemaRegistries.list -
Otorga el siguiente permiso para que los usuarios de la consola obtengan detalles del registro de esquemas:
managedkafka.schemaRegistries.get
También puedes obtener estos permisos con roles personalizados o con otros roles predefinidos.
El rol de nivel superior Administrador del registro de esquemas de Kafka administrado (roles/managedkafka.schemaRegistryAdmin) también incluye estos permisos.
Para obtener más información sobre los roles predefinidos disponibles para Managed Service for Apache Kafka, consulta la documentación de control de acceso.
Borra un registro de esquemas
Para borrar de forma permanente un registro de esquema y todo su contenido, sigue estos pasos:
Console
- En la consola Google Cloud , ve a la página Registros de esquemas.
Ir a los registros de esquemas
Se muestra una lista de los registros de esquemas de tu proyecto.
- Haz clic en el nombre del registro de esquemas que deseas borrar.
- En la página Detalles del registro de esquemas, haz clic en el botón Borrar.
- Confirma la eliminación cuando se te solicite.
gcloud
-
Instala Google Cloud CLI. Después de la instalación, inicializa Google Cloud CLI con el siguiente comando:
gcloud initSi usas un proveedor de identidad externo (IdP), primero debes acceder a la gcloud CLI con tu identidad federada.
Usa el comando
gcloud beta managed-kafka schema-registries delete:gcloud beta managed-kafka schema-registries delete SCHEMA_REGISTRY_ID \ --location=LOCATION \
Reemplaza lo siguiente:
SCHEMA_REGISTRY_ID(obligatorio): Es el ID del registro de esquema que deseas borrar.LOCATION(obligatorio): Es la región de Google Cloud donde se encuentra el registro de esquemas.
Por ejemplo, para borrar un registro de esquema llamado testRegistry en la región us-central1, ejecuta el siguiente comando:
gcloud beta managed-kafka schema-registries delete testRegistry \ --location=us-central1
API
Realiza una solicitud DELETE al URI de recurso específico del registro de esquema que deseas borrar.
DELETE https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID
Reemplaza lo siguiente:
PROJECT_ID(obligatorio): Tu ID del proyecto de Google Cloud.SCHEMA_REGISTRY_ID(obligatorio): Es el ID del registro de esquema que deseas borrar.LOCATION(obligatorio): Es la región de Google Cloud donde se encuentra el registro de esquemas.
Si la solicitud se realiza correctamente y se borra el registro de esquemas, la API suele devolver un código de estado 200 OK con un cuerpo JSON vacío que indica la finalización de una operación de larga duración o el recurso de la operación en sí.
Si el registro de esquemas especificado no existe, recibirás un error 404 Not Found.
Si no tienes permisos, recibirás un error 403 Forbidden.