Skip to main content

table

Gets an individual table resource

Overview

Nametable
TypeResource
Descriptiontable
Idawscc.timestream.table

Fields

NameDatatypeDescription
arnstring
namestringThe table name exposed as a read-only attribute.
database_namestringThe name for the database which the table to be created belongs to.
table_namestringThe name for the table. If you don't specify a name, AWS CloudFormation generates a unique physical ID and uses that ID for the table name.
retention_propertiesobjectThe retention duration of the memory store and the magnetic store.
schemaobjectA Schema specifies the expected data model of the table.
magnetic_store_write_propertiesobjectThe properties that determine whether magnetic store writes are enabled.
tagsarrayAn array of key-value pairs to apply to this resource.
regionstringAWS region.

Methods

Currently only SELECT is supported for this resource resource.

Example

SELECT
region,
arn,
name,
database_name,
table_name,
retention_properties,
schema,
magnetic_store_write_properties,
tags
FROM awscc.timestream.table
WHERE data__Identifier = '<DatabaseName>|<TableName>';

Permissions

To operate on the table resource, the following permissions are required:

Read

timestream:DescribeTable,
timestream:DescribeEndpoints,
timestream:ListTagsForResource

Update

timestream:UpdateTable,
timestream:DescribeEndpoints,
timestream:TagResource,
timestream:UntagResource,
s3:PutObject,
s3:GetObject,
s3:GetBucketAcl,
kms:GenerateDataKey*,
kms:DescribeKey,
kms:Encrypt

Delete

timestream:DeleteTable,
timestream:DescribeEndpoints,
timestream:DescribeTable