String databaseName
The name of the Timestream database.
String kmsKeyId
The KMS key for the database. If the KMS key is not specified, the database will be encrypted with a Timestream managed KMS key located in your account. Refer to Amazon Web Services managed KMS keys for more info.
List<E> tags
A list of key-value pairs to label the table.
Database database
The newly created Timestream database.
String databaseName
The name of the Timestream database.
String tableName
The name of the Timestream table.
RetentionProperties retentionProperties
The duration for which your time series data must be stored in the memory store and the magnetic store.
List<E> tags
A list of key-value pairs to label the table.
MagneticStoreWriteProperties magneticStoreWriteProperties
Contains properties to set on the table when enabling magnetic store writes.
Table table
The newly created Timestream table.
String arn
The Amazon Resource Name that uniquely identifies this database.
String databaseName
The name of the Timestream database.
Long tableCount
The total number of tables found within a Timestream database.
String kmsKeyId
The identifier of the KMS key used to encrypt the data stored in the database.
Date creationTime
The time when the database was created, calculated from the Unix epoch time.
Date lastUpdatedTime
The last time that this database was updated.
String databaseName
The name of the Timestream database to be deleted.
String databaseName
The name of the Timestream database.
Database database
The name of the Timestream table.
Table table
The Timestream table.
String 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.
String value
The value of the dimension.
String dimensionValueType
The data type of the dimension for the time series data point.
String nextToken
The pagination token. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.
Integer maxResults
The total number of items to return in the output. If the total number of items available is more than the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.
String databaseName
The name of the Timestream database.
String nextToken
The pagination token. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.
Integer maxResults
The total number of items to return in the output. If the total number of items available is more than the value specified, a NextToken is provided in the output. To resume pagination, provide the NextToken value as argument of a subsequent API invocation.
String resourceARN
The Timestream resource with tags to be listed. This value is an Amazon Resource Name (ARN).
S3Configuration s3Configuration
Configuration of an S3 location to write error reports for records rejected, asynchronously, during magnetic store writes.
Boolean enableMagneticStoreWrites
A flag to enable magnetic store writes.
MagneticStoreRejectedDataLocation magneticStoreRejectedDataLocation
The location to write error reports for records rejected asynchronously during magnetic store writes.
String name
Name of the MeasureValue.
For constraints on MeasureValue names, refer to Naming Constraints in the Timestream developer guide.
String value
Value for the MeasureValue.
String type
Contains the data type of the MeasureValue for the time series data point.
List<E> dimensions
Contains the list of dimensions for time series data points.
String 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.
String measureValue
Contains the measure value for the time series data point.
String measureValueType
Contains the data type of the measure value for the time series data point. Default type is DOUBLE
.
String 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.
String 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
.
Long 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.
List<E> 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.
Integer recordIndex
The index of the record in the input request for WriteRecords. Indexes begin with 0.
String reason
The reason why a record was not successfully inserted into Timestream. Possible causes of failure include:
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
If Timestream rejects data for this case, 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
When the retention window is updated, you will receive a RejectedRecords
exception if you
immediately try to ingest data within the new window. To avoid a RejectedRecords
exception, wait
until the duration of the new window to ingest new data. For further information, see Best
Practices for Configuring Timestream and the explanation of how storage
works in Timestream.
Records with dimensions or measures that exceed the Timestream defined limits.
For more information, see Access Management in the Timestream Developer Guide.
Long existingVersion
The existing version of the record. This value is populated in scenarios where an identical record exists with a higher version than the version in the write request.
String bucketName
>Bucket name of the customer S3 bucket.
String objectKeyPrefix
Object key preview for the customer S3 location.
String encryptionOption
Encryption option for the customer s3 location. Options are S3 server side encryption with an S3-managed key or KMS managed key.
String kmsKeyId
KMS key id for the customer s3 location when encrypting with a KMS managed key.
String arn
The Amazon Resource Name that uniquely identifies this table.
String tableName
The name of the Timestream table.
String databaseName
The name of the Timestream database that contains this table.
String tableStatus
The current state of the table:
DELETING
- The table is being deleted.
ACTIVE
- The table is ready for use.
RetentionProperties retentionProperties
The retention duration for the memory store and magnetic store.
Date creationTime
The time when the Timestream table was created.
Date lastUpdatedTime
The time when the Timestream table was last updated.
MagneticStoreWriteProperties magneticStoreWriteProperties
Contains properties to set on the table when enabling magnetic store writes.
String databaseName
The name of the database.
String kmsKeyId
The identifier of the new KMS key (KmsKeyId
) to be used to encrypt the data stored in the database.
If the KmsKeyId
currently registered with the database is the same as the KmsKeyId
in
the request, there will not be any update.
You can specify the KmsKeyId
using any of the following:
Key ID: 1234abcd-12ab-34cd-56ef-1234567890ab
Key ARN: arn:aws:kms:us-east-1:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab
Alias name: alias/ExampleAlias
Alias ARN: arn:aws:kms:us-east-1:111122223333:alias/ExampleAlias
Database database
String databaseName
The name of the Timestream database.
String tableName
The name of the Timestream table.
RetentionProperties retentionProperties
The retention duration of the memory store and the magnetic store.
MagneticStoreWriteProperties magneticStoreWriteProperties
Contains properties to set on the table when enabling magnetic store writes.
Table table
The updated Timestream table.
String databaseName
The name of the Timestream database.
String tableName
The name of the Timestream table.
Record commonAttributes
A record containing the common measure, dimension, time, and version attributes shared across all the records in
the request. The measure and dimension attributes specified will be merged with the measure and dimension
attributes in the records object when the data is written into Timestream. Dimensions may not overlap, or a
ValidationException
will be thrown. In other words, a record must contain dimensions with unique
names.
List<E> records
An array of records containing the unique measure, dimension, time, and version attributes for each time series data point.
RecordsIngested recordsIngested
Information on the records ingested by this request.
Copyright © 2022. All rights reserved.