オブジェクト変更の登録

このページでは、Cloud Storage 用に Cloud Pub/Sub Notifications を設定して使用する方法について説明します。Google Cloud Pub/Sub Notifications では、Cloud Storage オブジェクトに関する変更内容を記録できます。Cloud Pub/Sub for Cloud Storage についての詳細は、Notifications の概念ページをご覧ください。

前提条件

この機能を使用する前に、以下が必要です。

  1. 通知を受け取るプロジェクトの Cloud Pub/Sub API を有効にすること。

    API を有効にする

  2. モニタリングするバケットに対して十分な権限を持っていること。

    • バケットを含むプロジェクトを所有している場合は、必要な権限を持っていると考えられます。

    • IAM を使用する場合は、storage.buckets.update 権限が必要です。これを行う方法については、IAM 権限の使用をご覧ください。

    • ACL を使用する場合は、OWNER 権限が必要です。設定方法については、ACL の設定をご覧ください。

  3. 通知を受け取るプロジェクトに対して十分な権限を持っていること。

    • 通知を受け取るプロジェクトを所有している場合は、必要な権限を持っていると考えられます。

    • 通知を受け取るトピックを作成する場合は、pubsub.topics.create 権限が必要です。

    • 新規トピックまたは既存トピックを使用する場合は、pubsub.topics.setIamPolicy 権限が必要です。トピックを作成する場合、通常は pubsub.topics.setIamPolicy 権限を持っています。

      これらの Cloud Pub/Sub 権限を取得する方法については、Cloud Pub/Sub アクセス制御をご覧ください。

  4. 通知を送信する既存の Cloud Pub/Sub トピックを持っていること。

  5. Cloud Storage バケットを含むプロジェクトに関連付けられているサービス アカウントのメールアドレスを取得すること。

  6. 前の手順で取得したメールアドレスを使用して、目的の Cloud Pub/Sub トピックの IAM 役割 pubsub.publisher をサービス アカウントに付与すること。

通知構成の適用

次の手順では、すべてのサポート対象イベントの通知を送信するバケットに通知構成を追加します。サブセットのイベントの通知を送信するには、gsutil コマンドで -e フラグを付加するか、JSON リクエストの本文に event_types キーを含めます。

gsutil

gsutil notification create コマンドを使用します。[VALUES_IN_BRACKETS] は適切な値に置き換えます。

gsutil notification create -t [TOPIC_NAME] -f json gs://[BUCKET_NAME]

プロジェクトに存在しない [TOPIC_NAME] を使用すると、それが自動的に作成されます。

JSON API

  1. OAuth 2.0 Playground から承認アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。

  2. 次の情報を含む .json ファイルを作成します。[VALUES_IN_BRACKETS] は適切な値に置き換えます。

    {
"topic": "projects/[PROJECT_ID]/topics/[TOPIC_NAME]",
"payload_format": "JSON_API_V1"
}

  3. cURL を使用して、JSON API を POST notificationConfigs リクエストで呼び出します。[VALUES_IN_BRACKETS] は適切な値に置き換えます。 

    curl -X POST --data-binary @[JSON_FILE_NAME].json 
    
-H "Authorization: Bearer [OAUTH2_TOKEN]" 
    
-H "Content-Type: application/json" 
    
"https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs"

バケットの通知構成の一覧表示

特定のバケットに関連付けられた通知構成を一覧表示するには:

gsutil

gsutil notification list コマンドを使用します。[VALUES_IN_BRACKETS] は適切な値に置き換えます。

gsutil notification list gs://[BUCKET_NAME]

JSON API

  1. OAuth 2.0 Playground から承認アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。

  2. cURL を使用して、JSON API を GET notificationConfigs リクエストで呼び出します。[VALUES_IN_BRACKETS] は適切な値に置き換えます。 

    curl -X GET 
    
-H "Authorization: Bearer [OAUTH2_TOKEN]" 
    
"https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs"

通知構成の削除

バケットから既存の通知構成を削除するには:

gsutil

gsutil notification delete コマンドを使用します。[VALUES_IN_BRACKETS] は適切な値に置き換えます。

gsutil notification delete projects/_/buckets/[BUCKET_NAME]/notificationConfigs/[CONFIGURATION_NAME]

送信後、通知構成によってトリガーされたすべての通知が停止するまでに最大で 30 秒かかります。

JSON API

  1. OAuth 2.0 Playground から承認アクセス トークンを取得します。固有の OAuth 認証情報を使用するように Playground を構成します。

  2. cURL を使用して、JSON API を DELETE notificationConfigs リクエストで呼び出します。[VALUES_IN_BRACKETS] は適切な値に置き換えます。 

    curl -X DELETE 
    
-H "Authorization: Bearer [OAUTH2_TOKEN]" 
    
"https://www.googleapis.com/storage/v1/b/[BUCKET_NAME]/notificationConfigs/[CONFIGURATION_NAME]"

送信後、通知構成によってトリガーされたすべての通知が停止するまでに最大で 30 秒かかります。

次のステップ

このページは役立ちましたか？評価をお願いいたします。

フィードバックを送信...

このページ
ドキュメントのフィードバック
Cloud Storage
サービスのフィードバック
ご不明な点がありましたら、Google のサポートページをご覧ください。