/v2/budgets/{budget_id}

1 min

PATCH

https://dev-api.cloudzero.com/v2/budgets/{budget_id}

Update a single Budget

Path Parameters

budget_idstringrequired
Description
Unique budget identifier

Header Parameters

cloudzero-idempotency-keystring
Description
If passed, any subsequent operation with the same value for this header will return the exact same result. This is true for all responses, i.e. successes and errors.
cloudzero-test-keystring
Description
If passed, the operation executes in the namespace specified by this key. Resource mutations in the namespace last for 1 hour.

Body Parameters

bodybudget_new
- namestringrequired
  Description
  Budget name, must be unique within a View
- planned_limitsbudget_planned_limitsrequired
  Example
```
{
  "monthly": {
    "2022-02-01T00:00:00+00:00": {
      "amount": "1000.00"
    }
  }
}
```
  Description
  Mapping of date to amount, where date is an ISO Formatted string amount is a Mapping of the literal string "amount" to a dollar amount
  - monthlymap<string, object>required
    Description
    Monthly planned limit as a mapping of month date to amount, where month date is an ISO Formatted Date [Time] String that will be coerced to the first of the month amount is a Mapping of the literal string "amount" to a dollar amount
- viewwith_idrequired
  Description
  View associated with this Budget
  - idstringrequired
- alertsbudget_alerts
  Example
```
{
  "alerts": {
    "80": "N",
    "100": "Y"
  }
}
```
  Description
  Mapping of 1-100 to Y/N, where 1-100 is the percentage of the budget at which to send an alert Y/N is whether or not to send the alert

Responses

200Successful Operation

object
- budgetbudget
  - budget_new
    - namestringrequired
      Description
      Budget name, must be unique within a View
    - planned_limitsbudget_planned_limitsrequired
      Example
      { "monthly": { "2022-02-01T00:00:00+00:00": { "amount": "1000.00" } } }
      Description
      Mapping of date to amount, where date is an ISO Formatted string amount is a Mapping of the literal string "amount" to a dollar amount
      - monthlymap<string, object>required
        Description
        Monthly planned limit as a mapping of month date to amount, where month date is an ISO Formatted Date [Time] String that will be coerced to the first of the month amount is a Mapping of the literal string "amount" to a dollar amount
    - viewwith_idrequired
      Description
      View associated with this Budget
      - idstringrequired
    - alertsbudget_alerts
      Example
      { "alerts": { "80": "N", "100": "Y" } }
      Description
      Mapping of 1-100 to Y/N, where 1-100 is the percentage of the budget at which to send an alert Y/N is whether or not to send the alert
  - with_id
    - idstringrequired
  - with_created
    - createdepochrequired
      Description
      UTC timestamp for the creation of this entity
  - with_last_updated
    - last_updatedepochrequired
      Description
      UTC timestamp for the last update of this entity
  - object
    - cost_typecost_typerequired
      Description
      Type of charges included in the cost calculation, where real_cost: filters your bill to only display charges directly related to consumption
      - Max depth limit reached
    - granularitygranularityrequired
      Description
      Supported periods, e.g. "monthly"
      - Max depth limit reached

400Bad Request Error

object
- errorerror
  - messagestring
  - typestring

403Forbidden

object
- messagestringrequired

curl

curl --request PATCH \
     --url https://dev-api.cloudzero.com/v2/budgets/{budget_id} \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{
     "name": "",
     "planned_limits": {
     "monthly": ""
     },
     "view": {
     "id": ""
     }
     }'

javascript

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

var raw = JSON.stringify({
   "name": "",
   "planned_limits": {
      "monthly": ""
   },
   "view": {
      "id": ""
   }
});

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

fetch("https://dev-api.cloudzero.com/v2/budgets/{budget_id}", 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://dev-api.cloudzero.com/v2/budgets/{budget_id}")

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

request = Net::HTTP::Patch.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
   "name": "",
   "planned_limits": {
      "monthly": ""
   },
   "view": {
      "id": ""
   }
})

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

python

import requests
import json

url = "https://dev-api.cloudzero.com/v2/budgets/{budget_id}"

payload = json.dumps({
   "name": "",
   "planned_limits": {
      "monthly": ""
   },
   "view": {
      "id": ""
   }
})
headers = {
   'accept': 'application/json',
   'content-type': 'application/json'
}

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

print(response.text)

200

// Successful Operation
{
  "budget": {}
}

400

// Bad Request Error
{
  "error": {
    "message": "",
    "type": ""
  }
}

403

// Forbidden
{
  "message": ""
}