---
title: "GET /configuration/account/storage"
method: GET
path: "/configuration/account/storage"
---

# GET /configuration/account/storage

`GET /configuration/account/storage`

Retrieves information about the storage configuration for IoT SiteWise.

## Response `200`

Success

- DescribeStorageConfigurationResponse
  - `storageType` 'SITEWISE_DEFAULT_STORAGE' | 'MULTI_LAYER_STORAGE', required — <p>The storage tier that you specified for your data. The <code>storageType</code> parameter can be one of the following values:</p> <ul> <li> <p> <code>SITEWISE_DEFAULT_STORAGE</code> – IoT SiteWise saves your data into the hot tier. The hot tier is a service-managed database.</p> </li> <li> <p> <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.</p> </li> </ul>
  - `multiLayerStorage` object — Contains information about the storage destination.
    - `customerManagedS3Storage` object, required — Contains information about a customer managed Amazon S3 bucket.
      - `s3ResourceArn` string, required — The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">ARN</a> of the Amazon S3 object. For more information about how to find the ARN for an Amazon S3 object, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-arn-format.html">Amazon S3 resources</a> in the <i>Amazon Simple Storage Service User Guide</i>.
      - `roleArn` string, required — The <a href="https://docs.aws.amazon.com/general/latest/gr/aws-arns-and-namespaces.html">ARN</a> of the Identity and Access Management role that allows IoT SiteWise to send data to Amazon S3.
  - `disassociatedDataStorage` 'ENABLED' | 'DISABLED' — <p>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:</p> <ul> <li> <p> <code>ENABLED</code> – IoT SiteWise accepts time series that aren't associated with asset properties.</p> <important> <p>After the <code>disassociatedDataStorage</code> is enabled, you can't disable it.</p> </important> </li> <li> <p> <code>DISABLED</code> – IoT SiteWise doesn't accept time series (data streams) that aren't associated with asset properties.</p> </li> </ul> <p>For more information, see <a href="https://docs.aws.amazon.com/iot-sitewise/latest/userguide/data-streams.html">Data streams</a> in the <i>IoT SiteWise User Guide</i>.</p>
  - `retentionPeriod` object — How many days your data is kept in the hot tier. By default, your data is kept indefinitely in the hot tier.
    - `numberOfDays` integer — <p>The number of days that your data is kept.</p> <note> <p>If you specified a value for this parameter, the <code>unlimited</code> parameter must be <code>false</code>.</p> </note>
    - `unlimited` boolean — <p>If true, your data is kept indefinitely.</p> <note> <p>If configured to <code>true</code>, you must not specify a value for the <code>numberOfDays</code> parameter.</p> </note>
  - `configurationStatus` ConfigurationStatus, required — Contains current status information for the configuration.
    - `state` 'ACTIVE' | 'UPDATE_IN_PROGRESS' | 'UPDATE_FAILED', required — The current state of the configuration.
    - `error` object — Contains associated error information, if any.
      - `code` 'VALIDATION_ERROR' | 'INTERNAL_FAILURE', required — The error code.
      - `message` string, required — The error message.
  - `lastUpdateDate` string, date-time — The date the storage configuration was last updated, in Unix epoch time.

## Other responses

- `480` — InvalidRequestException
- `481` — ResourceNotFoundException
- `482` — InternalFailureException
- `483` — ThrottlingException
- `484` — LimitExceededException
- `485` — ConflictingOperationException

---

[API](https://skmtc.net/aws/apis/iotsitewise.md) · [All operations](https://skmtc.net/aws/apis/iotsitewise/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/aws/iotsitewise/versions/d13e5d3e0a6f/schema)