# CompositeAlarmProps

Properties for creating a Composite Alarm.

Extends: CompositeAlarmProps
Used as props by: CompositeAlarm

- Source: [`aws-cloudwatch/lib/composite-alarm.ts`](https://github.com/aws/aws-cdk/blob/v2.275.0/packages/aws-cdk-lib/aws-cloudwatch/lib/composite-alarm.ts#L15)
- Type last changed: v2.234.0 · 8 Jan 2026

## Example

```ts
declare const alarm1: cloudwatch.Alarm;
declare const alarm2: cloudwatch.Alarm;
declare const onAlarmAction: cloudwatch.IAlarmAction;
declare const onOkAction: cloudwatch.IAlarmAction;
declare const actionsSuppressor: cloudwatch.Alarm;

const alarmRule = cloudwatch.AlarmRule.anyOf(alarm1, alarm2);

const myCompositeAlarm = new cloudwatch.CompositeAlarm(this, 'MyAwesomeCompositeAlarm', {
  alarmRule,
  actionsSuppressor,
});
myCompositeAlarm.addAlarmAction(onAlarmAction);
myCompositeAlarm.addOkAction(onOkAction);
```

## Properties

- `actionsEnabled`: boolean = true — Whether the actions for this alarm are enabled.

- `actionsSuppressor`: [IAlarmRef](/cdk/api/v2/docs/aws-cdk-lib.interfaces.aws_cloudwatch.IAlarmRef.html) — Actions will be suppressed if the suppressor alarm is in the ALARM state.

  **Default:** alarm will not be suppressed.

- `actionsSuppressorExtensionPeriod`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The maximum duration that the composite alarm waits after suppressor alarm goes out of the ALARM state.

  **Default:** 1 minute extension period will be set.

  After this time, the composite alarm performs its actions.

- `actionsSuppressorWaitPeriod`: [Duration](/cdk/api/v2/docs/aws-cdk-lib.Duration.html) — The maximum duration that the composite alarm waits for the suppressor alarm to go into the ALARM state.

  **Default:** 1 minute wait period will be set.

  After this time, the composite alarm performs its actions.

- `alarmDescription`: string — Description for the alarm.

  **Default:** No description.

- `alarmRule`: [IAlarmRule](/cdk/api/v2/docs/aws-cdk-lib.aws_cloudwatch.IAlarmRule.html) (required) — Expression that specifies which other alarms are to be evaluated to determine this composite alarm's state.

- `compositeAlarmName`: string — Name of the alarm.

  **Default:** Automatically generated name.