使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

启用和停用服务

本页介绍如何启用和停用 Google Cloud 项目的服务。您可以使用 Service Usage 为项目启用或停用任何可用服务,包括公共 Google Cloud 服务和使用 Cloud Endpoints 创建的专用服务。如需详细了解公共和专用 API 和服务之间的差异,请参阅公共服务和专用服务

对于大多数操作用例,启用和停用服务的最简单方法是使用 Google Cloud 控制台。如果您需要创建脚本,还可以使用 Google Cloud CLI。如果需要针对 Service Usage API 进行编程,我们建议您使用我们提供的客户端库之一。若要尝试该 API,您可以按照本指南中的备用说明进行操作,并使用 curl 命令来测试该 API,而无需设置完整的应用开发环境。

准备工作

要启用和停用所需的 API 和服务,需满足以下条件:

启用服务

启用服务会使用 serviceusage.googleapis.com/mutate_requests 配额指标中的配额。默认可用配额为每秒 2 次查询 (QPS)。

控制台

要为项目启用 API,请执行以下操作:

  1. 转到 Google Cloud 控制台的 API 库页面。
    转到“API 库”页面
  2. 通过执行以下任一操作,选择您要在其中启用 API 的 Cloud 项目:

    • 选择近期的项目下点击 Cloud 项目。

    • 通过执行以下步骤,使用 Cloud 项目浏览器:

      1. 点击选择项目以打开 Cloud 项目浏览器。
      2. 找到您的项目,然后点击 Cloud 项目名称。
      3. 点击打开以打开项目。
  3. 点击您想要启用的 API。如果您在查找 API 时需要帮助,请使用页面顶部附近的搜索 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 方法在单次操作中启用 2 到 20 个服务。

启用单项服务

以下命令会在您的项目上启用 Pub/Sub API 服务:

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:enable"

services.enable 方法会返回长时间运行的操作资源,表示服务器上正在进行的工作。每个操作都有唯一的资源名称。例如,以下是名为 operations/acf.2e2fcfce-8327-4984-9040-a67777082687 的操作:

{
  "name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}

如需使用 Service Usage operations.get 方法轮询操作状态,请将操作名称传递到 API:

OPERATION_NAME="operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"

一次启用多个服务

如果要在您的项目上启用多个 API 服务,您可以为每个 API 服务单独发出启用命令,也可以发出一个批量启用命令并指定多个 API。例如,如需在您的项目上同时启用 Pub/Sub 和 Dataflow API 服务,请运行以下命令:

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

services.enable 一样,services.batchEnable 会返回一个操作资源,您可以使用 name 轮询该资源。

停用服务

停用服务时,系统会使用 serviceusage.googleapis.com/mutate_requests 配额指标中的配额。默认可用配额为每秒 2 次查询 (QPS)。

您可以随时停用项目的 API,但仍会向您的帐户收取待处理费用,并且您需要为项目中使用的所有计费 API 付费。如需了解详情,请参阅 API 和结算

Cloud Storage 和 BigQuery 等很多服务都会收取数据存储费用。停用服务的 API 访问权限不会删除仍将继续计费的底层数据。如果您打算停止使用某项服务并停止将来的所有费用,请务必先停用与该服务关联的所有数据,然后再停用该服务的 API 访问权限。

控制台

要为项目停用 API,请执行以下操作:

  1. 转到 Google Cloud 控制台的 API 信息中心页面。
    转到“API 信息中心”页面
  2. 通过执行以下任一操作,选择您要在其中停用 API 的 Cloud 项目:

    • 选择近期的项目下点击 Cloud 项目。

    • 通过执行以下步骤,使用 Cloud 项目浏览器:

      1. 点击选择项目以打开 Cloud 项目浏览器。
      2. 找到您的项目,然后点击 Cloud 项目名称。
      3. 点击打开以打开项目。
  3. 点击您想要禁用的 API。如果您在查找 API 时需要帮助,请使用页面顶部附近的搜索 API 和服务框。此时会显示描述 API 的页面。

  4. 点击 停用 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

以下命令会在您的项目上停用 Pub/Sub API 服务:

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable"

services.enable 一样,services.disable 会返回一个操作资源,您可以使用 name 轮询该资源。

后续步骤

如需了解如何查看和管理适用于项目的配额指标和限制,请参阅管理服务配额