启用和停用服务

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

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

准备工作

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

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

启用服务

Console

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

  1. 转到 Cloud Console 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 进行轮询。

停用服务

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

控制台

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

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

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

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

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

  4. 点击管理按钮。

  5. 点击 停用

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 进行轮询。

后续步骤

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