启用和停用服务

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

大多数用户都可以使用 Google Cloud 控制台启用和停用服务。对于脚本，请使用 Google Cloud CLI。如需以编程方式访问 Service Usage API，建议使用客户端库。如需试用该 API，您可以发送请求，而无需设置完整的开发环境。

如需了解服务使用情况配额限制，请参阅配额和限制。您可能希望限制计费使用量。根据 API，您可以明确限制请求。

准备工作

在启用和停用服务之前，您必须为 Service Usage 设置Google Cloud 项目和环境。

控制台

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

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

gcloud

登录您的 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 项目名称。

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

REST API

1. 拥有一个要为其启用或停用 API 的 Google Cloud 项目。

2. 验证您是否拥有完成本指南所需的权限。 如果您使用的是自己创建的项目，则通常已拥有所需的权限。

所需的角色

如需获得启用和停用服务所需的权限，请让您的管理员为您授予项目的 Service Usage Admin (roles/serviceusage.serviceUsageAdmin) IAM 角色。 如需详细了解如何授予角色，请参阅管理对项目、文件夹和组织的访问权限。

您也可以通过自定义角色或其他预定义角色来获取所需的权限。

启用服务

启用服务的过程可能因服务而异。有些 API 会要求您先接受其服务条款，或者处于预览状态，需要获得批准后才能使用。其他 API 可能会要求您提供更多信息，例如您组织的联系信息以及您应用的名称。所有请求的信息都会在 Google 内部保密。我们使用此电子邮件地址来了解 API 使用情况，并在必要时与您联系。

控制台

1. 在 Google Cloud 控制台中，前往 API 和服务 > API 库页面。

   转到 API 库

2. 选择近期的项目，或使用控制台工具栏上的资源选择器选择要启用 API 的 Google Cloud 项目。

3. 点击要启用的 API，或使用搜索 API 和服务框搜索该 API。

4. 点击启用。

gcloud

gcloud services enable 命令会为当前项目启用指定名称的服务。

在使用下面的命令数据之前，请先进行以下替换：

• SERVICE：您要启用的服务的名称。

执行 gcloud services enable 命令：

Linux、macOS 或 Cloud Shell

gcloud services enable SERVICE

Windows (PowerShell)

gcloud services enable SERVICE

Windows (cmd.exe)

gcloud services enable SERVICE

您应该会收到类似如下所示的响应：

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

如需启用多项服务，请使用以空格分隔的服务名称，例如，以下命令会同时启用 BigQuery 和 Pub/Sub 服务：

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

如需检索操作详细信息，请使用 gcloud services operations describe 命令：

gcloud services operations describe operations/OPERATION_ID

将 OPERATION_ID 替换为在原始请求的响应中收到的操作 ID。

REST API

启用单项服务

如需启用单项服务，请使用 services.enable 方法。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：您的 Google Cloud项目 ID。
• SERVICE：您要启用的服务的名称。

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

如果成功，响应正文将包含一个新创建的 Operation 实例：

{
  "name": "operations/OPERATION_ID"
}

注意： 默认情况下，系统会为项目启用 Service Usage API，但如果您为执行启用服务请求的项目停用了该 API，则在尝试发出请求时会收到错误。如需解决此问题，请使用 Google Cloud 控制台或 Google Cloud CLI 为发出请求的项目重新启用 Service Usage API。

启用多项服务

如需在单次操作中启用最多 20 项服务，请使用 services.batchEnable 方法。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：您的 Google Cloud项目 ID。
• SERVICE1：您要启用的服务的名称。
• SERVICE2：您要启用的另一项服务的名称。

请求 JSON 正文：

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以通过运行 gcloud auth list 来检查当前的活跃账号。

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

然后，执行以下命令以发送 REST 请求：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以通过运行 gcloud auth list 来检查当前的活跃账号。

将请求正文保存在名为 request.json 的文件中。在终端中运行以下命令，在当前目录中创建或覆盖此文件：

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

然后，执行以下命令以发送 REST 请求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

如果成功，响应正文将包含一个新创建的 Operation 实例：

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

注意： 默认情况下，系统会为项目启用 Service Usage API，但如果您为执行服务启用请求的项目停用了该 API，则在尝试发出请求时会收到错误。如需解决此问题，请使用 Google Cloud 控制台或 Google Cloud CLI 为发出请求的项目重新启用 Service Usage API。

