@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, withSdkRequestTimeoutpublic 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.
AlarmTypepublic 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.
AlarmTypepublic 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.
AlarmTypepublic 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.
AlarmTypepublic 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.
AlarmTypepublic 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.StateValuepublic String getStateValue()
Specify this parameter to receive information only about alarms that are currently in the state that you specify.
StateValuepublic 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.StateValuepublic 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.StateValuepublic 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.StateValuepublic 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 ObjectObject.toString()public DescribeAlarmsRequest clone()
AmazonWebServiceRequestclone in class AmazonWebServiceRequestObject.clone()