GET

/#Action=DescribeAlarmsForMetric

http://monitoring.{region}.amazonaws.com/#Action=DescribeAlarmsForMetric

<p>Retrieves the alarms for the specified metric. To filter the results, specify a statistic, period, or unit.</p> <p>This operation retrieves only standard alarms that are based on the specified metric. It does not return alarms based on math expressions that use the specified metric, or composite alarms that use the specified metric.</p>

Access Token Required: API Key

Query Params

MetricNamestringrequired

The name of the metric.

Namespacestringrequired

The namespace of the metric.

Statisticstring

The statistic for the metric, other than percentiles. For percentile statistics, use <code>ExtendedStatistics</code>.

Allowed:

ExtendedStatisticstring

The percentile statistic for the metric. Specify a value between p0.0 and p100.

Dimensionsarray

The dimensions associated with the metric. If the metric has any associated dimensions, you must specify them in order for the call to succeed.

Periodinteger

The period, in seconds, over which the statistic is applied.

Unitstring

The unit for the metric.

Allowed:

Actionstringrequired

Allowed:

Versionstringrequired

Allowed:

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request GET \
2     --url 'http://monitoring.{region}.amazonaws.com/#Action=DescribeAlarmsForMetric' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}