aws-sdk-cloudwatchlogs 1.154.0 → 1.156.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: feb7a7a0ef3e6f89b109c6f3fded42629d39441d0c9d9488ee8c0d691af5f670
4
- data.tar.gz: fb3078b8b6baea65c9250bda8692911696119a79567aeed9334a263d3c92500d
3
+ metadata.gz: ab5f10c38ad4b140617f81629c5c33fe31a425a7b29d0398c453c58d744ac83b
4
+ data.tar.gz: 2634cd67d159f34c96a1d507798ce93ac9ba928e7286015bb77c0c940cee3cce
5
5
  SHA512:
6
- metadata.gz: 55a06c3dc5d3070fd96f66d10cd8305f06e6f10a3ae5f5b8a04e0b5b93207ec2c12ed5f8d9024a9d8575862995a365ce278e177ce476acd67dfc1ef857fa83fe
7
- data.tar.gz: 4b6c3fa7b39d84bfbe072f60ba8ab6af001ec31dbaaa72be859b8d6da445d26e248ea93a7800e9342e37f94f6cfa53c6dc81c8044bb2fd42c6e0993ce144c551
6
+ metadata.gz: 4050525b4cb469868446a2e193a4b3ed21f99a68faffec806f38ae0e632be1c0caa376ed55fd9fedc1e1ff585e76c5b443ca40060b6f9dea39ed670f08fbb4db
7
+ data.tar.gz: b885687169b410826ded26e838f9967837536e3b1c3e9b82e0b6a974278883f9b87b264f061e1b37dba2d448d93bd5b1dc265b56b017fae4009056662ab95f25
data/CHANGELOG.md CHANGED
@@ -1,6 +1,16 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.156.0 (2026-06-18)
5
+ ------------------
6
+
7
+ * Feature - Added optional startFromHead parameter to FilterLogEvents enabling descending timestamp order (newest first) when set to false. Default true preserves existing ascending order. Reverse sorting requires a startTime on or after Jan 1, 2024.
8
+
9
+ 1.155.0 (2026-06-15)
10
+ ------------------
11
+
12
+ * Feature - Added endTimeOffset parameter to Scheduled Queries APIs (Create, Update, Get) enabling bounded time window configuration. Introduced scheduleType filter (CUSTOMER MANAGED, AWS MANAGED) for ListScheduledQueries and exposed it in Get and Update responses.
13
+
4
14
  1.154.0 (2026-06-03)
5
15
  ------------------
6
16
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.154.0
1
+ 1.156.0
@@ -1416,9 +1416,7 @@ module Aws::CloudWatchLogs
1416
1416
  #
1417
1417
  # @option params [required, String] :name
1418
1418
  # The name of the scheduled query. The name must be unique within your
1419
- # account and region. Valid characters are alphanumeric characters,
1420
- # hyphens, underscores, and periods. Length must be between 1 and 255
1421
- # characters.
1419
+ # account and region. Length must be between 1 and 300 characters.
1422
1420
  #
1423
1421
  # @option params [String] :description
1424
1422
  # An optional description for the scheduled query to help identify its
@@ -1450,6 +1448,11 @@ module Aws::CloudWatchLogs
1450
1448
  # query. This determines how far back in time the query searches from
1451
1449
  # the execution time.
1452
1450
  #
1451
+ # @option params [Integer] :end_time_offset
1452
+ # The time offset in seconds that defines the end of the lookback period
1453
+ # for the query. Together with `startTimeOffset`, this determines the
1454
+ # time window relative to the execution time over which the query runs.
1455
+ #
1453
1456
  # @option params [Types::DestinationConfiguration] :destination_configuration
1454
1457
  # Configuration for where to deliver query results. Currently supports
1455
1458
  # Amazon S3 destinations for storing query output.
@@ -1492,6 +1495,7 @@ module Aws::CloudWatchLogs
1492
1495
  # schedule_expression: "ScheduleExpression", # required
1493
1496
  # timezone: "ScheduleTimezone",
1494
1497
  # start_time_offset: 1,
1498
+ # end_time_offset: 1,
1495
1499
  # destination_configuration: {
1496
1500
  # s3_configuration: { # required
1497
1501
  # destination_identifier: "S3Uri", # required
@@ -3622,7 +3626,10 @@ module Aws::CloudWatchLogs
3622
3626
  #
3623
3627
  # The returned log events are sorted by event timestamp, the timestamp
3624
3628
  # when the event was ingested by CloudWatch Logs, and the ID of the
3625
- # `PutLogEvents` request.
3629
+ # `PutLogEvents` request. By default, the events are returned in
3630
+ # ascending timestamp order (oldest first). To return events in
3631
+ # descending timestamp order (newest first), set the `startFromHead`
3632
+ # parameter to `false`.
3626
3633
  #
3627
3634
  # If you are using CloudWatch cross-account observability, you can use
3628
3635
  # this operation in a monitoring account and view data from the linked
@@ -3702,6 +3709,24 @@ module Aws::CloudWatchLogs
3702
3709
  # @option params [Integer] :limit
3703
3710
  # The maximum number of events to return. The default is 10,000 events.
3704
3711
  #
3712
+ # @option params [Boolean] :start_from_head
3713
+ # If the value is true, the earliest log events are returned first. If
3714
+ # the value is false, the latest log events are returned first. The
3715
+ # default value is true.
3716
+ #
3717
+ # The `startFromHead` parameter sets the sort direction on the first
3718
+ # request. On subsequent requests, the `nextToken` determines the sort
3719
+ # direction. To continue paginating in the same direction, provide the
3720
+ # returned `nextToken`. If you provide both `nextToken` and
3721
+ # `startFromHead`, the direction of the `nextToken` is used.
3722
+ #
3723
+ # <note markdown="1"> Setting `startFromHead` to `false` is supported only when `startTime`
3724
+ # is on or after `Jan 1, 2024 00:00:00 UTC`. A request with
3725
+ # `startFromHead` set to `false` and a `startTime` before this date
3726
+ # returns an `InvalidParameterException`.
3727
+ #
3728
+ # </note>
3729
+ #
3705
3730
  # @option params [Boolean] :interleaved
