列出服務
本文將說明如何列出在 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 與服務:
- 前往 Google Cloud 控制台的「API Dashboard」(API 資訊主頁) 頁面。
前往「API Dashboard」(API 資訊主頁) 頁面 執行下列任一操作,選取 Google Cloud 專案:
按一下「Select a recent project」下方的 Google Cloud 專案。
如要使用 Google Cloud 專案瀏覽器,請按照下列步驟操作:
- 按一下「選取專案」,即可開啟 Google Cloud 專案瀏覽器。
- 找出專案,然後按一下 Google Cloud 專案名稱。
- 按一下「開啟」,即可開啟專案。
「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 與服務:
- 前往 Google Cloud 主控台的「API Library」(API 資料庫) 頁面。
前往「API Library」(API 程式庫) 頁面 如要選取 Google Cloud 專案,請執行下列任一操作:
按一下「Select a recent project」下方的 Google Cloud 專案。
如要使用 Google Cloud 專案瀏覽器,請按照下列步驟操作:
- 按一下「選取專案」,即可開啟 Google Cloud 專案瀏覽器。
- 找出專案,然後按一下 Google Cloud 專案名稱。
- 按一下「開啟」,即可開啟專案。
畫面上會顯示「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 專案中啟用或停用服務,請參閱「啟用及停用服務」。