このドキュメントでは、Pub/Sub トピックのスキーマを検証する方法について説明します。検証チェックでは、新しいリビジョンと古いリビジョンとの互換性はチェックされません。
準備
- Pub/Sub スキーマの仕組みを理解する。
- スキーマの作成
必要なロールと権限
スキーマ定義を検証して管理するために必要な権限を取得するには、管理者にPub/Sub 編集者 （roles/pubsub.editor ）プロジェクトに対する IAM ロールを付与するよう依頼してください。ロールの付与の詳細については、アクセス権の管理をご覧ください。
この事前定義ロールには、スキーマ定義を検証して管理するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。
必要な権限
スキーマ定義を検証して管理するには、次の権限が必要です。
-
スキーマを作成します:
pubsub.schemas.create -
スキーマをトピックに添付します:
pubsub.schemas.attach -
スキーマのリビジョンを commit します:
pubsub.schemas.commit -
スキーマまたはスキーマ リビジョンを削除します:
pubsub.schemas.delete -
スキーマまたはスキーマのリビジョンを取得します:
pubsub.schemas.get -
スキーマを一覧表示します:
pubsub.schemas.list -
スキーマのリビジョンを一覧表示します:
pubsub.schemas.listRevisions -
スキーマをロールバックします:
pubsub.schemas.rollback -
メッセージを検証します:
pubsub.schemas.validate -
スキーマの IAM ポリシーを取得します:
pubsub.schemas.getIamPolicy -
スキーマの IAM ポリシーを構成します:
pubsub.schemas.setIamPolicy
カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。
ユーザー、グループ、ドメイン、サービス アカウントなどのプリンシパルにロールと権限を付与できます。あるプロジェクトにスキーマを作成し、別のプロジェクトにあるトピックにアタッチできます。プロジェクトごとに必要な権限があることを確認します。
スキーマ定義を検証する
スキーマを検証するには、Google Cloud コンソール、gcloud CLI、Pub/Sub API、Cloud クライアント ライブラリを使用します。
スキーマを作成するの手順に従います。
検証チェックでは、新しいリビジョンと古いリビジョンとの互換性はチェックされません。