启用和停用服务

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

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

准备工作

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

  • Google Cloud 项目。如需了解如何创建 Google Cloud 项目，请参阅创建和管理项目。
  • 正确的 Identity and Access Management 权限。如需了解 Service Usage 的 IAM 要求，请参阅访问权限控制。
  • 安装 Google Cloud CLI。
  • 如果您要使用本指南中的 curl 示例，请确保按照使用入门中的说明完成初始设置。 这些步骤包括定义 gcurl（这是标准 curl 命令的经过身份验证的别名）和定义环境变量 PROJECT_NUMBER。

启用服务

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

控制台

要为项目启用 API，请执行以下操作：

  1. 前往 Google Cloud 控制台的 API 库页面。
    转到“API 库”页面

  2. 通过执行以下任一操作，选择您要在其中启用 API 的 Google Cloud 项目：

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

    • 通过执行以下步骤，使用 Google Cloud 项目浏览器：

      1. 点击选择项目以打开 Google Cloud 项目浏览器。
      2. 找到您的项目，然后点击 Google 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 访问权限。

如果您停用 GKE API，项目中的所有正在运行的集群都会被暂停。30 天后，我们会删除已暂停的集群。如需恢复已暂停的集群，请启用 GKE API。集群最长可能需要 24 小时才能恢复。

控制台

要为项目停用 API，请执行以下操作：

  1. 前往 Google Cloud 控制台的 API 信息中心页面。
    前往“API 信息中心”页面

  2. 通过执行以下任一操作，选择您要在其中停用 API 的 Google Cloud 项目：

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

    • 通过执行以下步骤，使用 Google Cloud 项目浏览器：

      1. 点击选择项目以打开 Google Cloud 项目浏览器。
      2. 找到您的项目，然后点击 Google 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 轮询该资源。

后续步骤

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