---
title: "PUT /{scope}/providers/Microsoft.Consumption/budgets/{budgetName}"
method: PUT
path: "/{scope}/providers/Microsoft.Consumption/budgets/{budgetName}"
tags: ["Budgets"]
---

# PUT /{scope}/providers/Microsoft.Consumption/budgets/{budgetName}

`PUT /{scope}/providers/Microsoft.Consumption/budgets/{budgetName}`

The operation to create or update a budget. Update operation requires latest eTag to be set in the request mandatorily. You may obtain the latest eTag by performing a get operation. Create operation does not require eTag.

## Path parameters

- `scope` string, required
- `budgetName` string, required

## Query parameters

- `api-version` string, required

## Request body

- Budget — The Resource model definition.
  - `id` string — Resource Id.
  - `name` string — Resource name.
  - `type` string — Resource type.
  - `eTag` string — eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.

## Response `200`

OK. The request has succeeded.

- Budget — The Resource model definition.
  - `id` string — Resource Id.
  - `name` string — Resource name.
  - `type` string — Resource type.
  - `eTag` string — eTag of the resource. To handle concurrent update scenario, this field will be used to determine whether the user is updating the latest version or not.

## Other responses

- `201` — Created.
- `default` — Error response describing why the operation failed.

---

[API](https://skmtc.net/azure/apis/consumptionmanagementclient.md) · [All operations](https://skmtc.net/azure/apis/consumptionmanagementclient/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/consumptionmanagementclient/versions/f34618e34e72/schema)