設定 Cloud Billing Budget API

本指南提供所有必要的設定步驟,協助您開始使用 Cloud Billing Budget API。

事前準備

閱讀本指南之前,請先完成下列工作:

  1. 請參閱 Cloud Billing Budget API 總覽。
  2. 請參閱「Cloud Billing Budget API 先決條件」。

關於 Google Cloud 控制台

Google Cloud 控制台 (參閱說明文件、開啟控制台) 是網頁 UI,可用於佈建、設定、管理及監控使用Google Cloud 產品的系統。您可以使用 Google Cloud 控制台設定及管理 Google Cloud Cloud Billing 資源。

1. 選取或建立專案

如要使用 Google Cloud提供的服務,必須建立專案。專案可整理您所有 Google Cloud 資源。專案是由一組協作者、已啟用的 API (和其他資源)、監控工具、帳單資訊,以及驗證和存取控管組成。您可以建立一個專案,也可以建立多個專案,並使用這些專案在資源階層中整理您的Google Cloud 資源。如要進一步瞭解專案,請參閱「Resource Manager 說明文件」。

專案建議:建議您建立並使用獨立的 Google Cloud 專案,來保存 Cloud Billing 帳戶的所有 FinOps 和帳單管理必要元件,包括 Cloud Billing Budget API 的使用。進一步瞭解使用 FinOps 專案的好處,以及如何用於帳單管理。

在 Google Cloud 控制台的專案選擇器頁面中,選取或建立 Google Cloud 專案。

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

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

前往專案選取器

2. 啟用計費功能

請務必在用於呼叫 Cloud Billing Budget API 的專案中啟用計費功能。如果您已按照專案部分的建議操作,這個專案就是您的 FinOps 或帳單管理 Google Cloud 專案。

確認 Google Cloud 專案已啟用計費功能。

Cloud Billing 帳戶可用來定義特定Google Cloud 資源組合費用的支付者。資源 (例如已啟用的 API) 會彙整在專案中。Cloud Billing 帳戶可連結至一或多個專案。專案的使用費會從相連結的帳單帳戶中扣除。在大多數情況下,您會在建立專案時設定帳單。詳情請參閱「Cloud Billing 說明文件」。

使用費用

您可以設定 Cloud Billing 預算,監控 Cloud Billing 帳戶產生的費用。您監控的 Cloud Billing 帳戶,可以與用來呼叫 Cloud Billing Budget API 的專案連結的 Cloud Billing 帳戶相同。請注意,客戶 Google Cloud 可免費使用 Cloud Billing Budget API。如果您選擇設定程式輔助預算通知,系統會按照標準 Pub/Sub 價格收費。

3. 啟用 API

您必須在用於呼叫 Cloud Billing Budget API 的專案中,啟用 Cloud Billing Budget API。如果您已按照專案部分的建議操作,這個專案就是您的 FinOps 或帳單管理 Google Cloud 專案。

如要進一步瞭解如何啟用 API,請參閱服務使用情形說明文件。

啟用 Cloud Billing Budget API (如果尚未啟用)。

啟用 API 時所需的角色

如要啟用 API,您必須具備 serviceusage.services.enable 權限。如果您建立了專案,可能已透過「擁有者」角色 (roles/owner) 取得這項權限。否則,您可以透過「服務使用管理員」角色 (roles/serviceusage.serviceUsageAdmin) 取得這項權限。瞭解如何授予角色。

啟用 API

4. 設定驗證與授權

如果您打算使用 Cloud Billing Budget API,必須設定驗證方法。任何使用該 API 的用戶端應用程式都必須經過驗證,確認自身身分。詳情請參閱「向 Cloud Billing 進行驗證」。

您會以特定主體 (例如 Google 帳戶或服務帳戶) 的身分進行驗證。該主體必須具備 Identity and Access Management (IAM) 角色,其中包含 Cloud Billing Budget API 的必要權限。

為確保主體具備管理預算所需的權限,請要求管理員在帳單帳戶中,授予主體「帳單帳戶管理員」 (roles/billing.admin) IAM 角色。如要進一步瞭解如何授予角色,請參閱「管理專案、資料夾和組織的存取權」。

管理員或許也能透過自訂角色或其他預先定義的角色,授予主體必要權限。

如要瞭解如何授予帳單帳戶角色,請參閱「更新 Cloud Billing 權限」。

5. 安裝並初始化 gcloud CLI

如要使用 Cloud Billing Budget API,必須安裝並初始化 Google Cloud CLI。Google Cloud CLI 是一套工具,可用來管理託管於 Google Cloud的資源和應用程式。包括 gcloud CLI。 以下連結提供操作說明:

安裝 Google Cloud CLI。 完成後,執行下列指令來初始化 Google Cloud CLI:

gcloud init

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

6. 測試 SDK 和驗證

如果您已在先前的步驟中設定驗證,可以使用 gcloud CLI 測試驗證環境。執行下列指令,確認沒有發生任何錯誤,且會傳回憑證:

gcloud auth print-access-token

所有 Cloud Billing Budget API 指令列 REST 範例都會使用該指令,驗證 API 呼叫。

7. 安裝 Cloud Billing Budget API 用戶端程式庫

Cloud Billing Budget API 是以 HTTP 和 JSON 做為建構基礎,因此所有標準 HTTP 用戶端都可以向 Cloud Billing Budget API 傳送要求並剖析回應。

您可以透過三種方式來呼叫 API:

  • Google 支援的用戶端程式庫 (建議)

    用戶端程式庫可以提供更好的語言整合環境、更高的安全性,並支援需要使用者授權的呼叫要求。Google 支援多種常見語言的用戶端程式庫,建議您使用這些程式庫。

  • REST

  • gRPC