3706
3731
  # If the value is true, the operation attempts to provide responses that
3707
3732
  # contain events from multiple log streams within the log group,
@@ -3740,6 +3765,7 @@ module Aws::CloudWatchLogs
3740
3765
  # filter_pattern: "FilterPattern",
3741
3766
  # next_token: "NextToken",
3742
3767
  # limit: 1,
3768
+ # start_from_head: false,
3743
3769
  # interleaved: false,
3744
3770
  # unmask: false,
3745
3771
  # })
@@ -4651,7 +4677,9 @@ module Aws::CloudWatchLogs
4651
4677
  # You can retrieve up to 100,000 log event results from a query, if
4652
4678
  # available, by using pagination. Use the `nextToken` returned in the
4653
4679
  # response to request additional pages of results, with each page
4654
- # returning up to 10,000 log events.
4680
+ # returning up to 10,000 log events. This is only supported for Logs
4681
+ # Insights QL and is currently not supported for PPL and SQL query
4682
+ # languages.
4655
4683
  #
4656
4684
  # If you are using CloudWatch cross-account observability, you can use
4657
4685
  # this operation in a monitoring account to start queries in linked
@@ -4738,8 +4766,10 @@ module Aws::CloudWatchLogs
4738
4766
  # * {Types::GetScheduledQueryResponse#schedule_expression #schedule_expression} => String
4739
4767
  # * {Types::GetScheduledQueryResponse#timezone #timezone} => String
4740
4768
  # * {Types::GetScheduledQueryResponse#start_time_offset #start_time_offset} => Integer
4769
+ # * {Types::GetScheduledQueryResponse#end_time_offset #end_time_offset} => Integer
4741
4770
  # * {Types::GetScheduledQueryResponse#destination_configuration #destination_configuration} => Types::DestinationConfiguration
4742
4771
  # * {Types::GetScheduledQueryResponse#state #state} => String
4772
+ # * {Types::GetScheduledQueryResponse#schedule_type #schedule_type} => String
4743
4773
  # * {Types::GetScheduledQueryResponse#last_triggered_time #last_triggered_time} => Integer
4744
4774
  # * {Types::GetScheduledQueryResponse#last_execution_status #last_execution_status} => String
4745
4775
  # * {Types::GetScheduledQueryResponse#schedule_start_time #schedule_start_time} => Integer
@@ -4766,11 +4796,13 @@ module Aws::CloudWatchLogs
4766
4796
  # resp.schedule_expression #=> String
4767
4797
  # resp.timezone #=> String
4768
4798
  # resp.start_time_offset #=> Integer
4799
+ # resp.end_time_offset #=> Integer
4769
4800
  # resp.destination_configuration.s3_configuration.destination_identifier #=> String
4770
4801
  # resp.destination_configuration.s3_configuration.role_arn #=> String
4771
4802
  # resp.destination_configuration.s3_configuration.owner_account_id #=> String
4772
4803
  # resp.destination_configuration.s3_configuration.kms_key_id #=> String
4773
4804
  # resp.state #=> String, one of "ENABLED", "DISABLED"
4805
+ # resp.schedule_type #=> String, one of "CUSTOMER_MANAGED", "AWS_MANAGED"
4774
4806
  # resp.last_triggered_time #=> Integer
4775
4807
  # resp.last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
4776
4808
  # resp.schedule_start_time #=> Integer
@@ -5479,6 +5511,11 @@ module Aws::CloudWatchLogs
5479
5511
  # Filter scheduled queries by state. Valid values are `ENABLED` and
5480
5512
  # `DISABLED`. If not specified, all scheduled queries are returned.
5481
5513
  #
5514
+ # @option params [String] :schedule_type
5515
+ # Filter scheduled queries by schedule type. Valid values are
5516
+ # `CUSTOMER_MANAGED` and `AWS_MANAGED`. If not specified, scheduled
5517
+ # queries of all schedule types are returned.
5518
+ #
5482
5519
  # @return [Types::ListScheduledQueriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5483
5520
  #
5484
5521
  # * {Types::ListScheduledQueriesResponse#next_token #next_token} => String
@@ -5492,6 +5529,7 @@ module Aws::CloudWatchLogs
5492
5529
  # max_results: 1,
5493
5530
  # next_token: "NextToken",
5494
5531
  # state: "ENABLED", # accepts ENABLED, DISABLED
5532
+ # schedule_type: "CUSTOMER_MANAGED", # accepts CUSTOMER_MANAGED, AWS_MANAGED
5495
5533
  # })
5496
5534
  #
5497
5535
  # @example Response structure
@@ -5501,6 +5539,7 @@ module Aws::CloudWatchLogs
5501
5539
  # resp.scheduled_queries[0].scheduled_query_arn #=> String
5502
5540
  # resp.scheduled_queries[0].name #=> String
5503
5541
  # resp.scheduled_queries[0].state #=> String, one of "ENABLED", "DISABLED"
5542
+ # resp.scheduled_queries[0].schedule_type #=> String, one of "CUSTOMER_MANAGED", "AWS_MANAGED"
5504
5543
  # resp.scheduled_queries[0].last_triggered_time #=> Integer
5505
5544
  # resp.scheduled_queries[0].last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
5506
5545
  # resp.scheduled_queries[0].schedule_expression #=> String
@@ -8439,11 +8478,13 @@ module Aws::CloudWatchLogs
8439
8478
  # [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_QuerySyntax.html
8440
8479
  #
8441
8480
  # @option params [Integer] :limit
