aws-sdk-cloudwatchlogs 1.129.0 → 1.130.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: f1a04e4091a31adeacec853ee6526bb0c15e275a852e1c925d1c2895f8b7ef4c
4
- data.tar.gz: b836e126e00a462df37cd4c02356ddee36f21c1a2a1d952af3d0da09f6311891
3
+ metadata.gz: 7aadb87d48aab5848e28e8440ea5d1e9003b79b70195f167ab1fc6bb0a6ee14f
4
+ data.tar.gz: 42ce2a1fb38fd04d0bdae84eeb0dfe8310f37b8e3bf720e87778a9a2c4109fb1
5
5
  SHA512:
6
- metadata.gz: 8c8428418aae6f51cb673325a4e6a166743e8c25b4b3c6b5f0b31c76e03ce0b425738b02706a78b67e15c2595edcc7af17d6c6ae9943e1178b5ff15d6aa6d9e1
7
- data.tar.gz: aac4847d622f7df651b4acf6bafefb10f67041e2c4509c80f430e7161dd842150b12e3a0fa456c8264baf02a24b365f058d49ac18b4def47c1ede91e34dfed5b
6
+ metadata.gz: ad9cb3bbb4101db9cca3751c6dfcc247ad45d3da7debdf467eb2b6bd50a688881a758d4030f1432af65f565dcce35d3438681e3930d3d6dd8b6e553cafd72b66
7
+ data.tar.gz: 4271ed283f83c94737db597fd3aa5805c24aca3c178ff7f3dd0e29c249204b6b5955077052ed1013962aeebd552cbeee2efd140ca633ebd01f63fe5f6a14c996
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.130.0 (2025-11-18)
5
+ ------------------
6
+
7
+ * Feature - CloudWatch Logs updates: Added capability to setup a recurring schedule for log insights queries. Logs introduced Scheduled Queries (managed through Create/Update/Get/Delete/List/History Scheduled Query APIs). For more information, see CloudWatch Logs API documentation.
8
+
4
9
  1.129.0 (2025-10-31)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.129.0
1
+ 1.130.0
@@ -1155,6 +1155,128 @@ module Aws::CloudWatchLogs
1155
1155
  req.send_request(options)
1156
1156
  end
1157
1157
 
1158
+ # Creates a new Scheduled Query that runs CloudWatch Logs Insights
1159
+ # queries on a schedule and delivers results to specified destinations.
1160
+ #
1161
+ # @option params [required, String] :name
1162
+ # A unique name for the scheduled query within the region for an AWS
1163
+ # account. The name can contain letters, numbers, underscores, hyphens,
1164
+ # forward slashes, periods, and hash symbols.
1165
+ #
1166
+ # @option params [String] :description
1167
+ # An optional description for the scheduled query to help identify its
1168
+ # purpose.
1169
+ #
1170
+ # @option params [required, String] :query_language
1171
+ # The query language to use for the scheduled query. Valid values are
1172
+ # LogsQL (CloudWatch Logs Insights query language), PPL (OpenSearch
1173
+ # Service Piped Processing Language), and SQL (OpenSearch Service
1174
+ # Structured Query Language).
1175
+ #
1176
+ # @option params [required, String] :query_string
1177
+ # The CloudWatch Logs Insights query string to execute. This is the
1178
+ # actual query that will be run against your log data on the specified
1179
+ # schedule.
1180
+ #
1181
+ # @option params [Array<String>] :log_group_identifiers
1182
+ # The log group identifiers to query. You can specify log group names or
1183
+ # log group ARNs. If querying log groups in a source account from a
1184
+ # monitoring account, you must specify the ARN of the log group.
1185
+ #
1186
+ # @option params [required, String] :schedule_expression
1187
+ # A cron expression that defines when the scheduled query runs. The
1188
+ # format is cron(fields) where fields consist of six space-separated
1189
+ # values: minutes, hours, day\_of\_month, month, day\_of\_week, year.
1190
+ #
1191
+ # @option params [String] :timezone
1192
+ # The timezone in which the schedule expression is evaluated. If not
1193
+ # provided, defaults to UTC.
1194
+ #
1195
+ # @option params [Integer] :start_time_offset
1196
+ # Time offset in seconds from the execution time for the start of the
1197
+ # query time range. This defines the lookback period for the query (for
1198
+ # example, 3600 for the last hour).
1199
+ #
1200
+ # @option params [Types::DestinationConfiguration] :destination_configuration
1201
+ # Configuration for destinations where the query results will be
1202
+ # delivered after successful execution. You can configure delivery to S3
1203
+ # buckets or EventBridge event buses.
1204
+ #
1205
+ # @option params [Integer] :schedule_start_time
1206
+ # The start time for the query schedule in Unix epoch time (seconds
1207
+ # since January 1, 1970, 00:00:00 UTC). If not specified, the schedule
1208
+ # starts immediately.
1209
+ #
1210
+ # @option params [Integer] :schedule_end_time
1211
+ # The end time for the query schedule in Unix epoch time (seconds since
1212
+ # January 1, 1970, 00:00:00 UTC). If not specified, the schedule runs
1213
+ # indefinitely.
1214
+ #
1215
+ # @option params [required, String] :execution_role_arn
1216
+ # The Amazon Resource Name (ARN) of the IAM role that CloudWatch Logs
1217
+ # will assume to execute the scheduled query and deliver results to the
1218
+ # specified destinations.
1219
+ #
1220
+ # @option params [String] :state
1221
+ # The initial state of the scheduled query. Valid values are ENABLED
1222
+ # (the query will run according to its schedule) and DISABLED (the query
1223
+ # is paused and will not run). If not provided, defaults to ENABLED.
1224
+ #
1225
+ # @option params [Hash<String,String>] :tags
1226
+ # An optional list of key-value pairs to associate with the resource.
1227
+ #
1228
+ # For more information about tagging, see [Tagging Amazon Web Services
1229
+ # resources][1]
1230
+ #
1231
+ #
1232
+ #
1233
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/aws_tagging.html
1234
+ #
1235
+ # @return [Types::CreateScheduledQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1236
+ #
1237
+ # * {Types::CreateScheduledQueryResponse#scheduled_query_arn #scheduled_query_arn} => String
1238
+ # * {Types::CreateScheduledQueryResponse#state #state} => String
1239
+ #
1240
+ # @example Request syntax with placeholder values
1241
+ #
1242
+ # resp = client.create_scheduled_query({
1243
+ # name: "ScheduledQueryName", # required
1244
+ # description: "ScheduledQueryDescription",
1245
+ # query_language: "CWLI", # required, accepts CWLI, SQL, PPL
1246
+ # query_string: "QueryString", # required
1247
+ # log_group_identifiers: ["LogGroupIdentifier"],
1248
+ # schedule_expression: "ScheduleExpression", # required
1249
+ # timezone: "ScheduleTimezone",
1250
+ # start_time_offset: 1,
1251
+ # destination_configuration: {
1252
+ # s3_configuration: { # required
1253
+ # destination_identifier: "S3Uri", # required
1254
+ # role_arn: "RoleArn", # required
1255
+ # },
1256
+ # },
1257
+ # schedule_start_time: 1,
1258
+ # schedule_end_time: 1,
1259
+ # execution_role_arn: "RoleArn", # required
1260
+ # state: "ENABLED", # accepts ENABLED, DISABLED
1261
+ # tags: {
1262
+ # "TagKey" => "TagValue",
1263
+ # },
1264
+ # })
1265
+ #
1266
+ # @example Response structure
1267
+ #
1268
+ # resp.scheduled_query_arn #=> String
1269
+ # resp.state #=> String, one of "ENABLED", "DISABLED"
1270
+ #
1271
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/CreateScheduledQuery AWS API Documentation
1272
+ #
1273
+ # @overload create_scheduled_query(params = {})
1274
+ # @param [Hash] params ({})
1275
+ def create_scheduled_query(params = {}, options = {})
1276
+ req = build_request(:create_scheduled_query, params)
1277
+ req.send_request(options)
1278
+ end
1279
+
1158
1280
  # Deletes a CloudWatch Logs account policy. This stops the account-wide
