Sign in

v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-141341,3811.0 MB

Creates a dataset. This operation doesn't support datasets that include uploaded files as a source.

post/accounts/{AwsAccountId}/data-sets

Path parameters

AwsAccountIdstring required

The Amazon Web Services account ID.

Request body

DataSetIdstring required

An ID for the dataset that you want to create. This ID is unique per Amazon Web Services Region for each Amazon Web Services account.

Namestring required

The display name for the dataset.

PhysicalTableMapobject required

Declares the physical tables that are available in the underlying data sources.

LogicalTableMapobject

Configures the combination and transformation of the data from the physical tables.

ImportMode'SPICE' | 'DIRECT_QUERY' required

Indicates whether you want to import the data into SPICE.

FieldFoldersobject

The folder that contains fields and nested subfolders for your dataset.

Response

Success

Arnstring

The Amazon Resource Name (ARN) of the dataset.

DataSetIdstring

The ID for the dataset that you want to create. This ID is unique per Amazon Web Services Region for each Amazon Web Services account.

IngestionArnstring

The ARN for the ingestion, which is triggered as a result of dataset creation if the import mode is SPICE.

IngestionIdstring

The ID of the ingestion, which is triggered as a result of dataset creation if the import mode is SPICE.

RequestIdstring

The Amazon Web Services request ID for this operation.

Statusinteger

The HTTP status of the request.