8442
- # The maximum number of log events to return in the query. If the query
8443
- # string uses the `fields` command, only the specified fields and their
8444
- # values are returned. The default is 10,000.
8445
- #
8446
- # The maximum value is 100,000.
8481
+ # The maximum number of log events to return from the query. The maximum
8482
+ # limit is 100,000. The maximum events returned in a single
8483
+ # GetQueryResults API call is 10,000 log events per request. You can
8484
+ # retrieve up to 100,000 log event results from a query by paginating
8485
+ # with the `nextToken`. 100,000 limit is only supported for Logs
8486
+ # Insights QL and is currently not supported for PPL and SQL query
8487
+ # languages.
8447
8488
  #
8448
8489
  # @return [Types::StartQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8449
8490
  #
@@ -9183,6 +9224,10 @@ module Aws::CloudWatchLogs
9183
9224
  # The updated time offset in seconds that defines the lookback period
9184
9225
  # for the query.
9185
9226
  #
9227
+ # @option params [Integer] :end_time_offset
9228
+ # The updated time offset in seconds that defines the end of the
9229
+ # lookback period for the query.
9230
+ #
9186
9231
  # @option params [Types::DestinationConfiguration] :destination_configuration
9187
9232
  # The updated configuration for where to deliver query results.
9188
9233
  #
@@ -9210,8 +9255,10 @@ module Aws::CloudWatchLogs
9210
9255
  # * {Types::UpdateScheduledQueryResponse#schedule_expression #schedule_expression} => String
9211
9256
  # * {Types::UpdateScheduledQueryResponse#timezone #timezone} => String
9212
9257
  # * {Types::UpdateScheduledQueryResponse#start_time_offset #start_time_offset} => Integer
9258
+ # * {Types::UpdateScheduledQueryResponse#end_time_offset #end_time_offset} => Integer
9213
9259
  # * {Types::UpdateScheduledQueryResponse#destination_configuration #destination_configuration} => Types::DestinationConfiguration
9214
9260
  # * {Types::UpdateScheduledQueryResponse#state #state} => String
9261
+ # * {Types::UpdateScheduledQueryResponse#schedule_type #schedule_type} => String
9215
9262
  # * {Types::UpdateScheduledQueryResponse#last_triggered_time #last_triggered_time} => Integer
9216
9263
  # * {Types::UpdateScheduledQueryResponse#last_execution_status #last_execution_status} => String
9217
9264
  # * {Types::UpdateScheduledQueryResponse#schedule_start_time #schedule_start_time} => Integer
@@ -9231,6 +9278,7 @@ module Aws::CloudWatchLogs
9231
9278
  # schedule_expression: "ScheduleExpression", # required
9232
9279
  # timezone: "ScheduleTimezone",
9233
9280
  # start_time_offset: 1,
9281
+ # end_time_offset: 1,
9234
9282
  # destination_configuration: {
9235
9283
  # s3_configuration: { # required
9236
9284
  # destination_identifier: "S3Uri", # required
@@ -9257,11 +9305,13 @@ module Aws::CloudWatchLogs
9257
9305
  # resp.schedule_expression #=> String
9258
9306
  # resp.timezone #=> String
9259
9307
  # resp.start_time_offset #=> Integer
9308
+ # resp.end_time_offset #=> Integer
9260
9309
  # resp.destination_configuration.s3_configuration.destination_identifier #=> String
9261
9310
  # resp.destination_configuration.s3_configuration.role_arn #=> String
9262
9311
  # resp.destination_configuration.s3_configuration.owner_account_id #=> String
9263
9312
  # resp.destination_configuration.s3_configuration.kms_key_id #=> String
9264
9313
  # resp.state #=> String, one of "ENABLED", "DISABLED"
9314
+ # resp.schedule_type #=> String, one of "CUSTOMER_MANAGED", "AWS_MANAGED"
9265
9315
  # resp.last_triggered_time #=> Integer
9266
9316
  # resp.last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
9267
9317
  # resp.schedule_start_time #=> Integer
@@ -9297,7 +9347,7 @@ module Aws::CloudWatchLogs
9297
9347
  tracer: tracer
9298
9348
  )
9299
9349
  context[:gem_name] = 'aws-sdk-cloudwatchlogs'
9300
- context[:gem_version] = '1.154.0'
9350
+ context[:gem_version] = '1.156.0'
9301
9351
  Seahorse::Client::Request.new(handlers, context)
9302
9352
  end
9303
9353
 
@@ -211,6 +211,7 @@ module Aws::CloudWatchLogs
211
211
  DynamicTokenPosition = Shapes::IntegerShape.new(name: 'DynamicTokenPosition')
212
212
  EmitSystemFields = Shapes::ListShape.new(name: 'EmitSystemFields')
213
213
  EncryptionKey = Shapes::StringShape.new(name: 'EncryptionKey')
214
+ EndTimeOffset = Shapes::IntegerShape.new(name: 'EndTimeOffset')
214
215
  Entity = Shapes::StructureShape.new(name: 'Entity')
215
216
  EntityAttributes = Shapes::MapShape.new(name: 'EntityAttributes')
216
217
  EntityAttributesKey = Shapes::StringShape.new(name: 'EntityAttributesKey')
@@ -578,6 +579,7 @@ module Aws::CloudWatchLogs
578
579
  S3Uri = Shapes::StringShape.new(name: 'S3Uri')
579
580
  ScheduleExpression = Shapes::StringShape.new(name: 'ScheduleExpression')
580
581
  ScheduleTimezone = Shapes::StringShape.new(name: 'ScheduleTimezone')
582
+ ScheduleType = Shapes::StringShape.new(name: 'ScheduleType')
581
583
  ScheduledQueryDescription = Shapes::StringShape.new(name: 'ScheduledQueryDescription')
582
584
  ScheduledQueryDestination = Shapes::StructureShape.new(name: 'ScheduledQueryDestination')
583
585
  ScheduledQueryDestinationList = Shapes::ListShape.new(name: 'ScheduledQueryDestinationList')
