Amazon Forecast
Developer Guide

This is prerelease documentation for a service in preview release. It is subject to change.

As of 6/6/19, Amazon Forecast no longer supports the following recipes: DeepAR, MDN, MLP, MQRNN, RFQR, and SQF. You can continue to use predictors created with these recipes to generate forecasts. However, you can’t use these recipes to create new predictors or to update existing predictors with new data. In addition, AutoML no longer considers these recipes. We’ve made these changes to ensure that Forecast offers the highest level of accuracy and robustness. We continue to support the ARIMA, DeepAR+, ETS, NPTS, and Prophet recipes.


Creates a forecast export job. Deploying an Amazon Forecast predictor (with the DeployPredictor operation) creates a forecast. To copy the forecast to a specified location, use the CreateForecastExportJob operation.

Exporting a forecast lets you process it on the client side. For example, you might ingest a forecast to an Amazon Redshift database for further processing.

Request Syntax

{ "ForecastId": "string", "OutputPath": { "RoleArn": "string", "S3Uri": "string" } }

Request Parameters

The request accepts the following data in JSON format.


The ID of the forecast that you want to export.

Type: String

Length Constraints: Maximum length of 256.

Pattern: ^[a-zA-Z0-9\_]+$

Required: Yes


The path to the S3 bucket where you want to save the forecast.

Cross-account pass role is not allowed. If you pass a role that doesn't belong to your account, an InvalidInputException is thrown.

Type: S3DataSource object

Required: Yes

Response Syntax

{ "ForecastExportArn": "string", "ForecastExportJobId": "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.


The Amazon Resource Name (ARN) of the export job.

Type: String

Length Constraints: Maximum length of 256.

Pattern: ^[a-zA-Z0-9\-\_\.\/\:]+$


The job ID of the forecast export job. Use this ID to check the status of the forecast that was exported with the DescribeForecastExportJob operation.

Type: String

Length Constraints: Maximum length of 256.

Pattern: ^[a-zA-Z0-9\_]+$



Request processing has failed due to some unknown error, exception, or failure.

HTTP Status Code: 400


We can't process the request because it includes an invalid value or a value that exceeds the valid range.

HTTP Status Code: 400


You have exceeded the quota limits for resources that are long-running jobs, such as import jobs, create predictors, and forecasts. You might also be creating too many resources concurrently, in which case, you might wait for resources to be created and try again.

HTTP Status Code: 400


There is already a resource with this name and characteristics. Try again with different settings.

HTTP Status Code: 400


We can't find a resource with that name. Check the name and try again.

HTTP Status Code: 400

See Also

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