Update budget limits and thresholds

1 min

PUT

https://app.amberflo.io/business-unit/budget

Update a budget

Body Parameters

bodybusiness_unit.budget.Budget.in
Description
Budget configuration for business unit cost management. Defines spending limits, time periods, cost allocation rules, and monitoring thresholds for cloud resource spending control.
- codestringrequired
  Description
  Unique identifier for budget configuration. Used for API references and must be unique within the account's budget registry.
- labelstringrequired
  Description
  Human-readable display name for budget configuration. Used in dashboards and reports for easy identification by users.
- descriptionstring
  Description
  Optional detailed description explaining budget purpose, scope, and allocation strategy. Supports markdown formatting for rich documentation.
- limitnumberrequired
  Description
  Maximum spending threshold for this budget in account currency. When exceeded, triggers notifications and optional enforcement actions.
- startTimeInSecondsinteger<int64>required
  Description
  Budget validity start time in Unix timestamp seconds. Inclusive lower bound when budget rules become active.
- endTimeInSecondsinteger<int64>required
  Description
  Budget validity end time in Unix timestamp seconds. Exclusive upper bound when budget rules stop applying.
- filtermap<string, string[]>
  Description
  Cost filtering criteria for budget scope. Key-value pairs define which resources and costs count towards budget limit.
- usageItemstringrequired
  Description
  Cost metric type tracked by this budget. Examples include EffectiveCost, BilledCost, or custom usage items.

Responses

200Successful request

business_unit.budget.Budget.out
Description
Budget configuration for business unit cost management. Defines spending limits, time periods, cost allocation rules, and monitoring thresholds for cloud resource spending control.
- codestringrequired
  Description
  Unique identifier for budget configuration. Used for API references and must be unique within the account's budget registry.
- labelstringrequired
  Description
  Human-readable display name for budget configuration. Used in dashboards and reports for easy identification by users.
- descriptionstring
  Description
  Optional detailed description explaining budget purpose, scope, and allocation strategy. Supports markdown formatting for rich documentation.
- limitnumberrequired
  Description
  Maximum spending threshold for this budget in account currency. When exceeded, triggers notifications and optional enforcement actions.
- startTimeInSecondsinteger<int64>required
  Description
  Budget validity start time in Unix timestamp seconds. Inclusive lower bound when budget rules become active.
- endTimeInSecondsinteger<int64>required
  Description
  Budget validity end time in Unix timestamp seconds. Exclusive upper bound when budget rules stop applying.
- filtermap<string, string[]>
  Description
  Cost filtering criteria for budget scope. Key-value pairs define which resources and costs count towards budget limit.
- usageItemstringrequired
  Description
  Cost metric type tracked by this budget. Examples include EffectiveCost, BilledCost, or custom usage items.
- createTimeInMillisinteger<int64>
  Description
  Budget creation timestamp in Unix milliseconds. System-generated when budget configuration is first created.
- updateTimeInMillisinteger<int64>
  Description
  Last modification timestamp in Unix milliseconds. Updated automatically whenever budget configuration changes.

curl

curl --request PUT \
     --url https://app.amberflo.io/business-unit/budget \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "code": "",
     "label": "",
     "limit": "",
     "startTimeInSeconds": 0,
     "endTimeInSeconds": 0,
     "usageItem": ""
     }'

javascript

var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");

var raw = JSON.stringify({
   "code": "",
   "label": "",
   "limit": "",
   "startTimeInSeconds": 0,
   "endTimeInSeconds": 0,
   "usageItem": ""
});

var requestOptions = {
   method: 'PUT',
   headers: myHeaders,
   body: raw,
   redirect: 'follow'
};

fetch("https://app.amberflo.io/business-unit/budget", requestOptions)
   .then(response => response.text())
   .then(result => console.log(result))
   .catch(error => console.log('error', error));

ruby

require "uri"
require "json"
require "net/http"

url = URI("https://app.amberflo.io/business-unit/budget")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Put.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "code": "",
   "label": "",
   "limit": "",
   "startTimeInSeconds": 0,
   "endTimeInSeconds": 0,
   "usageItem": ""
})

response = https.request(request)
puts response.read_body

python

import requests
import json

url = "https://app.amberflo.io/business-unit/budget"

payload = json.dumps({
   "code": "",
   "label": "",
   "limit": "",
   "startTimeInSeconds": 0,
   "endTimeInSeconds": 0,
   "usageItem": ""
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

response = requests.request("PUT", url, headers=headers, data=payload)

print(response.text)

200

// Successful request
{
  "code": "",
  "label": "",
  "description": "",
  "limit": 0,
  "startTimeInSeconds": "",
  "endTimeInSeconds": "",
  "filter": "",
  "usageItem": "",
  "createTimeInMillis": "",
  "updateTimeInMillis": ""
}