TimestreamQuery / Client / list_scheduled_queries

list_scheduled_queries#

TimestreamQuery.Client.list_scheduled_queries(**kwargs)#

Gets a list of all scheduled queries in the caller’s Amazon account and Region. ListScheduledQueries is eventually consistent.

See also: AWS API Documentation

Request Syntax

response = client.list_scheduled_queries(
    MaxResults=123,
    NextToken='string'
)
Parameters:
  • MaxResults (integer) – The maximum 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 the argument to the subsequent call to ListScheduledQueriesRequest.

  • NextToken (string) – A pagination token to resume pagination.

Return type:

dict

Returns:

Response Syntax

{
    'ScheduledQueries': [
        {
            'Arn': 'string',
            'Name': 'string',
            'CreationTime': datetime(2015, 1, 1),
            'State': 'ENABLED'|'DISABLED',
            'PreviousInvocationTime': datetime(2015, 1, 1),
            'NextInvocationTime': datetime(2015, 1, 1),
            'ErrorReportConfiguration': {
                'S3Configuration': {
                    'BucketName': 'string',
                    'ObjectKeyPrefix': 'string',
                    'EncryptionOption': 'SSE_S3'|'SSE_KMS'
                }
            },
            'TargetDestination': {
                'TimestreamDestination': {
                    'DatabaseName': 'string',
                    'TableName': 'string'
                }
            },
            'LastRunStatus': 'AUTO_TRIGGER_SUCCESS'|'AUTO_TRIGGER_FAILURE'|'MANUAL_TRIGGER_SUCCESS'|'MANUAL_TRIGGER_FAILURE'
        },
    ],
    'NextToken': 'string'
}

Response Structure

  • (dict) –

    • ScheduledQueries (list) –

      A list of scheduled queries.

      • (dict) –

        Scheduled Query

        • Arn (string) –

          The Amazon Resource Name.

        • Name (string) –

          The name of the scheduled query.

        • CreationTime (datetime) –

          The creation time of the scheduled query.

        • State (string) –

          State of scheduled query.

        • PreviousInvocationTime (datetime) –

          The last time the scheduled query was run.

        • NextInvocationTime (datetime) –

          The next time the scheduled query is to be run.

        • ErrorReportConfiguration (dict) –

          Configuration for scheduled query error reporting.

          • S3Configuration (dict) –

            The S3 configuration for the error reports.

            • BucketName (string) –

              Name of the S3 bucket under which error reports will be created.

            • ObjectKeyPrefix (string) –

              Prefix for the error report key. Timestream by default adds the following prefix to the error report path.

            • EncryptionOption (string) –

              Encryption at rest options for the error reports. If no encryption option is specified, Timestream will choose SSE_S3 as default.

        • TargetDestination (dict) –

          Target data source where final scheduled query result will be written.

          • TimestreamDestination (dict) –

            Query result destination details for Timestream data source.

            • DatabaseName (string) –

              Timestream database name.

            • TableName (string) –

              Timestream table name.

        • LastRunStatus (string) –

          Status of the last scheduled query run.

    • NextToken (string) –

      A token to specify where to start paginating. This is the NextToken from a previously truncated response.

Exceptions

  • TimestreamQuery.Client.exceptions.AccessDeniedException

  • TimestreamQuery.Client.exceptions.InternalServerException

  • TimestreamQuery.Client.exceptions.ThrottlingException

  • TimestreamQuery.Client.exceptions.ValidationException

  • TimestreamQuery.Client.exceptions.InvalidEndpointException