Cloud Billing Budget API 사용하기

Cloud Billing Budget API에 몇 가지 간단한 요청을 보내는 방법을 알아봅니다.

전체 메서드 목록은 REST API 또는 RPC API 참조 문서를 확인하세요.

시작하기 전에

이 가이드를 읽기 전에 다음을 수행해야 합니다.

1. Cloud Billing Budget API 개요를 읽어보세요.
2. Cloud Billing Budget API 기본 요건을 읽어보세요.
3. 설정 단계 수행

결제 계정 ID 확인

모든 Cloud Billing Budget API 호출에 대해 결제 계정 ID가 필요합니다.

1. Google Cloud Console 결제 계정 관리 페이지로 이동합니다.
2. 내 결제 계정 탭에서 이름 및 ID로 결제 계정 목록이 표시됩니다. 예산을 관리할 계정의 결제 계정 ID를 찾습니다.

API 호출

다음 샘플은 Cloud Billing Budget API에 몇 가지 간단한 요청을 보내는 방법을 보여줍니다.

예산은 전체 결제 계정에 적용되거나, 프로젝트 및 서비스 그룹에서 특정 비용 조각을 모니터링하기 위해 세부적인 예산 필터를 사용하여 특정 프로젝트 또는 제품의 하위 집합으로 범위가 지정(필터링)될 수 있습니다.

참고: 하나의 Cloud Billing 계정에 한 번에 연결될 수 있는 예산은 최대 5,000개입니다. 자세한 내용은 할당량 및 한도를 참조하세요.

예산 나열

이 API 메서드는 지정된 Cloud Billing 계정에 설정된 모든 예산을 나열합니다.

REST 및 명령줄

아래의 요청 데이터를 사용하기 전에 다음을 바꿉니다.

• billing-account-id: 예산이 적용되는 Google Cloud 결제 계정 ID

HTTP 메서드 및 URL:

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

다음 명령어를 실행합니다.

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

PowerShell(Windows)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

다음 명령어를 실행합니다.

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

PowerShell(Windows)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

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

PowerShell(Windows)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

curl -X PATCH \
-H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \
-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)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

요청 본문을 request.json 파일에 저장하고 다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

요청을 보내려면 다음 옵션 중 하나를 펼칩니다.

cURL(Linux, macOS, Cloud Shell)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

다음 명령어를 실행합니다.

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

PowerShell(Windows)

참고: GOOGLE_APPLICATION_CREDENTIALS 환경 변수를 서비스 계정 비공개 키 파일 경로로 설정해야 합니다.

다음 명령어를 실행합니다.

$cred = gcloud auth application-default print-access-token
$headers = @{ "Authorization" = "Bearer $cred" }

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

다음과 비슷한 JSON 응답이 표시됩니다.

{}