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: