列出服務

本文說明如何列出 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 專案,請參閱「建立及管理專案」。
  • 正確的身分與存取權管理權限。如要瞭解「服務使用情形」的 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 專案:

    • 按一下「選取近期專案」下方的 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 程式庫頁面。
    前往「API Library」(API 程式庫) 頁面
  2. 執行下列任一操作,選取 Google Cloud 專案:

    • 按一下「選取近期專案」下方的 Google Cloud 專案。

    • 請按照下列步驟使用 Google Cloud 專案瀏覽器:

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

    系統會顯示「API Library」(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 傳遞至先前的呼叫,排除目前在專案中啟用的服務。

後續步驟

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