Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1466276261.1 KB

Creates an empty dataset and adds it to the specified dataset group. Use CreateDatasetImportJob to import your training data to a dataset.

There are three types of datasets:

  • Interactions

  • Items

  • Users

Each dataset type has an associated schema with required field types. Only the Interactions dataset is required in order to train a model (also referred to as creating a solution).

A dataset can be in one of the following states:

  • CREATE PENDING > CREATE IN_PROGRESS > ACTIVE -or- CREATE FAILED

  • DELETE PENDING > DELETE IN_PROGRESS

To get the status of the dataset, call DescribeDataset.

Related APIs

post/#X-Amz-Target=AmazonPersonalize.CreateDataset

Headers

X-Amz-Target'AmazonPersonalize.CreateDataset' required

Request body

namestring required

The name for the dataset.

schemaArnstring required

The ARN of the schema to associate with the dataset. The schema defines the dataset fields.

datasetGroupArnstring required

The Amazon Resource Name (ARN) of the dataset group to add the dataset to.

datasetTypestring required
<p>The type of dataset.</p> <p>One of the following (case insensitive) values:</p> <ul> <li> <p>Interactions</p> </li> <li> <p>Items</p> </li> <li> <p>Users</p> </li> </ul>

Response

Success

datasetArnstring

The ARN of the dataset.