Cloud Billing Budget API에 몇 가지 간단한 요청을 보내는 방법을 알아봅니다.
전체 메서드 목록은 REST API 또는 RPC API 참조 문서를 확인하세요.
시작하기 전에
이 가이드를 읽기 전에 다음을 수행해야 합니다.
- Cloud Billing Budget API 개요를 읽어보세요.
- Cloud Billing Budget API 기본 요건을 읽어보세요.
- 설정 단계 수행
결제 계정 ID 확인
모든 Cloud Billing Budget API 호출에 대해 결제 계정 ID가 필요합니다.
- Google Cloud Console 결제 계정 관리 페이지로 이동합니다.
- 내 결제 계정 탭에서 이름 및 ID로 결제 계정 목록이 표시됩니다. 예산을 관리할 계정의 결제 계정 ID를 찾습니다.
API 호출
다음 샘플은 Cloud Billing Budget API에 몇 가지 간단한 요청을 보내는 방법을 보여줍니다.
예산은 전체 결제 계정에 적용되거나, 프로젝트 및 서비스 그룹에서 특정 비용 조각을 모니터링하기 위해 세부적인 예산 필터를 사용하여 특정 프로젝트 또는 제품의 하위 집합으로 범위가 지정(필터링)될 수 있습니다.
예산 나열
이 API 메서드는 지정된 Cloud Billing 계정에 설정된 모든 예산을 나열합니다.
REST 및 명령줄
아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.
- billing-account-id: 예산이 적용되는 Google Cloud 결제 계정 ID
HTTP 메서드 및 URL:
GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "budgets": [ { "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777", "displayName": "Forecasted spend budget with Svc Filter", "budgetFilter": { "projects": [ "projects/123456789" ], "services": [ "services/A1E8-BE35-7EBC" ], "creditTypesTreatment": "EXCLUDE_ALL_CREDITS" }, "amount": { "lastPeriodAmount": {} }, "thresholdRules": [ { "thresholdPercent": 0.9, "spendBasis": "FORECASTED_SPEND" } ], "allUpdatesRule": {}, "etag": "c9d6c011f6fa6b5c" } ] }
예산 가져오기
이 API 메서드는 특정 예산에 대한 세부정보를 가져옵니다.
REST 및 명령줄
이 메서드를 호출하려면 업데이트할 예산의 budget-id가 필요합니다. 예산을 만들 때는 createBudget
출력에서, 예산을 모두 나열할 때는 listBudgets
출력에서 예산 ID를 가져올 수 있습니다.
아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.
- billing-account-id: 이 예산이 적용되는 Google Cloud 결제 계정 ID
- budget-id: 가져올 예산의 ID
HTTP 메서드 및 URL:
GET https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777", "displayName": "Forecasted spend budget with Svc Filter", "budgetFilter": { "projects": [ "projects/123456789" ], "services": [ "services/A1E8-BE35-7EBC" ], "creditTypesTreatment": "EXCLUDE_ALL_CREDITS" }, "amount": { "lastPeriodAmount": {} }, "thresholdRules": [ { "thresholdPercent": 0.9, "spendBasis": "FORECASTED_SPEND" } ], "allUpdatesRule": {}, "etag": "c9d6c011f6fa6b5c" }
예산 만들기
이 API 메서드는 지정된 Cloud Billing 계정에 적용되는 Cloud Billing 예산을 만듭니다.
REST 및 명령줄
이 샘플은 사용자가 지정한 Google Cloud 프로젝트로 범위가 지정(필터링)된 정해진 결제 계정에 대해 예산을 만드는 방법을 보여줍니다.
아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.
- project-id: 예산 범위(
budgetFilter
)로 설정할 Google Cloud 프로젝트 ID - billing-account-id: 이 예산이 적용되는 Google Cloud 결제 계정 ID
HTTP 메서드 및 URL:
POST https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets
JSON 요청 본문:
{ "displayName": "Keep my spending down", "budgetFilter": { "projects": [ "projects/project-id" ] }, "amount": { "lastPeriodAmount": {} }, "thresholdRules": { "thresholdPercent": 0.8, "spendBasis": "CURRENT_SPEND" } }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 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" }, "amount": { "lastPeriodAmount": {} }, "thresholdRules": { "thresholdPercent": 0.8, "spendBasis": "CURRENT_SPEND" }, "allUpdatesRule": {}, "etag": "f7928d8010160668" }
예산 업데이트
이 API 메서드를 사용하여 기존 Cloud Billing 예산을 수정해 예산 금액, 필터(예산 범위) 또는 알림 기준을 변경할 수 있습니다.
REST 및 명령줄
이 샘플은 기존 예산을 업데이트하고 사용자가 지정한 Google Cloud 프로젝트별로 범위(필터)를 설정하는 방법을 보여줍니다.
이 메서드를 호출하려면 업데이트할 예산의 budget-id가 필요합니다. 예산을 만들 때는 createBudget
출력에서, 예산을 모두 나열할 때는 listBudgets
출력에서 예산 ID를 가져올 수 있습니다.
아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.
- project-id: 예산 범위(
budgetFilter
)로 설정할 Google Cloud 프로젝트 ID - billing-account-id: 이 예산이 적용되는 Google Cloud 결제 계정 ID
- budget-id: 업데이트할 예산의 ID
HTTP 메서드 및 URL:
PATCH https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id
JSON 요청 본문:
{ "budget": { "displayName": "My fancy budget", "budgetFilter": { "projects": [ "projects/project-id" ] }, "amount": { "specifiedAmount": { "units": 500 } }, "thresholdRules": { "thresholdPercent": 0.8, "spendBasis": "CURRENT_SPEND" } } }
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{ "name": "billingAccounts/000000-111111-222222/budgets/33333333-4444-5555-6666-777777777777", "displayName": "My fancy budget", "budgetFilter": { "projects": [ "projects/123456789" ], "creditTypesTreatment": "INCLUDE_ALL_CREDITS" }, "amount": { "specifiedAmount": { "units": 500 } }, "thresholdRules": { "thresholdPercent": 0.8, "spendBasis": "CURRENT_SPEND" }, "allUpdatesRule": {}, "etag": "f7928d8010160668" }
예산 삭제
이 API 메서드를 사용하여 기존 Cloud Billing 예산을 삭제할 수 있습니다.
REST 및 명령줄
이 메서드를 호출하려면 업데이트할 예산의 budget-id가 필요합니다. 예산을 만들 때는 createBudget
출력에서, 예산을 모두 나열할 때는 listBudgets
출력에서 예산 ID를 가져올 수 있습니다.
아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.
- billing-account-id: 이 예산이 적용되는 Google Cloud 결제 계정 ID
- budget-id: 삭제할 예산의 ID
HTTP 메서드 및 URL:
DELETE https://billingbudgets.googleapis.com/v1/billingAccounts/billing-account-id/budgets/budget-id
요청을 보내려면 다음 옵션 중 하나를 펼칩니다.
다음과 비슷한 JSON 응답이 표시됩니다.
{}