@@ -907,6 +909,7 @@ module Aws::CloudWatchLogs
907
909
  CreateScheduledQueryRequest.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpression, required: true, location_name: "scheduleExpression"))
908
910
  CreateScheduledQueryRequest.add_member(:timezone, Shapes::ShapeRef.new(shape: ScheduleTimezone, location_name: "timezone"))
909
911
  CreateScheduledQueryRequest.add_member(:start_time_offset, Shapes::ShapeRef.new(shape: StartTimeOffset, location_name: "startTimeOffset"))
912
+ CreateScheduledQueryRequest.add_member(:end_time_offset, Shapes::ShapeRef.new(shape: EndTimeOffset, location_name: "endTimeOffset"))
910
913
  CreateScheduledQueryRequest.add_member(:destination_configuration, Shapes::ShapeRef.new(shape: DestinationConfiguration, location_name: "destinationConfiguration"))
911
914
  CreateScheduledQueryRequest.add_member(:schedule_start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "scheduleStartTime"))
912
915
  CreateScheduledQueryRequest.add_member(:schedule_end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "scheduleEndTime"))
@@ -1370,6 +1373,7 @@ module Aws::CloudWatchLogs
1370
1373
  FilterLogEventsRequest.add_member(:filter_pattern, Shapes::ShapeRef.new(shape: FilterPattern, location_name: "filterPattern"))
1371
1374
  FilterLogEventsRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
1372
1375
  FilterLogEventsRequest.add_member(:limit, Shapes::ShapeRef.new(shape: EventsLimit, location_name: "limit"))
1376
+ FilterLogEventsRequest.add_member(:start_from_head, Shapes::ShapeRef.new(shape: StartFromHead, location_name: "startFromHead"))
1373
1377
  FilterLogEventsRequest.add_member(:interleaved, Shapes::ShapeRef.new(shape: Interleaved, deprecated: true, location_name: "interleaved", metadata: {"deprecatedMessage" => "Starting on June 17, 2019, this parameter will be ignored and the value will be assumed to be true. The response from this operation will always interleave events from multiple log streams within a log group."}))
1374
1378
  FilterLogEventsRequest.add_member(:unmask, Shapes::ShapeRef.new(shape: Unmask, location_name: "unmask"))
1375
1379
  FilterLogEventsRequest.struct_class = Types::FilterLogEventsRequest
@@ -1543,8 +1547,10 @@ module Aws::CloudWatchLogs
1543
1547
  GetScheduledQueryResponse.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpression, location_name: "scheduleExpression"))
1544
1548
  GetScheduledQueryResponse.add_member(:timezone, Shapes::ShapeRef.new(shape: ScheduleTimezone, location_name: "timezone"))
1545
1549
  GetScheduledQueryResponse.add_member(:start_time_offset, Shapes::ShapeRef.new(shape: StartTimeOffset, location_name: "startTimeOffset"))
1550
+ GetScheduledQueryResponse.add_member(:end_time_offset, Shapes::ShapeRef.new(shape: EndTimeOffset, location_name: "endTimeOffset"))
1546
1551
  GetScheduledQueryResponse.add_member(:destination_configuration, Shapes::ShapeRef.new(shape: DestinationConfiguration, location_name: "destinationConfiguration"))
1547
1552
  GetScheduledQueryResponse.add_member(:state, Shapes::ShapeRef.new(shape: ScheduledQueryState, location_name: "state"))
1553
+ GetScheduledQueryResponse.add_member(:schedule_type, Shapes::ShapeRef.new(shape: ScheduleType, location_name: "scheduleType"))
1548
1554
  GetScheduledQueryResponse.add_member(:last_triggered_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastTriggeredTime"))
1549
1555
  GetScheduledQueryResponse.add_member(:last_execution_status, Shapes::ShapeRef.new(shape: ExecutionStatus, location_name: "lastExecutionStatus"))
1550
1556
  GetScheduledQueryResponse.add_member(:schedule_start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "scheduleStartTime"))
@@ -1719,6 +1725,7 @@ module Aws::CloudWatchLogs
1719
1725
  ListScheduledQueriesRequest.add_member(:max_results, Shapes::ShapeRef.new(shape: ListScheduledQueriesMaxResults, location_name: "maxResults"))
1720
1726
  ListScheduledQueriesRequest.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
1721
1727
  ListScheduledQueriesRequest.add_member(:state, Shapes::ShapeRef.new(shape: ScheduledQueryState, location_name: "state"))
1728
+ ListScheduledQueriesRequest.add_member(:schedule_type, Shapes::ShapeRef.new(shape: ScheduleType, location_name: "scheduleType"))
1722
1729
  ListScheduledQueriesRequest.struct_class = Types::ListScheduledQueriesRequest
1723
1730
 
1724
1731
  ListScheduledQueriesResponse.add_member(:next_token, Shapes::ShapeRef.new(shape: NextToken, location_name: "nextToken"))
@@ -2336,6 +2343,7 @@ module Aws::CloudWatchLogs
2336
2343
  ScheduledQuerySummary.add_member(:scheduled_query_arn, Shapes::ShapeRef.new(shape: Arn, location_name: "scheduledQueryArn"))
2337
2344
  ScheduledQuerySummary.add_member(:name, Shapes::ShapeRef.new(shape: ScheduledQueryName, location_name: "name"))
2338
2345
  ScheduledQuerySummary.add_member(:state, Shapes::ShapeRef.new(shape: ScheduledQueryState, location_name: "state"))
2346
+ ScheduledQuerySummary.add_member(:schedule_type, Shapes::ShapeRef.new(shape: ScheduleType, location_name: "scheduleType"))
2339
2347
  ScheduledQuerySummary.add_member(:last_triggered_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastTriggeredTime"))
2340
2348
  ScheduledQuerySummary.add_member(:last_execution_status, Shapes::ShapeRef.new(shape: ExecutionStatus, location_name: "lastExecutionStatus"))
2341
2349
  ScheduledQuerySummary.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpression, location_name: "scheduleExpression"))
