啟用及停用服務

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

大多數使用者都能透過 Google Cloud 控制台啟用及停用服務。如要編寫指令碼，請使用 Google Cloud CLI。如要透過程式輔助方式存取 Service Usage API，建議使用用戶端程式庫。如要試用 API，您可以傳送要求，不必設定完整的開發環境。

如要瞭解服務使用情形配額限制，請參閱配額與限制。您可能想要限制付費用量。視 API 而定，您可以明確限制要求數量。

事前準備

啟用及停用服務前，請先為「服務使用情形」設定Google Cloud 專案和環境。

控制台

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

• Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
• Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Note: If you don't plan to keep the resources that you create in this procedure, create a project instead of selecting an existing project. After you finish these steps, you can delete the project, removing all resources associated with the project.

Go to project selector

If you're using an existing project for this guide, verify that you have the permissions required to complete this guide. If you created a new project, then you already have the required permissions.

gcloud

登入 Google Cloud 帳戶。如果您是 Google Cloud新手，歡迎 建立帳戶，親自評估產品在實際工作環境中的成效。新客戶還能獲得價值 $300 美元的免費抵免額，可用於執行、測試及部署工作負載。

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

建立或選取 Google Cloud 專案。

選取或建立專案所需的角色

• 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
• 建立專案：如要建立專案，您需要「專案建立者」角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。因此您在完成這些步驟之後，就可以刪除專案，並移除與該專案相關聯的所有資源。

• 建立 Google Cloud 專案：

  gcloud projects create PROJECT_ID

  將 PROJECT_ID 替換為您要建立的 Google Cloud 專案名稱。

• 選取您建立的 Google Cloud 專案：

  gcloud config set project PROJECT_ID

  將 PROJECT_ID 替換為 Google Cloud 專案名稱。

如要使用現有專案進行本指南中的操作，請確認您具有完成本指南所需的權限。如果您建立新專案，則已具備必要權限。

安裝 Google Cloud CLI。

若您採用的是外部識別資訊提供者 (IdP)，請先使用聯合身分登入 gcloud CLI。

執行下列指令，初始化 gcloud CLI：

gcloud init

建立或選取 Google Cloud 專案。

選取或建立專案所需的角色

• 選取專案：選取專案時，不需要具備特定 IAM 角色，只要您在專案中獲派角色，即可選取該專案。
• 建立專案：如要建立專案，您需要「專案建立者」角色 (roles/resourcemanager.projectCreator)，其中包含 resourcemanager.projects.create 權限。瞭解如何授予角色。

注意：如果您不打算保留在這項程序中建立的資源，請建立新專案，而不要選取現有專案。因此您在完成這些步驟之後，就可以刪除專案，並移除與該專案相關聯的所有資源。

• 建立 Google Cloud 專案：

  gcloud projects create PROJECT_ID

  將 PROJECT_ID 替換為您要建立的 Google Cloud 專案名稱。

• 選取您建立的 Google Cloud 專案：

  gcloud config set project PROJECT_ID

  將 PROJECT_ID 替換為 Google Cloud 專案名稱。

如要使用現有專案進行本指南中的操作，請確認您具有完成本指南所需的權限。如果您建立新專案，則已具備必要權限。

REST API

1. 擁有要啟用或停用 API 的 Google Cloud 專案。

2. 確認您具備完成本指南所需的權限。如果您使用自己建立的專案，通常已具備必要權限。

必要的角色

如要取得啟用及停用服務所需的權限，請要求管理員授予您專案的服務使用情形管理員 (roles/serviceusage.serviceUsageAdmin) IAM 角色。如要進一步瞭解如何授予角色，請參閱「管理專案、資料夾和組織的存取權」。

您或許也能透過自訂角色或其他預先定義的角色，取得必要權限。

可啟用服務

啟用服務的程序可能有所不同。部分 API 會要求您先接受服務條款，或處於預覽階段，需要先獲得核准才能使用。其他 API 可能會要求額外資訊，例如您機構的聯絡資訊，以及您應用程式的名稱。Google 會對您提供的任何資訊保密。我們使用這項資訊瞭解 API 用量，並在必要時與您聯絡。

控制台

1. 前往 Google Cloud 控制台的「APIs & Services」(API 與服務) >「API Library」(API 程式庫) 頁面。

   前往 API 程式庫

