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

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

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

始める前に

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

  • Cloud プロジェクトCloud プロジェクトの作成方法については、プロジェクトの作成と管理をご覧ください。
  • 適切な Identity and Access Management 権限。Service Usage に関する IAM の要件については、アクセス制御をご覧ください。
  • このガイドの gcloud コマンドライン サンプルを実行する場合は、Cloud SDK をインストールする必要があります。
  • このガイドのcurlの例を使用する場合は、スタートガイドの指示に従って初期設定を完了してください。

サービスの有効化

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 -d '{}' 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 と課金をご覧ください。

Console

プロジェクトで 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 -d '{}' https://serviceusage.googleapis.com/v1/projects/357084163378/services/pubsub.googleapis.com:disable

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