本頁面由 Cloud Translation API 翻譯而成。

使用 Cloud Billing Budget API

瞭解如何對 Cloud Billing Budget API 傳送幾個簡單的要求。

如需完整的方法清單，請參閱 REST API 或 RPC API 參考說明文件。

事前準備

閱讀本指南之前，請先完成下列工作：

找出 Cloud Billing 帳戶 ID

每次呼叫 Cloud Billing Budget API 時，您都需要帳單帳戶 ID。

前往 Google Cloud 主控台的「管理帳單帳戶」頁面。
在「我的帳單帳戶」分頁中，您會看到依名稱和 ID 列出的 Cloud Billing 帳戶。找出要管理預算的帳戶的帳單帳戶 ID。

「管理帳單」頁面的螢幕截圖，顯示帳單帳戶 ID 的位置。

預算重要概念

預算可以套用至整個帳單帳戶，也可以設定範圍 (篩選)，使用精細的預算篩選條件監控特定費用的切片。
套用至整個 Cloud Billing 帳戶的預算，會納入Google Cloud 該帳單帳戶支付的所有專案費用。
如果您對 Cloud Billing 帳戶的存取權有限或沒有存取權，可以為自有專案建立單一專案預算。如果您是 Cloud Billing 帳戶層級使用者，可以使用預算中的 OwnershipScope 欄位，建立專案層級使用者無法修改的單一專案預算。
您可以使用篩選器縮小預算範圍，例如機構、資料夾、專案、服務的子集，以及適用於 Cloud Billing 帳戶的其他預算篩選器。
您可以指定預算的時間範圍。根據預設，預算會監控在一個月內產生的費用。使用 Cloud Billing Budget API 提供的 usage_period 篩選器，您可以將預算時間範圍設為 CalendarPeriod 或 CustomPeriod，藉此建立預算來監控超出預設日曆月份的時間範圍，例如季、年或您指定的自訂日期範圍。
您可以將預算金額設為您指定的總金額，也可以根據上一個日曆週期的支出金額設定預算金額。
您可以設定預算門檻規則，觸發電子郵件快訊通知。當費用 (實際費用或預估費用) 超過某個預算百分比時，系統會根據您設定的規則傳送快訊電子郵件給指定的收件者。
您可以設定預算的通知規則，指定預算快訊的電子郵件收件者，並使用 Pub/Sub 啟用程式輔助通知。
您可以透過 Pub/Sub 主題接收程式輔助通知，例如將預算訊息轉寄至其他媒介 (如 Slack)，或自動處理成本管理工作。

配額限制：每個 Cloud 帳單帳戶一次最多可連結數千筆預算。如要瞭解目前的限制和其他資訊，請參閱配額與限制。

呼叫 API

下列範例說明如何向 Cloud Billing Budget API 傳送幾個簡單的要求。

列出預算

這個 API 方法會列出指定 Cloud Billing 帳戶的所有可用預算。

REST

使用任何要求資料之前，請先替換以下項目：

billing-account-id：預算適用的 Cloud Billing 帳戶 ID。
project-id：啟用 Cloud Billing Budget API 的專案。 Google Cloud

HTTP 方法和網址：

GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets

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

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)" \
     -H "x-goog-user-project: project-id" \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets"

PowerShell (Windows)

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

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets" | Select-Object -Expand Content

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

{
  "budgets": [
   {
      "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
      "displayName": "Forecasted spend budget with Service Filter",
      "budgetFilter": {
        "projects": [
          "projects/123456789"
        ],
        "services": [
          "services/A1E8-BE35-7EBC"
        ],
        "creditTypesTreatment": "EXCLUDE_ALL_CREDITS",
        "calendarPeriod": "MONTH"
      },
      "amount": {
        "lastPeriodAmount": {}
      },
      "thresholdRules": [
        {
          "thresholdPercent": 0.9,
          "spendBasis": "FORECASTED_SPEND"
        }
      ],
      "allUpdatesRule": {},
      "etag": "c9d6c011f6fa6b5c"
    }
  ]
}

取得預算

這個 API 方法會取得特定預算的詳細資料。

REST

如要呼叫這個方法，您需要更新預算的 budget-id。建立預算時，您可以從 createBudget 輸出內容取得預算 ID，也可以在列出所有預算時，從 listBudgets 輸出內容取得預算 ID。

使用任何要求資料之前，請先替換以下項目：

billing-account-id：這項預算適用的 Cloud Billing 帳戶 ID。
budget-id：您要取得的預算 ID。
project-id：啟用 Cloud Billing Budget API 的專案。 Google Cloud

HTTP 方法和網址：

GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

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

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X GET \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id"

PowerShell (Windows)

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

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method GET `
    -Headers $headers `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id" | Select-Object -Expand Content

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

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "Forecasted spend budget with Service Filter",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "services": [
      "services/A1E8-BE35-7EBC"
    ],
    "creditTypesTreatment": "EXCLUDE_ALL_CREDITS",
    "calendarPeriod": "MONTH"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": [
    {
      "thresholdPercent": 0.9,
      "spendBasis": "FORECASTED_SPEND"
    }
  ],
  "allUpdatesRule": {},
  "etag": "c9d6c011f6fa6b5c"
}

