aws-cdk-lib.aws_ce.CfnAnomalySubscriptionProps

CfnAnomalySubscriptionProps Struct

Properties for defining a CfnAnomalySubscription.

Source

Generated code

Type last changed

v2.227.0 · 21 Nov 2025

Example

// The code below shows an example of how to instantiate this type.
// The values are placeholders you should change.
import { aws_ce as ce } from 'aws-cdk-lib';
const cfnAnomalySubscriptionProps: ce.CfnAnomalySubscriptionProps = {
  frequency: 'frequency',
  monitorArnList: ['monitorArnList'],
  subscribers: [{
    address: 'address',
    type: 'type',

    // the properties below are optional
    status: 'status',
  }],
  subscriptionName: 'subscriptionName',

  // the properties below are optional
  resourceTags: [{
    key: 'key',
    value: 'value',
  }],
  threshold: 123,
  thresholdExpression: 'thresholdExpression',
};

Properties

frequencystringfrequencystrfrequencyStringFrequencystringFrequency*stringrequired#

The frequency that anomaly notifications are sent.

notes

Notifications are sent either over email (for DAILY and WEEKLY frequencies) or SNS (for IMMEDIATE frequency). For more information, see Creating an Amazon SNS topic for anomaly notifications .

monitorArnListstring | IAnomalyMonitorRef[]monitor_arn_listtyping.List[typing.Union[str, IAnomalyMonitorRef]]monitorArnListList<String>MonitorArnListstring[]MonitorArnList*[]interface{}required#

A list of cost anomaly monitors.

resourceTagsCfnAnomalySubscription.ResourceTagProperty[]resource_tagstyping.List[ResourceTagProperty]resourceTagsList<ResourceTagProperty>ResourceTagsResourceTagProperty[]ResourceTags*[]ResourceTagProperty#

Tags to assign to subscription.

subscribersIResolvable | IResolvable | CfnAnomalySubscription.SubscriberProperty[]subscriberstyping.Union[IResolvable, typing.List[typing.Union[IResolvable, SubscriberProperty]]]subscribersIResolvableSubscribersIResolvableSubscribersinterface{}required#

A list of subscribers to notify.

subscriptionNamestringsubscription_namestrsubscriptionNameStringSubscriptionNamestringSubscriptionName*stringrequired#

The name for the subscription.

thresholdnumberthresholdint | floatthresholdNumberThresholddoubleThreshold*float64#

(deprecated).

notes

An absolute dollar value that must be exceeded by the anomaly's total impact (see Impact for more details) for an anomaly notification to be generated.

This field has been deprecated. To specify a threshold, use ThresholdExpression. Continued use of Threshold will be treated as shorthand syntax for a ThresholdExpression.

One of Threshold or ThresholdExpression is required for AWS::CE::AnomalySubscription . You cannot specify both.

thresholdExpressionstringthreshold_expressionstrthresholdExpressionStringThresholdExpressionstringThresholdExpression*string#

An [Expression](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html) object in JSON string format used to specify the anomalies that you want to generate alerts for. This supports dimensions and nested expressions. The supported dimensions are `ANOMALY_TOTAL_IMPACT_ABSOLUTE` and `ANOMALY_TOTAL_IMPACT_PERCENTAGE` , corresponding to an anomaly’s TotalImpact and TotalImpactPercentage, respectively (see [Impact](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Impact.html) for more details). The supported nested expression types are `AND` and `OR` . The match option `GREATER_THAN_OR_EQUAL` is required. Values must be numbers between 0 and 10,000,000,000 in string format.

notes

One of Threshold or ThresholdExpression is required for AWS::CE::AnomalySubscription . You cannot specify both.

For further information, see the Examples section of this page.

Used as props by

• CfnAnomalySubscription