Menu
AWS Billing and Cost Management
User Guide (Version 2.0)

DeleteBudget

Deletes a budget. You can delete your budget at any time.

Warning

Deleting a budget also deletes the notifications and subscribers associated with that budget.

Request Parameters

The request requires the following data in JSON format.

accountId

The accountId that is associated with the budget.

Type: String

Length constraints: Minimum length of 12, maximum length of 12.

Required: Yes

budgetName

The name of the budget that you want to delete.

Type: String

Pattern: [^:]+

Required: Yes

Errors

NotFoundException

We can’t locate the resource that you specified.

HTTP Status Code: 400

InternalErrorException

An error on the server occurred during the processing of your request. Try again later.

HTTP Status Code: 500

InvalidParameterException

An error on the client occurred. Typically, the cause is an invalid input value.

HTTP Status Code: 400

Examples

The following example request deletes the budget named Example Budget.

Sample Request

Copy
{ "Operation": "com.amazonaws.awsbudgets#DeleteBudget", "Service": "com.amazonaws.awsbudgets#AWSBudgets", "Input": { "budgetName": "Example Budget", "accountId": "1234567890" } }