View a markdown version of this page

Actions, resources, and condition keys for Amazon Timestream - Service Authorization Reference

Actions, resources, and condition keys for Amazon Timestream

Amazon Timestream (service prefix: timestream) provides the following service-specific operations, resources, actions, and condition keys for use in IAM permission policies.

References:

API operations defined by Amazon Timestream

The following table maps API operations to the IAM actions they authorize. Only condition keys that have static values for the given API and action are listed; for the full set of condition keys supported by each action, see the Actions table.

Operation SDK client IAM action Condition key Possible value(s) Access level

CancelQuery

timestream-query

timestream:CancelQuery

Write

CreateScheduledQuery

timestream-query

timestream:CreateScheduledQuery

Write

timestream:TagResource

Tagging, Write

iam:PassRole

Write

DeleteScheduledQuery

timestream-query

timestream:DeleteScheduledQuery

Write

DescribeAccountSettings

timestream-query

timestream:DescribeAccountSettings

Read

DescribeEndpoints

timestream-query

timestream:DescribeEndpoints

List

DescribeScheduledQuery

timestream-query

timestream:DescribeScheduledQuery

Read

ExecuteScheduledQuery

timestream-query

timestream:ExecuteScheduledQuery

Write

ListScheduledQueries

timestream-query

timestream:ListScheduledQueries

List

ListTagsForResource

timestream-query

timestream:ListTagsForResource

Read

PrepareQuery

timestream-query

timestream:Select

Read

Query

timestream-query

timestream:DescribeTable

Read

timestream:ListDatabases

List

timestream:ListMeasures

List

timestream:ListTables

List

timestream:Select

Read

timestream:SelectValues

Read

timestream:Unload

Write

TagResource

timestream-query

timestream:TagResource

Tagging, Write

UntagResource

timestream-query

timestream:UntagResource

Tagging, Write

UpdateAccountSettings

timestream-query

timestream:UpdateAccountSettings

Write

iam:PassRole

Write

UpdateScheduledQuery

timestream-query

timestream:UpdateScheduledQuery

Write

CreateBatchLoadTask

timestream-write

timestream:CreateBatchLoadTask

Write

timestream:WriteRecords

Write

CreateDatabase

timestream-write

timestream:CreateDatabase

Write

timestream:TagResource

Tagging, Write

CreateTable

timestream-write

timestream:CreateTable

Write

timestream:TagResource

Tagging, Write

DeleteDatabase

timestream-write

timestream:DeleteDatabase

Write

DeleteTable

timestream-write

timestream:DeleteTable

Write

DescribeBatchLoadTask

timestream-write

timestream:DescribeBatchLoadTask

Read

DescribeDatabase

timestream-write

timestream:DescribeDatabase

Read

DescribeEndpoints

timestream-write

timestream:DescribeEndpoints

List

DescribeTable

timestream-write

timestream:DescribeTable

Read

ListBatchLoadTasks

timestream-write

timestream:ListBatchLoadTasks

List

ListDatabases

timestream-write

timestream:ListDatabases

List

ListTables

timestream-write

timestream:ListTables

List

ListTagsForResource

timestream-write

timestream:ListTagsForResource

Read

TagResource

timestream-write

timestream:TagResource

Tagging, Write

UntagResource

timestream-write

timestream:UntagResource

Tagging, Write

UpdateDatabase

timestream-write

timestream:UpdateDatabase

Write

UpdateTable

timestream-write

timestream:UpdateTable

Write

WriteRecords

timestream-write

timestream:WriteRecords

Write

Actions defined by Amazon Timestream

You can specify the following actions in the Action element of an IAM policy statement. Use policies to grant permissions to perform an operation in AWS. When you use an action in a policy, you usually allow or deny access to the API operation or CLI command with the same name. However, in some cases, a single action controls access to more than one operation. Alternatively, some operations require several different actions.

Actions Description Resource types (*required) Condition keys Access level

CancelQuery

Grants permission to cancel queries in your account

Write

CreateBatchLoadTask

Grants permission to create a batch load task in your account

table*

aws:ResourceTag/${TagKey}

Write

CreateDatabase

Grants permission to create a database in your account

database*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Write

CreateScheduledQuery

Grants permission to create a scheduled query in your account

aws:RequestTag/${TagKey}

aws:TagKeys

Write

CreateTable

Grants permission to create a table in your account

table*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Write

DeleteDatabase

Grants permission to delete a database in your account

database*

aws:ResourceTag/${TagKey}

Write

DeleteScheduledQuery

Grants permission to delete a scheduled query in your account

scheduled-query*