@@ -2564,6 +2572,7 @@ module Aws::CloudWatchLogs
2564
2572
  UpdateScheduledQueryRequest.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpression, required: true, location_name: "scheduleExpression"))
2565
2573
  UpdateScheduledQueryRequest.add_member(:timezone, Shapes::ShapeRef.new(shape: ScheduleTimezone, location_name: "timezone"))
2566
2574
  UpdateScheduledQueryRequest.add_member(:start_time_offset, Shapes::ShapeRef.new(shape: StartTimeOffset, location_name: "startTimeOffset"))
2575
+ UpdateScheduledQueryRequest.add_member(:end_time_offset, Shapes::ShapeRef.new(shape: EndTimeOffset, location_name: "endTimeOffset"))
2567
2576
  UpdateScheduledQueryRequest.add_member(:destination_configuration, Shapes::ShapeRef.new(shape: DestinationConfiguration, location_name: "destinationConfiguration"))
2568
2577
  UpdateScheduledQueryRequest.add_member(:schedule_start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "scheduleStartTime"))
2569
2578
  UpdateScheduledQueryRequest.add_member(:schedule_end_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "scheduleEndTime"))
@@ -2580,8 +2589,10 @@ module Aws::CloudWatchLogs
2580
2589
  UpdateScheduledQueryResponse.add_member(:schedule_expression, Shapes::ShapeRef.new(shape: ScheduleExpression, location_name: "scheduleExpression"))
2581
2590
  UpdateScheduledQueryResponse.add_member(:timezone, Shapes::ShapeRef.new(shape: ScheduleTimezone, location_name: "timezone"))
2582
2591
  UpdateScheduledQueryResponse.add_member(:start_time_offset, Shapes::ShapeRef.new(shape: StartTimeOffset, location_name: "startTimeOffset"))
2592
+ UpdateScheduledQueryResponse.add_member(:end_time_offset, Shapes::ShapeRef.new(shape: EndTimeOffset, location_name: "endTimeOffset"))
2583
2593
  UpdateScheduledQueryResponse.add_member(:destination_configuration, Shapes::ShapeRef.new(shape: DestinationConfiguration, location_name: "destinationConfiguration"))
2584
2594
  UpdateScheduledQueryResponse.add_member(:state, Shapes::ShapeRef.new(shape: ScheduledQueryState, location_name: "state"))
2595
+ UpdateScheduledQueryResponse.add_member(:schedule_type, Shapes::ShapeRef.new(shape: ScheduleType, location_name: "scheduleType"))
2585
2596
  UpdateScheduledQueryResponse.add_member(:last_triggered_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "lastTriggeredTime"))
2586
2597
  UpdateScheduledQueryResponse.add_member(:last_execution_status, Shapes::ShapeRef.new(shape: ExecutionStatus, location_name: "lastExecutionStatus"))
2587
2598
  UpdateScheduledQueryResponse.add_member(:schedule_start_time, Shapes::ShapeRef.new(shape: Timestamp, location_name: "scheduleStartTime"))
@@ -4112,6 +4123,7 @@ module Aws::CloudWatchLogs
4112
4123
  o.errors << Shapes::ShapeRef.new(shape: ValidationException)
4113
4124
  o.errors << Shapes::ShapeRef.new(shape: AccessDeniedException)
4114
4125
  o.errors << Shapes::ShapeRef.new(shape: ResourceNotFoundException)
4126
+ o.errors << Shapes::ShapeRef.new(shape: ConflictException)
4115
4127
  o.errors << Shapes::ShapeRef.new(shape: ThrottlingException)
4116
4128
  o.errors << Shapes::ShapeRef.new(shape: InternalServerException)
4117
4129
  end)
@@ -1205,9 +1205,7 @@ module Aws::CloudWatchLogs
1205
1205
 
1206
1206
  # @!attribute [rw] name
1207
1207
  # The name of the scheduled query. The name must be unique within your
1208
- # account and region. Valid characters are alphanumeric characters,
1209
- # hyphens, underscores, and periods. Length must be between 1 and 255
1210
- # characters.
1208
+ # account and region. Length must be between 1 and 300 characters.
1211
1209
  # @return [String]
1212
1210
  #
1213
1211
  # @!attribute [rw] description
@@ -1249,6 +1247,13 @@ module Aws::CloudWatchLogs
1249
1247
  # the execution time.
1250
1248
  # @return [Integer]
1251
1249
  #
1250
+ # @!attribute [rw] end_time_offset
1251
+ # The time offset in seconds that defines the end of the lookback
1252
+ # period for the query. Together with `startTimeOffset`, this
1253
+ # determines the time window relative to the execution time over which
1254
+ # the query runs.
1255
+ # @return [Integer]
1256
+ #
1252
1257
  # @!attribute [rw] destination_configuration
1253
1258
  # Configuration for where to deliver query results. Currently supports
1254
1259
  # Amazon S3 destinations for storing query output.
@@ -1292,6 +1297,7 @@ module Aws::CloudWatchLogs
1292
1297
  :schedule_expression,
1293
1298
  :timezone,
1294
1299
  :start_time_offset,
1300
+ :end_time_offset,
1295
1301
  :destination_configuration,
1296
1302
  :schedule_start_time,
1297
1303
  :schedule_end_time,
@@ -3566,6 +3572,25 @@ module Aws::CloudWatchLogs
3566
3572
  # events.
3567
3573
  # @return [Integer]
3568
3574
  #
3575
+ # @!attribute [rw] start_from_head
3576
+ # If the value is true, the earliest log events are returned first. If
3577
+ # the value is false, the latest log events are returned first. The
3578
+ # default value is true.
3579
+ #
3580
+ # The `startFromHead` parameter sets the sort direction on the first
3581
+ # request. On subsequent requests, the `nextToken` determines the sort
3582
+ # direction. To continue paginating in the same direction, provide the
3583
+ # returned `nextToken`. If you provide both `nextToken` and
3584
+ # `startFromHead`, the direction of the `nextToken` is used.
3585
+ #
3586
+ # <note markdown="1"> Setting `startFromHead` to `false` is supported only when
3587
+ # `startTime` is on or after `Jan 1, 2024 00:00:00 UTC`. A request
3588
+ # with `startFromHead` set to `false` and a `startTime` before this
3589
+ # date returns an `InvalidParameterException`.
3590
+ #
3591
+ # </note>
3592
+ # @return [Boolean]
3593
+ #
3569
3594
  # @!attribute [rw] interleaved
3570
3595
  # If the value is true, the operation attempts to provide responses
3571
3596
  # that contain events from multiple log streams within the log group,
@@ -3598,6 +3623,7 @@ module Aws::CloudWatchLogs
3598
3623
  :filter_pattern,
3599
3624
  :next_token,
3600
3625
  :limit,
3626
+ :start_from_head,
3601
3627
  :interleaved,
3602
3628
  :unmask)
3603
3629
  SENSITIVE = []
@@ -3617,8 +3643,9 @@ module Aws::CloudWatchLogs
3617
3643
  # @return [Array<Types::SearchedLogStream>]
3618
3644
  #
3619
3645
  # @!attribute [rw] next_token
3620
- # The token to use when requesting the next set of items. The token
3621
- # expires after 24 hours.
3646
+ # The token for the next set of items in the sorting direction
3647
+ # specified by the `startFromHead` parameter in the first request. The
3648
+ # token expires after 24 hours.
3622
3649
  #
3623
3650
  # If the results don't include a `nextToken`, then pagination is
3624
3651
  # finished.
@@ -4341,7 +4368,8 @@ module Aws::CloudWatchLogs
4341
4368
  # includes a `nextToken`. You can use this token in a subsequent
4342
4369
  # `GetQueryResults` request to get the next set of results. You can
4343
4370
  # retrieve up to 100,000 log event results from a query by paginating
4344
- # with this token.
4371
+ # with this token. This is only supported for Logs Insights QL and is
4372
+ # currently not supported for PPL and SQL query languages.
4345
4373
  # @return [String]
4346
4374
  #
4347
4375
  # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetQueryResultsResponse AWS API Documentation
@@ -4474,6 +4502,11 @@ module Aws::CloudWatchLogs
4474
4502
  # query.
4475
4503
  # @return [Integer]
4476
4504
  #
4505
+ # @!attribute [rw] end_time_offset
4506
+ # The time offset in seconds that defines the end of the lookback
4507
+ # period for the query.
4508
+ # @return [Integer]
4509
+ #
4477
4510
  # @!attribute [rw] destination_configuration
4478
4511
  # Configuration for where query results are delivered.
4479
4512
  # @return [Types::DestinationConfiguration]
@@ -4482,6 +4515,11 @@ module Aws::CloudWatchLogs
4482
4515
  # The current state of the scheduled query.
4483
4516
  # @return [String]
4484
4517
  #
4518
+ # @!attribute [rw] schedule_type
4519
+ # The schedule type of the scheduled query. Valid values are
4520
+ # `CUSTOMER_MANAGED` and `AWS_MANAGED`.
4521
+ # @return [String]
4522
+ #
4485
4523
  # @!attribute [rw] last_triggered_time
4486
4524
  # The timestamp when the scheduled query was last executed.
4487
4525
  # @return [Integer]
@@ -4523,8 +4561,10 @@ module Aws::CloudWatchLogs
4523
4561
  :schedule_expression,
4524
4562
  :timezone,
4525
4563
  :start_time_offset,
4564
+ :end_time_offset,
4526
4565
  :destination_configuration,
4527
4566
  :state,
4567
+ :schedule_type,
4528
4568
  :last_triggered_time,
4529
4569
  :last_execution_status,
4530
4570
  :schedule_start_time,
@@ -5346,12 +5386,19 @@ module Aws::CloudWatchLogs
5346
5386
  # `DISABLED`. If not specified, all scheduled queries are returned.
5347
5387
  # @return [String]
5348
5388
  #
5389
+ # @!attribute [rw] schedule_type
5390
+ # Filter scheduled queries by schedule type. Valid values are
5391
+ # `CUSTOMER_MANAGED` and `AWS_MANAGED`. If not specified, scheduled
5392
+ # queries of all schedule types are returned.
5393
+ # @return [String]
5394
+ #
5349
5395
  # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListScheduledQueriesRequest AWS API Documentation
5350
5396
  #
5351
5397
  class ListScheduledQueriesRequest < Struct.new(
5352
5398
  :max_results,
5353
5399
  :next_token,
5354
- :state)
5400
+ :state,
5401
+ :schedule_type)
5355
5402
  SENSITIVE = []
5356
5403
  include Aws::Structure
5357
5404
  end
@@ -9314,6 +9361,11 @@ module Aws::CloudWatchLogs
9314
9361
  # The current state of the scheduled query.
9315
9362
  # @return [String]
9316
9363
  #
9364
+ # @!attribute [rw] schedule_type
9365
+ # The schedule type of the scheduled query. Valid values are
9366
+ # `CUSTOMER_MANAGED` and `AWS_MANAGED`.
9367
+ # @return [String]
9368
+ #
9317
9369
  # @!attribute [rw] last_triggered_time
9318
9370
  # The timestamp when the scheduled query was last executed.
9319
9371
  # @return [Integer]
@@ -9348,6 +9400,7 @@ module Aws::CloudWatchLogs
9348
9400
  :scheduled_query_arn,
9349
9401
  :name,
9350
9402
  :state,
9403
+ :schedule_type,
9351
9404
  :last_triggered_time,
9352
9405
  :last_execution_status,
