列出服務

本文將說明如何列出在 Trusted Cloud 專案中啟用或可用的 API 與服務。

  • 如要列出專案中的服務，建議您使用Trusted Cloud 控制台或 Google Cloud CLI。本文將說明如何使用這兩種介面。
  • 如要根據 Service Usage API 編寫程式，請使用我們提供的其中一種用戶端程式庫。
  • 如要試用 API，建議您使用 curl 指令。您不需要設定完整的應用程式環境，但仍須進行部分設定。

    • 事前準備

    若要列出已啟用和可用的 API 與服務，您需要：

    • Trusted Cloud 專案。如要瞭解如何建立 Trusted Cloud 專案，請參閱「建立及管理專案」。
    • 正確的 Identity & Access Management 權限。如要瞭解「服務使用情形」的 IAM 需求，請參閱「存取權控管」。
    • 如要安裝 Google Cloud CLI，請按照下列步驟操作：
    • 如果您要使用本指南中的 curl 範例，請務必遵循「開始使用」中完成初始設定的操作說明。這些步驟包括定義 gcurl，這是標準 curl 指令的已驗證別名，以及定義環境變數 PROJECT_NUMBER。

    可列出專案中已啟用的服務

    已啟用服務的清單會使用 serviceusage.googleapis.com/list_enabled_requests 配額指標的配額。預設可用配額為每秒 10 次查詢 (QPS)。

    主控台

    若要列出專案已啟用的 API 與服務：

    1. 前往 Trusted Cloud 控制台的「API Dashboard」(API 資訊主頁) 頁面。
      前往「API Dashboard」(API 資訊主頁) 頁面

    2. 執行下列任一操作，選取 Trusted Cloud 專案：

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

      • 如要使用 Trusted Cloud 專案瀏覽器，請按照下列步驟操作：

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

      「API 和服務」頁面隨即顯示。您可以在本頁表格中，查看 Trusted 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. 前往 Trusted Cloud 主控台的「API Library」(API 資料庫) 頁面。
      前往「API Library」(API 程式庫) 頁面

    2. 如要選取 Trusted Cloud 專案，請執行下列任一操作：

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

      • 如要使用 Trusted Cloud 專案瀏覽器，請按照下列步驟操作：

        1. 按一下「選取專案」，即可開啟 Trusted Cloud 專案瀏覽器。
        2. 找出專案，然後按一下 Trusted 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 傳遞至先前的呼叫，藉此排除目前在專案中處於活動狀態的服務。

    後續步驟

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