aws:ResourceTag/${TagKey}

Write

DeleteTable

Grants permission to delete a table in your account

table*

aws:ResourceTag/${TagKey}

Write

DescribeAccountSettings

Grants permission to describe your account settings

Read

DescribeBatchLoadTask

Grants permission to describe a batch load task in your account

Read

DescribeDatabase

Grants permission to describe a database in your account

database*

aws:ResourceTag/${TagKey}

Read

DescribeEndpoints

Grants permission to describe timestream endpoints

List

DescribeScheduledQuery

Grants permission to describe a scheduled query in your account

scheduled-query*

aws:ResourceTag/${TagKey}

Read

DescribeTable

Grants permission to describe a table in your account

table*

aws:ResourceTag/${TagKey}

Read

ExecuteScheduledQuery

Grants permission to execute a scheduled query in your account

scheduled-query*

aws:ResourceTag/${TagKey}

Write

GetAwsBackupStatus

Grants permission to get Status of a Timestream Table Backup

Read

GetAwsRestoreStatus

Grants permission to get Status of a Timestream Table Restore

Read

ListBatchLoadTasks

Grants permission to list batch load tasks in your account

List

ListDatabases

Grants permission to list databases in your account

List

ListMeasures

Grants permission to list measures of a table in your account

table*

aws:ResourceTag/${TagKey}

List

ListScheduledQueries

Grants permission to list scheduled queries in your account

List

ListTables

Grants permission to list tables in your account

database*

aws:ResourceTag/${TagKey}

List

ListTagsForResource

Grants permission to list tags of a resource in your account

database*

aws:ResourceTag/${TagKey}

Read

scheduled-query*

aws:ResourceTag/${TagKey}

table*

aws:ResourceTag/${TagKey}

PrepareQuery

Grants permission to issue prepare queries

table*

aws:ResourceTag/${TagKey}

Read

ResumeBatchLoadTask

Grants permission to resume a batch load task in your account

Write

Select

Grants permission to issue 'select from table' queries

table*

aws:ResourceTag/${TagKey}

Read

SelectValues

Grants permission to issue 'select 1' queries

Read

StartAwsBackupJob

Grants permission to start a Backup Job for a Timestream Table

table*

aws:ResourceTag/${TagKey}

Write

StartAwsRestoreJob

Grants permission to start Restore Job for a Backup of Timestream Table

table*

aws:ResourceTag/${TagKey}

Write

TagResource

Grants permission to add tags to a resource

database*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

scheduled-query*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

table*

aws:RequestTag/${TagKey}

aws:ResourceTag/${TagKey}

aws:TagKeys

Unload

Grants permission to issue Unload queries

table*

aws:ResourceTag/${TagKey}

Write

UntagResource

Grants permission to remove a tag from a resource

database*

aws:ResourceTag/${TagKey}

aws:TagKeys

Tagging, Write

scheduled-query*

aws:ResourceTag/${TagKey}

aws:TagKeys

table*

aws:ResourceTag/${TagKey}

aws:TagKeys

UpdateAccountSettings

Grants permission to update your account settings

Write

UpdateDatabase

Grants permission to update a database in your account

database*

aws:ResourceTag/${TagKey}

Write

UpdateScheduledQuery

Grants permission to update a scheduled query in your account

scheduled-query*

aws:ResourceTag/${TagKey}

Write

UpdateTable

Grants permission to update a table in your account

table*

aws:ResourceTag/${TagKey}

Write

WriteRecords

Grants permission to ingest data to a table in your account

table*

aws:ResourceTag/${TagKey}

Write

Resource types defined by Amazon Timestream

The following resource types are defined by this service and can be used in the Resource element of IAM permission policy statements.

Resource types ARN Condition keys

database

arn:${Partition}:timestream:${Region}:${Account}:database/${DatabaseName}

aws:ResourceTag/${TagKey}

scheduled-query

arn:${Partition}:timestream:${Region}:${Account}:scheduled-query/${ScheduledQueryName}

aws:ResourceTag/${TagKey}

table

arn:${Partition}:timestream:${Region}:${Account}:database/${DatabaseName}/table/${TableName}

aws:ResourceTag/${TagKey}

Condition keys for Amazon Timestream

Amazon Timestream defines the following condition keys that can be used in the Condition element of an IAM policy.

Condition keys Description Type

aws:RequestTag/${TagKey}

Filters access by the presence of tag key-value pairs in the request

String

aws:ResourceTag/${TagKey}

Filters access by tag key-value pairs attached to the resource

String

aws:TagKeys

Filters access by the presence of tag keys in the request

ArrayOfString