9353
9406
  :schedule_expression,
@@ -9626,11 +9679,13 @@ module Aws::CloudWatchLogs
9626
9679
  # @return [String]
9627
9680
  #
9628
9681
  # @!attribute [rw] limit
9629
- # The maximum number of log events to return in the query. If the
9630
- # query string uses the `fields` command, only the specified fields
9631
- # and their values are returned. The default is 10,000.
9632
- #
9633
- # The maximum value is 100,000.
9682
+ # The maximum number of log events to return from the query. The
9683
+ # maximum limit is 100,000. The maximum events returned in a single
9684
+ # GetQueryResults API call is 10,000 log events per request. You can
9685
+ # retrieve up to 100,000 log event results from a query by paginating
9686
+ # with the `nextToken`. 100,000 limit is only supported for Logs
9687
+ # Insights QL and is currently not supported for PPL and SQL query
9688
+ # languages.
9634
9689
  # @return [Integer]
9635
9690
  #
9636
9691
  # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/StartQueryRequest AWS API Documentation
@@ -10427,6 +10482,11 @@ module Aws::CloudWatchLogs
10427
10482
  # for the query.
10428
10483
  # @return [Integer]
10429
10484
  #
10485
+ # @!attribute [rw] end_time_offset
10486
+ # The updated time offset in seconds that defines the end of the
10487
+ # lookback period for the query.
10488
+ # @return [Integer]
10489
+ #
10430
10490
  # @!attribute [rw] destination_configuration
10431
10491
  # The updated configuration for where to deliver query results.
10432
10492
  # @return [Types::DestinationConfiguration]
@@ -10459,6 +10519,7 @@ module Aws::CloudWatchLogs
10459
10519
  :schedule_expression,
10460
10520
  :timezone,
10461
10521
  :start_time_offset,
10522
+ :end_time_offset,
10462
10523
  :destination_configuration,
10463
10524
  :schedule_start_time,
10464
10525
  :schedule_end_time,
@@ -10504,6 +10565,10 @@ module Aws::CloudWatchLogs
10504
10565
  # The time offset of the updated scheduled query.
10505
10566
  # @return [Integer]
10506
10567
  #
10568
+ # @!attribute [rw] end_time_offset
10569
+ # The end time offset in seconds of the updated scheduled query.
10570
+ # @return [Integer]
10571
+ #
10507
10572
  # @!attribute [rw] destination_configuration
10508
10573
  # The destination configuration of the updated scheduled query.
10509
10574
  # @return [Types::DestinationConfiguration]
@@ -10512,6 +10577,10 @@ module Aws::CloudWatchLogs
10512
10577
  # The state of the updated scheduled query.
10513
10578
  # @return [String]
10514
10579
  #
10580
+ # @!attribute [rw] schedule_type
10581
+ # The schedule type of the updated scheduled query.
10582
+ # @return [String]
10583
+ #
10515
10584
  # @!attribute [rw] last_triggered_time
10516
10585
  # The timestamp when the updated scheduled query was last executed.
10517
10586
  # @return [Integer]
@@ -10553,8 +10622,10 @@ module Aws::CloudWatchLogs
10553
10622
  :schedule_expression,
10554
10623
  :timezone,
10555
10624
  :start_time_offset,
10625
+ :end_time_offset,
10556
10626
  :destination_configuration,
10557
10627
  :state,
10628
+ :schedule_type,
10558
10629
  :last_triggered_time,
10559
10630
  :last_execution_status,
10560
10631
  :schedule_start_time,
@@ -55,7 +55,7 @@ module Aws::CloudWatchLogs
55
55
  autoload :Endpoints, 'aws-sdk-cloudwatchlogs/endpoints'
56
56
  autoload :EventStreams, 'aws-sdk-cloudwatchlogs/event_streams'
57
57
 
58
- GEM_VERSION = '1.154.0'
58
+ GEM_VERSION = '1.156.0'
59
59
 
60
60
  end
61
61
 
data/sig/client.rbs CHANGED
@@ -238,6 +238,7 @@ module Aws
238
238
  schedule_expression: ::String,
239
239
  ?timezone: ::String,
240
240
  ?start_time_offset: ::Integer,
241
+ ?end_time_offset: ::Integer,
241
242
  ?destination_configuration: Params::destination_configuration,
242
243
  ?schedule_start_time: ::Integer,
243
244
  ?schedule_end_time: ::Integer,
@@ -690,6 +691,7 @@ module Aws
690
691
  ?filter_pattern: ::String,
691
692
  ?next_token: ::String,
692
693
  ?limit: ::Integer,
694
+ ?start_from_head: bool,
693
695
  ?interleaved: bool,
694
696
  ?unmask: bool
695
697
  ) -> _FilterLogEventsResponseSuccess
@@ -887,8 +889,10 @@ module Aws
887
889
  def schedule_expression: () -> ::String
888
890
  def timezone: () -> ::String
889
891
  def start_time_offset: () -> ::Integer
892
+ def end_time_offset: () -> ::Integer
890
893
  def destination_configuration: () -> Types::DestinationConfiguration
891
894
  def state: () -> ("ENABLED" | "DISABLED")
895
+ def schedule_type: () -> ("CUSTOMER_MANAGED" | "AWS_MANAGED")
892
896
  def last_triggered_time: () -> ::Integer
893
897
  def last_execution_status: () -> ("Running" | "InvalidQuery" | "Complete" | "Failed" | "Timeout")
894
898
  def schedule_start_time: () -> ::Integer
@@ -1047,7 +1051,8 @@ module Aws
1047
1051
  def list_scheduled_queries: (
1048
1052
  ?max_results: ::Integer,
1049
1053
  ?next_token: ::String,
1050
- ?state: ("ENABLED" | "DISABLED")
1054
+ ?state: ("ENABLED" | "DISABLED"),
1055
+ ?schedule_type: ("CUSTOMER_MANAGED" | "AWS_MANAGED")
1051
1056
  ) -> _ListScheduledQueriesResponseSuccess
