notifications_for_budgets

Creates, updates, deletes, gets or lists a notifications_for_budgets resource.

Overview

Name	notifications_for_budgets
Type	Resource
Id	aws.budgets.notifications_for_budgets

Fields

The following fields are returned by SELECT queries:

describe_notifications_for_budget

Name	Datatype	Description
comparison_operator	string	The comparison that's used for this notification. (GREATER_THAN, LESS_THAN, EQUAL_TO)
notification_state	string	Specifies whether this notification is in alarm. If a budget notification is in the ALARM state, you passed the set threshold for the budget. (OK, ALARM)
notification_type	string	Specifies whether the notification is for how much you have spent (ACTUAL) or for how much that you're forecasted to spend (FORECASTED). (ACTUAL, FORECASTED)
threshold	number (double)	The threshold that's associated with a notification. Thresholds are always a percentage, and many customers find value being alerted between 50% - 200% of the budgeted amount. The maximum limit for your threshold is 1,000,000% above the budgeted amount.
threshold_type	string	The type of threshold for a notification. For ABSOLUTE_VALUE thresholds, Amazon Web Services notifies you when you go over or are forecasted to go over your total cost threshold. For PERCENTAGE thresholds, Amazon Web Services notifies you when you go over or are forecasted to go over a certain percentage of your forecasted spend. For example, if you have a budget for 200 dollars and you have a PERCENTAGE threshold of 80%, Amazon Web Services notifies you when you go over 160 dollars. (PERCENTAGE, ABSOLUTE_VALUE)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
describe_notifications_for_budget	select	region		Lists the notifications that are associated with a budget.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
region	string	AWS region (default: us-east-1)

SELECT examples

describe_notifications_for_budget

Lists the notifications that are associated with a budget.

SELECT
comparison_operator,
notification_state,
notification_type,
threshold,
threshold_type
FROM aws.budgets.notifications_for_budgets
WHERE region = '{{ region }}' -- required
;