CompositeAlarm class

Provides a CloudWatch Composite Alarm resource.

> NOTE: An alarm (composite or metric) cannot be destroyed when there are other composite alarms depending on it. This can lead to a cyclical dependency on update, as the provider will unsuccessfully attempt to destroy alarms before updating the rule. Consider using dependsOn, references to alarm names, and two-stage updates.

Example Usage

import * as pulumi from "@pulumi/pulumi";
import * as aws from "@pulumi/aws";

const example = new aws.cloudwatch.CompositeAlarm("example", {
    actionsSuppressor: {
        alarm: "suppressor-alarm",
        extensionPeriod: 10,
        waitPeriod: 20,
    },
    alarmDescription: "This is a composite alarm!",
    alarmName: "example-composite-alarm",
    alarmActions: exampleAwsSnsTopic.arn,
    okActions: exampleAwsSnsTopic.arn,
    alarmRule: `ALARM(${alpha.alarmName}) OR
ALARM(${bravo.alarmName})
`,
});

import pulumi
import pulumi_aws as aws

example = aws.cloudwatch.CompositeAlarm("example",
    actions_suppressor={
        "alarm": "suppressor-alarm",
        "extension_period": 10,
        "wait_period": 20,
    },
    alarm_description="This is a composite alarm!",
    alarm_name="example-composite-alarm",
    alarm_actions=example_aws_sns_topic["arn"],
    ok_actions=example_aws_sns_topic["arn"],
    alarm_rule=f"""ALARM({alpha["alarmName"]}) OR
ALARM({bravo["alarmName"]})
""")

using System.Collections.Generic;
using System.Linq;
using Pulumi;
using Aws = Pulumi.Aws;

return await Deployment.RunAsync(() =>
{
    var example = new Aws.CloudWatch.CompositeAlarm("example", new()
    {
        ActionsSuppressor = new Aws.CloudWatch.Inputs.CompositeAlarmActionsSuppressorArgs
        {
            Alarm = "suppressor-alarm",
            ExtensionPeriod = 10,
            WaitPeriod = 20,
        },
        AlarmDescription = "This is a composite alarm!",
        AlarmName = "example-composite-alarm",
        AlarmActions = exampleAwsSnsTopic.Arn,
        OkActions = exampleAwsSnsTopic.Arn,
        AlarmRule = @$"ALARM({alpha.AlarmName}) OR
ALARM({bravo.AlarmName})
",
    });

});

package main

import (
	"github.com/pulumi/pulumi-aws/sdk/v7/go/aws/cloudwatch"
	"github.com/pulumi/pulumi/sdk/v3/go/pulumi"
)

func main() {
	pulumi.Run(func(ctx *pulumi.Context) error {
		_, err := cloudwatch.NewCompositeAlarm(ctx, "example", &cloudwatch.CompositeAlarmArgs{
			ActionsSuppressor: &cloudwatch.CompositeAlarmActionsSuppressorArgs{
				Alarm:           pulumi.String("suppressor-alarm"),
				ExtensionPeriod: pulumi.Int(10),
				WaitPeriod:      pulumi.Int(20),
			},
			AlarmDescription: pulumi.String("This is a composite alarm!"),
			AlarmName:        pulumi.String("example-composite-alarm"),
			AlarmActions:     pulumi.Any(exampleAwsSnsTopic.Arn),
			OkActions:        pulumi.Any(exampleAwsSnsTopic.Arn),
			AlarmRule:        pulumi.Sprintf("ALARM(%v) OR\nALARM(%v)\n", alpha.AlarmName, bravo.AlarmName),
		})
		if err != nil {
			return err
		}
		return nil
	})
}

pulumi {
  required_providers {
    aws = {
      source = "pulumi/aws"
    }
  }
}

resource "aws_cloudwatch_compositealarm" "example" {
  actions_suppressor = {
    alarm            = "suppressor-alarm"
    extension_period = 10
    wait_period      = 20
  }
  alarm_description = "This is a composite alarm!"
  alarm_name        = "example-composite-alarm"
  alarm_actions     = exampleAwsSnsTopic.arn
  ok_actions        = exampleAwsSnsTopic.arn
  alarm_rule        ="ALARM(${alpha.alarmName}) OR
ALARM(${bravo.alarmName})
"
}

package generated_program;

import com.pulumi.Context;
import com.pulumi.Pulumi;
import com.pulumi.core.Output;
import com.pulumi.aws.cloudwatch.CompositeAlarm;
import com.pulumi.aws.cloudwatch.CompositeAlarmArgs;
import com.pulumi.aws.cloudwatch.inputs.CompositeAlarmActionsSuppressorArgs;
import java.util.ArrayList;
import java.util.Arrays;
import java.util.Map;
import java.io.File;
import java.nio.file.Files;
import java.nio.file.Paths;

public class App {
    public static void main(String[] args) {
        Pulumi.run(App::stack);
    }

    public static void stack(Context ctx) {
        var example = new CompositeAlarm("example", CompositeAlarmArgs.builder()
            .actionsSuppressor(CompositeAlarmActionsSuppressorArgs.builder()
                .alarm("suppressor-alarm")
                .extensionPeriod(10)
                .waitPeriod(20)
                .build())
            .alarmDescription("This is a composite alarm!")
            .alarmName("example-composite-alarm")
            .alarmActions(exampleAwsSnsTopic.arn())
            .okActions(exampleAwsSnsTopic.arn())
            .alarmRule("""
ALARM(%s) OR
ALARM(%s)
", alpha.alarmName(),bravo.alarmName()))
            .build());

    }
}

resources:
  example:
    type: aws:cloudwatch:CompositeAlarm
    properties:
      actionsSuppressor:
        alarm: suppressor-alarm
        extensionPeriod: 10
        waitPeriod: 20
      alarmDescription: This is a composite alarm!
      alarmName: example-composite-alarm
      alarmActions: ${exampleAwsSnsTopic.arn}
      okActions: ${exampleAwsSnsTopic.arn}
      alarmRule: |
        ALARM(${alpha.alarmName}) OR
        ALARM(${bravo.alarmName})

Import

Identity Schema

Required

• alarmName (String) Name of the composite alarm.

Optional

• accountId (String) AWS Account where this resource is managed.
• region (String) Region where this resource is managed.

Using pulumi import, import Composite Alarms using alarmName. For example:

$ pulumi import aws:cloudwatch/compositeAlarm:CompositeAlarm example example-alarm