Google 會運用 AI 技術將內容翻譯成你偏好的語言，但可能會出錯。

啟用及停用服務

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

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

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

事前準備

啟用及停用服務前，請先為 Service Usage 設定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.

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.

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

擁有要啟用或停用 API 的 Google Cloud 專案。
確認您具備完成本指南所需的權限。如果您使用自己建立的專案，通常已具備必要權限。

必要的角色

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

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

可啟用服務

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

控制台

在 Google Cloud 控制台中，依序前往「APIs & Services」(API 與服務) >「API Library」(API 程式庫) 頁面。

前往 API 程式庫
選取近期專案，或使用控制台工具列的資源選取器，選取要啟用 API 的 Google Cloud 專案。
按一下要啟用的 API，或使用「搜尋 API 和服務」方塊搜尋。
按一下「啟用」。

gcloud

gcloud services enable 指令會為目前專案啟用指定名稱的服務。

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

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"
}

啟用多項服務

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

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

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

JSON 要求內文：

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

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 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"
  }
}

可停用服務

您隨時可以停用專案的 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 小時才會恢復。詳情請參閱「叢集生命週期」。

控制台

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

前往 API 程式庫
選取近期專案，或使用控制台工具列的資源選取器，選取要停用 API 的 Google Cloud 專案。
按一下要停用的 API，或使用「搜尋 API 和服務」方塊搜尋。
點選「停用 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)

執行下列指令：

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"
}

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

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

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

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

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

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

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 時，作業即完成。