設定預算

這個 API 方法會建立Cloud Billing 預算，並套用至指定的 Cloud Billing 帳戶。

REST

這個範例說明如何為指定的 Cloud Billing 帳戶建立預算，並依您指定的 Google Cloud 專案進行範圍設定 (篩選)，以及設定日曆時間範圍 (一季)。

使用任何要求資料之前，請先替換以下項目：

projects/budget-scope-project-id：您要設為預算範圍 (budgetFilter) 的 Google Cloud 專案 ID。
billing-account-id：這項預算適用的 Cloud Billing 帳戶 ID。
api-user-project-id：啟用 Cloud Billing Budget API 的專案。 Google Cloud

HTTP 方法和網址：

POST https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets

JSON 要求主體：

{
  "displayName": "Keep my spending down",
  "budgetFilter": {
    "projects": [
      "projects/budget-scope-project-id"
    ],
    "calendar_period": "QUARTER"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X POST \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: api-user-project-id" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets"

PowerShell (Windows)

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

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "api-user-project-id" }

Invoke-WebRequest `
    -Method POST `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets" | Select-Object -Expand Content

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

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "Keep my spending down",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "creditTypesTreatment": "INCLUDE_ALL_CREDITS",
    "calendar_period": "QUARTER"
  },
  "amount": {
    "lastPeriodAmount": {}
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  },
  "allUpdatesRule": {},
  "etag": "f7928d8010160668"
}

更新預算

使用這個 API 方法修改現有的 Cloud Billing 預算，變更預算金額、預算篩選器 (預算範圍)、預算時間範圍或額度規則。

REST

這個範例說明如何更新現有預算，以 Google Cloud 您指定的專案設定範圍 (篩選條件)，以及如何將預算的時間範圍從每月預算更新為每季預算。

使用任何要求資料之前，請先替換以下項目：

projects/budget-scope-project-id：您要設為 Google Cloud 預算範圍的專案 (budgetFilter)。
billing-account-id：這項預算適用的 Cloud Billing 帳戶 ID。
budget-id：要更新的預算 ID。
api-user-project-id：啟用 Cloud Billing Budget API 的專案。 Google Cloud

HTTP 方法和網址：

PATCH https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

JSON 要求主體：

{
  "budget": {
    "displayName": "My fancy budget",
    "budgetFilter": {
      "projects": [
        "projects/budget-scope-project-id"
      ],
      "calendar_period": "QUARTER"
    },
   "amount": {
      "specifiedAmount": {
        "units": 500
      }
    },
    "thresholdRules": {
      "thresholdPercent": 0.8,
      "spendBasis": "CURRENT_SPEND"
    }
  }
}

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

curl (Linux、macOS 或 Cloud Shell)

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

curl -X PATCH \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: api-user-project-id" \
     -H "Content-Type: application/json; charset=utf-8" \
     -d @request.json \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id"

PowerShell (Windows)

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

將要求主體儲存在名為 request.json 的檔案中，然後執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "api-user-project-id" }

Invoke-WebRequest `
    -Method PATCH `
    -Headers $headers `
    -ContentType: "application/json; charset=utf-8" `
    -InFile request.json `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id" | Select-Object -Expand Content

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

{
  "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777",
  "displayName": "My fancy budget",
  "budgetFilter": {
    "projects": [
      "projects/123456789"
    ],
    "creditTypesTreatment": "INCLUDE_ALL_CREDITS",
    "calendar_period": "QUARTER"
  },
  "amount": {
    "specifiedAmount": {
      "units": 500
    }
  },
  "thresholdRules": {
    "thresholdPercent": 0.8,
    "spendBasis": "CURRENT_SPEND"
  },
  "allUpdatesRule": {},
  "etag": "f7928d8010160668"
}

刪除預算

使用這個 API 方法刪除現有的 Cloud Billing 預算。

REST

使用任何要求資料之前，請先替換以下項目：

billing-account-id：這項預算適用的 Cloud Billing 帳戶 ID。
budget-id：要刪除的預算 ID。
project-id：啟用 Cloud Billing Budget API 的專案。 Google Cloud

HTTP 方法和網址：

DELETE https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id

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

curl (Linux、macOS 或 Cloud Shell)

執行下列指令：

curl -X DELETE \
     -H "Authorization: Bearer $(gcloud auth print-access-token)" \
     -H "x-goog-user-project: project-id" \
     "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id"

PowerShell (Windows)

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

執行下列指令：

$cred = gcloud auth print-access-token
$headers = @{ "Authorization" = "Bearer $cred"; "x-goog-user-project" = "project-id" }

Invoke-WebRequest `
    -Method DELETE `
    -Headers $headers `
    -Uri "https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id" | Select-Object -Expand Content

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

{}

設定

使用 Cloud Billing Budget API 透過集合功能整理內容 你可以依據偏好儲存及分類內容。

事前準備

找出 Cloud Billing 帳戶 ID

預算重要概念

呼叫 API

列出預算

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

取得預算

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

設定預算

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

更新預算

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

刪除預算

REST

curl (Linux、macOS 或 Cloud Shell)

PowerShell (Windows)

使用 Cloud Billing Budget API