aws-sdk-cloudwatchlogs 1.129.0 → 1.131.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 +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudwatchlogs/client.rb +508 -10
- data/lib/aws-sdk-cloudwatchlogs/client_api.rb +281 -0
- data/lib/aws-sdk-cloudwatchlogs/errors.rb +11 -0
- data/lib/aws-sdk-cloudwatchlogs/types.rb +757 -7
- data/lib/aws-sdk-cloudwatchlogs.rb +1 -1
- data/sig/client.rbs +144 -2
- data/sig/errors.rbs +2 -0
- data/sig/types.rbs +177 -1
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: ceb9a142da87790d75b76a013963763c5bc4d8ba9e0fae53d884e6698acfd927
|
|
4
|
+
data.tar.gz: be52f5645cbae68f27b97b79e963f6a6d168b69f1ce7d275935546b9b32198a7
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: f9119426ab9570779b8d1e77c6adf651e046c3d1dbbb7285cfcf66ec3334d0493148b7a60e239935fb2ad518f252715f819bc438105cdf53f8f1c8fe59864f39
|
|
7
|
+
data.tar.gz: 534089e4ec21ad46cbc84f137b2483a4edba01bd3bcda9b53c1e26c119320617c72d650e073efb3e43a2ba4078e1338320df1cec905b414ffedf52a4bfa7e037
|
data/CHANGELOG.md
CHANGED
|
@@ -1,6 +1,16 @@
|
|
|
1
1
|
Unreleased Changes
|
|
2
2
|
------------------
|
|
3
3
|
|
|
4
|
+
1.131.0 (2025-11-19)
|
|
5
|
+
------------------
|
|
6
|
+
|
|
7
|
+
* Feature - Adding support for ocsf version 1.5, add optional parameter MappingVersion
|
|
8
|
+
|
|
9
|
+
1.130.0 (2025-11-18)
|
|
10
|
+
------------------
|
|
11
|
+
|
|
12
|
+
* 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.
|
|
13
|
+
|
|
4
14
|
1.129.0 (2025-10-31)
|
|
5
15
|
------------------
|
|
6
16
|
|
data/VERSION
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
1.
|
|
1
|
+
1.131.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<String>
|
|
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<Types::TriggerHistoryRecord>
|
|
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
|
#
|
|
@@ -4022,7 +4303,8 @@ module Aws::CloudWatchLogs
|
|
|
4022
4303
|
# resp.transformer_config[0].parse_route_53.source #=> String
|
|
4023
4304
|
# resp.transformer_config[0].parse_to_ocsf.source #=> String
|
|
4024
4305
|
# resp.transformer_config[0].parse_to_ocsf.event_source #=> String, one of "CloudTrail", "Route53Resolver", "VPCFlow", "EKSAudit", "AWSWAF"
|
|
4025
|
-
# resp.transformer_config[0].parse_to_ocsf.ocsf_version #=> String, one of "V1.1"
|
|
4306
|
+
# resp.transformer_config[0].parse_to_ocsf.ocsf_version #=> String, one of "V1.1", "V1.5"
|
|
4307
|
+
# resp.transformer_config[0].parse_to_ocsf.mapping_version #=> String
|
|
4026
4308
|
# resp.transformer_config[0].parse_postgres.source #=> String
|
|
4027
4309
|
# resp.transformer_config[0].parse_vpc.source #=> String
|
|
4028
4310
|
# resp.transformer_config[0].parse_waf.source #=> String
|
|
@@ -4391,6 +4673,60 @@ module Aws::CloudWatchLogs
|
|
|
4391
4673
|
req.send_request(options)
|
|
4392
4674
|
end
|
|
4393
4675
|
|
|
4676
|
+
# Lists all scheduled queries in the current AWS account and region with
|
|
4677
|
+
# optional filtering by state.
|
|
4678
|
+
#
|
|
4679
|
+
# @option params [Integer] :max_results
|
|
4680
|
+
# The maximum number of scheduled queries to return in a single call.
|
|
4681
|
+
#
|
|
4682
|
+
# @option params [String] :next_token
|
|
4683
|
+
# The token for the next set of items to return. The token expires after
|
|
4684
|
+
# 24 hours.
|
|
4685
|
+
#
|
|
4686
|
+
# @option params [String] :state
|
|
4687
|
+
# Filter results by the state of scheduled queries (ENABLED or
|
|
4688
|
+
# DISABLED).
|
|
4689
|
+
#
|
|
4690
|
+
# @return [Types::ListScheduledQueriesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
4691
|
+
#
|
|
4692
|
+
# * {Types::ListScheduledQueriesResponse#next_token #next_token} => String
|
|
4693
|
+
# * {Types::ListScheduledQueriesResponse#scheduled_queries #scheduled_queries} => Array<Types::ScheduledQuerySummary>
|
|
4694
|
+
#
|
|
4695
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
|
4696
|
+
#
|
|
4697
|
+
# @example Request syntax with placeholder values
|
|
4698
|
+
#
|
|
4699
|
+
# resp = client.list_scheduled_queries({
|
|
4700
|
+
# max_results: 1,
|
|
4701
|
+
# next_token: "NextToken",
|
|
4702
|
+
# state: "ENABLED", # accepts ENABLED, DISABLED
|
|
4703
|
+
# })
|
|
4704
|
+
#
|
|
4705
|
+
# @example Response structure
|
|
4706
|
+
#
|
|
4707
|
+
# resp.next_token #=> String
|
|
4708
|
+
# resp.scheduled_queries #=> Array
|
|
4709
|
+
# resp.scheduled_queries[0].scheduled_query_arn #=> String
|
|
4710
|
+
# resp.scheduled_queries[0].name #=> String
|
|
4711
|
+
# resp.scheduled_queries[0].state #=> String, one of "ENABLED", "DISABLED"
|
|
4712
|
+
# resp.scheduled_queries[0].last_triggered_time #=> Integer
|
|
4713
|
+
# resp.scheduled_queries[0].last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
|
|
4714
|
+
# resp.scheduled_queries[0].schedule_expression #=> String
|
|
4715
|
+
# resp.scheduled_queries[0].timezone #=> String
|
|
4716
|
+
# resp.scheduled_queries[0].destination_configuration.s3_configuration.destination_identifier #=> String
|
|
4717
|
+
# resp.scheduled_queries[0].destination_configuration.s3_configuration.role_arn #=> String
|
|
4718
|
+
# resp.scheduled_queries[0].creation_time #=> Integer
|
|
4719
|
+
# resp.scheduled_queries[0].last_updated_time #=> Integer
|
|
4720
|
+
#
|
|
4721
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/ListScheduledQueries AWS API Documentation
|
|
4722
|
+
#
|
|
4723
|
+
# @overload list_scheduled_queries(params = {})
|
|
4724
|
+
# @param [Hash] params ({})
|
|
4725
|
+
def list_scheduled_queries(params = {}, options = {})
|
|
4726
|
+
req = build_request(:list_scheduled_queries, params)
|
|
4727
|
+
req.send_request(options)
|
|
4728
|
+
end
|
|
4729
|
+
|
|
4394
4730
|
# Displays the tags associated with a CloudWatch Logs resource.
|
|
4395
4731
|
# Currently, log groups and destinations support tagging.
|
|
4396
4732
|
#
|
|
@@ -4614,6 +4950,8 @@ module Aws::CloudWatchLogs
|
|
|
4614
4950
|
# the Standard log class. Default field indexes are automatically
|
|
4615
4951
|
# available for the following fields:
|
|
4616
4952
|
#
|
|
4953
|
+
# * `@logStream`
|
|
4954
|
+
#
|
|
4617
4955
|
# * `@aws.region`
|
|
4618
4956
|
#
|
|
4619
4957
|
# * `@aws.account`
|
|
@@ -5295,8 +5633,23 @@ module Aws::CloudWatchLogs
|
|
|
5295
5633
|
# @option params [required, String] :log_type
|
|
5296
5634
|
# Defines the type of log that the source is sending.
|
|
5297
5635
|
#
|
|
5298
|
-
# * For Amazon Bedrock, the valid
|
|
5299
|
-
# `
|
|
5636
|
+
# * For Amazon Bedrock Agents, the valid values are `APPLICATION_LOGS`
|
|
5637
|
+
# and `EVENT_LOGS`.
|
|
5638
|
+
#
|
|
5639
|
+
# * For Amazon Bedrock Knowledge Bases, the valid value is
|
|
5640
|
+
# `APPLICATION_LOGS`.
|
|
5641
|
+
#
|
|
5642
|
+
# * For Amazon Bedrock AgentCore Runtime, the valid values are
|
|
5643
|
+
# `APPLICATION_LOGS`, `USAGE_LOGS` and `TRACES`.
|
|
5644
|
+
#
|
|
5645
|
+
# * For Amazon Bedrock AgentCore Tools, the valid values are
|
|
5646
|
+
# `APPLICATION_LOGS`, `USAGE_LOGS` and `TRACES`.
|
|
5647
|
+
#
|
|
5648
|
+
# * For Amazon Bedrock AgentCore Identity, the valid values are
|
|
5649
|
+
# `APPLICATION_LOGS` and `TRACES`.
|
|
5650
|
+
#
|
|
5651
|
+
# * For Amazon Bedrock AgentCore Gateway, the valid values are
|
|
5652
|
+
# `APPLICATION_LOGS` and `TRACES`.
|
|
5300
5653
|
#
|
|
5301
5654
|
# * For CloudFront, the valid value is `ACCESS_LOGS`.
|
|
5302
5655
|
#
|
|
@@ -5313,12 +5666,17 @@ module Aws::CloudWatchLogs
|
|
|
5313
5666
|
#
|
|
5314
5667
|
# * For IAM Identity Center, the valid value is `ERROR_LOGS`.
|
|
5315
5668
|
#
|
|
5669
|
+
# * For Network Load Balancer, the valid value is `NLB_ACCESS_LOGS`.
|
|
5670
|
+
#
|
|
5316
5671
|
# * For PCS, the valid values are `PCS_SCHEDULER_LOGS` and
|
|
5317
5672
|
# `PCS_JOBCOMP_LOGS`.
|
|
5318
5673
|
#
|
|
5319
|
-
# * For Amazon
|
|
5674
|
+
# * For Amazon Web Services RTB Fabric, the valid values is
|
|
5675
|
+
# `APPLICATION_LOGS`.
|
|
5676
|
+
#
|
|
5677
|
+
# * For Amazon Q, the valid values are `EVENT_LOGS` and `SYNC_JOB_LOGS`.
|
|
5320
5678
|
#
|
|
5321
|
-
# * For Amazon SES mail manager, the valid values are `
|
|
5679
|
+
# * For Amazon SES mail manager, the valid values are `APPLICATION_LOGS`
|
|
5322
5680
|
# and `TRAFFIC_POLICY_DEBUG_LOGS`.
|
|
5323
5681
|
#
|
|
5324
5682
|
# * For Amazon WorkMail, the valid values are `ACCESS_CONTROL_LOGS`,
|
|
@@ -5533,6 +5891,8 @@ module Aws::CloudWatchLogs
|
|
|
5533
5891
|
# the Standard log class. Default field indexes are automatically
|
|
5534
5892
|
# available for the following fields:
|
|
5535
5893
|
#
|
|
5894
|
+
# * `@logStream`
|
|
5895
|
+
#
|
|
5536
5896
|
# * `@aws.region`
|
|
5537
5897
|
#
|
|
5538
5898
|
# * `@aws.account`
|
|
@@ -6018,8 +6378,22 @@ module Aws::CloudWatchLogs
|
|
|
6018
6378
|
|
|
6019
6379
|
# Creates or updates a resource policy allowing other Amazon Web
|
|
6020
6380
|
# Services services to put log events to this account, such as Amazon
|
|
6021
|
-
# Route 53.
|
|
6022
|
-
#
|
|
6381
|
+
# Route 53. This API has the following restrictions:
|
|
6382
|
+
#
|
|
6383
|
+
# * **Supported actions** - Policy only supports `logs:PutLogEvents` and
|
|
6384
|
+
# `logs:CreateLogStream ` actions
|
|
6385
|
+
#
|
|
6386
|
+
# * **Supported principals** - Policy only applies when operations are
|
|
6387
|
+
# invoked by Amazon Web Services service principals (not IAM users,
|
|
6388
|
+
# roles, or cross-account principals
|
|
6389
|
+
#
|
|
6390
|
+
# * **Policy limits** - An account can have a maximum of 10 policies
|
|
6391
|
+
# without resourceARN and one per LogGroup resourceARN
|
|
6392
|
+
#
|
|
6393
|
+
# Resource policies with actions invoked by non-Amazon Web Services
|
|
6394
|
+
# service principals (such as IAM users, roles, or other Amazon Web
|
|
6395
|
+
# Services accounts) will not be enforced. For access control involving
|
|
6396
|
+
# these principals, use the IAM policies.
|
|
6023
6397
|
#
|
|
6024
6398
|
# @option params [String] :policy_name
|
|
6025
6399
|
# Name of the new policy. This parameter is required.
|
|
@@ -6454,7 +6828,8 @@ module Aws::CloudWatchLogs
|
|
|
6454
6828
|
# parse_to_ocsf: {
|
|
6455
6829
|
# source: "Source",
|
|
6456
6830
|
# event_source: "CloudTrail", # required, accepts CloudTrail, Route53Resolver, VPCFlow, EKSAudit, AWSWAF
|
|
6457
|
-
# ocsf_version: "V1.1", # required, accepts V1.1
|
|
6831
|
+
# ocsf_version: "V1.1", # required, accepts V1.1, V1.5
|
|
6832
|
+
# mapping_version: "MappingVersion",
|
|
6458
6833
|
# },
|
|
6459
6834
|
# parse_postgres: {
|
|
6460
6835
|
# source: "Source",
|
|
@@ -7259,7 +7634,8 @@ module Aws::CloudWatchLogs
|
|
|
7259
7634
|
# parse_to_ocsf: {
|
|
7260
7635
|
# source: "Source",
|
|
7261
7636
|
# event_source: "CloudTrail", # required, accepts CloudTrail, Route53Resolver, VPCFlow, EKSAudit, AWSWAF
|
|
7262
|
-
# ocsf_version: "V1.1", # required, accepts V1.1
|
|
7637
|
+
# ocsf_version: "V1.1", # required, accepts V1.1, V1.5
|
|
7638
|
+
# mapping_version: "MappingVersion",
|
|
7263
7639
|
# },
|
|
7264
7640
|
# parse_postgres: {
|
|
7265
7641
|
# source: "Source",
|
|
@@ -7591,6 +7967,128 @@ module Aws::CloudWatchLogs
|
|
|
7591
7967
|
req.send_request(options)
|
|
7592
7968
|
end
|
|
7593
7969
|
|
|
7970
|
+
# Updates the configuration of an existing scheduled query. This
|
|
7971
|
+
# operation follows PUT semantics, replacing the existing configuration
|
|
7972
|
+
# with the provided values.
|
|
7973
|
+
#
|
|
7974
|
+
# @option params [required, String] :identifier
|
|
7975
|
+
# The name or ARN of the scheduled query to update.
|
|
7976
|
+
#
|
|
7977
|
+
# @option params [String] :description
|
|
7978
|
+
# Updated description for the scheduled query.
|
|
7979
|
+
#
|
|
7980
|
+
# @option params [required, String] :query_language
|
|
7981
|
+
# Updated query language to use (LogsQL, PPL, or SQL).
|
|
7982
|
+
#
|
|
7983
|
+
# @option params [required, String] :query_string
|
|
7984
|
+
# Updated CloudWatch Logs Insights query string to execute.
|
|
7985
|
+
#
|
|
7986
|
+
# @option params [Array<String>] :log_group_identifiers
|
|
7987
|
+
# Updated log group identifiers to query.
|
|
7988
|
+
#
|
|
7989
|
+
# @option params [required, String] :schedule_expression
|
|
7990
|
+
# Updated cron expression that defines when the scheduled query runs.
|
|
7991
|
+
#
|
|
7992
|
+
# @option params [String] :timezone
|
|
7993
|
+
# Updated timezone in which the schedule expression is evaluated.
|
|
7994
|
+
#
|
|
7995
|
+
# @option params [Integer] :start_time_offset
|
|
7996
|
+
# Updated time offset in seconds from the execution time for the start
|
|
7997
|
+
# of the query time range.
|
|
7998
|
+
#
|
|
7999
|
+
# @option params [Types::DestinationConfiguration] :destination_configuration
|
|
8000
|
+
# Updated configuration for destinations where the query results will be
|
|
8001
|
+
# delivered.
|
|
8002
|
+
#
|
|
8003
|
+
# @option params [Integer] :schedule_start_time
|
|
8004
|
+
# Updated start time for the query schedule in Unix epoch time.
|
|
8005
|
+
#
|
|
8006
|
+
# @option params [Integer] :schedule_end_time
|
|
8007
|
+
# Updated end time for the query schedule in Unix epoch time.
|
|
8008
|
+
#
|
|
8009
|
+
# @option params [required, String] :execution_role_arn
|
|
8010
|
+
# Updated ARN of the IAM role that CloudWatch Logs will assume to
|
|
8011
|
+
# execute the scheduled query.
|
|
8012
|
+
#
|
|
8013
|
+
# @option params [String] :state
|
|
8014
|
+
# Updated state of the scheduled query (ENABLED or DISABLED).
|
|
8015
|
+
#
|
|
8016
|
+
# @return [Types::UpdateScheduledQueryResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
|
8017
|
+
#
|
|
8018
|
+
# * {Types::UpdateScheduledQueryResponse#scheduled_query_arn #scheduled_query_arn} => String
|
|
8019
|
+
# * {Types::UpdateScheduledQueryResponse#name #name} => String
|
|
8020
|
+
# * {Types::UpdateScheduledQueryResponse#description #description} => String
|
|
8021
|
+
# * {Types::UpdateScheduledQueryResponse#query_language #query_language} => String
|
|
8022
|
+
# * {Types::UpdateScheduledQueryResponse#query_string #query_string} => String
|
|
8023
|
+
# * {Types::UpdateScheduledQueryResponse#log_group_identifiers #log_group_identifiers} => Array<String>
|
|
8024
|
+
# * {Types::UpdateScheduledQueryResponse#schedule_expression #schedule_expression} => String
|
|
8025
|
+
# * {Types::UpdateScheduledQueryResponse#timezone #timezone} => String
|
|
8026
|
+
# * {Types::UpdateScheduledQueryResponse#start_time_offset #start_time_offset} => Integer
|
|
8027
|
+
# * {Types::UpdateScheduledQueryResponse#destination_configuration #destination_configuration} => Types::DestinationConfiguration
|
|
8028
|
+
# * {Types::UpdateScheduledQueryResponse#state #state} => String
|
|
8029
|
+
# * {Types::UpdateScheduledQueryResponse#last_triggered_time #last_triggered_time} => Integer
|
|
8030
|
+
# * {Types::UpdateScheduledQueryResponse#last_execution_status #last_execution_status} => String
|
|
8031
|
+
# * {Types::UpdateScheduledQueryResponse#schedule_start_time #schedule_start_time} => Integer
|
|
8032
|
+
# * {Types::UpdateScheduledQueryResponse#schedule_end_time #schedule_end_time} => Integer
|
|
8033
|
+
# * {Types::UpdateScheduledQueryResponse#execution_role_arn #execution_role_arn} => String
|
|
8034
|
+
# * {Types::UpdateScheduledQueryResponse#creation_time #creation_time} => Integer
|
|
8035
|
+
# * {Types::UpdateScheduledQueryResponse#last_updated_time #last_updated_time} => Integer
|
|
8036
|
+
#
|
|
8037
|
+
# @example Request syntax with placeholder values
|
|
8038
|
+
#
|
|
8039
|
+
# resp = client.update_scheduled_query({
|
|
8040
|
+
# identifier: "ScheduledQueryIdentifier", # required
|
|
8041
|
+
# description: "ScheduledQueryDescription",
|
|
8042
|
+
# query_language: "CWLI", # required, accepts CWLI, SQL, PPL
|
|
8043
|
+
# query_string: "QueryString", # required
|
|
8044
|
+
# log_group_identifiers: ["LogGroupIdentifier"],
|
|
8045
|
+
# schedule_expression: "ScheduleExpression", # required
|
|
8046
|
+
# timezone: "ScheduleTimezone",
|
|
8047
|
+
# start_time_offset: 1,
|
|
8048
|
+
# destination_configuration: {
|
|
8049
|
+
# s3_configuration: { # required
|
|
8050
|
+
# destination_identifier: "S3Uri", # required
|
|
8051
|
+
# role_arn: "RoleArn", # required
|
|
8052
|
+
# },
|
|
8053
|
+
# },
|
|
8054
|
+
# schedule_start_time: 1,
|
|
8055
|
+
# schedule_end_time: 1,
|
|
8056
|
+
# execution_role_arn: "RoleArn", # required
|
|
8057
|
+
# state: "ENABLED", # accepts ENABLED, DISABLED
|
|
8058
|
+
# })
|
|
8059
|
+
#
|
|
8060
|
+
# @example Response structure
|
|
8061
|
+
#
|
|
8062
|
+
# resp.scheduled_query_arn #=> String
|
|
8063
|
+
# resp.name #=> String
|
|
8064
|
+
# resp.description #=> String
|
|
8065
|
+
# resp.query_language #=> String, one of "CWLI", "SQL", "PPL"
|
|
8066
|
+
# resp.query_string #=> String
|
|
8067
|
+
# resp.log_group_identifiers #=> Array
|
|
8068
|
+
# resp.log_group_identifiers[0] #=> String
|
|
8069
|
+
# resp.schedule_expression #=> String
|
|
8070
|
+
# resp.timezone #=> String
|
|
8071
|
+
# resp.start_time_offset #=> Integer
|
|
8072
|
+
# resp.destination_configuration.s3_configuration.destination_identifier #=> String
|
|
8073
|
+
# resp.destination_configuration.s3_configuration.role_arn #=> String
|
|
8074
|
+
# resp.state #=> String, one of "ENABLED", "DISABLED"
|
|
8075
|
+
# resp.last_triggered_time #=> Integer
|
|
8076
|
+
# resp.last_execution_status #=> String, one of "Running", "InvalidQuery", "Complete", "Failed", "Timeout"
|
|
8077
|
+
# resp.schedule_start_time #=> Integer
|
|
8078
|
+
# resp.schedule_end_time #=> Integer
|
|
8079
|
+
# resp.execution_role_arn #=> String
|
|
8080
|
+
# resp.creation_time #=> Integer
|
|
8081
|
+
# resp.last_updated_time #=> Integer
|
|
8082
|
+
#
|
|
8083
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/UpdateScheduledQuery AWS API Documentation
|
|
8084
|
+
#
|
|
8085
|
+
# @overload update_scheduled_query(params = {})
|
|
8086
|
+
# @param [Hash] params ({})
|
|
8087
|
+
def update_scheduled_query(params = {}, options = {})
|
|
8088
|
+
req = build_request(:update_scheduled_query, params)
|
|
8089
|
+
req.send_request(options)
|
|
8090
|
+
end
|
|
8091
|
+
|
|
7594
8092
|
# @!endgroup
|
|
7595
8093
|
|
|
7596
8094
|
# @param params ({})
|
|
@@ -7609,7 +8107,7 @@ module Aws::CloudWatchLogs
|
|
|
7609
8107
|
tracer: tracer
|
|
7610
8108
|
)
|
|
7611
8109
|
context[:gem_name] = 'aws-sdk-cloudwatchlogs'
|
|
7612
|
-
context[:gem_version] = '1.
|
|
8110
|
+
context[:gem_version] = '1.131.0'
|
|
7613
8111
|
Seahorse::Client::Request.new(handlers, context)
|
|
7614
8112
|
end
|
|
7615
8113
|
|