AWS Cost Explorer Service
Cost Management APIs

Notification

A notification that is associated with a budget. A budget can have up to five notifications.

Each notification must have at least one subscriber. A notification can have one SNS subscriber and up to 10 email subscribers, for a total of 11 subscribers.

For example, if you have a budget for 200 dollars and you want to be notified when you go over 160 dollars, create a notification with the following parameters:

  • A notificationType of ACTUAL

  • A comparisonOperator of GREATER_THAN

  • A notification threshold of 80

Contents

ComparisonOperator

The comparison that is used for this notification.

Type: String

Valid Values: GREATER_THAN | LESS_THAN | EQUAL_TO

Required: Yes

NotificationType

Whether the notification is for how much you have spent (ACTUAL) or for how much you are forecasted to spend (FORECASTED).

Type: String

Valid Values: ACTUAL | FORECASTED

Required: Yes

Threshold

The threshold that is associated with a notification. Thresholds are always a percentage.

Type: Double

Valid Range: Minimum value of 0.1. Maximum value of 1000000000.

Required: Yes

ThresholdType

The type of threshold for a notification. For ACTUAL thresholds, AWS notifies you when you go over the threshold. For FORECASTED thresholds, AWS notifies you when you are forecasted to go over the threshold.

Type: String

Valid Values: PERCENTAGE | ABSOLUTE_VALUE

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

On this page: