ScheduledQueryDescription - Amazon Timestream

Amazon Timestream for LiveAnalytics will no longer be open to new customers starting June 20, 2025. If you would like to use Amazon Timestream for LiveAnalytics, sign up prior to that date. Existing customers can continue to use the service as normal. For more information, see Amazon Timestream for LiveAnalytics availability change.

ScheduledQueryDescription

Structure that describes scheduled query.

Contents

Arn

Scheduled query ARN.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Required: Yes

Name

Name of the scheduled query.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 64.

Pattern: [a-zA-Z0-9|!\-_*'\(\)]([a-zA-Z0-9]|[!\-_*'\(\)\/.])+

Required: Yes

NotificationConfiguration

Notification configuration.

Type: NotificationConfiguration object

Required: Yes

QueryString

The query to be run.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 262144.

Required: Yes

ScheduleConfiguration

Schedule configuration.

Type: ScheduleConfiguration object

Required: Yes

State

State of the scheduled query.

Type: String

Valid Values: ENABLED | DISABLED

Required: Yes

CreationTime

Creation time of the scheduled query.

Type: Timestamp

Required: No

ErrorReportConfiguration

Error-reporting configuration for the scheduled query.

Type: ErrorReportConfiguration object

Required: No

KmsKeyId

A customer provided KMS key used to encrypt the scheduled query resource.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Required: No

LastRunSummary

Runtime summary for the last scheduled query run.

Type: ScheduledQueryRunSummary object

Required: No

NextInvocationTime

The next time the scheduled query is scheduled to run.

Type: Timestamp

Required: No

PreviousInvocationTime

Last time the query was run.

Type: Timestamp

Required: No

RecentlyFailedRuns

Runtime summary for the last five failed scheduled query runs.

Type: Array of ScheduledQueryRunSummary objects

Required: No

ScheduledQueryExecutionRoleArn

IAM role that Timestream uses to run the schedule query.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 2048.

Required: No

TargetConfiguration

Scheduled query target store configuration.

Type: TargetConfiguration object

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: