# CfnAnomalySubscriptionProps

Properties for defining a `CfnAnomalySubscription`.

Extends: CfnAnomalySubscriptionProps
Used as props by: CfnAnomalySubscription

- Source: Generated code
- Type last changed: v2.227.0 · 21 Nov 2025

## Example

```ts
// 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

- `frequency`: string (required) — The frequency that anomaly notifications are sent.

  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](https://docs.aws.amazon.com/cost-management/latest/userguide/ad-SNS.html) .

- `monitorArnList`: string | [IAnomalyMonitorRef](/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_ce.IAnomalyMonitorRef.html)[] (required) — A list of cost anomaly monitors.

- `resourceTags`: [CfnAnomalySubscription.ResourceTagProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_ce.CfnAnomalySubscription.ResourceTagProperty.html)[] — Tags to assign to subscription.

- `subscribers`: [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [IResolvable](/cdk/api/v2/docs/aws-cdk-lib.IResolvable.html) | [CfnAnomalySubscription.SubscriberProperty](/cdk/api/v2/docs/aws-cdk-lib.aws_ce.CfnAnomalySubscription.SubscriberProperty.html)[] (required) — A list of subscribers to notify.

- `subscriptionName`: string (required) — The name for the subscription.

- `threshold`: number — (deprecated).

  An absolute dollar value that must be exceeded by the anomaly's total impact (see [Impact](https://docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Impact.html) 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.

- `thresholdExpression`: 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.

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

  For further information, see the [Examples](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-ce-anomalysubscription.html#aws-resource-ce-anomalysubscription--examples) section of this page.