1159
1281
  # policy from applying to log groups in the account. If you delete a
1160
1282
  # data protection policy or subscription filter policy, any log-group
@@ -1669,6 +1791,30 @@ module Aws::CloudWatchLogs
1669
1791
  req.send_request(options)
1670
1792
  end
1671
1793
 
1794
+ # Deletes an existing scheduled query and all its associated
1795
+ # configurations. This operation permanently removes the scheduled query
1796
+ # and cannot be undone.
1797
+ #
1798
+ # @option params [required, String] :identifier
1799
+ # The name or ARN of the scheduled query to delete.
1800
+ #
1801
+ # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1802
+ #
1803
+ # @example Request syntax with placeholder values
1804
+ #
1805
+ # resp = client.delete_scheduled_query({
1806
+ # identifier: "ScheduledQueryIdentifier", # required
1807
+ # })
1808
+ #
1809
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DeleteScheduledQuery AWS API Documentation
1810
+ #
1811
+ # @overload delete_scheduled_query(params = {})
1812
+ # @param [Hash] params ({})
1813
+ def delete_scheduled_query(params = {}, options = {})
1814
+ req = build_request(:delete_scheduled_query, params)
1815
+ req.send_request(options)
1816
+ end
1817
+
1672
1818
  # Deletes the specified subscription filter.
1673
1819
  #
1674
1820
  # @option params [required, String] :log_group_name
@@ -3937,6 +4083,141 @@ module Aws::CloudWatchLogs
3937
4083
  req.send_request(options)
3938
4084
  end
3939
4085
 
4086
+ # Returns detailed information about a specified scheduled query,
4087
+ # including its configuration, current state, and execution history.
4088
+ #
4089
+ # @option params [required, String] :identifier
4090
+ # The name or ARN of the scheduled query to retrieve.
4091
+ #
4092
+ # @return [Types::GetScheduledQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4093
+ #
4094
+ # * {Types::GetScheduledQueryResponse#scheduled_query_arn #scheduled_query_arn} => String
4095
+ # * {Types::GetScheduledQueryResponse#name #name} => String
4096
+ # * {Types::GetScheduledQueryResponse#description #description} => String
4097
+ # * {Types::GetScheduledQueryResponse#query_language #query_language} => String
4098
+ # * {Types::GetScheduledQueryResponse#query_string #query_string} => String
4099
+ # * {Types::GetScheduledQueryResponse#log_group_identifiers #log_group_identifiers} => Array&lt;String&gt;
4100
+ # * {Types::GetScheduledQueryResponse#schedule_expression #schedule_expression} => String
4101
+ # * {Types::GetScheduledQueryResponse#timezone #timezone} => String
4102
+ # * {Types::GetScheduledQueryResponse#start_time_offset #start_time_offset} => Integer
4103
+ # * {Types::GetScheduledQueryResponse#destination_configuration #destination_configuration} => Types::DestinationConfiguration
4104
+ # * {Types::GetScheduledQueryResponse#state #state} => String
4105
+ # * {Types::GetScheduledQueryResponse#last_triggered_time #last_triggered_time} => Integer
4106
+ # * {Types::GetScheduledQueryResponse#last_execution_status #last_execution_status} => String
4107
+ # * {Types::GetScheduledQueryResponse#schedule_start_time #schedule_start_time} => Integer
4108
+ # * {Types::GetScheduledQueryResponse#schedule_end_time #schedule_end_time} => Integer
4109
+ # * {Types::GetScheduledQueryResponse#execution_role_arn #execution_role_arn} => String
4110
+ # * {Types::GetScheduledQueryResponse#creation_time #creation_time} => Integer
4111
+ # * {Types::GetScheduledQueryResponse#last_updated_time #last_updated_time} => Integer
4112
+ #
4113
+ # @example Request syntax with placeholder values
4114
+ #
4115
+ # resp = client.get_scheduled_query({
4116
+ # identifier: "ScheduledQueryIdentifier", # required
4117
+ # })
4118
+ #
4119
+ # @example Response structure
4120
+ #
4121
+ # resp.scheduled_query_arn #=> String
4122
+ # resp.name #=> String
4123
+ # resp.description #=> String
4124
+ # resp.query_language #=> String, one of "CWLI", "SQL", "PPL"
4125
+ # resp.query_string #=> String
4126
+ # resp.log_group_identifiers #=> Array
4127
+ # resp.log_group_identifiers[0] #=> String
4128
+ # resp.schedule_expression #=> String
4129
+ # resp.timezone #=> String
4130
+ # resp.start_time_offset #=> Integer
4131
+ # resp.destination_configuration.s3_configuration.destination_identifier #=> String
4132
+ # resp.destination_configuration.s3_configuration.role_arn #=> String
4133
+ # resp.state #=> String, one of "ENABLED", "DISABLED"
4134
+ # resp.last_triggered_time #=> Integer
4135
+ # resp.last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
4136
+ # resp.schedule_start_time #=> Integer
4137
+ # resp.schedule_end_time #=> Integer
4138
+ # resp.execution_role_arn #=> String
4139
+ # resp.creation_time #=> Integer
4140
+ # resp.last_updated_time #=> Integer
4141
+ #
4142
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetScheduledQuery AWS API Documentation
4143
+ #
4144
+ # @overload get_scheduled_query(params = {})
4145
+ # @param [Hash] params ({})
4146
+ def get_scheduled_query(params = {}, options = {})
4147
+ req = build_request(:get_scheduled_query, params)
4148
+ req.send_request(options)
4149
+ end
4150
+
4151
+ # Retrieves the execution history of a scheduled query within a
4152
+ # specified time range, including execution status and destination
4153
+ # processing metadata.
4154
+ #
4155
+ # @option params [required, String] :identifier
4156
+ # The name or ARN of the scheduled query to retrieve history for.
4157
+ #
4158
+ # @option params [required, Integer] :start_time
4159
+ # The start time for the history retrieval window in Unix epoch time.
4160
+ #
4161
+ # @option params [required, Integer] :end_time
4162
+ # The end time for the history retrieval window in Unix epoch time.
4163
+ #
4164
+ # @option params [Array<String>] :execution_statuses
4165
+ # Filter results by execution status (Running, Complete, Failed,
4166
+ # Timeout, or InvalidQuery).
4167
+ #
4168
+ # @option params [Integer] :max_results
4169
+ # The maximum number of history records to return in a single call.
4170
+ #
4171
+ # @option params [String] :next_token
4172
+ # The token for the next set of items to return. The token expires after
4173
+ # 24 hours.
4174
+ #
4175
+ # @return [Types::GetScheduledQueryHistoryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4176
+ #
4177
+ # * {Types::GetScheduledQueryHistoryResponse#name #name} => String
4178
+ # * {Types::GetScheduledQueryHistoryResponse#scheduled_query_arn #scheduled_query_arn} => String
4179
+ # * {Types::GetScheduledQueryHistoryResponse#trigger_history #trigger_history} => Array&lt;Types::TriggerHistoryRecord&gt;
4180
+ # * {Types::GetScheduledQueryHistoryResponse#next_token #next_token} => String
4181
+ #
4182
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4183
+ #
4184
+ # @example Request syntax with placeholder values
4185
+ #
4186
+ # resp = client.get_scheduled_query_history({
4187
+ # identifier: "ScheduledQueryIdentifier", # required
4188
+ # start_time: 1, # required
4189
+ # end_time: 1, # required
4190
+ # execution_statuses: ["Running"], # accepts Running, InvalidQuery, Complete, Failed, Timeout
4191
+ # max_results: 1,
4192
+ # next_token: "NextToken",
4193
+ # })
4194
+ #
4195
+ # @example Response structure
4196
+ #
4197
+ # resp.name #=> String
4198
+ # resp.scheduled_query_arn #=> String
4199
+ # resp.trigger_history #=> Array
4200
+ # resp.trigger_history[0].query_id #=> String
4201
+ # resp.trigger_history[0].execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
4202
+ # resp.trigger_history[0].triggered_timestamp #=> Integer
4203
+ # resp.trigger_history[0].error_message #=> String
4204
+ # resp.trigger_history[0].destinations #=> Array
4205
+ # resp.trigger_history[0].destinations[0].destination_type #=> String, one of "S3"
4206
+ # resp.trigger_history[0].destinations[0].destination_identifier #=> String
4207
+ # resp.trigger_history[0].destinations[0].status #=> String, one of "IN_PROGRESS", "CLIENT_ERROR", "FAILED", "COMPLETE"
4208
+ # resp.trigger_history[0].destinations[0].processed_identifier #=> String
4209
+ # resp.trigger_history[0].destinations[0].error_message #=> String
4210
+ # resp.next_token #=> String
4211
+ #
4212
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/GetScheduledQueryHistory AWS API Documentation
4213
+ #
4214
+ # @overload get_scheduled_query_history(params = {})
4215
+ # @param [Hash] params ({})
4216
+ def get_scheduled_query_history(params = {}, options = {})
4217
+ req = build_request(:get_scheduled_query_history, params)
4218
+ req.send_request(options)
4219
+ end
4220
+
3940
4221
  # Returns the information about the log transformer associated with this
