サービスの有効化を管理する

階層型サービス有効化を使用すると、 Google Cloud リソース階層から継承されるサービスの有効化を管理できます。詳細については、概要をご覧ください。

このドキュメントでは、Google Cloud CLI を使用して、プロジェクト、フォルダ、組織のサービスを有効にする方法について説明します。

始める前に

  1. Google Cloud アカウントにログインします。 Google Cloudを初めて使用する場合は、 アカウントを作成して、実際のシナリオで Google プロダクトのパフォーマンスを評価してください。新規のお客様には、ワークロードの実行、テスト、デプロイができる無料クレジット $300 分を差し上げます。
  2. Google Cloud CLI をインストールします。

  3. 外部 ID プロバイダ(IdP)を使用している場合は、まず フェデレーション ID を使用して gcloud CLI にログインする必要があります。

  4. gcloud CLI を初期化するには、次のコマンドを実行します。

    gcloud init
  5. Google Cloud プロジェクトを作成または選択します。

    プロジェクトの選択または作成に必要なロール

    • プロジェクトを選択する: プロジェクトを選択する際に、特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者のロール(roles/resourcemanager.projectCreator)が必要です。詳しくは、ロールを付与する方法をご覧ください。
    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、 Google Cloud プロジェクト名に置き換えます。

  6. このガイドで既存のプロジェクトを使用する場合は、このガイドを完了するために必要な権限があることを確認します。新しいプロジェクトを作成した場合は、必要な権限がすでに付与されています。

  7. Google Cloud CLI をインストールします。

  8. 外部 ID プロバイダ(IdP)を使用している場合は、まず フェデレーション ID を使用して gcloud CLI にログインする必要があります。

  9. gcloud CLI を初期化するには、次のコマンドを実行します。

    gcloud init
  10. Google Cloud プロジェクトを作成または選択します。

    プロジェクトの選択または作成に必要なロール

    • プロジェクトを選択する: プロジェクトを選択する際に、特定の IAM ロールは必要ありません。ロールが付与されているプロジェクトを選択できます。
    • プロジェクトを作成する: プロジェクトを作成するには、resourcemanager.projects.create 権限を含むプロジェクト作成者のロール(roles/resourcemanager.projectCreator)が必要です。詳しくは、ロールを付与する方法をご覧ください。
    • Google Cloud プロジェクトを作成します。

      gcloud projects create PROJECT_ID

      PROJECT_ID は、作成する Google Cloud プロジェクトの名前に置き換えます。

    • 作成した Google Cloud プロジェクトを選択します。

      gcloud config set project PROJECT_ID

      PROJECT_ID は、 Google Cloud プロジェクト名に置き換えます。

  11. このガイドで既存のプロジェクトを使用する場合は、このガイドを完了するために必要な権限があることを確認します。新しいプロジェクトを作成した場合は、必要な権限がすでに付与されています。

  12. 管理する Google Cloud リソースを指定しない場合、このドキュメントのコマンドはデフォルトで現在のプロジェクトに設定されます。たとえば、gcloud beta services list --enabled は、現在のプロジェクトで有効なサービスのリストを返します。

    現在のプロジェクト ID を取得できます。

    gcloud config list --format='text(core.project)'

必要なロール

サービスを有効にするために必要な権限を取得するには、ターゲット リソースに対する Service Usage 管理者 (roles/serviceusage.serviceUsageAdmin)IAM ロールを付与するよう管理者に依頼してください。ロールの付与については、プロジェクト、フォルダ、組織に対するアクセス権の管理をご覧ください。

この事前定義ロールには、サービスの有効化を管理するために必要な権限が含まれています。必要とされる正確な権限については、「必要な権限」セクションを開いてご確認ください。

必要な権限