2. 選取近期專案，或使用控制台工具列的資源選取器，選取要啟用 API 的 Google Cloud 專案。

3. 按一下要啟用的 API，或使用「搜尋 API 和服務」方塊搜尋。

4. 按一下「啟用」。

gcloud

The gcloud services enable command enables a service with the name specified for the current project.

使用下方的任何指令資料之前，請先替換以下項目：

• SERVICE：要啟用的服務名稱。

執行 gcloud services enable 指令：

Linux、macOS 或 Cloud Shell

gcloud services enable SERVICE

Windows (PowerShell)

gcloud services enable SERVICE

Windows (cmd.exe)

gcloud services enable SERVICE

您應該會收到類似以下的回應：

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

如要啟用多項服務，請使用以空格分隔的服務名稱。舉例來說，下列指令會同時啟用 BigQuery 和 Pub/Sub 服務：

gcloud services enable bigquery.googleapis.com pubsub.googleapis.com

如要擷取作業詳細資料，請使用 gcloud services operations describe 指令：

gcloud services operations describe operations/OPERATION_ID

將 OPERATION_ID 替換為您在原始要求的回應中收到的作業 ID。

REST API

啟用單一服務

如要啟用單一服務，請使用 services.enable 方法。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID：您的 Google Cloud專案 ID。
• SERVICE：要啟用的服務名稱。

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:enable" | Select-Object -Expand Content

如果成功，回應主體會包含新建立的 Operation 例項：

{
  "name": "operations/OPERATION_ID"
}

注意： 預設情況下，專案會啟用 Service Usage API，但如果您為要求啟用服務的專案停用該 API，嘗試提出要求時就會收到錯誤訊息。如要修正此問題，請使用 Google Cloud 控制台或 Google Cloud CLI，重新啟用執行要求的專案的 Service Usage API。

啟用多項服務

如要在單一作業中啟用最多 20 項服務，請使用 services.batchEnable 方法。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID：您的 Google Cloud專案 ID。
• SERVICE1：要啟用的服務名稱。
• SERVICE2：要啟用的其他服務名稱。

JSON 要求內文：

{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中。 在終端機中執行下列指令，在目前目錄中建立或覆寫這個檔案：

cat > request.json << 'EOF'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
EOF

接著，請執行下列指令來傳送 REST 要求：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

將要求主體儲存在名為 request.json 的檔案中。 在終端機中執行下列指令，在目前目錄中建立或覆寫這個檔案：

@'
{
  "serviceIds": ["SERVICE1", "SERVICE2"]
}
'@  | Out-File -FilePath request.json -Encoding utf8

接著，請執行下列指令來傳送 REST 要求：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services:batchEnable" | Select-Object -Expand Content

如果成功，回應主體會包含新建立的 Operation 例項：

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.OperationMetadata"
  }
}

注意： 預設情況下，專案會啟用 Service Usage API，但如果您為要求啟用服務的專案停用該 API，嘗試提出要求時就會收到錯誤訊息。如要修正此問題，請使用 Google Cloud 控制台或 Google Cloud CLI，重新啟用執行要求的專案的 Service Usage API。

可停用服務

您可以隨時停用專案的 API。不過，系統仍會向您收取待處理費用，且您必須支付專案中任何付費 API 的使用費用。詳情請參閱 Cloud API 的入門指南。

許多服務 (例如 Cloud Storage 和 BigQuery) 會收取資料儲存費用，停用這些服務的 API 不會刪除您的資料。即使停用 API，系統仍會繼續收取這些服務的資料儲存費用。相反地，停用 Cloud Run API 時，系統會刪除與 Cloud Run 相關聯的資源，這可能不是您想執行的操作。

無論是哪種情況，一般最佳做法都是先清查與服務相關聯的資源，再停用服務。如果是 Cloud Storage 和 BigQuery 等服務，如要停止產生後續費用並停用服務，請先刪除所有相關聯的資料，再停用 API。如果是 Cloud Run，請先確認現有的 Cloud Run 資源可安全刪除，再停用 API。

如果停用 Kubernetes Engine API，專案中正在執行的叢集就會暫停。30 天後，系統就會刪除這些已暫停的叢集。如要重新啟用叢集，請重新啟用 GKE API。叢集最多可能需要 24 小時才會恢復。詳情請參閱「叢集生命週期」。

