---
title: "GET /datastores"
method: GET
path: "/datastores"
---

# GET /datastores

`GET /datastores`

Retrieves a list of data stores.

## Query parameters

- `nextToken` string
- `maxResults` integer

## Response `200`

Success

- ListDatastoresResponse
  - `datastoreSummaries` DatastoreSummary[] — A list of <code>DatastoreSummary</code> objects.
    - `datastoreName` string — The name of the data store.
    - `datastoreStorage` object — Where data in a data store is stored.
      - `serviceManagedS3` object — Used to store data in an Amazon S3 bucket managed by IoT Analytics.
      - `customerManagedS3` object — Used to store data in an Amazon S3 bucket managed by IoT Analytics.
        - `bucket` string — The name of the Amazon S3 bucket where your data is stored.
        - `keyPrefix` string — (Optional) The prefix used to create the keys of the data store data objects. Each object in an Amazon S3 bucket has a key that is its unique identifier in the bucket. Each object in a bucket has exactly one key. The prefix must end with a forward slash (/).
        - `roleArn` string — The ARN of the role that grants IoT Analytics permission to interact with your Amazon S3 resources.
      - `iotSiteWiseMultiLayerStorage` object — Used to store data used by IoT SiteWise in an Amazon S3 bucket that you manage.
        - `customerManagedS3Storage` object — Used to store data used by IoT SiteWise in an Amazon S3 bucket that you manage.
          - `bucket` string — The name of the Amazon S3 bucket where your data is stored.
          - `keyPrefix` string — (Optional) The prefix used to create the keys of the data store data objects. Each object in an Amazon S3 bucket has a key that is its unique identifier in the bucket. Each object in a bucket has exactly one key. The prefix must end with a forward slash (/).
    - `status` 'CREATING' | 'ACTIVE' | 'DELETING' — The status of the data store.
    - `creationTime` string, date-time — When the data store was created.
    - `lastUpdateTime` string, date-time — The last time the data store was updated.
    - `lastMessageArrivalTime` string, date-time — <p>The last time when a new message arrived in the data store.</p> <p>IoT Analytics updates this value at most once per minute for Amazon Simple Storage Service one data store. Hence, the <code>lastMessageArrivalTime</code> value is an approximation.</p> <p>This feature only applies to messages that arrived in the data store after October 23, 2020. </p>
    - `fileFormatType` 'JSON' | 'PARQUET' — The file format of the data in the data store.
    - `datastorePartitions` object — Contains information about the partition dimensions in a data store.
      - `partitions` DatastorePartition[] — A list of partition dimensions in a data store.
        - `attributePartition` object — A partition dimension defined by an <code>attributeName</code>.
          - `attributeName` string, required — The name of the attribute that defines a partition dimension.
        - `timestampPartition` object — A partition dimension defined by a timestamp attribute.
          - `attributeName` string, required — The attribute name of the partition defined by a timestamp.
          - `timestampFormat` string — The timestamp format of a partition defined by a timestamp. The default format is seconds since epoch (January 1, 1970 at midnight UTC time).
  - `nextToken` string — The token to retrieve the next set of results, or <code>null</code> if there are no more results.

## Other responses

- `480` — InvalidRequestException
- `481` — InternalFailureException
- `482` — ServiceUnavailableException
- `483` — ThrottlingException

---

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