サービスの有効化を管理するには、次の権限が必要です。

  • サービスを一覧表示する:
    • serviceusage.effectivepolicy.get
    • serviceusage.services.list
    • serviceusage.services.get
  • 次のサービスを有効にします。
    • serviceusage.consumerpolicy.get
    • serviceusage.consumerpolicy.update
    • serviceusage.groups.listExpandedMembers
  • サービスを無効にします。
    • serviceusage.consumerpolicy.get
    • serviceusage.consumerpolicy.update
    • serviceusage.consumerpolicy.analyze

カスタムロールや他の事前定義ロールを使用して、これらの権限を取得することもできます。

サービスの一覧表示

プロジェクト、フォルダ、組織で有効または使用可能な Google API とサービスを一覧表示するには、gcloud beta services list コマンドを使用します。

サービスの有効化と可用性は、リソースの祖先から継承できます。リソースの有効なサービスには、リソース自体で有効になっているサービスと、すべてのリソースの祖先で有効になっているサービスが含まれます。

gcloud beta services list --enabled \
    --RESOURCE_TYPE=RESOURCE_ID

次のように置き換えます。

  • RESOURCE_TYPE: サービスを一覧表示するリソースのタイプ。有効な値は project、folder、organization です。このフラグを省略すると、現在のプロジェクトの結果が返されます。

  • RESOURCE_ID: RESOURCE_TYPE に使用した値に応じて、プロジェクト ID、フォルダ ID、または組織 ID。

次の点にご注意ください。

  • 次のいずれか 1 つのフラグを指定する必要があります。

    • --available: 使用するために有効にできるサービスを一覧表示します。
    • --enabled: 使用が有効になっているサービスを一覧表示します。
  • 他のフラグを使用して、一覧表示されるサービスをフィルタリングして制限できます。

サービスを有効化する

gcloud beta services enable コマンドを使用して、プロジェクト、フォルダ、または組織で 1 つ以上のサービスを有効にできます。

このコマンドは、ターゲット リソースの ConsumerPolicy を更新します。詳細については、コンシューマー ポリシーを管理するをご覧ください。

gcloud beta services enable SERVICE \
    --RESOURCE_TYPE=RESOURCE_ID

次のように置き換えます。

  • SERVICE: 有効にするサービスの名前。複数のサービスを有効にするには、スペース区切りのサービス名を使用します。たとえば、次のコマンドは API キーと BigQuery サービスの両方を有効にします。

    gcloud beta services enable apikeys.googleapis.com bigquery.googleapis.com
    
  • RESOURCE_TYPE: サービスを有効にするリソースのタイプ。有効な値は project、folder、organization です。このフラグを省略すると、現在のプロジェクトのサービスを有効にできます。

  • RESOURCE_ID: RESOURCE_TYPE に使用した値に応じて、プロジェクト ID、フォルダ ID、または組織 ID。

サポートされているフラグ:

  • --async: 処理中のオペレーションの完了を待たずに、直ちにコマンドを終了します。

  • --skip-dependency: サービス依存関係の有効化をスキップします。それ以外の場合、すべてのサービス依存関係はデフォルトで有効になります。

    サービスの依存関係を検査できます。詳細については、サービス依存関係を一覧表示するをご覧ください。

  • --validate-only: 実際にオペレーションを実行せずに、有効化を検証します。

次の点にご注意ください。

  • すでに有効になっているサービスを有効にしようとすると、サービスがすでに有効になっていて、コンシューマ ポリシーに存在することを示すエラーが表示されます。(サービスがすでに有効になっていても、依存関係が有効になっていない場合、コマンドは成功します)。

  • 組織のポリシーの制約 constraints/serviceuser.services は、階層型サービス アクティベーションと互換性がないため、一緒に使用しないでください。代わりに、リソースに対して有効にできるサービスを制御するには、constraints/gcp.restrictServiceUsage 制約を使用します。詳細については、リソース使用量の制限をご覧ください。

    • 組織で以前に constraints/serviceuser.services を使用したことがあり、階層型サービス有効化を使用しようとしたときにエラーが発生した場合は、Cloud カスタマーケアにお問い合わせください。
  • Google Cloud は、多くのGoogle Cloud サービス用のサービス アカウントを作成して管理します。これらのサービス アカウントは、サービス エージェントとも呼ばれます。service account not found エラーが発生した場合は、gcloud beta services identity create コマンドを使用してサービス エージェントを作成する必要があります。

