GetAnomalySubscriptions - AWS Cost Explorer Service

GetAnomalySubscriptions

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

Request Syntax

{ "MaxResults": number, "MonitorArn": "string", "NextPageToken": "string", "SubscriptionArnList": [ "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

MonitorArn

Cost anomaly monitor ARNs.

Type: String

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

SubscriptionArnList

A list of cost anomaly subscription ARNs.

Type: Array of strings

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

Pattern: [\S\s]*

Required: No

Response Syntax

{ "AnomalySubscriptions": [ { "AccountId": "string", "Frequency": "string", "MonitorArnList": [ "string" ], "Subscribers": [ { "Address": "string", "Status": "string", "Type": "string" } ], "SubscriptionArn": "string", "SubscriptionName": "string", "Threshold": number } ], "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.

AnomalySubscriptions

A list of cost anomaly subscriptions that includes the detailed metadata for each one.

Type: Array of AnomalySubscription 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

UnknownSubscriptionException

The cost anomaly subscription 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: