啟用及停用服務
本頁面說明如何為 Google Cloud 專案啟用和停用服務。您可以使用「服務使用情形」為專案啟用或停用任何可用的服務,包括公開的 Google Cloud 服務,以及使用 Cloud Endpoints 建立的私人服務。若要進一步瞭解公開和私人 API 與服務之間的差異,請參閱「公開與私人服務」一文。
在大部分的作業使用情況下,啟用和停用服務的最簡單方式是使用 Google Cloud 主控台。如需建立指令碼,您也可以使用 Google Cloud CLI。如果您需要根據 Service Usage API 編寫程式,建議您使用我們提供的其中一種用戶端程式庫。如要試用 API,請按照本指南中的替代操作說明,使用 curl
指令測試 API,無需設定完整的應用程式開發環境。
事前準備
若要啟用及停用您需要的 API 與服務:
- Google Cloud 專案。如要瞭解如何建立 Google Cloud 專案,請參閱「建立及管理專案」。
- 正確的 Identity & Access Management 權限。如要瞭解「服務使用情形」的 IAM 需求,請參閱「存取權控管」。
- 如要安裝 Google Cloud CLI,請按照下列步驟操作:
- 如果您要使用本指南中的
curl
範例,請務必遵循「開始使用」中完成初始設定的操作說明。這些步驟包括定義gcurl
,這是標準curl
指令的已驗證別名,以及定義環境變數PROJECT_NUMBER
。
啟用服務
啟用服務會使用 serviceusage.googleapis.com/mutate_requests
配額指標的配額。預設可用配額為每秒 2 次查詢 (QPS)。
主控台
如何在專案中啟用 API:
- 前往 Google Cloud 主控台的「API Library」(API 資料庫) 頁面。
前往「API Library」(API 程式庫) 頁面 請執行下列任一操作,選取要啟用 API 的 Google Cloud 專案:
按一下「Select a recent project」下方的 Google Cloud 專案。
如要使用 Google Cloud 專案瀏覽器,請按照下列步驟操作:
- 按一下「選取專案」,即可開啟 Google Cloud 專案瀏覽器。
- 找出專案,然後按一下 Google Cloud 專案名稱。
- 按一下「開啟」,即可開啟專案。
按一下您要啟用的 API。如果您在尋找 API 時需要協助,請使用頁面頂端附近的「搜尋 API 和服務」方塊。畫面隨即顯示描述 API 的頁面。
按一下「啟用」按鈕。
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:
- 前往 Google Cloud 控制台的「API Dashboard」頁面。
前往「API Dashboard」(API 資訊主頁) 頁面 請執行下列任一操作,選取要停用 API 的 Google Cloud 專案:
按一下「Select a recent project」下方的 Google Cloud 專案。
如要使用 Google Cloud 專案瀏覽器,請按照下列步驟操作:
- 按一下「選取專案」,即可開啟 Google Cloud 專案瀏覽器。
- 找出專案,然後按一下 Google Cloud 專案名稱。
- 按一下「開啟」,即可開啟專案。
按一下要停用的 API。如果您在尋找 API 時需要協助,請使用頁面頂端附近的「搜尋 API 和服務」方塊。畫面隨即顯示描述 API 的頁面。
按一下 stop「停用 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
進行輪詢。