3941
4222
  # log group.
3942
4223
  #
@@ -4391,6 +4672,60 @@ module Aws::CloudWatchLogs
4391
4672
  req.send_request(options)
4392
4673
  end
4393
4674
 
4675
+ # Lists all scheduled queries in the current AWS account and region with
4676
+ # optional filtering by state.
4677
+ #
4678
+ # @option params [Integer] :max_results
4679
+ # The maximum number of scheduled queries to return in a single call.
4680
+ #
4681
+ # @option params [String] :next_token
4682
+ # The token for the next set of items to return. The token expires after
4683
+ # 24 hours.
4684
+ #
4685
+ # @option params [String] :state
4686
+ # Filter results by the state of scheduled queries (ENABLED or
4687
+ # DISABLED).
4688
+ #
4689
+ # @return [Types::ListScheduledQueriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4690
+ #
4691
+ # * {Types::ListScheduledQueriesResponse#next_token #next_token} => String
4692
+ # * {Types::ListScheduledQueriesResponse#scheduled_queries #scheduled_queries} => Array&lt;Types::ScheduledQuerySummary&gt;
4693
+ #
4694
+ # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
4695
+ #
4696
+ # @example Request syntax with placeholder values
4697
+ #
4698
+ # resp = client.list_scheduled_queries({
4699
+ # max_results: 1,
4700
+ # next_token: "NextToken",
4701
+ # state: "ENABLED", # accepts ENABLED, DISABLED
4702
+ # })
4703
+ #
4704
+ # @example Response structure
4705
+ #
4706
+ # resp.next_token #=> String
4707
+ # resp.scheduled_queries #=> Array
4708
+ # resp.scheduled_queries[0].scheduled_query_arn #=> String
4709
+ # resp.scheduled_queries[0].name #=> String
4710
+ # resp.scheduled_queries[0].state #=> String, one of "ENABLED", "DISABLED"
4711
+ # resp.scheduled_queries[0].last_triggered_time #=> Integer
4712
+ # resp.scheduled_queries[0].last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
4713
+ # resp.scheduled_queries[0].schedule_expression #=> String
4714
+ # resp.scheduled_queries[0].timezone #=> String
4715
+ # resp.scheduled_queries[0].destination_configuration.s3_configuration.destination_identifier #=> String
4716
+ # resp.scheduled_queries[0].destination_configuration.s3_configuration.role_arn #=> String
4717
+ # resp.scheduled_queries[0].creation_time #=> Integer
4718
+ # resp.scheduled_queries[0].last_updated_time #=> Integer
4719
+ #
4720
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListScheduledQueries AWS API Documentation
4721
+ #
4722
+ # @overload list_scheduled_queries(params = {})
4723
+ # @param [Hash] params ({})
4724
+ def list_scheduled_queries(params = {}, options = {})
4725
+ req = build_request(:list_scheduled_queries, params)
4726
+ req.send_request(options)
4727
+ end
4728
+
4394
4729
  # Displays the tags associated with a CloudWatch Logs resource.