停用服务

您可以随时为项目停用 API。不过，您仍需支付待处理费用以及项目中使用的所有计费 API 的费用。如需了解详情，请参阅 Cloud API 的使用入门指南。

许多服务（例如 Cloud Storage 和 BigQuery）都会收取数据存储费用，而停用这些服务的 API 并不会删除您的数据。对于这些服务，即使停用相应 API，您仍需继续支付数据存储费用。相比之下，停用 Cloud Run API 时，与 Cloud Run 关联的资源会被删除，这可能不是您想要的结果。

在上述两种情况下，以及作为一般最佳实践，您都应在停用服务之前清点与该服务关联的资源。对于 Cloud Storage 和 BigQuery 等服务，如需停止日后产生费用并停止使用相应服务，请先删除所有关联数据，然后再停用其 API。对于 Cloud Run，请先确认可以安全地删除所有现有的 Cloud Run 资源，然后再停用该 API。

如果您停用 Kubernetes Engine API，项目中的运行集群将进入暂停状态。30 天后，这些暂停的集群会被删除。如需重新激活集群，请重新启用 GKE API。集群最长可能需要 24 小时才能恢复。如需了解详情，请参阅集群生命周期。

注意： 如果您尝试停用其他已启用服务所依赖的服务，请求将会失败并返回错误。如需停用指定的服务以及所有依赖于该服务的所有服务，请将 services.disable 请求中的 disableDependentServices 参数设置为 true。

控制台

1. 在 Google Cloud 控制台中，前往 API 和服务 > API 库页面。

   转到 API 库

2. 选择近期的项目，或使用控制台工具栏上的资源选择器选择要停用 API 的 Google Cloud 项目。

3. 点击要禁用的 API，或使用搜索 API 和服务框搜索该 API。

4. 点击 停用 API。

gcloud

gcloud services disable 命令会针对当前项目停用指定名称的服务。

在使用下面的命令数据之前，请先进行以下替换：

• SERVICE：要停用的服务的名称。

执行 gcloud services disable 命令：

Linux、macOS 或 Cloud Shell

gcloud services disable SERVICE

Windows (PowerShell)

gcloud services disable SERVICE

Windows (cmd.exe)

gcloud services disable SERVICE

您应该会收到类似如下所示的响应：

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

如需停用多项服务，请使用以空格分隔的服务名称。例如，以下命令会同时停用 BigQuery 和 Pub/Sub 服务：

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

如需检索操作详细信息，请使用 gcloud services operations describe 命令：

gcloud services operations describe operations/OPERATION_ID

将 OPERATION_ID 替换为在原始请求的响应中收到的操作 ID。

REST API

如需停用服务，请使用 services.disable 方法。

在使用任何请求数据之前，请先进行以下替换：

• PROJECT_ID：您的 Google Cloud项目 ID。
• SERVICE：要停用的服务的名称。

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

如果成功，响应正文将包含一个新创建的 Operation 实例：

{
  "name": "operations/OPERATION_ID"
}

注意： 默认情况下，系统会为项目启用 Service Usage API，但如果您为执行停用服务请求的项目停用了该 API，则在尝试执行请求时会收到错误。如需解决此问题，请使用 Google Cloud 控制台或 Google Cloud CLI 为发出请求的项目重新启用 Service Usage API。

检查长时间运行的操作的状态

使用启用或停用方法会返回长时间运行的操作 (LRO)。LRO 会跟踪请求的状态，并指示服务更改是否已完成。

在使用任何请求数据之前，请先进行以下替换：

OPERATION_ID：操作标识符。 您将在原始请求的响应中收到此 ID。

如需发送您的请求，请展开以下选项之一：

curl（Linux、macOS 或 Cloud Shell）

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI，或者使用了 Cloud Shell，这会使您自动登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

PowerShell (Windows)

注意：以下命令假定您已使用您的用户账号通过运行 gcloud init 或 gcloud auth login 登录 gcloud CLI。您可以运行 gcloud auth list 来检查当前活跃的账号。

执行以下命令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

您应该收到类似以下内容的 JSON 响应：

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

当 done 字段设置为 true 时，操作完成。