本指南提供所有必要的設定步驟,協助您開始使用 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 為重點的專案,對帳單管理用途有何好處。
In the Google Cloud console, on the project selector page, select or create a Google Cloud project.
2. 啟用計費功能
請務必在用於呼叫 Cloud Billing Budget API 的專案中啟用帳單功能。如果您已按照專案部分的建議操作,這個專案就是您的 FinOps 或帳單管理 Google Cloud 專案。
Make sure that billing is enabled for your Google Cloud project.
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,請參閱服務使用情形說明文件。
Enable the Cloud Billing Budget 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。 以下連結提供操作說明:
After installing the Google Cloud CLI, initialize it by running the following command:
gcloud init
If you're using an external identity provider (IdP), you must first sign in to the gcloud CLI with your federated identity.
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 用戶端都可以傳送要求給這個 API 並剖析回應。
您可以透過三種方式來呼叫 API:
Google 支援的用戶端程式庫 (建議)
用戶端程式庫可提供更好的語言整合環境、更高的安全性,並支援需要使用者授權的呼叫要求。我們提供多種常見語言的 Google 支援用戶端程式庫,以下是建議的選項。