@Generated(value="com.amazonaws:aws-java-sdk-code-generator") public class DescribeAlarmsRequest extends AmazonWebServiceRequest implements Serializable, Cloneable
NOOP
Constructor and Description |
---|
DescribeAlarmsRequest() |
Modifier and Type | Method and Description |
---|---|
DescribeAlarmsRequest |
clone()
Creates a shallow clone of this object for all fields except the handler context.
|
boolean |
equals(Object obj) |
String |
getActionPrefix()
Use this parameter to filter the results of the operation to only those alarms that use a certain alarm action.
|
String |
getAlarmNamePrefix()
An alarm name prefix.
|
List<String> |
getAlarmNames()
The names of the alarms to retrieve information about.
|
List<String> |
getAlarmTypes()
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
|
String |
getChildrenOfAlarmName()
If you use this parameter and specify the name of a composite alarm, the operation returns information about the
"children" alarms of the alarm you specify.
|
Integer |
getMaxRecords()
The maximum number of alarm descriptions to retrieve.
|
String |
getNextToken()
The token returned by a previous call to indicate that there is more data available.
|
String |
getParentsOfAlarmName()
If you use this parameter and specify the name of a metric or composite alarm, the operation returns information
about the "parent" alarms of the alarm you specify.
|
String |
getStateValue()
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
|
int |
hashCode() |
void |
setActionPrefix(String actionPrefix)
Use this parameter to filter the results of the operation to only those alarms that use a certain alarm action.
|
void |
setAlarmNamePrefix(String alarmNamePrefix)
An alarm name prefix.
|
void |
setAlarmNames(Collection<String> alarmNames)
The names of the alarms to retrieve information about.
|
void |
setAlarmTypes(Collection<String> alarmTypes)
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
|
void |
setChildrenOfAlarmName(String childrenOfAlarmName)
If you use this parameter and specify the name of a composite alarm, the operation returns information about the
"children" alarms of the alarm you specify.
|
void |
setMaxRecords(Integer maxRecords)
The maximum number of alarm descriptions to retrieve.
|
void |
setNextToken(String nextToken)
The token returned by a previous call to indicate that there is more data available.
|
void |
setParentsOfAlarmName(String parentsOfAlarmName)
If you use this parameter and specify the name of a metric or composite alarm, the operation returns information
about the "parent" alarms of the alarm you specify.
|
void |
setStateValue(StateValue stateValue)
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
|
void |
setStateValue(String stateValue)
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
|
String |
toString()
Returns a string representation of this object.
|
DescribeAlarmsRequest |
withActionPrefix(String actionPrefix)
Use this parameter to filter the results of the operation to only those alarms that use a certain alarm action.
|
DescribeAlarmsRequest |
withAlarmNamePrefix(String alarmNamePrefix)
An alarm name prefix.
|
DescribeAlarmsRequest |
withAlarmNames(Collection<String> alarmNames)
The names of the alarms to retrieve information about.
|
DescribeAlarmsRequest |
withAlarmNames(String... alarmNames)
The names of the alarms to retrieve information about.
|
DescribeAlarmsRequest |
withAlarmTypes(AlarmType... alarmTypes)
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
|
DescribeAlarmsRequest |
withAlarmTypes(Collection<String> alarmTypes)
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
|
DescribeAlarmsRequest |
withAlarmTypes(String... alarmTypes)
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
|
DescribeAlarmsRequest |
withChildrenOfAlarmName(String childrenOfAlarmName)
If you use this parameter and specify the name of a composite alarm, the operation returns information about the
"children" alarms of the alarm you specify.
|
DescribeAlarmsRequest |
withMaxRecords(Integer maxRecords)
The maximum number of alarm descriptions to retrieve.
|
DescribeAlarmsRequest |
withNextToken(String nextToken)
The token returned by a previous call to indicate that there is more data available.
|
DescribeAlarmsRequest |
withParentsOfAlarmName(String parentsOfAlarmName)
If you use this parameter and specify the name of a metric or composite alarm, the operation returns information
about the "parent" alarms of the alarm you specify.
|
DescribeAlarmsRequest |
withStateValue(StateValue stateValue)
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
|
DescribeAlarmsRequest |
withStateValue(String stateValue)
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
|
addHandlerContext, getCloneRoot, getCloneSource, getCustomQueryParameters, getCustomRequestHeaders, getGeneralProgressListener, getHandlerContext, getReadLimit, getRequestClientOptions, getRequestCredentials, getRequestCredentialsProvider, getRequestMetricCollector, getSdkClientExecutionTimeout, getSdkRequestTimeout, putCustomQueryParameter, putCustomRequestHeader, setGeneralProgressListener, setRequestCredentials, setRequestCredentialsProvider, setRequestMetricCollector, setSdkClientExecutionTimeout, setSdkRequestTimeout, withGeneralProgressListener, withRequestCredentialsProvider, withRequestMetricCollector, withSdkClientExecutionTimeout, withSdkRequestTimeout
public List<String> getAlarmNames()
The names of the alarms to retrieve information about.
public void setAlarmNames(Collection<String> alarmNames)
The names of the alarms to retrieve information about.
alarmNames
- The names of the alarms to retrieve information about.public DescribeAlarmsRequest withAlarmNames(String... alarmNames)
The names of the alarms to retrieve information about.
NOTE: This method appends the values to the existing list (if any). Use
setAlarmNames(java.util.Collection)
or withAlarmNames(java.util.Collection)
if you want to
override the existing values.
alarmNames
- The names of the alarms to retrieve information about.public DescribeAlarmsRequest withAlarmNames(Collection<String> alarmNames)
The names of the alarms to retrieve information about.
alarmNames
- The names of the alarms to retrieve information about.public void setAlarmNamePrefix(String alarmNamePrefix)
An alarm name prefix. If you specify this parameter, you receive information about all alarms that have names that start with this prefix.
If this parameter is specified, you cannot specify AlarmNames
.
alarmNamePrefix
- An alarm name prefix. If you specify this parameter, you receive information about all alarms that have
names that start with this prefix.
If this parameter is specified, you cannot specify AlarmNames
.
public String getAlarmNamePrefix()
An alarm name prefix. If you specify this parameter, you receive information about all alarms that have names that start with this prefix.
If this parameter is specified, you cannot specify AlarmNames
.
If this parameter is specified, you cannot specify AlarmNames
.
public DescribeAlarmsRequest withAlarmNamePrefix(String alarmNamePrefix)
An alarm name prefix. If you specify this parameter, you receive information about all alarms that have names that start with this prefix.
If this parameter is specified, you cannot specify AlarmNames
.
alarmNamePrefix
- An alarm name prefix. If you specify this parameter, you receive information about all alarms that have
names that start with this prefix.
If this parameter is specified, you cannot specify AlarmNames
.
public List<String> getAlarmTypes()
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a list
of metric alarms. It does not return any composite alarms, even if composite alarms exist in the account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and does not
return any metric alarms.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only
a list of metric alarms. It does not return any composite alarms, even if composite alarms exist in the
account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and
does not return any metric alarms.
AlarmType
public void setAlarmTypes(Collection<String> alarmTypes)
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a list
of metric alarms. It does not return any composite alarms, even if composite alarms exist in the account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and does not
return any metric alarms.
alarmTypes
- Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the
account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a
list of metric alarms. It does not return any composite alarms, even if composite alarms exist in the
account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and
does not return any metric alarms.
AlarmType
public DescribeAlarmsRequest withAlarmTypes(String... alarmTypes)
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a list
of metric alarms. It does not return any composite alarms, even if composite alarms exist in the account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and does not
return any metric alarms.
NOTE: This method appends the values to the existing list (if any). Use
setAlarmTypes(java.util.Collection)
or withAlarmTypes(java.util.Collection)
if you want to
override the existing values.
alarmTypes
- Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the
account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a
list of metric alarms. It does not return any composite alarms, even if composite alarms exist in the
account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and
does not return any metric alarms.
AlarmType
public DescribeAlarmsRequest withAlarmTypes(Collection<String> alarmTypes)
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a list
of metric alarms. It does not return any composite alarms, even if composite alarms exist in the account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and does not
return any metric alarms.
alarmTypes
- Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the
account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a
list of metric alarms. It does not return any composite alarms, even if composite alarms exist in the
account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and
does not return any metric alarms.
AlarmType
public DescribeAlarmsRequest withAlarmTypes(AlarmType... alarmTypes)
Use this parameter to specify whether you want the operation to return metric alarms or composite alarms. If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a list
of metric alarms. It does not return any composite alarms, even if composite alarms exist in the account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and does not
return any metric alarms.
alarmTypes
- Use this parameter to specify whether you want the operation to return metric alarms or composite alarms.
If you omit this parameter, only metric alarms are returned, even if composite alarms exist in the
account.
For example, if you omit this parameter or specify MetricAlarms
, the operation returns only a
list of metric alarms. It does not return any composite alarms, even if composite alarms exist in the
account.
If you specify CompositeAlarms
, the operation returns only a list of composite alarms, and
does not return any metric alarms.
AlarmType
public void setChildrenOfAlarmName(String childrenOfAlarmName)
If you use this parameter and specify the name of a composite alarm, the operation returns information about the
"children" alarms of the alarm you specify. These are the metric alarms and composite alarms referenced in the
AlarmRule
field of the composite alarm that you specify in ChildrenOfAlarmName
.
Information about the composite alarm that you name in ChildrenOfAlarmName
is not returned.
If you specify ChildrenOfAlarmName
, you cannot specify any other parameters in the request except
for MaxRecords
and NextToken
. If you do so, you receive a validation error.
Only the Alarm Name
, ARN
, StateValue
(OK/ALARM/INSUFFICIENT_DATA), and
StateUpdatedTimestamp
information are returned by this operation when you use this parameter. To get
complete information about these alarms, perform another DescribeAlarms
operation and specify the
parent alarm names in the AlarmNames
parameter.
childrenOfAlarmName
- If you use this parameter and specify the name of a composite alarm, the operation returns information
about the "children" alarms of the alarm you specify. These are the metric alarms and composite alarms
referenced in the AlarmRule
field of the composite alarm that you specify in
ChildrenOfAlarmName
. Information about the composite alarm that you name in
ChildrenOfAlarmName
is not returned.
If you specify ChildrenOfAlarmName
, you cannot specify any other parameters in the request
except for MaxRecords
and NextToken
. If you do so, you receive a validation
error.
Only the Alarm Name
, ARN
, StateValue
(OK/ALARM/INSUFFICIENT_DATA),
and StateUpdatedTimestamp
information are returned by this operation when you use this
parameter. To get complete information about these alarms, perform another DescribeAlarms
operation and specify the parent alarm names in the AlarmNames
parameter.
public String getChildrenOfAlarmName()
If you use this parameter and specify the name of a composite alarm, the operation returns information about the
"children" alarms of the alarm you specify. These are the metric alarms and composite alarms referenced in the
AlarmRule
field of the composite alarm that you specify in ChildrenOfAlarmName
.
Information about the composite alarm that you name in ChildrenOfAlarmName
is not returned.
If you specify ChildrenOfAlarmName
, you cannot specify any other parameters in the request except
for MaxRecords
and NextToken
. If you do so, you receive a validation error.
Only the Alarm Name
, ARN
, StateValue
(OK/ALARM/INSUFFICIENT_DATA), and
StateUpdatedTimestamp
information are returned by this operation when you use this parameter. To get
complete information about these alarms, perform another DescribeAlarms
operation and specify the
parent alarm names in the AlarmNames
parameter.
AlarmRule
field of the composite alarm that you specify in
ChildrenOfAlarmName
. Information about the composite alarm that you name in
ChildrenOfAlarmName
is not returned.
If you specify ChildrenOfAlarmName
, you cannot specify any other parameters in the request
except for MaxRecords
and NextToken
. If you do so, you receive a validation
error.
Only the Alarm Name
, ARN
, StateValue
(OK/ALARM/INSUFFICIENT_DATA),
and StateUpdatedTimestamp
information are returned by this operation when you use this
parameter. To get complete information about these alarms, perform another DescribeAlarms
operation and specify the parent alarm names in the AlarmNames
parameter.
public DescribeAlarmsRequest withChildrenOfAlarmName(String childrenOfAlarmName)
If you use this parameter and specify the name of a composite alarm, the operation returns information about the
"children" alarms of the alarm you specify. These are the metric alarms and composite alarms referenced in the
AlarmRule
field of the composite alarm that you specify in ChildrenOfAlarmName
.
Information about the composite alarm that you name in ChildrenOfAlarmName
is not returned.
If you specify ChildrenOfAlarmName
, you cannot specify any other parameters in the request except
for MaxRecords
and NextToken
. If you do so, you receive a validation error.
Only the Alarm Name
, ARN
, StateValue
(OK/ALARM/INSUFFICIENT_DATA), and
StateUpdatedTimestamp
information are returned by this operation when you use this parameter. To get
complete information about these alarms, perform another DescribeAlarms
operation and specify the
parent alarm names in the AlarmNames
parameter.
childrenOfAlarmName
- If you use this parameter and specify the name of a composite alarm, the operation returns information
about the "children" alarms of the alarm you specify. These are the metric alarms and composite alarms
referenced in the AlarmRule
field of the composite alarm that you specify in
ChildrenOfAlarmName
. Information about the composite alarm that you name in
ChildrenOfAlarmName
is not returned.
If you specify ChildrenOfAlarmName
, you cannot specify any other parameters in the request
except for MaxRecords
and NextToken
. If you do so, you receive a validation
error.
Only the Alarm Name
, ARN
, StateValue
(OK/ALARM/INSUFFICIENT_DATA),
and StateUpdatedTimestamp
information are returned by this operation when you use this
parameter. To get complete information about these alarms, perform another DescribeAlarms
operation and specify the parent alarm names in the AlarmNames
parameter.
public void setParentsOfAlarmName(String parentsOfAlarmName)
If you use this parameter and specify the name of a metric or composite alarm, the operation returns information
about the "parent" alarms of the alarm you specify. These are the composite alarms that have
AlarmRule
parameters that reference the alarm named in ParentsOfAlarmName
. Information
about the alarm that you specify in ParentsOfAlarmName
is not returned.
If you specify ParentsOfAlarmName
, you cannot specify any other parameters in the request except for
MaxRecords
and NextToken
. If you do so, you receive a validation error.
Only the Alarm Name and ARN are returned by this operation when you use this parameter. To get complete
information about these alarms, perform another DescribeAlarms
operation and specify the parent
alarm names in the AlarmNames
parameter.
parentsOfAlarmName
- If you use this parameter and specify the name of a metric or composite alarm, the operation returns
information about the "parent" alarms of the alarm you specify. These are the composite alarms that have
AlarmRule
parameters that reference the alarm named in ParentsOfAlarmName
.
Information about the alarm that you specify in ParentsOfAlarmName
is not returned.
If you specify ParentsOfAlarmName
, you cannot specify any other parameters in the request
except for MaxRecords
and NextToken
. If you do so, you receive a validation
error.
Only the Alarm Name and ARN are returned by this operation when you use this parameter. To get complete
information about these alarms, perform another DescribeAlarms
operation and specify the
parent alarm names in the AlarmNames
parameter.
public String getParentsOfAlarmName()
If you use this parameter and specify the name of a metric or composite alarm, the operation returns information
about the "parent" alarms of the alarm you specify. These are the composite alarms that have
AlarmRule
parameters that reference the alarm named in ParentsOfAlarmName
. Information
about the alarm that you specify in ParentsOfAlarmName
is not returned.
If you specify ParentsOfAlarmName
, you cannot specify any other parameters in the request except for
MaxRecords
and NextToken
. If you do so, you receive a validation error.
Only the Alarm Name and ARN are returned by this operation when you use this parameter. To get complete
information about these alarms, perform another DescribeAlarms
operation and specify the parent
alarm names in the AlarmNames
parameter.
AlarmRule
parameters that reference the alarm named in ParentsOfAlarmName
.
Information about the alarm that you specify in ParentsOfAlarmName
is not returned.
If you specify ParentsOfAlarmName
, you cannot specify any other parameters in the request
except for MaxRecords
and NextToken
. If you do so, you receive a validation
error.
Only the Alarm Name and ARN are returned by this operation when you use this parameter. To get complete
information about these alarms, perform another DescribeAlarms
operation and specify the
parent alarm names in the AlarmNames
parameter.
public DescribeAlarmsRequest withParentsOfAlarmName(String parentsOfAlarmName)
If you use this parameter and specify the name of a metric or composite alarm, the operation returns information
about the "parent" alarms of the alarm you specify. These are the composite alarms that have
AlarmRule
parameters that reference the alarm named in ParentsOfAlarmName
. Information
about the alarm that you specify in ParentsOfAlarmName
is not returned.
If you specify ParentsOfAlarmName
, you cannot specify any other parameters in the request except for
MaxRecords
and NextToken
. If you do so, you receive a validation error.
Only the Alarm Name and ARN are returned by this operation when you use this parameter. To get complete
information about these alarms, perform another DescribeAlarms
operation and specify the parent
alarm names in the AlarmNames
parameter.
parentsOfAlarmName
- If you use this parameter and specify the name of a metric or composite alarm, the operation returns
information about the "parent" alarms of the alarm you specify. These are the composite alarms that have
AlarmRule
parameters that reference the alarm named in ParentsOfAlarmName
.
Information about the alarm that you specify in ParentsOfAlarmName
is not returned.
If you specify ParentsOfAlarmName
, you cannot specify any other parameters in the request
except for MaxRecords
and NextToken
. If you do so, you receive a validation
error.
Only the Alarm Name and ARN are returned by this operation when you use this parameter. To get complete
information about these alarms, perform another DescribeAlarms
operation and specify the
parent alarm names in the AlarmNames
parameter.
public void setStateValue(String stateValue)
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
stateValue
- Specify this parameter to receive information only about alarms that are currently in the state that you
specify.StateValue
public String getStateValue()
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
StateValue
public DescribeAlarmsRequest withStateValue(String stateValue)
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
stateValue
- Specify this parameter to receive information only about alarms that are currently in the state that you
specify.StateValue
public void setStateValue(StateValue stateValue)
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
stateValue
- Specify this parameter to receive information only about alarms that are currently in the state that you
specify.StateValue
public DescribeAlarmsRequest withStateValue(StateValue stateValue)
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
stateValue
- Specify this parameter to receive information only about alarms that are currently in the state that you
specify.StateValue
public void setActionPrefix(String actionPrefix)
Use this parameter to filter the results of the operation to only those alarms that use a certain alarm action. For example, you could specify the ARN of an SNS topic to find all alarms that send notifications to that topic.
actionPrefix
- Use this parameter to filter the results of the operation to only those alarms that use a certain alarm
action. For example, you could specify the ARN of an SNS topic to find all alarms that send notifications
to that topic.public String getActionPrefix()
Use this parameter to filter the results of the operation to only those alarms that use a certain alarm action. For example, you could specify the ARN of an SNS topic to find all alarms that send notifications to that topic.
public DescribeAlarmsRequest withActionPrefix(String actionPrefix)
Use this parameter to filter the results of the operation to only those alarms that use a certain alarm action. For example, you could specify the ARN of an SNS topic to find all alarms that send notifications to that topic.
actionPrefix
- Use this parameter to filter the results of the operation to only those alarms that use a certain alarm
action. For example, you could specify the ARN of an SNS topic to find all alarms that send notifications
to that topic.public void setMaxRecords(Integer maxRecords)
The maximum number of alarm descriptions to retrieve.
maxRecords
- The maximum number of alarm descriptions to retrieve.public Integer getMaxRecords()
The maximum number of alarm descriptions to retrieve.
public DescribeAlarmsRequest withMaxRecords(Integer maxRecords)
The maximum number of alarm descriptions to retrieve.
maxRecords
- The maximum number of alarm descriptions to retrieve.public void setNextToken(String nextToken)
The token returned by a previous call to indicate that there is more data available.
nextToken
- The token returned by a previous call to indicate that there is more data available.public String getNextToken()
The token returned by a previous call to indicate that there is more data available.
public DescribeAlarmsRequest withNextToken(String nextToken)
The token returned by a previous call to indicate that there is more data available.
nextToken
- The token returned by a previous call to indicate that there is more data available.public String toString()
toString
in class Object
Object.toString()
public DescribeAlarmsRequest clone()
AmazonWebServiceRequest
clone
in class AmazonWebServiceRequest
Object.clone()