POST

/configuration/account/storage

http://iotsitewise.{region}.amazonaws.com/configuration/account/storage

Configures storage settings for IoT SiteWise.

Access Token Required: API Key

Body Params

storageTypestringrequired

The storage tier that you specified for your data. The <code>storageType</code> parameter can be one of the following values: <ul> <li> <code>SITEWISE_DEFAULT_STORAGE</code> – IoT SiteWise saves your data into the hot tier. The hot tier is a service-managed database. </li> <li> <code>MULTI_LAYER_STORAGE</code> – IoT SiteWise saves your data in both the cold tier and the hot tier. The cold tier is a customer-managed Amazon S3 bucket. </li> </ul>

retentionPeriodobject

How many days your data is kept in the hot tier. By default, your data is kept indefinitely in the hot tier.

multiLayerStorageobject

Contains information about the storage destination.

disassociatedDataStoragestring

Contains the storage configuration for time series (data streams) that aren't associated with asset properties. The <code>disassociatedDataStorage</code> can be one of the following values: <ul> <li> <code>ENABLED</code> – IoT SiteWise accepts time series that aren't associated with asset properties. <important> After the <code>disassociatedDataStorage</code> is enabled, you can't disable it. </important> </li> <li> <code>DISABLED</code> – IoT SiteWise doesn't accept time series (data streams) that aren't associated with asset properties. </li> </ul> For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/data-streams.html">Data streams</a> in the IoT SiteWise User Guide.

Responses

{
  "success": true,
  "data": {
    "id": "abc123",
    "created_at": "2025-01-01T00:00:00Z"
  }
}

{
  "success": false,
  "error": {
    "code": "VALIDATION_ERROR",
    "message": "Invalid request parameters"
  }
}

Language

CredentialsAPI KEY

API Key

Enter token below to save for later

cURL Request

1curl --request POST \
2     --url 'http://iotsitewise.{region}.amazonaws.com/configuration/account/storage' \
3     --header 'accept: application/json' \
4     --header 'content-type: application/json'

Response

1{
2  "success": true,
3  "data": {
4    "id": "abc123",
5    "created_at": "2025-01-01T00:00:00Z"
6  }
7}