このドキュメントでは、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 クライアント ライブラリを使用して取得できます。結果は、最新のリビジョン ID の詳細を返します。
Console
Google Cloud コンソールで、[Pub/Sub スキーマ] ページに移動します。
表示するスキーマの名前をクリックします。
スキーマの [スキーマの詳細] ページが開きます。
gcloud
スキーマの最新リビジョンを表示するには:
gcloud pubsub schemas describe SCHEMA_NAME
スキーマの特定のリビジョンを表示するには:
gcloud pubsub schemas describe SCHEMA_ID@REVISION_ID
ここで
- REVISION_ID は、ロールバックするリビジョンです。
REST
スキーマの最新リビジョンの詳細を取得するには、次のような GET リクエストを送信します。
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID
たとえば、スキーマ ID が schema-inventory
のスキーマの場合は、次のリクエストを送信します。https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory
スキーマの特定のリビジョンの詳細を取得するには、次のような GET リクエストを送信します。
GET https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/SCHEMA_ID@REVISION_ID
たとえば、スキーマ ID が schema-inventory
でリビジョン ID が fa567a3e
のスキーマの場合は、次のリクエストを送信します。https://pubsub.googleapis.com/v1/projects/PROJECT_ID/schemas/schema-inventory@fa567a3e
ここで
- PROJECT_ID はプロジェクト ID です。
- SCHEMA_ID は、スキーマ ID です。
- REVISION_ID は、特定のスキーマのリビジョンの ID です。
成功した場合、レスポンスの本文にはスキーマクラスのインスタンスが含まれます。
C++
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の C++ の設定手順を実施してください。詳細については、Pub/Sub C++ API のリファレンス ドキュメントをご覧ください。
C#
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の C# の設定手順を実施してください。詳細については、Pub/Sub C# API のリファレンス ドキュメントをご覧ください。
Go
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の Go の設定手順を実施してください。詳細については、Pub/Sub Go API のリファレンス ドキュメントをご覧ください。
Java
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の Java の設定手順を実施してください。詳細については、Pub/Sub Java API のリファレンス ドキュメントをご覧ください。
Node.js
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の Node.js の設定手順を実施してください。詳細については、Pub/Sub Node.js API のリファレンス ドキュメントをご覧ください。
Node.js
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の Node.js の設定手順を実施してください。詳細については、Pub/Sub Node.js API のリファレンス ドキュメントをご覧ください。
PHP
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の PHP の設定手順を実施してください。詳細については、Pub/Sub PHP API のリファレンス ドキュメントをご覧ください。
Python
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の Python の設定手順を実施してください。詳細については、Pub/Sub Python API のリファレンス ドキュメントをご覧ください。
Ruby
このサンプルを試す前に、クイックスタート: クライアント ライブラリの使用の Ruby の設定手順を実施してください。詳細については、Pub/Sub Ruby API のリファレンス ドキュメントをご覧ください。