GetUsageForecastRetrieves a forecast for how much Amazon Web Services predicts that you will use over the forecast time period that you select, based on your past usage. Show Request Syntax
Request ParametersFor information about the parameters that are common to all actions, see Common Parameters. The request accepts the following data in JSON format. Filter The filters that you want to use to filter your forecast. The
Type: Expression object Required: No GranularityHow granular you want the forecast to be. You can get 3 months of The Type: String Valid
Values: Required: Yes MetricWhich metric Cost Explorer uses to create your forecast. Valid values for a
Type: String Valid Values: Required: Yes PredictionIntervalLevelAWS Cost Explorer always returns the mean forecast as a single point. You can request a prediction interval around the mean by specifying a confidence level. The higher the confidence level, the more confident Cost Explorer is about the actual value falling in the prediction interval. Higher confidence levels result in wider prediction intervals. Type: Integer Valid Range: Minimum value of 51. Maximum value of 99. Required: No TimePeriodThe start and end dates of the period that you want to retrieve usage forecast for. The start date is included in the period, but the end date isn't included in the period. For example, if Type: DateInterval object Required: Yes Response Syntax
Response ElementsIf the action is successful, the service sends back an HTTP 200 response. The following data is returned in JSON format by the service. ForecastResultsByTime The forecasts for your query, in order. For Type: Array of ForecastResult objects TotalHow much you're forecasted to use over the forecast period. Type: MetricValue object ErrorsFor information about the errors that are common to all actions, see Common Errors. DataUnavailableException The requested data is unavailable. HTTP Status Code: 400 LimitExceededExceptionYou made too many calls in a short period of time. Try again later. HTTP Status Code: 400 UnresolvableUsageUnitExceptionCost Explorer was unable to identify the usage unit. Provide HTTP Status Code: 400 ExamplesExampleThe following example shows how to retrieve a forecast using the Sample Request
Sample Response
See AlsoFor more information about using this API in one of the language-specific AWS SDKs, see the following:
How does Amazon forecast work?Amazon Forecast is a fully managed service that uses machine learning to deliver highly accurate forecasts. Based on the same technology used at Amazon.com, Amazon Forecast uses machine learning to combine time series data with additional variables to build forecasts.
What tool is best for forecasting your AWS spending?AWS Cost Explorer enables you to view and analyze your AWS Cost and Usage Reports (AWS CUR). You can also predict your overall cost associated with AWS services in the future by creating a forecast of AWS Cost Explorer, but you can't view historical data beyond 12 months.
What is usage type in AWS?Usage types are the units that each service uses to measure the usage of a specific type of resource. For example, the BoxUsage:t2. micro(Hrs) usage type filters by the running hours of Amazon EC2 t2.
What forecasting model does Amazon use?Amazon Forecast CNN-QR, Convolutional Neural Network - Quantile Regression, is a proprietary machine learning algorithm for forecasting time series using causal convolutional neural networks (CNNs). CNN-QR works best with large datasets containing hundreds of time series.
|