删除架构注册表是不可逆转的操作。注册表中包含的所有主题、架构和版本都会被永久删除。 请确保在继续操作之前,没有活跃的 Kafka 客户端依赖于此注册表。
所需的角色和权限
如需获得删除架构注册表所需的权限,请让您的管理员为您授予架构注册表实例的 Managed Kafka Schema Registry Editor (roles/managedkafka.schemaRegistryEditor) IAM 角色。
如需详细了解如何授予角色,请参阅管理对项目、文件夹和组织的访问权限。
此预定义角色包含删除架构注册表所需的权限。如需查看所需的确切权限,请展开所需权限部分:
所需权限
您需要具备以下权限才能删除架构注册表:
-
在架构注册表中授予以下权限:
managedkafka.schemaRegistries.delete -
授予以下权限,以便控制台用户列出架构注册表:
managedkafka.schemaRegistries.list -
授予以下权限,以便控制台用户获取架构注册表详细信息:
managedkafka.schemaRegistries.get
更高级别的 Managed Kafka Schema Registry Admin (roles/managedkafka.schemaRegistryAdmin) 角色也包含这些权限。
如需详细了解 Managed Service for Apache Kafka 可用的预定义角色,请参阅访问权限控制文档。
删除架构注册表
如需永久删除架构注册表及其所有内容,请按以下步骤操作:
控制台
- 在 Google Cloud 控制台中,前往架构注册表页面。
系统会显示项目中的架构注册表列表。
- 点击要删除的架构注册表的名称。
- 在架构注册表详情页面上,点击删除按钮。
- 在系统提示时确认删除。
gcloud
-
安装 Google Cloud CLI。 安装完成后,运行以下命令来初始化 Google Cloud CLI:
gcloud init如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI。
使用
gcloud beta managed-kafka schema-registries delete命令:gcloud beta managed-kafka schema-registries delete SCHEMA_REGISTRY_ID \ --location=LOCATION \
替换以下内容:
SCHEMA_REGISTRY_ID(必需):您要删除的架构注册表的 ID。LOCATION(必需):架构注册表所在的 Google Cloud 区域。
例如,如需删除 us-central1 区域中名为 testRegistry 的架构注册表,请运行以下命令:
gcloud beta managed-kafka schema-registries delete testRegistry \ --location=us-central1
API
向要删除的架构注册表的特定资源 URI 发出 DELETE 请求。
DELETE https://managedkafka.googleapis.com/v1main/projects/PROJECT_ID/locations/LOCATION/schemaRegistries/SCHEMA_REGISTRY_ID
替换以下内容:
PROJECT_ID(必需):您的 Google Cloud 项目 ID。SCHEMA_REGISTRY_ID(必需):您要删除的架构注册表的 ID。LOCATION(必需):架构注册表所在的 Google Cloud 区域。
如果请求成功且架构注册表已删除,API 通常会返回 200 OK 状态代码,并附带一个空的 JSON 正文,表明长时间运行的操作或操作资源本身已完成。
如果指定的架构注册表不存在,您会收到 404 Not Found 错误。
如果您缺少权限,则会收到 403 Forbidden 错误。