API version 2018-11-01 of the Amazon Timestream Write SDK configuration.

You are not authorized to perform this action.

Timestream was unable to process this request because it contains resource that already exists.

Timestream was unable to fully process this request because of an internal server error.

The requested endpoint was invalid.

WriteRecords would throw this exception in the following cases:

• Records with duplicate data where there are multiple records with the same dimensions, timestamps, and measure names but:

  • Measure values are different
  • Version is not present in the request or the value of version in the new record is equal to or lower than the existing value

  In this case, if Timestream rejects data, the ExistingVersion field in the RejectedRecords response will indicate the current record’s version. To force an update, you can resend the request with a version for the record set to a value greater than the ExistingVersion.

• Records with timestamps that lie outside the retention duration of the memory store
• Records with dimensions or measures that exceed the Timestream defined limits.

For more information, see Quotas in the Timestream Developer Guide.

The operation tried to access a nonexistent resource. The resource might not be specified correctly, or its status might not be ACTIVE.

Instance quota of resource exceeded for this account.

Too many requests were made by a user exceeding service quotas. The request was throttled.

Invalid or malformed request.

A top level container for a table. Databases and tables are the fundamental management concepts in Amazon Timestream. All tables in a database are encrypted with the same KMS key.

See: newDatabase smart constructor.

Create a value of Database with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:arn:Database', database_arn - The Amazon Resource Name that uniquely identifies this database.

$sel:creationTime:Database', database_creationTime - The time when the database was created, calculated from the Unix epoch time.

$sel:databaseName:Database', database_databaseName - The name of the Timestream database.

$sel:kmsKeyId:Database', database_kmsKeyId - The identifier of the KMS key used to encrypt the data stored in the database.

$sel:lastUpdatedTime:Database', database_lastUpdatedTime - The last time that this database was updated.

$sel:tableCount:Database', database_tableCount - The total number of tables found within a Timestream database.

The Amazon Resource Name that uniquely identifies this database.

The time when the database was created, calculated from the Unix epoch time.

The name of the Timestream database.

The identifier of the KMS key used to encrypt the data stored in the database.

The last time that this database was updated.

The total number of tables found within a Timestream database.

Dimension represents the meta data attributes of the time series. For example, the name and availability zone of an EC2 instance or the name of the manufacturer of a wind turbine are dimensions.

See: newDimension smart constructor.

Create a value of Dimension with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:dimensionValueType:Dimension', dimension_dimensionValueType - The data type of the dimension for the time series data point.

$sel:name:Dimension', dimension_name - Dimension represents the meta data attributes of the time series. For example, the name and availability zone of an EC2 instance or the name of the manufacturer of a wind turbine are dimensions.

For constraints on Dimension names, see Naming Constraints.

$sel:value:Dimension', dimension_value - The value of the dimension.

The data type of the dimension for the time series data point.

Dimension represents the meta data attributes of the time series. For example, the name and availability zone of an EC2 instance or the name of the manufacturer of a wind turbine are dimensions.

For constraints on Dimension names, see Naming Constraints.

The value of the dimension.

Represents an available endpoint against which to make API calls agaisnt, as well as the TTL for that endpoint.

See: newEndpoint smart constructor.

Create a value of Endpoint with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:address:Endpoint', endpoint_address - An endpoint address.

$sel:cachePeriodInMinutes:Endpoint', endpoint_cachePeriodInMinutes - The TTL for the endpoint, in minutes.

An endpoint address.

The TTL for the endpoint, in minutes.

The location to write error reports for records rejected, asynchronously, during magnetic store writes.

See: newMagneticStoreRejectedDataLocation smart constructor.

Create a value of MagneticStoreRejectedDataLocation with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:s3Configuration:MagneticStoreRejectedDataLocation', magneticStoreRejectedDataLocation_s3Configuration - Configuration of an S3 location to write error reports for records rejected, asynchronously, during magnetic store writes.

Configuration of an S3 location to write error reports for records rejected, asynchronously, during magnetic store writes.

The set of properties on a table for configuring magnetic store writes.

See: newMagneticStoreWriteProperties smart constructor.

Create a value of MagneticStoreWriteProperties with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:magneticStoreRejectedDataLocation:MagneticStoreWriteProperties', magneticStoreWriteProperties_magneticStoreRejectedDataLocation - The location to write error reports for records rejected asynchronously during magnetic store writes.

$sel:enableMagneticStoreWrites:MagneticStoreWriteProperties', magneticStoreWriteProperties_enableMagneticStoreWrites - A flag to enable magnetic store writes.

The location to write error reports for records rejected asynchronously during magnetic store writes.

A flag to enable magnetic store writes.

MeasureValue represents the data attribute of the time series. For example, the CPU utilization of an EC2 instance or the RPM of a wind turbine are measures. MeasureValue has both name and value.

MeasureValue is only allowed for type MULTI. Using MULTI type, you can pass multiple data attributes associated with the same time series in a single record

