Copyright	(c) 2013-2023 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	Safe-Inferred
Language	Haskell2010

Amazonka.CloudWatch.DescribeAlarmsForMetric

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

Retrieves the alarms for the specified metric. To filter the results, specify a statistic, period, or unit.

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.

Synopsis

data DescribeAlarmsForMetric = DescribeAlarmsForMetric' {
- dimensions :: Maybe [Dimension]
- extendedStatistic :: Maybe Text
- period :: Maybe Natural
- statistic :: Maybe Statistic
- unit :: Maybe StandardUnit
- metricName :: Text
- namespace :: Text
}
newDescribeAlarmsForMetric :: Text -> Text -> DescribeAlarmsForMetric
describeAlarmsForMetric_dimensions :: Lens' DescribeAlarmsForMetric (Maybe [Dimension])
describeAlarmsForMetric_extendedStatistic :: Lens' DescribeAlarmsForMetric (Maybe Text)
describeAlarmsForMetric_period :: Lens' DescribeAlarmsForMetric (Maybe Natural)
describeAlarmsForMetric_statistic :: Lens' DescribeAlarmsForMetric (Maybe Statistic)
describeAlarmsForMetric_unit :: Lens' DescribeAlarmsForMetric (Maybe StandardUnit)
describeAlarmsForMetric_metricName :: Lens' DescribeAlarmsForMetric Text
describeAlarmsForMetric_namespace :: Lens' DescribeAlarmsForMetric Text
data DescribeAlarmsForMetricResponse = DescribeAlarmsForMetricResponse' {
- metricAlarms :: Maybe [MetricAlarm]
- httpStatus :: Int
}
newDescribeAlarmsForMetricResponse :: Int -> DescribeAlarmsForMetricResponse
describeAlarmsForMetricResponse_metricAlarms :: Lens' DescribeAlarmsForMetricResponse (Maybe [MetricAlarm])
describeAlarmsForMetricResponse_httpStatus :: Lens' DescribeAlarmsForMetricResponse Int

Creating a Request

data DescribeAlarmsForMetric Source #

See: newDescribeAlarmsForMetric smart constructor.

Constructors

DescribeAlarmsForMetric'

Fields

dimensions :: Maybe [Dimension]
The dimensions associated with the metric. If the metric has any associated dimensions, you must specify them in order for the call to succeed.
extendedStatistic :: Maybe Text
The percentile statistic for the metric. Specify a value between p0.0 and p100.
period :: Maybe Natural
The period, in seconds, over which the statistic is applied.
statistic :: Maybe Statistic
The statistic for the metric, other than percentiles. For percentile statistics, use ExtendedStatistics.
unit :: Maybe StandardUnit
The unit for the metric.
metricName :: Text
The name of the metric.
namespace :: Text
The namespace of the metric.

Instances

Instances details

ToHeaders DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods toHeaders :: DescribeAlarmsForMetric -> [Header] #
ToPath DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods toPath :: DescribeAlarmsForMetric -> ByteString #
ToQuery DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods toQuery :: DescribeAlarmsForMetric -> QueryString #
AWSRequest DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Associated Types type AWSResponse DescribeAlarmsForMetric # Methods request :: (Service -> Service) -> DescribeAlarmsForMetric -> Request DescribeAlarmsForMetric # response :: MonadResource m => (ByteStringLazy -> IO ByteStringLazy) -> Service -> Proxy DescribeAlarmsForMetric -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse DescribeAlarmsForMetric))) #
Generic DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Associated Types type Rep DescribeAlarmsForMetric :: Type -> Type # Methods from :: DescribeAlarmsForMetric -> Rep DescribeAlarmsForMetric x # to :: Rep DescribeAlarmsForMetric x -> DescribeAlarmsForMetric #
Read DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods readsPrec :: Int -> ReadS DescribeAlarmsForMetric # readList :: ReadS [DescribeAlarmsForMetric] # readPrec :: ReadPrec DescribeAlarmsForMetric # readListPrec :: ReadPrec [DescribeAlarmsForMetric] #
Show DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods showsPrec :: Int -> DescribeAlarmsForMetric -> ShowS # show :: DescribeAlarmsForMetric -> String # showList :: [DescribeAlarmsForMetric] -> ShowS #
NFData DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods rnf :: DescribeAlarmsForMetric -> () #
Eq DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods (==) :: DescribeAlarmsForMetric -> DescribeAlarmsForMetric -> Bool # (/=) :: DescribeAlarmsForMetric -> DescribeAlarmsForMetric -> Bool #
Hashable DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods hashWithSalt :: Int -> DescribeAlarmsForMetric -> Int # hash :: DescribeAlarmsForMetric -> Int #
type AWSResponse DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric type AWSResponse DescribeAlarmsForMetric = DescribeAlarmsForMetricResponse
type Rep DescribeAlarmsForMetric Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric type Rep DescribeAlarmsForMetric = D1 ('MetaData "DescribeAlarmsForMetric" "Amazonka.CloudWatch.DescribeAlarmsForMetric" "amazonka-cloudwatch-2.0-9xq2AWTkbYo3pEtgQNn4jD" 'False) (C1 ('MetaCons "DescribeAlarmsForMetric'" 'PrefixI 'True) ((S1 ('MetaSel ('Just "dimensions") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Dimension])) :: (S1 ('MetaSel ('Just "extendedStatistic") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text)) :: S1 ('MetaSel ('Just "period") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Natural)))) :: ((S1 ('MetaSel ('Just "statistic") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Statistic)) :: S1 ('MetaSel ('Just "unit") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe StandardUnit))) :: (S1 ('MetaSel ('Just "metricName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :: S1 ('MetaSel ('Just "namespace") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)))))

