列出服務

本文將說明如何列出在 Google Cloud 專案中啟用或可用的 API 與服務。可用或啟用的 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 & Access Management 權限。如要瞭解「服務使用情形」的 IAM 需求,請參閱「存取權控管」。
  • 如要安裝 Google Cloud CLI,請按照下列步驟操作:
  • 如果您要使用本指南中的 curl 範例,請務必遵循「開始使用」中完成初始設定的操作說明。這些步驟包括定義 gcurl,這是標準 curl 指令的已驗證別名,以及定義環境變數 PROJECT_NUMBER

列出機構中已啟用的服務

如要列出組織中已啟用的服務,請使用 Cloud Asset Inventory,這項服務可在單一 RPC 呼叫中匯出組織控制下所有專案的狀態。Cloud Asset Inventory 也可用於監控狀態變更。如要匯出特定機構已啟用的所有服務,請按照 Cloud Asset Inventory 文件中的列出資產操作說明進行。

如要列出機構已啟用的 API,請在設定機構和計費專案 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 Dashboard」(API 資訊主頁) 頁面。
    前往「API Dashboard」(API 資訊主頁) 頁面
  2. 執行下列任一操作,選取 Google Cloud 專案:

    • 按一下「Select a recent project」下方的 Google Cloud 專案。

    • 如要使用 Google Cloud 專案瀏覽器,請按照下列步驟操作:

      1. 按一下「選取專案」,即可開啟 Google Cloud 專案瀏覽器。
      2. 找出專案,然後按一下 Google Cloud 專案名稱。
      3. 按一下「開啟」,即可開啟專案。

    「API 和服務」頁面隨即顯示。您可以在本頁表格中,查看 Google Cloud 專案中已啟用的 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 Library」(API 資料庫) 頁面。
    前往「API Library」(API 程式庫) 頁面
  2. 如要選取 Google Cloud 專案,請執行下列任一操作:

    • 按一下「Select a recent project」下方的 Google Cloud 專案。

    • 如要使用 Google Cloud 專案瀏覽器,請按照下列步驟操作:

      1. 按一下「選取專案」,即可開啟 Google Cloud 專案瀏覽器。
      2. 找出專案,然後按一下 Google Cloud 專案名稱。
      3. 按一下「開啟」,即可開啟專案。

    畫面上會顯示「API Library」畫面。您可以在此畫面搜尋或捲動瀏覽可用的 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 傳遞至先前的呼叫,藉此排除目前在專案中處於活動狀態的服務。

後續步驟

如要瞭解如何在Google Cloud 專案中啟用或停用服務,請參閱「啟用及停用服務」。