aws-sdk-cloudwatchlogs 1.88.0 → 1.96.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +40 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-cloudwatchlogs/client.rb +254 -25
- data/lib/aws-sdk-cloudwatchlogs/client_api.rb +145 -0
- data/lib/aws-sdk-cloudwatchlogs/endpoints.rb +96 -296
- data/lib/aws-sdk-cloudwatchlogs/plugins/endpoints.rb +22 -6
- data/lib/aws-sdk-cloudwatchlogs/types.rb +393 -11
- data/lib/aws-sdk-cloudwatchlogs.rb +16 -12
- data/sig/client.rbs +45 -1
- data/sig/resource.rbs +2 -0
- data/sig/types.rbs +79 -0
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: dd79d61961e5e5dcda644d7f69f7f8a5b911a77735905c5c47a1e1ee71e311d0
|
4
|
+
data.tar.gz: 2069d23b0f271c75b30090e0e61189b4a74afbea282d8a5940f33da18c944272
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 64b3e948e4a5bc252a4f4144580c232466cb0690331beedd673c3861e6c937839ed1f076503331cfe50f2a135f58e08bf19a3a0e41fd6157cf2f25489dad7ca1
|
7
|
+
data.tar.gz: 04dbb04c194d8b092eca90bb40fba955a40abbd541c0ff37b85604ebebda7c21bf247468d68982305e84625a39bd4f307e66cb1d79d9a87a19d88e0402bc4995
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,46 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.96.0 (2024-09-24)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
8
|
+
|
9
|
+
1.95.0 (2024-09-23)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
13
|
+
|
14
|
+
1.94.0 (2024-09-20)
|
15
|
+
------------------
|
16
|
+
|
17
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
18
|
+
|
19
|
+
1.93.0 (2024-09-11)
|
20
|
+
------------------
|
21
|
+
|
22
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
23
|
+
|
24
|
+
1.92.0 (2024-09-10)
|
25
|
+
------------------
|
26
|
+
|
27
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
28
|
+
|
29
|
+
1.91.0 (2024-09-04)
|
30
|
+
------------------
|
31
|
+
|
32
|
+
* Feature - Update to support new APIs for delivery of logs from AWS services.
|
33
|
+
|
34
|
+
1.90.0 (2024-09-03)
|
35
|
+
------------------
|
36
|
+
|
37
|
+
* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
|
38
|
+
|
39
|
+
1.89.0 (2024-08-30)
|
40
|
+
------------------
|
41
|
+
|
42
|
+
* Feature - This release introduces a new optional parameter: Entity, in PutLogEvents request
|
43
|
+
|
4
44
|
1.88.0 (2024-07-30)
|
5
45
|
------------------
|
6
46
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.96.0
|
@@ -32,12 +32,11 @@ require 'aws-sdk-core/plugins/checksum_algorithm.rb'
|
|
32
32
|
require 'aws-sdk-core/plugins/request_compression.rb'
|
33
33
|
require 'aws-sdk-core/plugins/defaults_mode.rb'
|
34
34
|
require 'aws-sdk-core/plugins/recursion_detection.rb'
|
35
|
+
require 'aws-sdk-core/plugins/telemetry.rb'
|
35
36
|
require 'aws-sdk-core/plugins/sign.rb'
|
36
37
|
require 'aws-sdk-core/plugins/protocols/json_rpc.rb'
|
37
38
|
require 'aws-sdk-core/plugins/event_stream_configuration.rb'
|
38
39
|
|
39
|
-
Aws::Plugins::GlobalConfiguration.add_identifier(:cloudwatchlogs)
|
40
|
-
|
41
40
|
module Aws::CloudWatchLogs
|
42
41
|
# An API client for CloudWatchLogs. To construct a client, you need to configure a `:region` and `:credentials`.
|
43
42
|
#
|
@@ -84,6 +83,7 @@ module Aws::CloudWatchLogs
|
|
84
83
|
add_plugin(Aws::Plugins::RequestCompression)
|
85
84
|
add_plugin(Aws::Plugins::DefaultsMode)
|
86
85
|
add_plugin(Aws::Plugins::RecursionDetection)
|
86
|
+
add_plugin(Aws::Plugins::Telemetry)
|
87
87
|
add_plugin(Aws::Plugins::Sign)
|
88
88
|
add_plugin(Aws::Plugins::Protocols::JsonRpc)
|
89
89
|
add_plugin(Aws::Plugins::EventStreamConfiguration)
|
@@ -130,13 +130,15 @@ module Aws::CloudWatchLogs
|
|
130
130
|
# locations will be searched for credentials:
|
131
131
|
#
|
132
132
|
# * `Aws.config[:credentials]`
|
133
|
-
# * The `:access_key_id`, `:secret_access_key`,
|
134
|
-
#
|
133
|
+
# * The `:access_key_id`, `:secret_access_key`, `:session_token`, and
|
134
|
+
# `:account_id` options.
|
135
|
+
# * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY'],
|
136
|
+
# ENV['AWS_SESSION_TOKEN'], and ENV['AWS_ACCOUNT_ID']
|
135
137
|
# * `~/.aws/credentials`
|
136
138
|
# * `~/.aws/config`
|
137
139
|
# * EC2/ECS IMDS instance profile - When used by default, the timeouts
|
138
140
|
# are very aggressive. Construct and pass an instance of
|
139
|
-
# `Aws::
|
141
|
+
# `Aws::InstanceProfileCredentials` or `Aws::ECSCredentials` to
|
140
142
|
# enable retries and extended timeouts. Instance profile credential
|
141
143
|
# fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
|
142
144
|
# to true.
|
@@ -155,6 +157,8 @@ module Aws::CloudWatchLogs
|
|
155
157
|
#
|
156
158
|
# @option options [String] :access_key_id
|
157
159
|
#
|
160
|
+
# @option options [String] :account_id
|
161
|
+
#
|
158
162
|
# @option options [Boolean] :active_endpoint_cache (false)
|
159
163
|
# When set to `true`, a thread polling for endpoints will be running in
|
160
164
|
# the background every 60 secs (default). Defaults to `false`.
|
@@ -348,6 +352,16 @@ module Aws::CloudWatchLogs
|
|
348
352
|
# ** Please note ** When response stubbing is enabled, no HTTP
|
349
353
|
# requests are made, and retries are disabled.
|
350
354
|
#
|
355
|
+
# @option options [Aws::Telemetry::TelemetryProviderBase] :telemetry_provider (Aws::Telemetry::NoOpTelemetryProvider)
|
356
|
+
# Allows you to provide a telemetry provider, which is used to
|
357
|
+
# emit telemetry data. By default, uses `NoOpTelemetryProvider` which
|
358
|
+
# will not record or emit any telemetry data. The SDK supports the
|
359
|
+
# following telemetry providers:
|
360
|
+
#
|
361
|
+
# * OpenTelemetry (OTel) - To use the OTel provider, install and require the
|
362
|
+
# `opentelemetry-sdk` gem and then, pass in an instance of a
|
363
|
+
# `Aws::Telemetry::OTelProvider` for telemetry provider.
|
364
|
+
#
|
351
365
|
# @option options [Aws::TokenProvider] :token_provider
|
352
366
|
# A Bearer Token Provider. This can be an instance of any one of the
|
353
367
|
# following classes:
|
@@ -375,7 +389,9 @@ module Aws::CloudWatchLogs
|
|
375
389
|
# sending the request.
|
376
390
|
#
|
377
391
|
# @option options [Aws::CloudWatchLogs::EndpointProvider] :endpoint_provider
|
378
|
-
# The endpoint provider used to resolve endpoints. Any object that responds to
|
392
|
+
# The endpoint provider used to resolve endpoints. Any object that responds to
|
393
|
+
# `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to
|
394
|
+
# `Aws::CloudWatchLogs::EndpointParameters`.
|
379
395
|
#
|
380
396
|
# @option options [Float] :http_continue_timeout (1)
|
381
397
|
# The number of seconds to wait for a 100-continue response before sending the
|
@@ -431,6 +447,12 @@ module Aws::CloudWatchLogs
|
|
431
447
|
# @option options [String] :ssl_ca_store
|
432
448
|
# Sets the X509::Store to verify peer certificate.
|
433
449
|
#
|
450
|
+
# @option options [OpenSSL::X509::Certificate] :ssl_cert
|
451
|
+
# Sets a client certificate when creating http connections.
|
452
|
+
#
|
453
|
+
# @option options [OpenSSL::PKey] :ssl_key
|
454
|
+
# Sets a client key when creating http connections.
|
455
|
+
#
|
434
456
|
# @option options [Float] :ssl_timeout
|
435
457
|
# Sets the SSL timeout in seconds
|
436
458
|
#
|
@@ -645,6 +667,19 @@ module Aws::CloudWatchLogs
|
|
645
667
|
# @option params [required, String] :delivery_destination_arn
|
646
668
|
# The ARN of the delivery destination to use for this delivery.
|
647
669
|
#
|
670
|
+
# @option params [Array<String>] :record_fields
|
671
|
+
# The list of record fields to be delivered to the destination, in
|
672
|
+
# order. If the delivery’s log source has mandatory fields, they must be
|
673
|
+
# included in this list.
|
674
|
+
#
|
675
|
+
# @option params [String] :field_delimiter
|
676
|
+
# The field delimiter to use between record fields when the final output
|
677
|
+
# format of a delivery is in `Plain`, `W3C`, or `Raw` format.
|
678
|
+
#
|
679
|
+
# @option params [Types::S3DeliveryConfiguration] :s3_delivery_configuration
|
680
|
+
# This structure contains parameters that are valid only when the
|
681
|
+
# delivery’s delivery destination is an S3 bucket.
|
682
|
+
#
|
648
683
|
# @option params [Hash<String,String>] :tags
|
649
684
|
# An optional list of key-value pairs to associate with the resource.
|
650
685
|
#
|
@@ -664,6 +699,12 @@ module Aws::CloudWatchLogs
|
|
664
699
|
# resp = client.create_delivery({
|
665
700
|
# delivery_source_name: "DeliverySourceName", # required
|
666
701
|
# delivery_destination_arn: "Arn", # required
|
702
|
+
# record_fields: ["FieldHeader"],
|
703
|
+
# field_delimiter: "FieldDelimiter",
|
704
|
+
# s3_delivery_configuration: {
|
705
|
+
# suffix_path: "DeliverySuffixPath",
|
706
|
+
# enable_hive_compatible_path: false,
|
707
|
+
# },
|
667
708
|
# tags: {
|
668
709
|
# "TagKey" => "TagValue",
|
669
710
|
# },
|
@@ -676,6 +717,11 @@ module Aws::CloudWatchLogs
|
|
676
717
|
# resp.delivery.delivery_source_name #=> String
|
677
718
|
# resp.delivery.delivery_destination_arn #=> String
|
678
719
|
# resp.delivery.delivery_destination_type #=> String, one of "S3", "CWL", "FH"
|
720
|
+
# resp.delivery.record_fields #=> Array
|
721
|
+
# resp.delivery.record_fields[0] #=> String
|
722
|
+
# resp.delivery.field_delimiter #=> String
|
723
|
+
# resp.delivery.s3_delivery_configuration.suffix_path #=> String
|
724
|
+
# resp.delivery.s3_delivery_configuration.enable_hive_compatible_path #=> Boolean
|
679
725
|
# resp.delivery.tags #=> Hash
|
680
726
|
# resp.delivery.tags["TagKey"] #=> String
|
681
727
|
#
|
@@ -1552,6 +1598,94 @@ module Aws::CloudWatchLogs
|
|
1552
1598
|
req.send_request(options)
|
1553
1599
|
end
|
1554
1600
|
|
1601
|
+
# Use this operation to return the valid and default values that are
|
1602
|
+
# used when creating delivery sources, delivery destinations, and
|
1603
|
+
# deliveries. For more information about deliveries, see
|
1604
|
+
# [CreateDelivery][1].
|
1605
|
+
#
|
1606
|
+
#
|
1607
|
+
#
|
1608
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CreateDelivery.html
|
1609
|
+
#
|
1610
|
+
# @option params [String] :service
|
1611
|
+
# Use this parameter to filter the response to include only the
|
1612
|
+
# configuration templates that apply to the Amazon Web Services service
|
1613
|
+
# that you specify here.
|
1614
|
+
#
|
1615
|
+
# @option params [Array<String>] :log_types
|
1616
|
+
# Use this parameter to filter the response to include only the
|
1617
|
+
# configuration templates that apply to the log types that you specify
|
1618
|
+
# here.
|
1619
|
+
#
|
1620
|
+
# @option params [Array<String>] :resource_types
|
1621
|
+
# Use this parameter to filter the response to include only the
|
1622
|
+
# configuration templates that apply to the resource types that you
|
1623
|
+
# specify here.
|
1624
|
+
#
|
1625
|
+
# @option params [Array<String>] :delivery_destination_types
|
1626
|
+
# Use this parameter to filter the response to include only the
|
1627
|
+
# configuration templates that apply to the delivery destination types
|
1628
|
+
# that you specify here.
|
1629
|
+
#
|
1630
|
+
# @option params [String] :next_token
|
1631
|
+
# The token for the next set of items to return. The token expires after
|
1632
|
+
# 24 hours.
|
1633
|
+
#
|
1634
|
+
# @option params [Integer] :limit
|
1635
|
+
# Use this parameter to limit the number of configuration templates that
|
1636
|
+
# are returned in the response.
|
1637
|
+
#
|
1638
|
+
# @return [Types::DescribeConfigurationTemplatesResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1639
|
+
#
|
1640
|
+
# * {Types::DescribeConfigurationTemplatesResponse#configuration_templates #configuration_templates} => Array<Types::ConfigurationTemplate>
|
1641
|
+
# * {Types::DescribeConfigurationTemplatesResponse#next_token #next_token} => String
|
1642
|
+
#
|
1643
|
+
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
1644
|
+
#
|
1645
|
+
# @example Request syntax with placeholder values
|
1646
|
+
#
|
1647
|
+
# resp = client.describe_configuration_templates({
|
1648
|
+
# service: "Service",
|
1649
|
+
# log_types: ["LogType"],
|
1650
|
+
# resource_types: ["ResourceType"],
|
1651
|
+
# delivery_destination_types: ["S3"], # accepts S3, CWL, FH
|
1652
|
+
# next_token: "NextToken",
|
1653
|
+
# limit: 1,
|
1654
|
+
# })
|
1655
|
+
#
|
1656
|
+
# @example Response structure
|
1657
|
+
#
|
1658
|
+
# resp.configuration_templates #=> Array
|
1659
|
+
# resp.configuration_templates[0].service #=> String
|
1660
|
+
# resp.configuration_templates[0].log_type #=> String
|
1661
|
+
# resp.configuration_templates[0].resource_type #=> String
|
1662
|
+
# resp.configuration_templates[0].delivery_destination_type #=> String, one of "S3", "CWL", "FH"
|
1663
|
+
# resp.configuration_templates[0].default_delivery_config_values.record_fields #=> Array
|
1664
|
+
# resp.configuration_templates[0].default_delivery_config_values.record_fields[0] #=> String
|
1665
|
+
# resp.configuration_templates[0].default_delivery_config_values.field_delimiter #=> String
|
1666
|
+
# resp.configuration_templates[0].default_delivery_config_values.s3_delivery_configuration.suffix_path #=> String
|
1667
|
+
# resp.configuration_templates[0].default_delivery_config_values.s3_delivery_configuration.enable_hive_compatible_path #=> Boolean
|
1668
|
+
# resp.configuration_templates[0].allowed_fields #=> Array
|
1669
|
+
# resp.configuration_templates[0].allowed_fields[0].name #=> String
|
1670
|
+
# resp.configuration_templates[0].allowed_fields[0].mandatory #=> Boolean
|
1671
|
+
# resp.configuration_templates[0].allowed_output_formats #=> Array
|
1672
|
+
# resp.configuration_templates[0].allowed_output_formats[0] #=> String, one of "json", "plain", "w3c", "raw", "parquet"
|
1673
|
+
# resp.configuration_templates[0].allowed_action_for_allow_vended_logs_delivery_for_resource #=> String
|
1674
|
+
# resp.configuration_templates[0].allowed_field_delimiters #=> Array
|
1675
|
+
# resp.configuration_templates[0].allowed_field_delimiters[0] #=> String
|
1676
|
+
# resp.configuration_templates[0].allowed_suffix_path_fields #=> Array
|
1677
|
+
# resp.configuration_templates[0].allowed_suffix_path_fields[0] #=> String
|
1678
|
+
# resp.next_token #=> String
|
1679
|
+
#
|
1680
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/DescribeConfigurationTemplates AWS API Documentation
|
1681
|
+
#
|
1682
|
+
# @overload describe_configuration_templates(params = {})
|
1683
|
+
# @param [Hash] params ({})
|
1684
|
+
def describe_configuration_templates(params = {}, options = {})
|
1685
|
+
req = build_request(:describe_configuration_templates, params)
|
1686
|
+
req.send_request(options)
|
1687
|
+
end
|
1688
|
+
|
1555
1689
|
# Retrieves a list of the deliveries that have been created in the
|
1556
1690
|
# account.
|
1557
1691
|
#
|
@@ -1600,6 +1734,11 @@ module Aws::CloudWatchLogs
|
|
1600
1734
|
# resp.deliveries[0].delivery_source_name #=> String
|
1601
1735
|
# resp.deliveries[0].delivery_destination_arn #=> String
|
1602
1736
|
# resp.deliveries[0].delivery_destination_type #=> String, one of "S3", "CWL", "FH"
|
1737
|
+
# resp.deliveries[0].record_fields #=> Array
|
1738
|
+
# resp.deliveries[0].record_fields[0] #=> String
|
1739
|
+
# resp.deliveries[0].field_delimiter #=> String
|
1740
|
+
# resp.deliveries[0].s3_delivery_configuration.suffix_path #=> String
|
1741
|
+
# resp.deliveries[0].s3_delivery_configuration.enable_hive_compatible_path #=> Boolean
|
1603
1742
|
# resp.deliveries[0].tags #=> Hash
|
1604
1743
|
# resp.deliveries[0].tags["TagKey"] #=> String
|
1605
1744
|
# resp.next_token #=> String
|
@@ -2463,18 +2602,17 @@ module Aws::CloudWatchLogs
|
|
2463
2602
|
# @option params [Array<String>] :log_stream_names
|
2464
2603
|
# Filters the results to only logs from the log streams in this list.
|
2465
2604
|
#
|
2466
|
-
# If you specify a value for both `
|
2467
|
-
# `
|
2468
|
-
# error.
|
2605
|
+
# If you specify a value for both `logStreamNames` and
|
2606
|
+
# `logStreamNamePrefix`, the action returns an
|
2607
|
+
# `InvalidParameterException` error.
|
2469
2608
|
#
|
2470
2609
|
# @option params [String] :log_stream_name_prefix
|
2471
2610
|
# Filters the results to include only events from log streams that have
|
2472
2611
|
# names starting with this prefix.
|
2473
2612
|
#
|
2474
2613
|
# If you specify a value for both `logStreamNamePrefix` and
|
2475
|
-
# `logStreamNames`,
|
2476
|
-
#
|
2477
|
-
# returns an `InvalidParameterException` error.
|
2614
|
+
# `logStreamNames`, the action returns an `InvalidParameterException`
|
2615
|
+
# error.
|
2478
2616
|
#
|
2479
2617
|
# @option params [Integer] :start_time
|
2480
2618
|
# The start of the time range, expressed as the number of milliseconds
|
@@ -2641,6 +2779,11 @@ module Aws::CloudWatchLogs
|
|
2641
2779
|
# resp.delivery.delivery_source_name #=> String
|
2642
2780
|
# resp.delivery.delivery_destination_arn #=> String
|
2643
2781
|
# resp.delivery.delivery_destination_type #=> String, one of "S3", "CWL", "FH"
|
2782
|
+
# resp.delivery.record_fields #=> Array
|
2783
|
+
# resp.delivery.record_fields[0] #=> String
|
2784
|
+
# resp.delivery.field_delimiter #=> String
|
2785
|
+
# resp.delivery.s3_delivery_configuration.suffix_path #=> String
|
2786
|
+
# resp.delivery.s3_delivery_configuration.enable_hive_compatible_path #=> Boolean
|
2644
2787
|
# resp.delivery.tags #=> Hash
|
2645
2788
|
# resp.delivery.tags["TagKey"] #=> String
|
2646
2789
|
#
|
@@ -3400,11 +3543,11 @@ module Aws::CloudWatchLogs
|
|
3400
3543
|
# [PutDestination][5], for cross-account delivery. Kinesis Data
|
3401
3544
|
# Streams and Firehose are supported as logical destinations.
|
3402
3545
|
#
|
3403
|
-
# Each account can have one account-level subscription filter policy
|
3404
|
-
# you are updating an existing filter, you must specify the
|
3405
|
-
# in `PolicyName`. To perform a `PutAccountPolicy`
|
3406
|
-
# operation for any destination except a Lambda
|
3407
|
-
# have the `iam:PassRole` permission.
|
3546
|
+
# Each account can have one account-level subscription filter policy per
|
3547
|
+
# Region. If you are updating an existing filter, you must specify the
|
3548
|
+
# correct name in `PolicyName`. To perform a `PutAccountPolicy`
|
3549
|
+
# subscription filter operation for any destination except a Lambda
|
3550
|
+
# function, you must also have the `iam:PassRole` permission.
|
3408
3551
|
#
|
3409
3552
|
#
|
3410
3553
|
#
|
@@ -3489,7 +3632,7 @@ module Aws::CloudWatchLogs
|
|
3489
3632
|
# * **FilterPattern** A filter pattern for subscribing to a filtered
|
3490
3633
|
# stream of log events.
|
3491
3634
|
#
|
3492
|
-
# * **Distribution**The method used to distribute log data to the
|
3635
|
+
# * **Distribution** The method used to distribute log data to the
|
3493
3636
|
# destination. By default, log data is grouped by log stream, but the
|
3494
3637
|
# grouping can be set to `Random` for a more even distribution. This
|
3495
3638
|
# property is only applicable when the destination is an Kinesis Data
|
@@ -3896,9 +4039,11 @@ module Aws::CloudWatchLogs
|
|
3896
4039
|
# @option params [required, String] :log_type
|
3897
4040
|
# Defines the type of log that the source is sending.
|
3898
4041
|
#
|
4042
|
+
# * For Amazon Bedrock, the valid value is `APPLICATION_LOGS`.
|
4043
|
+
#
|
3899
4044
|
# * For Amazon CodeWhisperer, the valid value is `EVENT_LOGS`.
|
3900
4045
|
#
|
3901
|
-
# * For IAM Identity
|
4046
|
+
# * For IAM Identity Center, the valid value is `ERROR_LOGS`.
|
3902
4047
|
#
|
3903
4048
|
# * For Amazon WorkMail, the valid values are `ACCESS_CONTROL_LOGS`,
|
3904
4049
|
# `AUTHENTICATION_LOGS`, `WORKMAIL_AVAILABILITY_PROVIDER_LOGS`, and
|
@@ -4142,10 +4287,14 @@ module Aws::CloudWatchLogs
|
|
4142
4287
|
# `InvalidSequenceTokenException` or `DataAlreadyAcceptedException` even
|
4143
4288
|
# if the sequence token is not valid.
|
4144
4289
|
#
|
4290
|
+
# @option params [Types::Entity] :entity
|
4291
|
+
# Reserved for internal use.
|
4292
|
+
#
|
4145
4293
|
# @return [Types::PutLogEventsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
4146
4294
|
#
|
4147
4295
|
# * {Types::PutLogEventsResponse#next_sequence_token #next_sequence_token} => String
|
4148
4296
|
# * {Types::PutLogEventsResponse#rejected_log_events_info #rejected_log_events_info} => Types::RejectedLogEventsInfo
|
4297
|
+
# * {Types::PutLogEventsResponse#rejected_entity_info #rejected_entity_info} => Types::RejectedEntityInfo
|
4149
4298
|
#
|
4150
4299
|
# @example Request syntax with placeholder values
|
4151
4300
|
#
|
@@ -4159,6 +4308,14 @@ module Aws::CloudWatchLogs
|
|
4159
4308
|
# },
|
4160
4309
|
# ],
|
4161
4310
|
# sequence_token: "SequenceToken",
|
4311
|
+
# entity: {
|
4312
|
+
# key_attributes: {
|
4313
|
+
# "EntityKeyAttributesKey" => "EntityKeyAttributesValue",
|
4314
|
+
# },
|
4315
|
+
# attributes: {
|
4316
|
+
# "EntityAttributesKey" => "EntityAttributesValue",
|
4317
|
+
# },
|
4318
|
+
# },
|
4162
4319
|
# })
|
4163
4320
|
#
|
4164
4321
|
# @example Response structure
|
@@ -4167,6 +4324,7 @@ module Aws::CloudWatchLogs
|
|
4167
4324
|
# resp.rejected_log_events_info.too_new_log_event_start_index #=> Integer
|
4168
4325
|
# resp.rejected_log_events_info.too_old_log_event_end_index #=> Integer
|
4169
4326
|
# resp.rejected_log_events_info.expired_log_event_end_index #=> Integer
|
4327
|
+
# resp.rejected_entity_info.error_type #=> String, one of "InvalidEntity", "InvalidTypeValue", "InvalidKeyAttributes", "InvalidAttributes", "EntitySizeTooLarge", "UnsupportedLogGroupType", "MissingRequiredFields"
|
4170
4328
|
#
|
4171
4329
|
# @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/PutLogEvents AWS API Documentation
|
4172
4330
|
#
|
@@ -4185,6 +4343,14 @@ module Aws::CloudWatchLogs
|
|
4185
4343
|
# The maximum number of metric filters that can be associated with a log
|
4186
4344
|
# group is 100.
|
4187
4345
|
#
|
4346
|
+
# Using regular expressions to create metric filters is supported. For
|
4347
|
+
# these filters, there is a quotas of quota of two regular expression
|
4348
|
+
# patterns within a single filter pattern. There is also a quota of five
|
4349
|
+
# regular expression patterns per log group. For more information about
|
4350
|
+
# using regular expressions in metric filters, see [ Filter pattern
|
4351
|
+
# syntax for metric filters, subscription filters, filter log events,
|
4352
|
+
# and Live Tail][2].
|
4353
|
+
#
|
4188
4354
|
# When you create a metric filter, you can also optionally assign a unit
|
4189
4355
|
# and dimensions to the metric that is created.
|
4190
4356
|
#
|
@@ -4200,12 +4366,13 @@ module Aws::CloudWatchLogs
|
|
4200
4366
|
#
|
4201
4367
|
# You can also set up a billing alarm to alert you if your charges are
|
4202
4368
|
# higher than expected. For more information, see [ Creating a Billing
|
4203
|
-
# Alarm to Monitor Your Estimated Amazon Web Services Charges][
|
4369
|
+
# Alarm to Monitor Your Estimated Amazon Web Services Charges][3].
|
4204
4370
|
#
|
4205
4371
|
#
|
4206
4372
|
#
|
4207
4373
|
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
|
4208
|
-
# [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/
|
4374
|
+
# [2]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html
|
4375
|
+
# [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/monitor_estimated_charges_with_cloudwatch.html
|
4209
4376
|
#
|
4210
4377
|
# @option params [required, String] :log_group_name
|
4211
4378
|
# The name of the log group.
|
@@ -4497,6 +4664,14 @@ module Aws::CloudWatchLogs
|
|
4497
4664
|
# it. If you are updating an existing filter, you must specify the
|
4498
4665
|
# correct name in `filterName`.
|
4499
4666
|
#
|
4667
|
+
# Using regular expressions to create subscription filters is supported.
|
4668
|
+
# For these filters, there is a quotas of quota of two regular
|
4669
|
+
# expression patterns within a single filter pattern. There is also a
|
4670
|
+
# quota of five regular expression patterns per log group. For more
|
4671
|
+
# information about using regular expressions in subscription filters,
|
4672
|
+
# see [ Filter pattern syntax for metric filters, subscription filters,
|
4673
|
+
# filter log events, and Live Tail][3].
|
4674
|
+
#
|
4500
4675
|
# To perform a `PutSubscriptionFilter` operation for any destination
|
4501
4676
|
# except a Lambda function, you must also have the `iam:PassRole`
|
4502
4677
|
# permission.
|
@@ -4505,6 +4680,7 @@ module Aws::CloudWatchLogs
|
|
4505
4680
|
#
|
4506
4681
|
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutLogEvents.html
|
4507
4682
|
# [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_PutDestination.html
|
4683
|
+
# [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/FilterAndPatternSyntax.html
|
4508
4684
|
#
|
4509
4685
|
# @option params [required, String] :log_group_name
|
4510
4686
|
# The name of the log group.
|
@@ -4630,8 +4806,8 @@ module Aws::CloudWatchLogs
|
|
4630
4806
|
# [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/CloudWatchLogs_LiveTail.html
|
4631
4807
|
# [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_LiveTailSessionStart.html
|
4632
4808
|
# [3]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_LiveTailSessionUpdate.html
|
4633
|
-
# [4]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/
|
4634
|
-
# [5]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/
|
4809
|
+
# [4]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTailResponseStream.html#CWL-Type-StartLiveTailResponseStream-SessionStreamingException
|
4810
|
+
# [5]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_StartLiveTailResponseStream.html#CWL-Type-StartLiveTailResponseStream-SessionTimeoutException
|
4635
4811
|
# [6]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/example_cloudwatch-logs_StartLiveTail_section.html
|
4636
4812
|
#
|
4637
4813
|
# @option params [required, Array<String>] :log_group_identifiers
|
@@ -5319,6 +5495,54 @@ module Aws::CloudWatchLogs
|
|
5319
5495
|
req.send_request(options)
|
5320
5496
|
end
|
5321
5497
|
|
5498
|
+
# Use this operation to update the configuration of a [delivery][1] to
|
5499
|
+
# change either the S3 path pattern or the format of the delivered logs.
|
5500
|
+
# You can't use this operation to change the source or destination of
|
5501
|
+
# the delivery.
|
5502
|
+
#
|
5503
|
+
#
|
5504
|
+
#
|
5505
|
+
# [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_Delivery.html
|
5506
|
+
#
|
5507
|
+
# @option params [required, String] :id
|
5508
|
+
# The ID of the delivery to be updated by this request.
|
5509
|
+
#
|
5510
|
+
# @option params [Array<String>] :record_fields
|
5511
|
+
# The list of record fields to be delivered to the destination, in
|
5512
|
+
# order. If the delivery’s log source has mandatory fields, they must be
|
5513
|
+
# included in this list.
|
5514
|
+
#
|
5515
|
+
# @option params [String] :field_delimiter
|
5516
|
+
# The field delimiter to use between record fields when the final output
|
5517
|
+
# format of a delivery is in `Plain`, `W3C`, or `Raw` format.
|
5518
|
+
#
|
5519
|
+
# @option params [Types::S3DeliveryConfiguration] :s3_delivery_configuration
|
5520
|
+
# This structure contains parameters that are valid only when the
|
5521
|
+
# delivery’s delivery destination is an S3 bucket.
|
5522
|
+
#
|
5523
|
+
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
5524
|
+
#
|
5525
|
+
# @example Request syntax with placeholder values
|
5526
|
+
#
|
5527
|
+
# resp = client.update_delivery_configuration({
|
5528
|
+
# id: "DeliveryId", # required
|
5529
|
+
# record_fields: ["FieldHeader"],
|
5530
|
+
# field_delimiter: "FieldDelimiter",
|
5531
|
+
# s3_delivery_configuration: {
|
5532
|
+
# suffix_path: "DeliverySuffixPath",
|
5533
|
+
# enable_hive_compatible_path: false,
|
5534
|
+
# },
|
5535
|
+
# })
|
5536
|
+
#
|
5537
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/logs-2014-03-28/UpdateDeliveryConfiguration AWS API Documentation
|
5538
|
+
#
|
5539
|
+
# @overload update_delivery_configuration(params = {})
|
5540
|
+
# @param [Hash] params ({})
|
5541
|
+
def update_delivery_configuration(params = {}, options = {})
|
5542
|
+
req = build_request(:update_delivery_configuration, params)
|
5543
|
+
req.send_request(options)
|
5544
|
+
end
|
5545
|
+
|
5322
5546
|
# Updates an existing log anomaly detector.
|
5323
5547
|
#
|
5324
5548
|
# @option params [required, String] :anomaly_detector_arn
|
@@ -5375,14 +5599,19 @@ module Aws::CloudWatchLogs
|
|
5375
5599
|
# @api private
|
5376
5600
|
def build_request(operation_name, params = {})
|
5377
5601
|
handlers = @handlers.for(operation_name)
|
5602
|
+
tracer = config.telemetry_provider.tracer_provider.tracer(
|
5603
|
+
Aws::Telemetry.module_to_tracer_name('Aws::CloudWatchLogs')
|
5604
|
+
)
|
5378
5605
|
context = Seahorse::Client::RequestContext.new(
|
5379
5606
|
operation_name: operation_name,
|
5380
5607
|
operation: config.api.operation(operation_name),
|
5381
5608
|
client: self,
|
5382
5609
|
params: params,
|
5383
|
-
config: config
|
5610
|
+
config: config,
|
5611
|
+
tracer: tracer
|
5612
|
+
)
|
5384
5613
|
context[:gem_name] = 'aws-sdk-cloudwatchlogs'
|
5385
|
-
context[:gem_version] = '1.
|
5614
|
+
context[:gem_version] = '1.96.0'
|
5386
5615
|
Seahorse::Client::Request.new(handlers, context)
|
5387
5616
|
end
|
5388
5617
|
|