啟用及停用服務

本頁面說明如何為 Google Cloud 專案啟用和停用服務。您可以使用「服務使用情形」為專案啟用或停用任何可用的服務，包括公開的Google Cloud 服務，以及使用 Cloud Endpoints 建立的私人服務。如要進一步瞭解公開和私人 API 與服務之間的差異，請參閱公開與私人服務。

在大多數作業用途下，啟用及停用服務的最簡單方式是使用 Google Cloud 主控台。如需建立指令碼，您也可以使用 Google Cloud CLI。如需根據 Service Usage API 編寫程式，建議您使用我們提供的其中一種用戶端程式庫。如要試用 API，請按照本指南中的替代操作說明，使用 curl 指令測試 API，無需設定完整的應用程式開發環境。

事前準備

若要啟用及停用您需要的 API 與服務：

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

啟用服務

啟用服務會使用「serviceusage.googleapis.com/mutate_requests」配額指標的配額。預設可用配額為每秒 2 次查詢 (QPS)。

主控台

如何在專案中啟用 API：

  1. 前往 Google Cloud 主控台API 程式庫頁面。
    前往「API Library」(API 程式庫) 頁面

  2. 選取要啟用 API 的 Google Cloud 專案，方法如下：

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

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

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

  3. 按一下您要啟用的 API。如果需要尋找 API，請使用頁面頂端的「搜尋 API 和服務」方塊。畫面會顯示 API 的說明頁面。

  4. 點選「啟用」按鈕。

gcloud

執行下列指令，在目前的專案中啟用 Pub/Sub API 服務：

gcloud services enable pubsub.googleapis.com

這個指令會產生類似下列的輸出內容：

Waiting for async operation operations/acf.2e2fcfce-8327-4984-9040-a67777082687 to complete...
Operation finished successfully.

您可以使用下列指令取得作業詳細資料：

gcloud services operations describe operations/acf.2e2fcfce-8327-4984-9040-a67777082687

curl

您可以使用 services.enable 方法啟用單一服務。使用 services.batchEnable 方法，可以在單一作業中啟用 2 到 20 個服務。

啟用單一服務

下列指令會啟用專案的 Pub/Sub API 服務：

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:enable"

services.enable 方法會傳回長時間執行的作業資源，代表伺服器上正在進行的工作。每個作業都有專屬的資源名稱。舉例來說，以下是名稱為 operations/acf.2e2fcfce-8327-4984-9040-a67777082687 的作業：

{
  "name": "operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
}

如要使用服務使用情形的 operations.get 方法輪詢作業狀態，請將作業名稱傳遞至 API：

OPERATION_NAME="operations/acf.2e2fcfce-8327-4984-9040-a67777082687"
gcurl "https://serviceusage.googleapis.com/v1/${OPERATION_NAME}"

一次啟用多項服務

如要在專案中啟用多項 API 服務，可以個別為每項 API 服務發出啟用指令，也可以發出一個批次啟用指令，並指定多個 API。舉例來說，如要在專案中同時啟用 Pub/Sub 和 Dataflow API 服務：

gcurl -d '{
"serviceIds": ["pubsub.googleapis.com", "dataflow.googleapis.com"]
}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services:batchEnable"

與 services.enable 類似，services.batchEnable 會傳回作業資源，您可以使用其 name 輪詢該資源。

停用服務

停用服務會使用「serviceusage.googleapis.com/mutate_requests」配額指標的配額。預設可用配額為每秒 2 次查詢 (QPS)。

您可以隨時停用專案的 API，只是系統仍會向您的帳戶收取待處理費用，且您必須支付專案中任何付費 API 的使用費用。詳情請參閱 API 和帳單一文。

許多服務 (例如 Cloud Storage 和 BigQuery) 都會收取資料儲存費用。停用服務的 API 存取權不會刪除基礎資料，因此系統仍會繼續計費。如要停止使用服務並避免日後產生任何費用，請務必先刪除與服務相關的所有資料，再停用服務的 API 存取權。

如果停用 GKE API，專案中所有正在執行的叢集都會暫停。30 天後，系統會刪除已暫停的叢集。如要恢復遭停權的叢集，請啟用 GKE API。叢集最多可能需要 24 小時才會恢復。

主控台

如何在專案中停用 API：

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

  2. 選取要停用 API 的 Google Cloud 專案，方法如下：

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

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

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

  3. 按一下要停用的 API。如果需要尋找 API，請使用頁面頂端的「搜尋 API 和服務」方塊。畫面會顯示 API 的說明頁面。

  4. 按一下 「停用 API」。

gcloud

執行下列指令，在目前的專案中停用 Pub/Sub API 服務：

gcloud services disable pubsub.googleapis.com

這個指令會產生類似下列的輸出內容：

Waiting for async operation operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8 to complete...
Operation finished successfully.

您可以使用下列指令取得作業詳細資料：

gcloud services operations describe operations/acf.e9d0943b-55d9-4ac0-8af4-745e1b8983f8

curl

下列指令會停用專案的 Pub/Sub API 服務：

gcurl -d '{}' "https://serviceusage.googleapis.com/v1/projects/${PROJECT_NUMBER}/services/pubsub.googleapis.com:disable"

與 services.enable 類似，services.disable 會傳回作業資源，您可以使用其 name 輪詢該資源。