删除架构注册表

删除架构注册表是不可逆转的操作。注册表中包含的所有主题、架构和版本都会被永久删除。 请确保在继续操作之前,没有活跃的 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 可用的预定义角色,请参阅访问权限控制文档

删除架构注册表

如需永久删除架构注册表及其所有内容,请按以下步骤操作:

控制台

  1. 在 Google Cloud 控制台中,前往架构注册表页面。

    前往架构注册表

    系统会显示项目中的架构注册表列表。

  2. 点击要删除的架构注册表的名称。
  3. 架构注册表详情页面上,点击删除按钮。
  4. 在系统提示时确认删除。

gcloud

  1. 安装 Google Cloud CLI。 安装完成后,运行以下命令来初始化 Google Cloud CLI:

    gcloud init

    如果您使用的是外部身份提供方 (IdP),则必须先使用联合身份登录 gcloud CLI

  2. 使用 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 错误。

后续步骤

Apache Kafka® 是 Apache Software Foundation 或其关联公司在美国和/或其他国家/地区的注册商标。