4395
4730
  # Currently, log groups and destinations support tagging.
4396
4731
  #
@@ -4614,6 +4949,8 @@ module Aws::CloudWatchLogs
4614
4949
  # the Standard log class. Default field indexes are automatically
4615
4950
  # available for the following fields:
4616
4951
  #
4952
+ # * `@logStream`
4953
+ #
4617
4954
  # * `@aws.region`
4618
4955
  #
4619
4956
  # * `@aws.account`
@@ -5295,8 +5632,23 @@ module Aws::CloudWatchLogs
5295
5632
  # @option params [required, String] :log_type
5296
5633
  # Defines the type of log that the source is sending.
5297
5634
  #
5298
- # * For Amazon Bedrock, the valid value is `APPLICATION_LOGS` and
5299
- # `TRACES`.
5635
+ # * For Amazon Bedrock Agents, the valid values are `APPLICATION_LOGS`
5636
+ # and `EVENT_LOGS`.
5637
+ #
5638
+ # * For Amazon Bedrock Knowledge Bases, the valid value is
5639
+ # `APPLICATION_LOGS`.
5640
+ #
5641
+ # * For Amazon Bedrock AgentCore Runtime, the valid values are
5642
+ # `APPLICATION_LOGS`, `USAGE_LOGS` and `TRACES`.
5643
+ #
5644
+ # * For Amazon Bedrock AgentCore Tools, the valid values are
5645
+ # `APPLICATION_LOGS`, `USAGE_LOGS` and `TRACES`.
5646
+ #
5647
+ # * For Amazon Bedrock AgentCore Identity, the valid values are
5648
+ # `APPLICATION_LOGS` and `TRACES`.
5649
+ #
5650
+ # * For Amazon Bedrock AgentCore Gateway, the valid values are
5651
+ # `APPLICATION_LOGS` and `TRACES`.
5300
5652
  #
5301
5653
  # * For CloudFront, the valid value is `ACCESS_LOGS`.
5302
5654
  #
@@ -5316,9 +5668,9 @@ module Aws::CloudWatchLogs
5316
5668
  # * For PCS, the valid values are `PCS_SCHEDULER_LOGS` and
5317
5669
  # `PCS_JOBCOMP_LOGS`.
5318
5670
  #
5319
- # * For Amazon Q, the valid value is `EVENT_LOGS`.
5671
+ # * For Amazon Q, the valid values are `EVENT_LOGS` and `SYNC_JOB_LOGS`.
5320
5672
  #
5321
- # * For Amazon SES mail manager, the valid values are `APPLICATION_LOG`
5673
+ # * For Amazon SES mail manager, the valid values are `APPLICATION_LOGS`
5322
5674
  # and `TRAFFIC_POLICY_DEBUG_LOGS`.
5323
5675
  #
5324
5676
  # * For Amazon WorkMail, the valid values are `ACCESS_CONTROL_LOGS`,
@@ -5533,6 +5885,8 @@ module Aws::CloudWatchLogs
5533
5885
  # the Standard log class. Default field indexes are automatically
5534
5886
  # available for the following fields:
5535
5887
  #
5888
+ # * `@logStream`
5889
+ #
5536
5890
  # * `@aws.region`
5537
5891
  #
5538
5892
  # * `@aws.account`
@@ -6018,8 +6372,22 @@ module Aws::CloudWatchLogs
6018
6372
 
6019
6373
  # Creates or updates a resource policy allowing other Amazon Web
6020
6374
  # Services services to put log events to this account, such as Amazon
