Request Parameters Response Elements Errors Examples See Also

GetAlarmMuteRule

Retrieves details for a specific alarm mute rule.

This operation returns complete information about the mute rule, including its configuration, status, targeted alarms, and metadata.

The returned status indicates the current state of the mute rule:

SCHEDULED: The mute rule is configured and will become active in the future
ACTIVE: The mute rule is currently muting alarm actions
EXPIRED: The mute rule has passed its expiration date and will no longer become active

Permissions

To retrieve details for a mute rule, you need the cloudwatch:GetAlarmMuteRule permission on the alarm mute rule resource.

Request Parameters

AlarmMuteRuleName

The name of the alarm mute rule to retrieve.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Required: Yes

Response Elements

The following elements are returned by the service.

AlarmMuteRuleArn

The Amazon Resource Name (ARN) of the alarm mute rule.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 1600.

Description

The description of the alarm mute rule.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 1024.

ExpireDate

The date and time when the mute rule expires and is no longer evaluated.

Type: Timestamp

LastUpdatedTimestamp

The date and time when the mute rule was last updated.

Type: Timestamp

MuteTargets

Specifies which alarms this rule applies to.

Type: MuteTargets object

MuteType

Indicates whether the mute rule is one-time or recurring. Valid values are ONE_TIME or RECURRING.

Type: String

Name

The name of the alarm mute rule.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 255.

Rule

The configuration that defines when and how long alarms are muted.

Type: Rule object

StartDate

The date and time when the mute rule becomes active. If not set, the rule is active immediately.

Type: Timestamp

Status

The current status of the alarm mute rule. Valid values are SCHEDULED, ACTIVE, or EXPIRED.

Type: String

Valid Values: SCHEDULED | ACTIVE | EXPIRED

Errors

For information about the errors that are common to all actions, see Common Errors.

ResourceNotFoundException

The named resource does not exist.

HTTP Status Code: 404

Examples

Get details for a mute rule

Retrieve complete details for a specific alarm mute rule.

Sample Request



aws cloudwatch get-alarm-mute-rule \
	--alarm-mute-rule-name "DailyMaintenanceWindow"

Sample Response



{
    "Name": "DailyMaintenanceWindow",
    "AlarmMuteRuleArn": "arn:aws:cloudwatch:us-east-1:123456789012:alarm-mute-rule:DailyMaintenanceWindow",
    "Description": "Mute alarms during daily maintenance",
    "Rule": {
        "Schedule": {
            "Expression": "cron(0 2 * * ?)",
            "Duration": "PT2H",
            "Timezone": "UTC"
        }
    },
    "MuteTargets": {
        "AlarmNames": [
            "WebServerCPUAlarm",
            "DatabaseConnectionAlarm"
        ]
    },
    "Status": "SCHEDULED",
    "LastUpdatedTimestamp": "2026-01-15T10:30:00Z"
}