See: newMeasureValue smart constructor.

Create a value of MeasureValue with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:name:MeasureValue', measureValue_name - Name of the MeasureValue.

For constraints on MeasureValue names, refer to Naming Constraints in the Timestream developer guide.

$sel:value:MeasureValue', measureValue_value - Value for the MeasureValue.

$sel:type':MeasureValue', measureValue_type - Contains the data type of the MeasureValue for the time series data point.

Name of the MeasureValue.

For constraints on MeasureValue names, refer to Naming Constraints in the Timestream developer guide.

Value for the MeasureValue.

Contains the data type of the MeasureValue for the time series data point.

Record represents a time series data point being written into Timestream. Each record contains an array of dimensions. Dimensions represent the meta data attributes of a time series data point such as the instance name or availability zone of an EC2 instance. A record also contains the measure name which is the name of the measure being collected for example the CPU utilization of an EC2 instance. A record also contains the measure value and the value type which is the data type of the measure value. In addition, the record contains the timestamp when the measure was collected that the timestamp unit which represents the granularity of the timestamp.

Records have a Version field, which is a 64-bit long that you can use for updating data points. Writes of a duplicate record with the same dimension, timestamp, and measure name but different measure value will only succeed if the Version attribute of the record in the write request is higher than that of the existing record. Timestream defaults to a Version of 1 for records without the Version field.

See: newRecord smart constructor.

Create a value of Record with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:dimensions:Record', record_dimensions - Contains the list of dimensions for time series data points.

$sel:measureName:Record', record_measureName - Measure represents the data attribute of the time series. For example, the CPU utilization of an EC2 instance or the RPM of a wind turbine are measures.

$sel:measureValue:Record', record_measureValue - Contains the measure value for the time series data point.

$sel:measureValueType:Record', record_measureValueType - Contains the data type of the measure value for the time series data point. Default type is DOUBLE.

$sel:measureValues:Record', record_measureValues - Contains the list of MeasureValue for time series data points.

This is only allowed for type MULTI. For scalar values, use MeasureValue attribute of the Record directly.

$sel:time:Record', record_time - Contains the time at which the measure value for the data point was collected. The time value plus the unit provides the time elapsed since the epoch. For example, if the time value is 12345 and the unit is ms, then 12345 ms have elapsed since the epoch.

$sel:timeUnit:Record', record_timeUnit - The granularity of the timestamp unit. It indicates if the time value is in seconds, milliseconds, nanoseconds or other supported values. Default is MILLISECONDS.

$sel:version:Record', record_version - 64-bit attribute used for record updates. Write requests for duplicate data with a higher version number will update the existing measure value and version. In cases where the measure value is the same, Version will still be updated . Default value is 1.

Version must be 1 or greater, or you will receive a ValidationException error.

Contains the list of dimensions for time series data points.

Measure represents the data attribute of the time series. For example, the CPU utilization of an EC2 instance or the RPM of a wind turbine are measures.

Contains the measure value for the time series data point.

Contains the data type of the measure value for the time series data point. Default type is DOUBLE.

Contains the list of MeasureValue for time series data points.

This is only allowed for type MULTI. For scalar values, use MeasureValue attribute of the Record directly.

Contains the time at which the measure value for the data point was collected. The time value plus the unit provides the time elapsed since the epoch. For example, if the time value is 12345 and the unit is ms, then 12345 ms have elapsed since the epoch.

The granularity of the timestamp unit. It indicates if the time value is in seconds, milliseconds, nanoseconds or other supported values. Default is MILLISECONDS.

64-bit attribute used for record updates. Write requests for duplicate data with a higher version number will update the existing measure value and version. In cases where the measure value is the same, Version will still be updated . Default value is 1.

Version must be 1 or greater, or you will receive a ValidationException error.

Information on the records ingested by this request.

See: newRecordsIngested smart constructor.

Create a value of RecordsIngested with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:magneticStore:RecordsIngested', recordsIngested_magneticStore - Count of records ingested into the magnetic store.

$sel:memoryStore:RecordsIngested', recordsIngested_memoryStore - Count of records ingested into the memory store.

$sel:total:RecordsIngested', recordsIngested_total - Total count of successfully ingested records.

Count of records ingested into the magnetic store.

Count of records ingested into the memory store.

Total count of successfully ingested records.

Retention properties contain the duration for which your time series data must be stored in the magnetic store and the memory store.

See: newRetentionProperties smart constructor.

Create a value of RetentionProperties with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:memoryStoreRetentionPeriodInHours:RetentionProperties', retentionProperties_memoryStoreRetentionPeriodInHours - The duration for which data must be stored in the memory store.

$sel:magneticStoreRetentionPeriodInDays:RetentionProperties', retentionProperties_magneticStoreRetentionPeriodInDays - The duration for which data must be stored in the magnetic store.

The duration for which data must be stored in the memory store.

The duration for which data must be stored in the magnetic store.

Configuration specifing an S3 location.

See: newS3Configuration smart constructor.