Select your cookie preferences

We use essential cookies and similar tools that are necessary to provide our site and services. We use performance cookies to collect anonymous statistics, so we can understand how customers use our site and make improvements. Essential cookies cannot be deactivated, but you can choose “Customize” or “Decline” to decline performance cookies.

If you agree, AWS and approved third parties will also use cookies to provide useful site features, remember your preferences, and display relevant content, including relevant advertising. To accept or decline all non-essential cookies, choose “Accept” or “Decline.” To make more detailed choices, choose “Customize.”

Keeping multiple versions of datasets - AWS IoT Analytics

AWS IoT Analytics is no longer available to new customers. Existing customers of AWS IoT Analytics can continue to use the service as normal. Learn more

AWS IoT Analytics is no longer available to new customers. Existing customers of AWS IoT Analytics can continue to use the service as normal. Learn more

Keeping multiple versions of datasets

You can choose how many versions of your dataset contents to retain, and for how long, by specifying values for the dataset retentionPeriod and versioningConfiguration fields when invoking the CreateDataset and UpdateDataset APIs:

... "retentionPeriod": { "unlimited": "boolean", "numberOfDays": "integer" }, "versioningConfiguration": { "unlimited": "boolean", "maxVersions": "integer" }, ...

The settings of these two parameters work together to determine how many versions of data set contents are retained, and for how long, in the following ways.

retentionPeriod

[not specified]

retentionPeriod:

unlimited = TRUE, numberOfDays = not set

retentionPeriod:

unlimited = FALSE, numberOfDays = X

versioningConfiguration:

[not specified]

Only the latest version plus the latest succeeded version (if different) are retained for 90 days.

Only the latest version plus the latest succeeded version (if different) are retained for an unlimited time.

Only the latest version plus the latest succeeded version (if different) are retained for X days.

versioningConfiguration:

unlimited = TRUE, maxVersions not set

All versions from the last 90 days will be retained, regardless of how many.

There is no limit to the number of versions retained.

All versions from the last X days will be retained, regardless of how many.

versioningConfiguration:

unlimited = FALSE, maxVersions = Y

No more than Y versions from the last 90 days will be retained.

Up to Y versions will be retained, regardless of how old they are.

No more than Y versions from the last X days will be retained.

PrivacySite termsCookie preferences
© 2025, Amazon Web Services, Inc. or its affiliates. All rights reserved.