GetAnomalyMonitors - AWS Cost Explorer Service

GetAnomalyMonitors

Retrieves the cost anomaly monitor definitions for your account. You can filter using a list of cost anomaly monitor Amazon Resource Names (ARNs).

Request Syntax

{ "MaxResults": number, "MonitorArnList": [ "string" ], "NextPageToken": "string" }

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

The request accepts the following data in JSON format.

MaxResults

The number of entries a paginated response contains.

Type: Integer

Required: No

MonitorArnList

A list of cost anomaly monitor ARNs.

Type: Array of strings

Length Constraints: Minimum length of 0. Maximum length of 1024.

Pattern: [\S\s]*

Required: No

NextPageToken

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 8192.

Pattern: [\S\s]*

Required: No

Response Syntax

{ "AnomalyMonitors": [ { "CreationDate": "string", "DimensionalValueCount": number, "LastEvaluatedDate": "string", "LastUpdatedDate": "string", "MonitorArn": "string", "MonitorDimension": "string", "MonitorName": "string", "MonitorSpecification": { "And": [ "Expression" ], "CostCategories": { "Key": "string", "MatchOptions": [ "string" ], "Values": [ "string" ] }, "Dimensions": { "Key": "string", "MatchOptions": [ "string" ], "Values": [ "string" ] }, "Not": "Expression", "Or": [ "Expression" ], "Tags": { "Key": "string", "MatchOptions": [ "string" ], "Values": [ "string" ] } }, "MonitorType": "string" } ], "NextPageToken": "string" }

Response Elements

If the action is successful, the service sends back an HTTP 200 response.

The following data is returned in JSON format by the service.

AnomalyMonitors

A list of cost anomaly monitors that includes the detailed metadata for each monitor.

Type: Array of AnomalyMonitor objects

NextPageToken

The token to retrieve the next set of results. AWS provides the token when the response from a previous call has more results than the maximum page size.

Type: String

Length Constraints: Minimum length of 0. Maximum length of 8192.

Pattern: [\S\s]*

Errors

For information about the errors that are common to all actions, see Common Errors.

InvalidNextTokenException

The pagination token is invalid. Try again without a pagination token.

HTTP Status Code: 400

LimitExceededException

You made too many calls in a short period of time. Try again later.

HTTP Status Code: 400

UnknownMonitorException

The cost anomaly monitor does not exist for the account.

HTTP Status Code: 400

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: