POST

/datastores

http://iotanalytics.{region}.amazonaws.com/datastores

Creates a data store, which is a repository for messages.

Access Token Required: API Key

Body Params

tagsarray

Metadata which can be used to manage the data store.

datastoreNamestringrequired

The name of the data store.

retentionPeriodobject

How long, in days, message data is kept.

datastoreStorageobject

Where data in a data store is stored.. You can choose <code>serviceManagedS3</code> storage, <code>customerManagedS3</code> storage, or <code>iotSiteWiseMultiLayerStorage</code> storage. The default is <code>serviceManagedS3</code>. You can't change the choice of Amazon S3 storage after your data store is created.

datastorePartitionsobject

Contains information about the partition dimensions in a data store.

fileFormatConfigurationobject

Contains the configuration information of file formats. IoT Analytics data stores support JSON and <a href="https://parquet.apache.org/">Parquet</a>. The default file format is JSON. You can specify only one format. You can't change the file format after you create the data store.

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://iotanalytics.{region}.amazonaws.com/datastores' \
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}