注意： 如果您嘗試停用其他已啟用服務依賴的服務，要求將會失敗並傳回錯誤。如要停用指定服務和所有依附於該服務的服務，請在 services.disable 要求中將 disableDependentServices 參數設為 true。

控制台

1. 前往 Google Cloud 控制台的「APIs & Services」(API 與服務) >「API Library」(API 程式庫) 頁面。

   前往 API 程式庫

2. 選取近期專案，或使用控制台工具列的資源選取器，選取要停用 API 的 Google Cloud 專案。

3. 按一下要停用的 API，或使用「Search for APIs & Services」(搜尋 API 和服務) 方塊搜尋。

4. 按一下「停用 API」。

gcloud

gcloud services disable 指令會停用目前專案中指定名稱的服務。

使用下方的任何指令資料之前，請先替換以下項目：

• SERVICE：要停用的服務名稱。

執行 gcloud services disable 指令：

Linux、macOS 或 Cloud Shell

gcloud services disable SERVICE

Windows (PowerShell)

gcloud services disable SERVICE

Windows (cmd.exe)

gcloud services disable SERVICE

您應該會收到類似以下的回應：

Waiting for async operation operations/OPERATION_ID to complete...
Operation finished successfully.

如要停用多項服務，請使用以空格分隔的服務名稱。舉例來說，下列指令會同時停用 BigQuery 和 Pub/Sub 服務：

gcloud services disable bigquery.googleapis.com pubsub.googleapis.com

如要擷取作業詳細資料，請使用 gcloud services operations describe 指令：

gcloud services operations describe operations/OPERATION_ID

將 OPERATION_ID 替換為您在原始要求的回應中收到的作業 ID。

REST API

如要停用服務，請使用 services.disable 方法。

使用任何要求資料之前，請先修改下列項目的值：

• PROJECT_ID：您的 Google Cloud專案 ID。
• SERVICE：要停用的服務名稱。

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d "" \
     "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/projects/PROJECT_ID/services/SERVICE:disable" | Select-Object -Expand Content

如果成功，回應主體會包含新建立的 Operation 例項：

{
  "name": "operations/OPERATION_ID"
}

注意： 預設情況下，專案會啟用 Service Usage API，但如果您為要停用服務的專案停用這項 API，嘗試提出要求時就會收到錯誤訊息。如要修正此問題，請使用 Google Cloud 控制台或 Google Cloud CLI，重新啟用執行要求的專案的 Service Usage API。

檢查長時間執行的作業狀態

使用啟用或停用方法會傳回長時間執行的作業 (LRO)。LRO 會追蹤要求狀態，並指出服務變更是否完成。

使用任何要求資料之前，請先修改下列項目的值：

OPERATION_ID：作業 ID。 您會在原始要求的相關回覆中收到這個 ID。

請展開以下其中一個選項，以傳送要求：

curl (Linux、macOS 或 Cloud Shell)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI，或已使用 Cloud Shell 自動登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID"

PowerShell (Windows)

注意：下列指令假設您已執行 gcloud init 或 gcloud auth login，透過使用者帳戶登入 gcloud CLI。您可以執行 gcloud auth list，查看目前使用的帳戶。

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://serviceusage.googleapis.com/v1/operations/OPERATION_ID" | Select-Object -Expand Content

您應該會收到如下的 JSON 回覆：

{
  "name": "operations/OPERATION_ID",
  "metadata": {
    "@type": "type.googleapis.com/google.protobuf.Empty"
  },
  "done": true,
  "response": {
    "@type": "type.googleapis.com/google.api.serviceusage.v1.EnableServiceResponse",
    "service": {
      "name": "projects/PROJECT_NUMBER/services/SERVICE",
      "config": {
        "name": "SERVICE",
        "title": "TITLE",
        "documentation": {},
        "quota": {},
        "authentication": {},
        "usage": {
          "requirements": [
            "serviceusage.googleapis.com/tos/cloud"
          ]
        },
        "monitoring": {}
      },
      "state": "ENABLED",
      "parent": "projects/PROJECT_NUMBER"
    }
  }
}

done 欄位設為 true 時，即代表作業完成。