刪除結構定義儲存庫

刪除結構定義儲存庫後無法復原。登錄檔中的所有主體、結構定義和版本都會永久刪除。請先確認沒有任何有效的 Kafka 用戶端依賴這個登錄檔,再繼續操作。

必要角色和權限

如要取得刪除結構定義儲存庫所需的權限,請要求管理員授予您結構定義儲存庫執行個體的「Managed Kafka Schema Registry Editor 」(roles/managedkafka.schemaRegistryEditor) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

這個預先定義的角色具備刪除結構定義登錄所需的權限。如要查看確切的必要權限,請展開「Required permissions」(必要權限) 部分:

所需權限

如要刪除結構定義登錄檔,您必須具備下列權限:

  • 在結構定義登錄中授予下列權限: managedkafka.schemaRegistries.delete
  • 授予主控台使用者下列權限,即可列出結構定義登錄: managedkafka.schemaRegistries.list
  • 授予主控台使用者下列權限,讓他們取得結構定義登錄詳細資料: managedkafka.schemaRegistries.get

您或許還可透過自訂角色或其他預先定義的角色取得這些權限。

較高層級的「代管 Kafka 結構定義儲存庫管理員」(roles/managedkafka.schemaRegistryAdmin) 角色也包含這些權限。

如要進一步瞭解 Managed Service for Apache Kafka 適用的預先定義角色,請參閱存取權控管說明文件

刪除結構定義儲存庫

如要永久刪除結構定義登錄檔和所有內容,請按照下列步驟操作:

控制台

  1. 前往 Google Cloud 控制台的「Schema registries」頁面。

    前往結構定義登錄

    畫面會顯示專案中的結構定義登錄清單。

  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® 是 The Apache Software Foundation 或其關聯企業在美國與/或其他國家/地區的註冊商標。