启用和停用服务

本页介绍如何启用和停用 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. 选择要启用的 Google Cloud 项目 通过执行以下某项操作来启动 API:

    • 选择最近的项目 (Select a recent project) 下点击一个 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 访问权限。

控制台

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

  1. 前往 Google Cloud 控制台 API 信息中心 页面。
    转到“API 信息中心”页面
  2. 选择要停用的 Google Cloud 项目 通过执行以下某项操作来创建 API:

    • 选择近期的项目下点击 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 轮询该资源。

后续步骤

要了解如何查看和管理适用于 项目请参阅管理服务配额