aws-sdk-cloudwatchlogs 1.29.0 → 1.34.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 +5 -5
- data/lib/aws-sdk-cloudwatchlogs.rb +3 -1
- data/lib/aws-sdk-cloudwatchlogs/client.rb +211 -44
- data/lib/aws-sdk-cloudwatchlogs/client_api.rb +78 -0
- data/lib/aws-sdk-cloudwatchlogs/customizations.rb +1 -0
- data/lib/aws-sdk-cloudwatchlogs/errors.rb +2 -0
- data/lib/aws-sdk-cloudwatchlogs/resource.rb +3 -7
- data/lib/aws-sdk-cloudwatchlogs/types.rb +266 -8
- metadata +5 -5
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
|
-
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
2
|
+
SHA256:
|
3
|
+
metadata.gz: 6044a4d75302b3655b978b7cbc27f42b83922c0b450c65355e6af72e1dc7fa15
|
4
|
+
data.tar.gz: a4bd19ddf66ecc2235582dbbac9f9c090f9d4c7e006438f5216f8a06679de083
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 831a0dfcc679a26ada1bddd069dfa27bcd51ef8e4cc7a1307067a91e62a27dfb8c1411b7a1cb8625953c22af7546737d9f1bba5ec1cee1fdeaf5d25b96a658ff
|
7
|
+
data.tar.gz: 06fcb907f490bc1c564953d78594446bda80e36b1a5549f65bc9ff6b1889d3a016942d3d0af241d272d2cafa5d71b8e83151d384c17522752f73c9008ba944dc
|
@@ -1,3 +1,5 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
# WARNING ABOUT GENERATED CODE
|
2
4
|
#
|
3
5
|
# This file is generated. See the contributing guide for more information:
|
@@ -45,6 +47,6 @@ require_relative 'aws-sdk-cloudwatchlogs/customizations'
|
|
45
47
|
# @service
|
46
48
|
module Aws::CloudWatchLogs
|
47
49
|
|
48
|
-
GEM_VERSION = '1.
|
50
|
+
GEM_VERSION = '1.34.0'
|
49
51
|
|
50
52
|
end
|
@@ -1,3 +1,5 @@
|
|
1
|
+
# frozen_string_literal: true
|
2
|
+
|
1
3
|
# WARNING ABOUT GENERATED CODE
|
2
4
|
#
|
3
5
|
# This file is generated. See the contributing guide for more information:
|
@@ -24,6 +26,7 @@ require 'aws-sdk-core/plugins/jsonvalue_converter.rb'
|
|
24
26
|
require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
|
25
27
|
require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
|
26
28
|
require 'aws-sdk-core/plugins/transfer_encoding.rb'
|
29
|
+
require 'aws-sdk-core/plugins/http_checksum.rb'
|
27
30
|
require 'aws-sdk-core/plugins/signature_v4.rb'
|
28
31
|
require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
|
29
32
|
|
@@ -32,11 +35,11 @@ Aws::Plugins::GlobalConfiguration.add_identifier(:cloudwatchlogs)
|
|
32
35
|
module Aws::CloudWatchLogs
|
33
36
|
# An API client for CloudWatchLogs. To construct a client, you need to configure a `:region` and `:credentials`.
|
34
37
|
#
|
35
|
-
#
|
36
|
-
#
|
37
|
-
#
|
38
|
-
#
|
39
|
-
#
|
38
|
+
# client = Aws::CloudWatchLogs::Client.new(
|
39
|
+
# region: region_name,
|
40
|
+
# credentials: credentials,
|
41
|
+
# # ...
|
42
|
+
# )
|
40
43
|
#
|
41
44
|
# For details on configuring region and credentials see
|
42
45
|
# the [developer guide](/sdk-for-ruby/v3/developer-guide/setup-config.html).
|
@@ -69,6 +72,7 @@ module Aws::CloudWatchLogs
|
|
69
72
|
add_plugin(Aws::Plugins::ClientMetricsPlugin)
|
70
73
|
add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
|
71
74
|
add_plugin(Aws::Plugins::TransferEncoding)
|
75
|
+
add_plugin(Aws::Plugins::HttpChecksum)
|
72
76
|
add_plugin(Aws::Plugins::SignatureV4)
|
73
77
|
add_plugin(Aws::Plugins::Protocols::JsonRpc)
|
74
78
|
|
@@ -105,7 +109,7 @@ module Aws::CloudWatchLogs
|
|
105
109
|
# @option options [required, String] :region
|
106
110
|
# The AWS region to connect to. The configured `:region` is
|
107
111
|
# used to determine the service `:endpoint`. When not passed,
|
108
|
-
# a default `:region` is
|
112
|
+
# a default `:region` is searched for in the following locations:
|
109
113
|
#
|
110
114
|
# * `Aws.config[:region]`
|
111
115
|
# * `ENV['AWS_REGION']`
|
@@ -161,7 +165,7 @@ module Aws::CloudWatchLogs
|
|
161
165
|
# @option options [String] :endpoint
|
162
166
|
# The client endpoint is normally constructed from the `:region`
|
163
167
|
# option. You should only configure an `:endpoint` when connecting
|
164
|
-
# to test endpoints. This should be
|
168
|
+
# to test or custom endpoints. This should be a valid HTTP(S) URI.
|
165
169
|
#
|
166
170
|
# @option options [Integer] :endpoint_cache_max_entries (1000)
|
167
171
|
# Used for the maximum size limit of the LRU cache storing endpoints data
|
@@ -176,7 +180,7 @@ module Aws::CloudWatchLogs
|
|
176
180
|
# requests fetching endpoints information. Defaults to 60 sec.
|
177
181
|
#
|
178
182
|
# @option options [Boolean] :endpoint_discovery (false)
|
179
|
-
# When set to `true`, endpoint discovery will be enabled for operations when available.
|
183
|
+
# When set to `true`, endpoint discovery will be enabled for operations when available.
|
180
184
|
#
|
181
185
|
# @option options [Aws::Log::Formatter] :log_formatter (Aws::Log::Formatter.default)
|
182
186
|
# The log formatter.
|
@@ -229,15 +233,19 @@ module Aws::CloudWatchLogs
|
|
229
233
|
#
|
230
234
|
# @option options [String] :retry_mode ("legacy")
|
231
235
|
# Specifies which retry algorithm to use. Values are:
|
232
|
-
#
|
233
|
-
#
|
234
|
-
#
|
235
|
-
#
|
236
|
-
#
|
237
|
-
#
|
238
|
-
#
|
239
|
-
#
|
240
|
-
#
|
236
|
+
#
|
237
|
+
# * `legacy` - The pre-existing retry behavior. This is default value if
|
238
|
+
# no retry mode is provided.
|
239
|
+
#
|
240
|
+
# * `standard` - A standardized set of retry rules across the AWS SDKs.
|
241
|
+
# This includes support for retry quotas, which limit the number of
|
242
|
+
# unsuccessful retries a client can make.
|
243
|
+
#
|
244
|
+
# * `adaptive` - An experimental retry mode that includes all the
|
245
|
+
# functionality of `standard` mode along with automatic client side
|
246
|
+
# throttling. This is a provisional mode that may change behavior
|
247
|
+
# in the future.
|
248
|
+
#
|
241
249
|
#
|
242
250
|
# @option options [String] :secret_access_key
|
243
251
|
#
|
@@ -275,8 +283,7 @@ module Aws::CloudWatchLogs
|
|
275
283
|
#
|
276
284
|
# @option options [Integer] :http_read_timeout (60) The default
|
277
285
|
# number of seconds to wait for response data. This value can
|
278
|
-
# safely be set
|
279
|
-
# per-request on the session yielded by {#session_for}.
|
286
|
+
# safely be set per-request on the session.
|
280
287
|
#
|
281
288
|
# @option options [Float] :http_idle_timeout (5) The number of
|
282
289
|
# seconds a connection is allowed to sit idle before it is
|
@@ -288,7 +295,7 @@ module Aws::CloudWatchLogs
|
|
288
295
|
# request body. This option has no effect unless the request has
|
289
296
|
# "Expect" header set to "100-continue". Defaults to `nil` which
|
290
297
|
# disables this behaviour. This value can safely be set per
|
291
|
-
# request on the session
|
298
|
+
# request on the session.
|
292
299
|
#
|
293
300
|
# @option options [Boolean] :http_wire_trace (false) When `true`,
|
294
301
|
# HTTP debug output will be sent to the `:logger`.
|
@@ -405,9 +412,9 @@ module Aws::CloudWatchLogs
|
|
405
412
|
# This is an asynchronous call. If all the required information is
|
406
413
|
# provided, this operation initiates an export task and responds with
|
407
414
|
# the ID of the task. After the task has started, you can use
|
408
|
-
# DescribeExportTasks to get the status of the export task. Each
|
409
|
-
# can only have one active (`RUNNING` or `PENDING`) export task
|
410
|
-
# time. To cancel an export task, use CancelExportTask.
|
415
|
+
# [DescribeExportTasks][1] to get the status of the export task. Each
|
416
|
+
# account can only have one active (`RUNNING` or `PENDING`) export task
|
417
|
+
# at a time. To cancel an export task, use [CancelExportTask][2].
|
411
418
|
#
|
412
419
|
# You can export logs from multiple log groups or multiple time ranges
|
413
420
|
# to the same S3 bucket. To separate out log data for each export task,
|
@@ -417,6 +424,11 @@ module Aws::CloudWatchLogs
|
|
417
424
|
# Exporting to S3 buckets that are encrypted with AES-256 is supported.
|
418
425
|
# Exporting to S3 buckets encrypted with SSE-KMS is not supported.
|
419
426
|
#
|
427
|
+
#
|
428
|
+
#
|
429
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeExportTasks.html
|
430
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CancelExportTask.html
|
431
|
+
#
|
420
432
|
# @option params [String] :task_name
|
421
433
|
# The name of the export task.
|
422
434
|
#
|
@@ -682,6 +694,31 @@ module Aws::CloudWatchLogs
|
|
682
694
|
req.send_request(options)
|
683
695
|
end
|
684
696
|
|
697
|
+
# @option params [required, String] :query_definition_id
|
698
|
+
#
|
699
|
+
# @return [Types::DeleteQueryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
700
|
+
#
|
701
|
+
# * {Types::DeleteQueryDefinitionResponse#success #success} => Boolean
|
702
|
+
#
|
703
|
+
# @example Request syntax with placeholder values
|
704
|
+
#
|
705
|
+
# resp = client.delete_query_definition({
|
706
|
+
# query_definition_id: "QueryId", # required
|
707
|
+
# })
|
708
|
+
#
|
709
|
+
# @example Response structure
|
710
|
+
#
|
711
|
+
# resp.success #=> Boolean
|
712
|
+
#
|
713
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DeleteQueryDefinition AWS API Documentation
|
714
|
+
#
|
715
|
+
# @overload delete_query_definition(params = {})
|
716
|
+
# @param [Hash] params ({})
|
717
|
+
def delete_query_definition(params = {}, options = {})
|
718
|
+
req = build_request(:delete_query_definition, params)
|
719
|
+
req.send_request(options)
|
720
|
+
end
|
721
|
+
|
685
722
|
# Deletes a resource policy from this account. This revokes the access
|
686
723
|
# of the identities in that policy to put log events to this account.
|
687
724
|
#
|
@@ -776,6 +813,8 @@ module Aws::CloudWatchLogs
|
|
776
813
|
# * {Types::DescribeDestinationsResponse#destinations #destinations} => Array<Types::Destination>
|
777
814
|
# * {Types::DescribeDestinationsResponse#next_token #next_token} => String
|
778
815
|
#
|
816
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
817
|
+
#
|
779
818
|
# @example Request syntax with placeholder values
|
780
819
|
#
|
781
820
|
# resp = client.describe_destinations({
|
@@ -882,6 +921,8 @@ module Aws::CloudWatchLogs
|
|
882
921
|
# * {Types::DescribeLogGroupsResponse#log_groups #log_groups} => Array<Types::LogGroup>
|
883
922
|
# * {Types::DescribeLogGroupsResponse#next_token #next_token} => String
|
884
923
|
#
|
924
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
925
|
+
#
|
885
926
|
# @example Request syntax with placeholder values
|
886
927
|
#
|
887
928
|
# resp = client.describe_log_groups({
|
@@ -959,6 +1000,8 @@ module Aws::CloudWatchLogs
|
|
959
1000
|
# * {Types::DescribeLogStreamsResponse#log_streams #log_streams} => Array<Types::LogStream>
|
960
1001
|
# * {Types::DescribeLogStreamsResponse#next_token #next_token} => String
|
961
1002
|
#
|
1003
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1004
|
+
#
|
962
1005
|
# @example Request syntax with placeholder values
|
963
1006
|
#
|
964
1007
|
# resp = client.describe_log_streams({
|
@@ -1025,6 +1068,8 @@ module Aws::CloudWatchLogs
|
|
1025
1068
|
# * {Types::DescribeMetricFiltersResponse#metric_filters #metric_filters} => Array<Types::MetricFilter>
|
1026
1069
|
# * {Types::DescribeMetricFiltersResponse#next_token #next_token} => String
|
1027
1070
|
#
|
1071
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1072
|
+
#
|
1028
1073
|
# @example Request syntax with placeholder values
|
1029
1074
|
#
|
1030
1075
|
# resp = client.describe_metric_filters({
|
@@ -1112,6 +1157,47 @@ module Aws::CloudWatchLogs
|
|
1112
1157
|
req.send_request(options)
|
1113
1158
|
end
|
1114
1159
|
|
1160
|
+
# @option params [String] :query_definition_name_prefix
|
1161
|
+
#
|
1162
|
+
# @option params [Integer] :max_results
|
1163
|
+
#
|
1164
|
+
# @option params [String] :next_token
|
1165
|
+
# The token for the next set of items to return. The token expires after
|
1166
|
+
# 24 hours.
|
1167
|
+
#
|
1168
|
+
# @return [Types::DescribeQueryDefinitionsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1169
|
+
#
|
1170
|
+
# * {Types::DescribeQueryDefinitionsResponse#query_definitions #query_definitions} => Array<Types::QueryDefinition>
|
1171
|
+
# * {Types::DescribeQueryDefinitionsResponse#next_token #next_token} => String
|
1172
|
+
#
|
1173
|
+
# @example Request syntax with placeholder values
|
1174
|
+
#
|
1175
|
+
# resp = client.describe_query_definitions({
|
1176
|
+
# query_definition_name_prefix: "QueryDefinitionName",
|
1177
|
+
# max_results: 1,
|
1178
|
+
# next_token: "NextToken",
|
1179
|
+
# })
|
1180
|
+
#
|
1181
|
+
# @example Response structure
|
1182
|
+
#
|
1183
|
+
# resp.query_definitions #=> Array
|
1184
|
+
# resp.query_definitions[0].query_definition_id #=> String
|
1185
|
+
# resp.query_definitions[0].name #=> String
|
1186
|
+
# resp.query_definitions[0].query_string #=> String
|
1187
|
+
# resp.query_definitions[0].last_modified #=> Integer
|
1188
|
+
# resp.query_definitions[0].log_group_names #=> Array
|
1189
|
+
# resp.query_definitions[0].log_group_names[0] #=> String
|
1190
|
+
# resp.next_token #=> String
|
1191
|
+
#
|
1192
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DescribeQueryDefinitions AWS API Documentation
|
1193
|
+
#
|
1194
|
+
# @overload describe_query_definitions(params = {})
|
1195
|
+
# @param [Hash] params ({})
|
1196
|
+
def describe_query_definitions(params = {}, options = {})
|
1197
|
+
req = build_request(:describe_query_definitions, params)
|
1198
|
+
req.send_request(options)
|
1199
|
+
end
|
1200
|
+
|
1115
1201
|
# Lists the resource policies in this account.
|
1116
1202
|
#
|
1117
1203
|
# @option params [String] :next_token
|
@@ -1175,6 +1261,8 @@ module Aws::CloudWatchLogs
|
|
1175
1261
|
# * {Types::DescribeSubscriptionFiltersResponse#subscription_filters #subscription_filters} => Array<Types::SubscriptionFilter>
|
1176
1262
|
# * {Types::DescribeSubscriptionFiltersResponse#next_token #next_token} => String
|
1177
1263
|
#
|
1264
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1265
|
+
#
|
1178
1266
|
# @example Request syntax with placeholder values
|
1179
1267
|
#
|
1180
1268
|
# resp = client.describe_subscription_filters({
|
@@ -1311,6 +1399,8 @@ module Aws::CloudWatchLogs
|
|
1311
1399
|
# * {Types::FilterLogEventsResponse#searched_log_streams #searched_log_streams} => Array<Types::SearchedLogStream>
|
1312
1400
|
# * {Types::FilterLogEventsResponse#next_token #next_token} => String
|
1313
1401
|
#
|
1402
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1403
|
+
#
|
1314
1404
|
# @example Request syntax with placeholder values
|
1315
1405
|
#
|
1316
1406
|
# resp = client.filter_log_events({
|
@@ -1397,6 +1487,8 @@ module Aws::CloudWatchLogs
|
|
1397
1487
|
# * {Types::GetLogEventsResponse#next_forward_token #next_forward_token} => String
|
1398
1488
|
# * {Types::GetLogEventsResponse#next_backward_token #next_backward_token} => String
|
1399
1489
|
#
|
1490
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1491
|
+
#
|
1400
1492
|
# @example Request syntax with placeholder values
|
1401
1493
|
#
|
1402
1494
|
# resp = client.get_log_events({
|
@@ -1434,11 +1526,16 @@ module Aws::CloudWatchLogs
|
|
1434
1526
|
#
|
1435
1527
|
# In the results, fields that start with @ are fields generated by
|
1436
1528
|
# CloudWatch Logs. For example, `@timestamp` is the timestamp of each
|
1437
|
-
# log event.
|
1529
|
+
# log event. For more information about the fields that are generated by
|
1530
|
+
# CloudWatch logs, see [Supported Logs and Discovered Fields][1].
|
1438
1531
|
#
|
1439
1532
|
# The response results are sorted by the frequency percentage, starting
|
1440
1533
|
# with the highest percentage.
|
1441
1534
|
#
|
1535
|
+
#
|
1536
|
+
#
|
1537
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CWL_AnalyzeLogData-discoverable-fields.html
|
1538
|
+
#
|
1442
1539
|
# @option params [required, String] :log_group_name
|
1443
1540
|
# The name of the log group to search.
|
1444
1541
|
#
|
@@ -1519,16 +1616,22 @@ module Aws::CloudWatchLogs
|
|
1519
1616
|
#
|
1520
1617
|
# Only the fields requested in the query are returned, along with a
|
1521
1618
|
# `@ptr` field which is the identifier for the log record. You can use
|
1522
|
-
# the value of `@ptr` in a operation to get the full
|
1619
|
+
# the value of `@ptr` in a [GetLogRecord][1] operation to get the full
|
1620
|
+
# log record.
|
1523
1621
|
#
|
1524
1622
|
# `GetQueryResults` does not start a query execution. To run a query,
|
1525
|
-
# use .
|
1623
|
+
# use [StartQuery][2].
|
1526
1624
|
#
|
1527
1625
|
# If the value of the `Status` field in the output is `Running`, this
|
1528
1626
|
# operation returns only partial results. If you see a value of
|
1529
1627
|
# `Scheduled` or `Running` for the status, you can retry the operation
|
1530
1628
|
# later to see the final results.
|
1531
1629
|
#
|
1630
|
+
#
|
1631
|
+
#
|
1632
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_GetLogRecord.html
|
1633
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartQuery.html
|
1634
|
+
#
|
1532
1635
|
# @option params [required, String] :query_id
|
1533
1636
|
# The ID number of the query.
|
1534
1637
|
#
|
@@ -1598,15 +1701,21 @@ module Aws::CloudWatchLogs
|
|
1598
1701
|
#
|
1599
1702
|
# A destination encapsulates a physical resource (such as an Amazon
|
1600
1703
|
# Kinesis stream) and enables you to subscribe to a real-time stream of
|
1601
|
-
# log events for a different account, ingested using PutLogEvents.
|
1704
|
+
# log events for a different account, ingested using [PutLogEvents][1].
|
1602
1705
|
#
|
1603
1706
|
# Through an access policy, a destination controls what is written to
|
1604
1707
|
# it. By default, `PutDestination` does not set any access policy with
|
1605
1708
|
# the destination, which means a cross-account user cannot call
|
1606
|
-
# PutSubscriptionFilter against this destination. To enable this,
|
1607
|
-
# destination owner must call PutDestinationPolicy after
|
1709
|
+
# [PutSubscriptionFilter][2] against this destination. To enable this,
|
1710
|
+
# the destination owner must call [PutDestinationPolicy][3] after
|
1608
1711
|
# `PutDestination`.
|
1609
1712
|
#
|
1713
|
+
#
|
1714
|
+
#
|
1715
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
|
1716
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutSubscriptionFilter.html
|
1717
|
+
# [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestinationPolicy.html
|
1718
|
+
#
|
1610
1719
|
# @option params [required, String] :destination_name
|
1611
1720
|
# A name for the destination.
|
1612
1721
|
#
|
@@ -1735,9 +1844,13 @@ module Aws::CloudWatchLogs
|
|
1735
1844
|
# The sequence token obtained from the response of the previous
|
1736
1845
|
# `PutLogEvents` call. An upload in a newly created log stream does not
|
1737
1846
|
# require a sequence token. You can also get the sequence token using
|
1738
|
-
# DescribeLogStreams. If you call `PutLogEvents` twice within a
|
1739
|
-
# time period using the same value for `sequenceToken`, both
|
1740
|
-
# be successful, or one may be rejected.
|
1847
|
+
# [DescribeLogStreams][1]. If you call `PutLogEvents` twice within a
|
1848
|
+
# narrow time period using the same value for `sequenceToken`, both
|
1849
|
+
# calls may be successful, or one may be rejected.
|
1850
|
+
#
|
1851
|
+
#
|
1852
|
+
#
|
1853
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeLogStreams.html
|
1741
1854
|
#
|
1742
1855
|
# @return [Types::PutLogEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1743
1856
|
#
|
@@ -1776,11 +1889,16 @@ module Aws::CloudWatchLogs
|
|
1776
1889
|
|
1777
1890
|
# Creates or updates a metric filter and associates it with the
|
1778
1891
|
# specified log group. Metric filters allow you to configure rules to
|
1779
|
-
# extract metric data from log events ingested through
|
1892
|
+
# extract metric data from log events ingested through
|
1893
|
+
# [PutLogEvents][1].
|
1780
1894
|
#
|
1781
1895
|
# The maximum number of metric filters that can be associated with a log
|
1782
1896
|
# group is 100.
|
1783
1897
|
#
|
1898
|
+
#
|
1899
|
+
#
|
1900
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
|
1901
|
+
#
|
1784
1902
|
# @option params [required, String] :log_group_name
|
1785
1903
|
# The name of the log group.
|
1786
1904
|
#
|
@@ -1821,6 +1939,40 @@ module Aws::CloudWatchLogs
|
|
1821
1939
|
req.send_request(options)
|
1822
1940
|
end
|
1823
1941
|
|
1942
|
+
# @option params [required, String] :name
|
1943
|
+
#
|
1944
|
+
# @option params [String] :query_definition_id
|
1945
|
+
#
|
1946
|
+
# @option params [Array<String>] :log_group_names
|
1947
|
+
#
|
1948
|
+
# @option params [required, String] :query_string
|
1949
|
+
#
|
1950
|
+
# @return [Types::PutQueryDefinitionResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1951
|
+
#
|
1952
|
+
# * {Types::PutQueryDefinitionResponse#query_definition_id #query_definition_id} => String
|
1953
|
+
#
|
1954
|
+
# @example Request syntax with placeholder values
|
1955
|
+
#
|
1956
|
+
# resp = client.put_query_definition({
|
1957
|
+
# name: "QueryDefinitionName", # required
|
1958
|
+
# query_definition_id: "QueryId",
|
1959
|
+
# log_group_names: ["LogGroupName"],
|
1960
|
+
# query_string: "QueryDefinitionString", # required
|
1961
|
+
# })
|
1962
|
+
#
|
1963
|
+
# @example Response structure
|
1964
|
+
#
|
1965
|
+
# resp.query_definition_id #=> String
|
1966
|
+
#
|
1967
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutQueryDefinition AWS API Documentation
|
1968
|
+
#
|
1969
|
+
# @overload put_query_definition(params = {})
|
1970
|
+
# @param [Hash] params ({})
|
1971
|
+
def put_query_definition(params = {}, options = {})
|
1972
|
+
req = build_request(:put_query_definition, params)
|
1973
|
+
req.send_request(options)
|
1974
|
+
end
|
1975
|
+
|
1824
1976
|
# Creates or updates a resource policy allowing other AWS services to
|
1825
1977
|
# put log events to this account, such as Amazon Route 53. An account
|
1826
1978
|
# can have up to 10 resource policies per region.
|
@@ -1901,9 +2053,9 @@ module Aws::CloudWatchLogs
|
|
1901
2053
|
|
1902
2054
|
# Creates or updates a subscription filter and associates it with the
|
1903
2055
|
# specified log group. Subscription filters allow you to subscribe to a
|
1904
|
-
# real-time stream of log events ingested through PutLogEvents and
|
1905
|
-
# them delivered to a specific destination. Currently, the
|
1906
|
-
# destinations are:
|
2056
|
+
# real-time stream of log events ingested through [PutLogEvents][1] and
|
2057
|
+
# have them delivered to a specific destination. Currently, the
|
2058
|
+
# supported destinations are:
|
1907
2059
|
#
|
1908
2060
|
# * An Amazon Kinesis stream belonging to the same account as the
|
1909
2061
|
# subscription filter, for same-account delivery.
|
@@ -1922,6 +2074,10 @@ module Aws::CloudWatchLogs
|
|
1922
2074
|
# name in `filterName`. Otherwise, the call fails because you cannot
|
1923
2075
|
# associate a second filter with a log group.
|
1924
2076
|
#
|
2077
|
+
#
|
2078
|
+
#
|
2079
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
|
2080
|
+
#
|
1925
2081
|
# @option params [required, String] :log_group_name
|
1926
2082
|
# The name of the log group.
|
1927
2083
|
#
|
@@ -1930,7 +2086,11 @@ module Aws::CloudWatchLogs
|
|
1930
2086
|
# filter, you must specify the correct name in `filterName`. Otherwise,
|
1931
2087
|
# the call fails because you cannot associate a second filter with a log
|
1932
2088
|
# group. To find the name of the filter currently associated with a log
|
1933
|
-
# group, use DescribeSubscriptionFilters.
|
2089
|
+
# group, use [DescribeSubscriptionFilters][1].
|
2090
|
+
#
|
2091
|
+
#
|
2092
|
+
#
|
2093
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeSubscriptionFilters.html
|
1934
2094
|
#
|
1935
2095
|
# @option params [required, String] :filter_pattern
|
1936
2096
|
# A filter pattern for subscribing to a filtered stream of log events.
|
@@ -2096,15 +2256,17 @@ module Aws::CloudWatchLogs
|
|
2096
2256
|
|
2097
2257
|
# Adds or updates the specified tags for the specified log group.
|
2098
2258
|
#
|
2099
|
-
# To list the tags for a log group, use ListTagsLogGroup. To remove
|
2100
|
-
# tags, use UntagLogGroup.
|
2259
|
+
# To list the tags for a log group, use [ListTagsLogGroup][1]. To remove
|
2260
|
+
# tags, use [UntagLogGroup][2].
|
2101
2261
|
#
|
2102
2262
|
# For more information about tags, see [Tag Log Groups in Amazon
|
2103
|
-
# CloudWatch Logs][
|
2263
|
+
# CloudWatch Logs][3] in the *Amazon CloudWatch Logs User Guide*.
|
2104
2264
|
#
|
2105
2265
|
#
|
2106
2266
|
#
|
2107
|
-
# [1]: https://docs.aws.amazon.com/
|
2267
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html
|
2268
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_UntagLogGroup.html
|
2269
|
+
# [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Working-with-log-groups-and-streams.html#log-group-tagging
|
2108
2270
|
#
|
2109
2271
|
# @option params [required, String] :log_group_name
|
2110
2272
|
# The name of the log group.
|
@@ -2175,8 +2337,13 @@ module Aws::CloudWatchLogs
|
|
2175
2337
|
|
2176
2338
|
# Removes the specified tags from the specified log group.
|
2177
2339
|
#
|
2178
|
-
# To list the tags for a log group, use ListTagsLogGroup. To add
|
2179
|
-
# use
|
2340
|
+
# To list the tags for a log group, use [ListTagsLogGroup][1]. To add
|
2341
|
+
# tags, use [TagLogGroup][2].
|
2342
|
+
#
|
2343
|
+
#
|
2344
|
+
#
|
2345
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_ListTagsLogGroup.html
|
2346
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_TagLogGroup.html
|
2180
2347
|
#
|
2181
2348
|
# @option params [required, String] :log_group_name
|
2182
2349
|
# The name of the log group.
|
@@ -2215,7 +2382,7 @@ module Aws::CloudWatchLogs
|
|
2215
2382
|
params: params,
|
2216
2383
|
config: config)
|
2217
2384
|
context[:gem_name] = 'aws-sdk-cloudwatchlogs'
|
2218
|
-
context[:gem_version] = '1.
|
2385
|
+
context[:gem_version] = '1.34.0'
|
2219
2386
|
Seahorse::Client::Request.new(handlers, context)
|
2220
2387
|
end
|
2221
2388
|
|