サービスを無効にする

gcloud beta services disable コマンドを使用して、プロジェクト、フォルダ、または組織の 1 つ以上のサービスを無効にできます。

このコマンドは、ターゲット リソースの ConsumerPolicy を更新します。詳細については、コンシューマー ポリシーを管理するをご覧ください。

gcloud beta services disable SERVICE \
    --RESOURCE_TYPE=RESOURCE_ID

次のように置き換えます。

  • SERVICE: 無効にするサービスの名前。複数のサービスを無効にするには、スペース区切りのサービス名を使用します。次に例を示します。

    gcloud beta services disable apikeys.googleapis.com bigquery.googleapis.com
    
  • RESOURCE_TYPE: サービスを無効にするリソースのタイプ。有効な値は project、folder、organization です。このフラグを省略すると、現在のプロジェクトのサービスを無効にできます。

  • RESOURCE_ID: RESOURCE_TYPE に使用した値に応じて、プロジェクト ID、フォルダ ID、または組織 ID。または、フラグを省略してデフォルトの現在のプロジェクトにします。

サポートされているフラグ:

  • --async: 処理中のオペレーションの完了を待たずに、直ちにコマンドを終了します。

  • --bypass-api-usage-check: 使用状況チェックをバイパスします。それ以外の場合、無効にするサービスが過去 30 日間に使用されたか、過去 3 日間に有効にされた場合、システムはエラーを返します。

  • 次のいずれか 1 つのフラグを指定できます。

    • --bypass-dependency-service-check: 依存関係のチェックをバイパスします。無効にするサービスに依存する有効なサービスは、有効なままになります。
    • --disable-dependency-services: サービスと、無効にするサービスに依存する有効なサービスを無効にします。

    サービスの依存関係を検査できます。詳細については、サービス依存関係を一覧表示するをご覧ください。

  • --force: サービスに依存する有効なサービスがある場合、サービスが過去 30 日間に使用された場合、または過去 3 日間に有効にされた場合でも、処理を続行します。依存するサービスも無効になります。

    --bypass-api-usage-check、--bypass-dependency-service-check、--disable-dependency-services フラグはすべて、--force フラグよりも優先されます。

    --disable-dependency-services フラグと --bypass-api-usage-check フラグの両方を使用することは、--force フラグを使用することと同じです。サービスとその依存関係は、使用状況を確認せずに無効になります。

  • --validate-only: 実際にオペレーションを実行せずに、無効化を検証します。

例

