スキーマ レジストリを削除する

スキーマ レジストリを削除すると、元に戻すことはできません。レジストリに含まれるすべてのサブジェクト、スキーマ、バージョンが完全に削除されます。続行する前に、アクティブな Kafka クライアントがこのレジストリに依存していないことを確認してください。

必要なロールと権限

スキーマ レジストリを削除するために必要な権限を取得するには、スキーマ レジストリ インスタンスに対する Managed Kafka スキーマ レジストリ編集者 roles/managedkafka.schemaRegistryEditor)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには、スキーマ レジストリの削除に必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

スキーマ レジストリを削除するには、次の権限が必要です。

  • スキーマ レジストリに次の権限を付与します。 managedkafka.schemaRegistries.delete
  • コンソール ユーザーに、スキーマ レジストリを一覧表示するための次の権限を付与します。 managedkafka.schemaRegistries.list
  • コンソール ユーザーがスキーマ レジストリの詳細を取得できるように、次の権限を付与します。 managedkafka.schemaRegistries.get

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

上位レベルの Managed Kafka Schema Registry 管理者roles/managedkafka.schemaRegistryAdmin)ロールにも、これらの権限が含まれています。

Managed Service for Apache Kafka で使用できる事前定義ロールの詳細については、アクセス制御のドキュメントをご覧ください。

スキーマ レジストリを削除する

スキーマ レジストリとそのすべてのコンテンツを完全に削除する手順は次のとおりです。

コンソール

  1. Google Cloud コンソールで、[スキーマ レジストリ] ページに移動します。

    スキーマ レジストリに移動

    プロジェクト内のスキーマ レジストリのリストが表示されます。

  2. 削除するスキーマ レジストリの名前をクリックします。
  3. [スキーマ レジストリの詳細] ページで、[削除] ボタンをクリックします。
  4. メッセージが表示されたら、削除を確定します。

gcloud

  1. Google Cloud CLI をインストールします。 インストール後、次のコマンドを実行して Google Cloud CLI を初期化します。

    gcloud init

    外部 ID プロバイダ(IdP)を使用している場合は、まず連携 ID を使用して 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 は通常、長時間実行オペレーションの完了を示す空の JSON 本文またはオペレーション リソース自体を含む 200 OK ステータス コードを返します。

指定したスキーマ レジストリが存在しない場合は、404 Not Found エラーが返されます。

権限がない場合は、403 Forbidden エラーが返されます。

次のステップ

Apache Kafka® は、Apache Software Foundation または米国その他の諸国における関連会社の登録商標です。