6021
- # Route 53. An account can have up to 10 resource policies per Amazon
6022
- # Web Services Region.
6375
+ # Route 53. This API has the following restrictions:
6376
+ #
6377
+ # * **Supported actions** - Policy only supports `logs:PutLogEvents` and
6378
+ # `logs:CreateLogStream ` actions
6379
+ #
6380
+ # * **Supported principals** - Policy only applies when operations are
6381
+ # invoked by Amazon Web Services service principals (not IAM users,
6382
+ # roles, or cross-account principals
6383
+ #
6384
+ # * **Policy limits** - An account can have a maximum of 10 policies
6385
+ # without resourceARN and one per LogGroup resourceARN
6386
+ #
6387
+ # Resource policies with actions invoked by non-Amazon Web Services
6388
+ # service principals (such as IAM users, roles, or other Amazon Web
6389
+ # Services accounts) will not be enforced. For access control involving
6390
+ # these principals, use the IAM policies.
6023
6391
  #
6024
6392
  # @option params [String] :policy_name
6025
6393
  # Name of the new policy. This parameter is required.
@@ -7591,6 +7959,128 @@ module Aws::CloudWatchLogs
7591
7959
  req.send_request(options)
7592
7960
  end
7593
7961
 
7962
+ # Updates the configuration of an existing scheduled query. This
7963
+ # operation follows PUT semantics, replacing the existing configuration
7964
+ # with the provided values.
7965
+ #
7966
+ # @option params [required, String] :identifier
7967
+ # The name or ARN of the scheduled query to update.
7968
+ #
7969
+ # @option params [String] :description
7970
+ # Updated description for the scheduled query.
7971
+ #
7972
+ # @option params [required, String] :query_language
7973
+ # Updated query language to use (LogsQL, PPL, or SQL).
7974
+ #
7975
+ # @option params [required, String] :query_string
7976
+ # Updated CloudWatch Logs Insights query string to execute.
7977
+ #
7978
+ # @option params [Array<String>] :log_group_identifiers
7979
+ # Updated log group identifiers to query.
7980
+ #
7981
+ # @option params [required, String] :schedule_expression
7982
+ # Updated cron expression that defines when the scheduled query runs.
7983
+ #
7984
+ # @option params [String] :timezone
7985
+ # Updated timezone in which the schedule expression is evaluated.
7986
+ #
7987
+ # @option params [Integer] :start_time_offset
7988
+ # Updated time offset in seconds from the execution time for the start
7989
+ # of the query time range.
7990
+ #
7991
+ # @option params [Types::DestinationConfiguration] :destination_configuration
7992
+ # Updated configuration for destinations where the query results will be
7993
+ # delivered.
7994
+ #
7995
+ # @option params [Integer] :schedule_start_time
7996
+ # Updated start time for the query schedule in Unix epoch time.
7997
+ #
7998
+ # @option params [Integer] :schedule_end_time
7999
+ # Updated end time for the query schedule in Unix epoch time.
8000
+ #
8001
+ # @option params [required, String] :execution_role_arn
8002
+ # Updated ARN of the IAM role that CloudWatch Logs will assume to
8003
+ # execute the scheduled query.
8004
+ #
8005
+ # @option params [String] :state
8006
+ # Updated state of the scheduled query (ENABLED or DISABLED).
8007
+ #
8008
+ # @return [Types::UpdateScheduledQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8009
+ #
8010
+ # * {Types::UpdateScheduledQueryResponse#scheduled_query_arn #scheduled_query_arn} => String
8011
+ # * {Types::UpdateScheduledQueryResponse#name #name} => String
8012
+ # * {Types::UpdateScheduledQueryResponse#description #description} => String
8013
+ # * {Types::UpdateScheduledQueryResponse#query_language #query_language} => String
8014
+ # * {Types::UpdateScheduledQueryResponse#query_string #query_string} => String
8015
+ # * {Types::UpdateScheduledQueryResponse#log_group_identifiers #log_group_identifiers} => Array&lt;String&gt;
8016
+ # * {Types::UpdateScheduledQueryResponse#schedule_expression #schedule_expression} => String
8017
+ # * {Types::UpdateScheduledQueryResponse#timezone #timezone} => String
8018
+ # * {Types::UpdateScheduledQueryResponse#start_time_offset #start_time_offset} => Integer
8019
+ # * {Types::UpdateScheduledQueryResponse#destination_configuration #destination_configuration} => Types::DestinationConfiguration
8020
+ # * {Types::UpdateScheduledQueryResponse#state #state} => String
8021
+ # * {Types::UpdateScheduledQueryResponse#last_triggered_time #last_triggered_time} => Integer
8022
+ # * {Types::UpdateScheduledQueryResponse#last_execution_status #last_execution_status} => String
8023
+ # * {Types::UpdateScheduledQueryResponse#schedule_start_time #schedule_start_time} => Integer
8024
+ # * {Types::UpdateScheduledQueryResponse#schedule_end_time #schedule_end_time} => Integer
8025
+ # * {Types::UpdateScheduledQueryResponse#execution_role_arn #execution_role_arn} => String
8026
+ # * {Types::UpdateScheduledQueryResponse#creation_time #creation_time} => Integer
8027
+ # * {Types::UpdateScheduledQueryResponse#last_updated_time #last_updated_time} => Integer
8028
+ #
8029
+ # @example Request syntax with placeholder values
8030
+ #
8031
+ # resp = client.update_scheduled_query({
8032
+ # identifier: "ScheduledQueryIdentifier", # required
8033
+ # description: "ScheduledQueryDescription",
8034
+ # query_language: "CWLI", # required, accepts CWLI, SQL, PPL
8035
+ # query_string: "QueryString", # required
8036
+ # log_group_identifiers: ["LogGroupIdentifier"],
8037
+ # schedule_expression: "ScheduleExpression", # required
8038
+ # timezone: "ScheduleTimezone",
8039
+ # start_time_offset: 1,
8040
+ # destination_configuration: {
8041
+ # s3_configuration: { # required
8042
+ # destination_identifier: "S3Uri", # required
8043
+ # role_arn: "RoleArn", # required
8044
+ # },
8045
+ # },
8046
+ # schedule_start_time: 1,
8047
+ # schedule_end_time: 1,
8048
+ # execution_role_arn: "RoleArn", # required
8049
+ # state: "ENABLED", # accepts ENABLED, DISABLED
8050
+ # })
8051
+ #
8052
+ # @example Response structure
8053
+ #
8054
+ # resp.scheduled_query_arn #=> String
8055
+ # resp.name #=> String
8056
+ # resp.description #=> String
8057
+ # resp.query_language #=> String, one of "CWLI", "SQL", "PPL"
8058
+ # resp.query_string #=> String
8059
+ # resp.log_group_identifiers #=> Array
8060
+ # resp.log_group_identifiers[0] #=> String
8061
+ # resp.schedule_expression #=> String
8062
+ # resp.timezone #=> String
8063
+ # resp.start_time_offset #=> Integer
8064
+ # resp.destination_configuration.s3_configuration.destination_identifier #=> String
8065
+ # resp.destination_configuration.s3_configuration.role_arn #=> String
8066
+ # resp.state #=> String, one of "ENABLED", "DISABLED"
8067
+ # resp.last_triggered_time #=> Integer
8068
+ # resp.last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
8069
+ # resp.schedule_start_time #=> Integer
8070
+ # resp.schedule_end_time #=> Integer
8071
+ # resp.execution_role_arn #=> String
8072
+ # resp.creation_time #=> Integer
8073
+ # resp.last_updated_time #=> Integer
8074
+ #
8075
+ # @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/UpdateScheduledQuery AWS API Documentation
8076
+ #
8077
+ # @overload update_scheduled_query(params = {})
8078
+ # @param [Hash] params ({})
8079
+ def update_scheduled_query(params = {}, options = {})
8080
+ req = build_request(:update_scheduled_query, params)
8081
+ req.send_request(options)
8082
+ end
8083
+
7594
8084
  # @!endgroup
7595
8085
 
7596
8086
  # @param params ({})
@@ -7609,7 +8099,7 @@ module Aws::CloudWatchLogs
7609
8099
  tracer: tracer
7610
8100
  )
7611
8101
  context[:gem_name] = 'aws-sdk-cloudwatchlogs'
7612
- context[:gem_version] = '1.129.0'
8102
+ context[:gem_version] = '1.130.0'
7613
8103
  Seahorse::Client::Request.new(handlers, context)
7614
8104
  end
7615
8105