Container for the parameters to the DeleteAlarms operation. Deletes the specified alarms. You can delete up to 100 alarms in one operation. However, this total can include no more than one composite alarm. For example, you could delete 99 metric alarms and one composite alarms with one operation, but you can't delete two composite alarms with one operation.
If you specify any incorrect alarm names, the alarms you specify with correct names
are still deleted. Other syntax errors might result in no alarms being deleted. To
confirm that alarms were deleted successfully, you can use the DescribeAlarms
operation after using DeleteAlarms.
It is possible to create a loop or cycle of composite alarms, where composite alarm A depends on composite alarm B, and composite alarm B also depends on composite alarm A. In this scenario, you can't delete any composite alarm that is part of the cycle because there is always still a composite alarm that depends on that alarm that you want to delete.
To get out of such a situation, you must break the cycle by changing the rule of one
of the composite alarms in the cycle to remove a dependency that creates the cycle.
The simplest change to make to break a cycle is to change the AlarmRule of
one of the alarms to false.
Additionally, the evaluation of composite alarms stops if CloudWatch detects a cycle in the evaluation path.
Inheritance Hierarchy
Amazon.Runtime.AmazonWebServiceRequest
Amazon.CloudWatch.AmazonCloudWatchRequest
Amazon.CloudWatch.Model.DeleteAlarmsRequest
Namespace: Amazon.CloudWatch.Model
Assembly: AWSSDK.CloudWatch.dll
Version: 3.x.y.z
Syntax
public class DeleteAlarmsRequest : AmazonCloudWatchRequest IAmazonWebServiceRequest
The DeleteAlarmsRequest type exposes the following members
Constructors
| Name | Description | |
|---|---|---|
|
DeleteAlarmsRequest() |
Properties
| Name | Type | Description | |
|---|---|---|---|
|
|
AlarmNames | System.Collections.Generic.List<System.String> |
Gets and sets the property AlarmNames. The alarms to be deleted. Do not enclose the alarm names in quote marks. Starting with version 4 of the SDK this property will default to null. If no data for this property is returned from the service the property will also be null. This was changed to improve performance and allow the SDK and caller to distinguish between a property not set or a property being empty to clear out a value. To retain the previous SDK behavior set the AWSConfigs.InitializeCollections static property to true. |
Examples
This example shows how to delete an alarm.
Delete alarm example
var client = new AmazonCloudWatchClient();
var request = new DeleteAlarmsRequest
{
AlarmNames = new List<string>() { "t1.microCPUUtilization" }
};
await client.DeleteAlarmsAsync(request);
Version Information
.NET:
Supported in: 8.0 and newer, Core 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.7.2 and newer