Amazon Forecast
Developer Guide

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

ListDatasetImportJobs

Returns a list of dataset import jobs for the specified dataset. You create an import job using the CreateDatasetImportJob operation.

Request Syntax

{ "DatasetName": "string", "MaxResults": number, "NextToken": "string" }

Request Parameters

The request accepts the following data in JSON format.

DatasetName

The name of the dataset.

Type: String

Length Constraints: Maximum length of 256.

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

Required: Yes

MaxResults

The number of items to return in the response.

Type: Integer

Valid Range: Minimum value of 0. Maximum value of 100.

Required: No

NextToken

If the result of the previous request was truncated, the response includes a NextToken. To retrieve the next set of results, use the token in the next request. Tokens expire after 24 hours.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2000.

Required: No

Response Syntax

{ "DatasetImportJobs": [ { "DatasetName": "string", "VersionId": "string" } ], "NextToken": "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.

DatasetImportJobs

An array of DatasetImportJobsResonseItem objects, one for each job for the specified dataset.

Type: Array of DatasetImportJobsResponseItem objects

NextToken

If the response is truncated, Amazon Forecast returns this token. To retrieve the next set of results, use the token in the next request.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2000.

Errors

InternalServiceException

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

HTTP Status Code: 400

InvalidInputException

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

HTTP Status Code: 400

ResourceAlreadyExistsException

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

HTTP Status Code: 400

ResourceNotFoundException

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: