v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1429165131.4 KB

This operation creates a data set.

post/v1/data-sets

Request body

AssetType'S3_SNAPSHOT' | 'REDSHIFT_DATA_SHARE' | 'API_GATEWAY_API' | 'S3_DATA_ACCESS' | 'LAKE_FORMATION_DATA_PERMISSION' required

The type of asset that is added to a data set.

Descriptionstring required

A description for the data set. This value can be up to 16,348 characters long.

Namestring required

The name of the data set.

Tagsobject

A data set tag is an optional label that you can assign to a data set when you create it. Each tag consists of a key and an optional value, both of which you define. When you use tagging, you can also use tag-based access control in IAM policies to control access to these data sets and revisions.

Response

Success

Arnstring

The ARN for the data set.

AssetType'S3_SNAPSHOT' | 'REDSHIFT_DATA_SHARE' | 'API_GATEWAY_API' | 'S3_DATA_ACCESS' | 'LAKE_FORMATION_DATA_PERMISSION'

The type of asset that is added to a data set.

CreatedAtstring date-time

The date and time that the data set was created, in ISO 8601 format.

Descriptionstring

The description for the data set.

Idstring

The unique identifier for the data set.

Namestring

The name of the data set.

Origin'OWNED' | 'ENTITLED'

A property that defines the data set as OWNED by the account (for providers) or ENTITLED to the account (for subscribers).

SourceIdstring

The data set ID of the owned data set corresponding to the entitled data set being viewed. This parameter is returned when a data set owner is viewing the entitled copy of its owned data set.

Tagsobject

The tags for the data set.

UpdatedAtstring date-time

The date and time that the data set was last updated, in ISO 8601 format.