
describe-alarms
***************


DESCRIPTION
===========

Retrieves alarms with the specified names. If no name is specified,
all alarms for the user are returned. Alarms can be retrieved by using
only a prefix for the alarm name, the alarm state, or a prefix for any
action.


SYNOPSIS
========

   aws cloudwatch describe-alarms
     [--state-value <value>]
     [--action-prefix <value>]
     [--max-records <value>]
     [--alarm-names <value>]
     [--alarm-name-prefix <value>]
     [--next-token <value>]


REQUIRED PARAMETERS
===================

None


OPTIONAL PARAMETERS
===================

"--state-value"  (string)
   The state value to be used in matching alarms.

"--action-prefix"  (string)
   The action name prefix.

"--max-records"  (integer)
   The maximum number of alarm descriptions to retrieve.

"--alarm-names"  (list of string)
   A list of alarm names to retrieve information for.

   *Parameter Syntax*

      ["string", ...]

"--alarm-name-prefix"  (string)
   The alarm name prefix. "--alarm-names" cannot be specified if this
   parameter is specified.

"--next-token"  (string)
   The token returned by a previous call to indicate that there is
   more data available.