1052
1057
  | (?Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _ListScheduledQueriesResponseSuccess
1053
1058
 
@@ -1486,8 +1491,10 @@ module Aws
1486
1491
  def schedule_expression: () -> ::String
1487
1492
  def timezone: () -> ::String
1488
1493
  def start_time_offset: () -> ::Integer
1494
+ def end_time_offset: () -> ::Integer
1489
1495
  def destination_configuration: () -> Types::DestinationConfiguration
1490
1496
  def state: () -> ("ENABLED" | "DISABLED")
1497
+ def schedule_type: () -> ("CUSTOMER_MANAGED" | "AWS_MANAGED")
1491
1498
  def last_triggered_time: () -> ::Integer
1492
1499
  def last_execution_status: () -> ("Running" | "InvalidQuery" | "Complete" | "Failed" | "Timeout")
1493
1500
  def schedule_start_time: () -> ::Integer
@@ -1506,6 +1513,7 @@ module Aws
1506
1513
  schedule_expression: ::String,
1507
1514
  ?timezone: ::String,
1508
1515
  ?start_time_offset: ::Integer,
1516
+ ?end_time_offset: ::Integer,
1509
1517
  ?destination_configuration: Params::destination_configuration,
1510
1518
  ?schedule_start_time: ::Integer,
1511
1519
  ?schedule_end_time: ::Integer,
data/sig/types.rbs CHANGED
@@ -261,6 +261,7 @@ module Aws::CloudWatchLogs
261
261
  attr_accessor schedule_expression: ::String
262
262
  attr_accessor timezone: ::String
263
263
  attr_accessor start_time_offset: ::Integer
264
+ attr_accessor end_time_offset: ::Integer
264
265
  attr_accessor destination_configuration: Types::DestinationConfiguration
265
266
  attr_accessor schedule_start_time: ::Integer
266
267
  attr_accessor schedule_end_time: ::Integer
@@ -838,6 +839,7 @@ module Aws::CloudWatchLogs
838
839
  attr_accessor filter_pattern: ::String
839
840
  attr_accessor next_token: ::String
840
841
  attr_accessor limit: ::Integer
842
+ attr_accessor start_from_head: bool
841
843
  attr_accessor interleaved: bool
842
844
  attr_accessor unmask: bool
843
845
  SENSITIVE: []
@@ -1073,8 +1075,10 @@ module Aws::CloudWatchLogs
1073
1075
  attr_accessor schedule_expression: ::String
1074
1076
  attr_accessor timezone: ::String
1075
1077
  attr_accessor start_time_offset: ::Integer
1078
+ attr_accessor end_time_offset: ::Integer
1076
1079
  attr_accessor destination_configuration: Types::DestinationConfiguration
1077
1080
  attr_accessor state: ("ENABLED" | "DISABLED")
1081
+ attr_accessor schedule_type: ("CUSTOMER_MANAGED" | "AWS_MANAGED")
1078
1082
  attr_accessor last_triggered_time: ::Integer
1079
1083
  attr_accessor last_execution_status: ("Running" | "InvalidQuery" | "Complete" | "Failed" | "Timeout")
1080
1084
  attr_accessor schedule_start_time: ::Integer
@@ -1290,6 +1294,7 @@ module Aws::CloudWatchLogs
1290
1294
  attr_accessor max_results: ::Integer
1291
1295
  attr_accessor next_token: ::String
1292
1296
  attr_accessor state: ("ENABLED" | "DISABLED")
1297
+ attr_accessor schedule_type: ("CUSTOMER_MANAGED" | "AWS_MANAGED")
1293
1298
  SENSITIVE: []
1294
1299
  end
1295
1300
 
@@ -2040,6 +2045,7 @@ module Aws::CloudWatchLogs
2040
2045
  attr_accessor scheduled_query_arn: ::String
2041
2046
  attr_accessor name: ::String
2042
2047
  attr_accessor state: ("ENABLED" | "DISABLED")
2048
+ attr_accessor schedule_type: ("CUSTOMER_MANAGED" | "AWS_MANAGED")
2043
2049
  attr_accessor last_triggered_time: ::Integer
2044
2050
  attr_accessor last_execution_status: ("Running" | "InvalidQuery" | "Complete" | "Failed" | "Timeout")
2045
2051
  attr_accessor schedule_expression: ::String
@@ -2306,6 +2312,7 @@ module Aws::CloudWatchLogs
2306
2312
  attr_accessor schedule_expression: ::String
2307
2313
  attr_accessor timezone: ::String
2308
2314
  attr_accessor start_time_offset: ::Integer
2315
+ attr_accessor end_time_offset: ::Integer
2309
2316
  attr_accessor destination_configuration: Types::DestinationConfiguration
2310
2317
  attr_accessor schedule_start_time: ::Integer
2311
2318
  attr_accessor schedule_end_time: ::Integer
@@ -2324,8 +2331,10 @@ module Aws::CloudWatchLogs
2324
2331
  attr_accessor schedule_expression: ::String
2325
2332
  attr_accessor timezone: ::String
2326
2333
  attr_accessor start_time_offset: ::Integer
2334
+ attr_accessor end_time_offset: ::Integer
2327
2335
  attr_accessor destination_configuration: Types::DestinationConfiguration
2328
2336
  attr_accessor state: ("ENABLED" | "DISABLED")
2337
+ attr_accessor schedule_type: ("CUSTOMER_MANAGED" | "AWS_MANAGED")
2329
2338
  attr_accessor last_triggered_time: ::Integer
2330
2339
  attr_accessor last_execution_status: ("Running" | "InvalidQuery" | "Complete" | "Failed" | "Timeout")
2331
2340
  attr_accessor schedule_start_time: ::Integer
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-cloudwatchlogs
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.154.0
4
+ version: 1.156.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services