newDescribeAlarmsForMetric Source #

Arguments

:: Text	`DescribeAlarmsForMetric`
-> Text	`DescribeAlarmsForMetric`
-> DescribeAlarmsForMetric

Create a value of DescribeAlarmsForMetric with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

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

DescribeAlarmsForMetric, describeAlarmsForMetric_extendedStatistic - The percentile statistic for the metric. Specify a value between p0.0 and p100.

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

DescribeAlarmsForMetric, describeAlarmsForMetric_statistic - The statistic for the metric, other than percentiles. For percentile statistics, use ExtendedStatistics.

DescribeAlarmsForMetric, describeAlarmsForMetric_unit - The unit for the metric.

DescribeAlarmsForMetric, describeAlarmsForMetric_metricName - The name of the metric.

DescribeAlarmsForMetric, describeAlarmsForMetric_namespace - The namespace of the metric.

Request Lenses

describeAlarmsForMetric_dimensions :: Lens' DescribeAlarmsForMetric (Maybe [Dimension]) Source #

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

describeAlarmsForMetric_extendedStatistic :: Lens' DescribeAlarmsForMetric (Maybe Text) Source #

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

describeAlarmsForMetric_period :: Lens' DescribeAlarmsForMetric (Maybe Natural) Source #

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

describeAlarmsForMetric_statistic :: Lens' DescribeAlarmsForMetric (Maybe Statistic) Source #

The statistic for the metric, other than percentiles. For percentile statistics, use ExtendedStatistics.

describeAlarmsForMetric_unit :: Lens' DescribeAlarmsForMetric (Maybe StandardUnit) Source #

The unit for the metric.

describeAlarmsForMetric_metricName :: Lens' DescribeAlarmsForMetric Text Source #

The name of the metric.

describeAlarmsForMetric_namespace :: Lens' DescribeAlarmsForMetric Text Source #

The namespace of the metric.

Destructuring the Response

data DescribeAlarmsForMetricResponse Source #

See: newDescribeAlarmsForMetricResponse smart constructor.

Constructors

DescribeAlarmsForMetricResponse'
Fields metricAlarms :: Maybe [MetricAlarm] The information for each alarm with the specified metric. httpStatus :: Int The response's http status code.

Instances

Instances details

Generic DescribeAlarmsForMetricResponse Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Associated Types type Rep DescribeAlarmsForMetricResponse :: Type -> Type # Methods from :: DescribeAlarmsForMetricResponse -> Rep DescribeAlarmsForMetricResponse x # to :: Rep DescribeAlarmsForMetricResponse x -> DescribeAlarmsForMetricResponse #
Read DescribeAlarmsForMetricResponse Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods readsPrec :: Int -> ReadS DescribeAlarmsForMetricResponse # readList :: ReadS [DescribeAlarmsForMetricResponse] # readPrec :: ReadPrec DescribeAlarmsForMetricResponse # readListPrec :: ReadPrec [DescribeAlarmsForMetricResponse] #
Show DescribeAlarmsForMetricResponse Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods showsPrec :: Int -> DescribeAlarmsForMetricResponse -> ShowS # show :: DescribeAlarmsForMetricResponse -> String # showList :: [DescribeAlarmsForMetricResponse] -> ShowS #
NFData DescribeAlarmsForMetricResponse Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods rnf :: DescribeAlarmsForMetricResponse -> () #
Eq DescribeAlarmsForMetricResponse Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric Methods (==) :: DescribeAlarmsForMetricResponse -> DescribeAlarmsForMetricResponse -> Bool # (/=) :: DescribeAlarmsForMetricResponse -> DescribeAlarmsForMetricResponse -> Bool #
type Rep DescribeAlarmsForMetricResponse Source #
Instance details Defined in Amazonka.CloudWatch.DescribeAlarmsForMetric type Rep DescribeAlarmsForMetricResponse = D1 ('MetaData "DescribeAlarmsForMetricResponse" "Amazonka.CloudWatch.DescribeAlarmsForMetric" "amazonka-cloudwatch-2.0-9xq2AWTkbYo3pEtgQNn4jD" 'False) (C1 ('MetaCons "DescribeAlarmsForMetricResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "metricAlarms") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [MetricAlarm])) :*: S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int)))

newDescribeAlarmsForMetricResponse Source #

Arguments

:: Int	`$sel:httpStatus:DescribeAlarmsForMetricResponse'`
-> DescribeAlarmsForMetricResponse

Create a value of DescribeAlarmsForMetricResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:metricAlarms:DescribeAlarmsForMetricResponse', describeAlarmsForMetricResponse_metricAlarms - The information for each alarm with the specified metric.

$sel:httpStatus:DescribeAlarmsForMetricResponse', describeAlarmsForMetricResponse_httpStatus - The response's http status code.

Response Lenses

describeAlarmsForMetricResponse_metricAlarms :: Lens' DescribeAlarmsForMetricResponse (Maybe [MetricAlarm]) Source #

The information for each alarm with the specified metric.

describeAlarmsForMetricResponse_httpStatus :: Lens' DescribeAlarmsForMetricResponse Int Source #

The response's http status code.