Google 会使用 AI 技术将内容翻译成您偏好的语言。AI 翻译可能包含错误。

管理服务启用

借助分层服务激活，您可以管理通过 Google Cloud 资源层次结构继承的服务启用。如需了解详情，请参阅概览。

本文档介绍了如何使用 Google Cloud CLI 管理项目、文件夹和组织的服务启用。

准备工作

登录您的 Google Cloud 账号。如果您是 Google Cloud新手，请创建一个账号来评估我们的产品在实际场景中的表现。新客户还可获享 $300 赠金，用于运行、测试和部署工作负载。

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

创建或选择 Google Cloud 项目。

选择或创建项目所需的角色

选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
创建项目：如需创建项目，您需要拥有 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予角色。

创建 Google Cloud 项目：
```
gcloud projects create PROJECT_ID
```
将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。
选择您创建的 Google Cloud 项目：
```
gcloud config set project PROJECT_ID
```
将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

如果您要使用现有项目来完成本指南，请验证您是否拥有完成本指南所需的权限。如果您创建了新项目，则您已拥有所需的权限。

安装 Google Cloud CLI。

如果您使用的是外部身份提供方 (IdP)，则必须先使用联合身份登录 gcloud CLI。

如需初始化 gcloud CLI，请运行以下命令：

gcloud init

创建或选择 Google Cloud 项目。

选择或创建项目所需的角色

选择项目：选择项目不需要特定的 IAM 角色，您可以选择已获授角色的任何项目。
创建项目：如需创建项目，您需要拥有 Project Creator 角色 (roles/resourcemanager.projectCreator)，该角色包含 resourcemanager.projects.create 权限。了解如何授予角色。

创建 Google Cloud 项目：
```
gcloud projects create PROJECT_ID
```
将 PROJECT_ID 替换为您要创建的 Google Cloud 项目的名称。
选择您创建的 Google Cloud 项目：
```
gcloud config set project PROJECT_ID
```
将 PROJECT_ID 替换为您的 Google Cloud 项目名称。

如果您要使用现有项目来完成本指南，请验证您是否拥有完成本指南所需的权限。如果您创建了新项目，则您已拥有所需的权限。

如果您未指明要管理的 Google Cloud 资源，则本文档中的命令默认为当前项目。例如，gcloud beta services list --enabled 会返回当前项目的已启用的服务列表。
您可以检索当前项目 ID：
```
gcloud config list --format='text(core.project)'
```

所需的角色

如需获得管理服务启用所需的权限，请让您的管理员为您授予目标资源的 Service Usage Admin (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

您也可以使用自定义角色或其他预定义角色来获取这些权限。

列出服务

您可以使用 gcloud beta services list 命令列出为项目、文件夹或组织启用或可用的 Google API 和服务。

服务启用和可用性可以从资源祖先继承。资源的已启用的服务包括在资源本身上启用的服务以及在所有资源祖先实体上启用的服务。

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

替换以下内容：

RESOURCE_TYPE：您要为其列出服务的资源类型。有效值为 project、folder 和 organization。您可以省略此标志，以返回当前项目的结果。
RESOURCE_ID：项目 ID、文件夹 ID 或组织 ID，具体取决于您为 RESOURCE_TYPE 使用的值。

请注意以下几点：

您必须指定以下标志之一：
- --available，列出可以启用以供使用的服务。
- --enabled，列出已启用以供使用的服务。
您可以使用其他标志来过滤和限制列出的服务。

启用服务

您可以使用 gcloud beta services enable 命令为一个项目、文件夹或组织启用一项或多项服务。

此命令会更新目标资源处的 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：项目 ID、文件夹 ID 或组织 ID，具体取决于您为 RESOURCE_TYPE 使用的值。

支持的标志：

--async - 立即返回，而无需等待正在进行的操作完成。
--skip-dependency，以跳过启用任何服务依赖项。否则，默认情况下会启用所有服务依赖项。

您可以检查服务依赖项。如需了解详情，请参阅列出服务依赖项。
--validate-only - 验证启用，而不实际执行操作。

请注意以下几点：

如果您尝试启用已启用的服务，则会收到一条错误消息，指出该服务已启用并存在于使用方政策中。（如果服务已启用，但其依赖项未启用，则该命令将成功。）
组织政策限制条件 constraints/serviceuser.services 与分层服务启用不兼容，不应与其一起使用。而是使用 constraints/gcp.restrictServiceUsage 限制条件来控制可以为资源启用哪些服务。如需了解详情，请参阅限制资源使用。
- 如果您的组织之前使用过 constraints/serviceuser.services，并且您在尝试使用分层服务激活时收到错误，请与 Cloud Customer Care 联系。
Google Cloud 为许多Google Cloud 服务创建和管理服务账号。这些服务账号称为“服务代理”。如果您遇到 service account not found 错误，则可能需要使用 gcloud beta services identity create 命令创建服务代理。

停用服务

您可以使用 gcloud beta services disable 命令为项目、文件夹或组织停用一项或多项服务。

此命令会更新目标资源处的 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：项目 ID、文件夹 ID 或组织 ID，具体取决于您为 RESOURCE_TYPE 使用的值。或者，省略该标志以默认使用当前项目。

支持的标志：

--async - 立即返回，而无需等待正在进行的操作完成。
--bypass-api-usage-check，以绕过用量检查。否则，如果您要停用的服务在过去 30 天内使用过或在过去 3 天内启用过，系统会返回错误。
您可以指定以下标志中的一个：
- --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"
}

后续步骤

如需管理政策，请参阅管理使用方政策。
如需检查服务依赖项，请参阅列出服务依赖项。