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