サービスの有効化と無効化

このページでは、Google Cloud プロジェクトのサービスを有効または無効にする方法について説明します。Service Usage を使用すると、公開Google Cloud サービスCloud Endpointsを使用して作成された非公開サービスなど、プロジェクトで利用可能なサービスを有効または無効にできます。公開 API と非公開 API サービスの相違について詳しくは、一般公開サービスと非公開サービスをご覧ください。

ほとんどの運用ユースケースでは、サービスを有効または無効にする最も簡単な方法は、Google Cloud Console を使用することです。スクリプトを作成する必要がある場合は、gcloudコマンドライン インターフェースを使用することもできます。Service Usage API に対するプログラムが必要な場合、用意されているいずれかのクライアント ライブラリを使用することをおすすめします。API を試すには、このガイドの代替手順に従い、curlコマンドを使用して、完全なアプリケーション開発環境をセットアップせずに API をテストできます。

始める前に

API とサービスを有効および無効にするには、以下が必要です。

サービスの有効化

Console

プロジェクトで API を有効にするには、次のようにします。

  1. Cloud Console のAPI ライブラリページに移動します。
    API ライブラリページに移動
  2. [選択] をクリックして、Cloudプロジェクトを選択します。
  3. 有効にする API をクリックします。API を検索する場合は検索フィールドを使用します。
  4. [有効にする] をクリックします。

gcloud

次のコマンドを実行して、現在のプロジェクトで Pub/Sub API サービスを有効にします。

gcloud services enable pubsub.googleapis.com

このコマンドによって、次のような出力が生成されます。

Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

次のコマンドを使用して、オペレーションの詳細を取得できます。

gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687

curl

services.enableを使用して単一のサービスを有効にできます。services.batchEnableメソッドを使用すると、1 回のオペレーションで 2〜20 のサービスを有効にできます。

次のコマンドは、プロジェクト番号357084163378の Pub/Sub API サービスを有効にします。

gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:enable

services.enableメソッドは、長時間実行オペレーションリソースを返します。これを使用して、オペレーションのステータスを確認できます。Service Usage operations.getメソッドを使用して、オペレーションステータスをポーリングできます。

次のコマンドは、プロジェクト番号357084163378で Pub/Sub と Dataflow API サービスの両方を有効にします。

gcurl -d '{
"serviceIds": ["pubsub.googleapis.com", "dataflow.googleapis.com"]
}' https://serviceusage.googleapis.com/v1/projects/357084163378/services:batchEnable

services.batchEnableメソッドは、長時間実行オペレーションリソースを返します。これを使用して、オペレーションのステータスを確認できます。Service Usage operations.getメソッドを使用して、オペレーションステータスをポーリングできます。

サービスの無効化

プロジェクトの API はいつでも無効にすることができますが、アカウントに対して保留中の料金は引き続き請求され、プロジェクト内の請求可能な API の使用に対して請求されます。詳しくは、API と課金をご覧ください。

コンソール

プロジェクトで API を無効にするには、次のようにします。

  1. Cloud Console のAPI ダッシュボードページに移動します。
    API ダッシュボードページに移動
  2. [選択] をクリックして、Cloudプロジェクトを選択します。
  3. 無効にする API の横の [無効にする] をクリックします。

gcloud

次のコマンドを実行して、現在のプロジェクトの Pub/Sub API サービスを無効にします。

gcloud services disable pubsub.googleapis.com

このコマンドによって、次のような出力が生成されます。

Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.

次のコマンドを使用して、オペレーションの詳細を取得できます。

gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8

curl

次のコマンドは、プロジェクト番号357084163378の Pub/Sub API サービスを無効にします。

gcurl https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:disable

services.disable メソッドでは、長時間実行オペレーション リソースが返されます。これを使用して、オペレーションのステータスを確認できます。Service Usage operations.getメソッドを使用して、オペレーションステータスをポーリングできます。