サービスを有効にする

  • 依存関係なしで BigQuery サービスを有効にする。
    gcloud beta services enable bigquery.googleapis.com --skip-dependency

    出力:

    Operation [operations/ucpat.p39-581601899707-73a57d57-aa46-4d0b-a5ee-57034a42f2b3] complete. Result: {
          "@type":"type.googleapis.com/google.api.serviceusage.v2beta.ConsumerPolicy",
          "createTime":"2025-01-31T20:17:37.272343Z",
          "enableRules":[
              {
                  "services":[
                      "services/apikeys.googleapis.com",
                      "services/compute.googleapis.com",
                      "services/oslogin.googleapis.com",
                      "services/serviceusage.googleapis.com",
                      "services/bigquery.googleapis.com"
                  ]
              }
          ],
          "etag":"W/\"W9nsVJK0V1m7ee7tM7pFDg==\"",
          "name":"projects/PROJECT_ID/consumerPolicies/default",
          "updateTime":"2025-09-11T23:05:22.758394Z"
      }
  • BigQuery サービスとその依存関係を有効にする:
    gcloud beta services enable bigquery.googleapis.com

    出力:

    Operation [operations/ucpat.p39-581601899707-73192b0f-053c-46ee-911a-7eca6b8fe899] complete. Result: {
          "@type":"type.googleapis.com/google.api.serviceusage.v2beta.ConsumerPolicy",
          "createTime":"2025-01-31T20:17:37.272343Z",
          "enableRules":[
              {
                  "services":[
                      "services/apikeys.googleapis.com",
                      "services/compute.googleapis.com",
                      "services/oslogin.googleapis.com",
                      "services/serviceusage.googleapis.com",
                      "services/cloudresourcemanager.googleapis.com",
                      "services/dataplex.googleapis.com",
                      "services/bigquery.googleapis.com",
                      "services/bigquerystorage.googleapis.com",
                      "services/bigqueryconnection.googleapis.com",
                      "services/analyticshub.googleapis.com",
                      "services/bigquerymigration.googleapis.com",
                      "services/dataform.googleapis.com",
                      "services/bigquerydatapolicy.googleapis.com",
                      "services/bigquerydatatransfer.googleapis.com",
                      "services/bigqueryreservation.googleapis.com"
                  ]
              }
          ],
          "etag":"W/\"FDXMAIdsBW7BrXjL7oP6FA==\"",
          "name":"projects/PROJECT_ID/consumerPolicies/default",
          "updateTime":"2025-09-12T19:44:23.675769Z"
      }

サービスの無効化

  • アクティブな依存関係がある BigQuery サービスを無効にしようとしています。
    gcloud beta services disable bigquery.googleapis.com

    エラー メッセージ:

    ERROR: (gcloud.beta.services.disable) The services are depended on by the following active service(s) {"bigquery.googleapis.com": ["services/bigquerystorage.googleapis.com"]} . Please remove the active dependent services or provide the --disable-dependency-services flag to disable them, or --bypass-dependency-service-check to ignore this check.
  • 最近使用した BigQuery サービスを無効にしようとしています。
    gcloud beta services disable bigquery.googleapis.com --disable-dependency-services

    エラー メッセージ:

    ERROR: (gcloud.beta.services.disable) The operation "operations/ucpat.p39-581601899707-d35c2e2b-d2a3-47af-a1c0-033ed65df236" resulted in a failure "The services bigquery.googleapis.com,bigquerystorage.googleapis.com have usage in the last 30 days or were enabled in the past 3 days. Please specify force if you want to proceed with the destructive policy change.
  • BigQuery サービスとその依存関係を無効にし、使用状況チェックをバイパスします。
    gcloud beta services disable bigquery.googleapis.com --disable-dependency-services --bypass-api-usage-check

    出力:

    Operation [operations/ucpat.p39-581601899707-5c02aa04-7ad7-4eb6-a6a1-dc68653bcdb4] complete. Result: {
        "@type":"type.googleapis.com/google.api.serviceusage.v2beta.ConsumerPolicy",
        "createTime":"2025-01-31T20:17:37.272343Z",
        "enableRules":[
            {
                "services":[
                    "services/analyticshub.googleapis.com",
                    "services/apikeys.googleapis.com",
                    "services/bigqueryconnection.googleapis.com",
                    "services/bigquerydatapolicy.googleapis.com",
                    "services/bigquerydatatransfer.googleapis.com",
                    "services/bigquerymigration.googleapis.com",
                    "services/bigqueryreservation.googleapis.com",
                    "services/cloudresourcemanager.googleapis.com",
                    "services/compute.googleapis.com",
                    "services/dataform.googleapis.com",
                    "services/dataplex.googleapis.com",
                    "services/oslogin.googleapis.com",
                    "services/serviceusage.googleapis.com"
                ]
            }
        ],
        "etag":"W/\"TqbPaELDHlZQOj7As1P06g==\"",
        "name":"projects/PROJECT_ID/consumerPolicies/default",
        "updateTime":"2025-09-30T21:39:40.746125Z"
    }

次のステップ