列出服务

本文档介绍了如何列出已启用或 Google Cloud 项目中可用的资源。可用或已启用的 API 和服务的列表可以包含公共 Google Cloud 服务(如 Pub/Sub)以及任何以私密方式共享给您的 API 和服务(例如使用 Cloud Endpoints 创建的服务)。如需详细了解公共和专用 API 和服务之间的差异,请参阅公共服务和专用服务

  • 要获取或监控组织已启用的服务, 请参阅列出组织中已启用的服务
  • 要列出项目中的服务,我们建议您使用 Google Cloud 控制台或 Google Cloud CLI。本文档介绍了如何 使用这两个接口
  • 如需针对 Service Usage API 进行编程,请使用我们提供的某种 客户端库
  • 如需试用此 API,我们建议您使用 curl 命令。您无需设置完整的应用环境;不过 进行一些所需的设置

准备工作

要列出已启用和可用的 API 和服务,需满足以下条件:

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

列出组织中已启用的服务

要列出整个组织已启用的服务,请使用 Cloud Asset Inventory,允许 单个 RPC 中由组织控制的所有项目的状态 调用。Cloud Asset Inventory 还可用于 监控状态变化 要导出特定组织的所有已启用服务,请按照 Cloud Asset Inventory 文档中有关列出资产的说明进行操作。

要列出组织已启用的 API,请在运行 您需要设置组织 ID 和结算项目 ID:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--organization='ORGANIZATION_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

执行上一个命令可让具有足够特权的用户列出该集合, 为组织中的所有项目启用的服务。

如需试用 Cloud Asset Inventory 命令,请将这些命令应用于特定项目。例如,以下命令 列出特定项目的所有已启用服务:

NOW=$(TZ=GMT date +"%Y-%m-%dT%H:%M:%SZ")
gcloud asset list \
--project='PROJECT_ID' \
--billing-project='BILLING_PROJECT_ID' \
--asset-types='serviceusage.googleapis.com/Service' \
--snapshot-time=$NOW \
--content-type='resource'

列出项目中已启用的服务

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

控制台

要列出项目中已启用的 API 和服务,请执行以下操作:

  1. 前往 Google Cloud 控制台 API 信息中心 页面。
    前往“API 信息中心”页面
  2. 执行以下某项操作,选择您的 Google Cloud 项目:

    • 选择最近的项目 (Select a recent project) 下点击一个 Google Cloud 项目。

    • 如需使用 Google Cloud 项目浏览器,请执行以下操作: 步骤:

      1. 点击选择项目,打开 Google Cloud 项目浏览器。
      2. 找到您的项目,然后点击 Google Cloud 项目名称。
      3. 点击打开以打开项目。

    此时会显示 API 和服务页面。您可在下方 已在本页的表格中启用。

gcloud

如需列出当前项目中已启用的 API 和服务,请运行以下命令:

gcloud services list

该命令生成类似于以下内容的输出:

NAME                                              TITLE
pubsub.googleapis.com             Google Cloud Pub/Sub API
bigquery.googleapis.com           BigQuery API
cloudtrace.googleapis.com         Stackdriver Trace API
servicemanagement.googleapis.com  Google Service Management API
monitoring.googleapis.com         Stackdriver Monitoring API
storage-api.googleapis.com        Google Cloud Storage JSON API
logging.googleapis.com            Stackdriver Logging API
clouddebugger.googleapis.com      Stackdriver Debugger API
...

curl

如需列出已启用的服务,请使用 state:ENABLED 过滤条件调用 services.list 方法。

如需列出项目中已启用的 API 和服务,请运行以下命令:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services?filter=state:ENABLED"

列出项目中的可用服务

列出所有可用服务会使用 serviceusage.googleapis.com/list_available_requests 配额。默认 可用配额为 1 QPS可用的服务集很少发生变化 可以缓存更长时间。

控制台

要列出项目中可用的 API 和服务,请执行以下操作:

  1. 前往 Google Cloud 控制台 API 库 页面。
    转到“API 库”页面
  2. 通过执行以下任一操作来选择 Google Cloud 项目:

    • 选择最近的项目 (Select a recent project) 下点击一个 Google Cloud 项目。

    • 如需使用 Google Cloud 项目浏览器,请执行以下操作: 步骤:

      1. 点击选择项目,打开 Google Cloud 项目浏览器。
      2. 找到您的项目,然后点击 Google Cloud 项目名称。
      3. 点击打开以打开项目。

    系统会显示 API 库屏幕。您可以在此屏幕中搜索或滚动浏览可用的 API。

gcloud

如需列出当前项目中可用的 API 和服务,请运行以下命令:

gcloud services list --available

结果包括已启用的任何服务,以及可为当前项目启用的服务。 该命令生成类似于以下内容的输出:

NAME                                              TITLE
places-backend.googleapis.com                  Google Places API Web Service
clouderrorreporting.googleapis.com             Stackdriver Error Reporting API
analyticsreporting.googleapis.com              Google Analytics Reporting API
youtube.googleapis.com                         YouTube Data API v3
adsense.googleapis.com                         AdSense Management API
sqladmin.googleapis.com                        Google Cloud SQL API
genomics.googleapis.com                        Genomics API
adexchangebuyer.googleapis.com                 Ad Exchange Buyer API II
...

curl

如需列出可用服务,请调用 services.list 方法。

如需列出项目中可用的 API 和服务,请运行以下命令:

gcurl "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services"

结果包括所有公共服务、调用用户具有 servicemanagement.services.bind 权限的所有服务,以及已在项目中启用的所有服务。

您可以通过将 filter=state:DISABLED 传递给上一个调用来排除项目中当前处于活动状态的服务。

后续步骤

有关如何启用/停用服务的信息,请参阅 请参阅 启用和停用服务