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 CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: d12e2967f009e49e166d53cd61e224295b11968be2222cc87054968c7c75da3f
4
- data.tar.gz: 8659171d01a526b808c431dacaba5ffd1cc2780ebd2834c10f04cceac2fe074f
3
+ metadata.gz: dd79d61961e5e5dcda644d7f69f7f8a5b911a77735905c5c47a1e1ee71e311d0
4
+ data.tar.gz: 2069d23b0f271c75b30090e0e61189b4a74afbea282d8a5940f33da18c944272
5
5
  SHA512:
6
- metadata.gz: 3e6a1c1e2f4ae7721f6fe38c35f3c685a45ff4cec57379d5332c44f2f7481ee52a7dcd15c913876eda3e2eaf6361cc224f8ac9f2a573cb11e864340a227b8674
7
- data.tar.gz: 1dff809e596b218017864e62b09ff69a3b96c82be755b70527de411507324c387ac477c2d6c1cd2329029acf9b76f23d54329f9afd48f50ae31a39c42a249a7d
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.88.0
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`, and `:session_token` options.
134
- # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
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::InstanceProfileCredentails` or `Aws::ECSCredentials` to
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 `#resolve_endpoint(parameters)` where `parameters` is a Struct similar to `Aws::CloudWatchLogs::EndpointParameters`
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&lt;Types::ConfigurationTemplate&gt;
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 `logStreamNamePrefix` and
2467
- # `logStreamNames`, the action returns an `InvalidParameterException`
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`, but the value for `logStreamNamePrefix` does not
2476
- # match any log stream names specified in `logStreamNames`, the action
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. If
3404
- # you are updating an existing filter, you must specify the correct name
3405
- # in `PolicyName`. To perform a `PutAccountPolicy` subscription filter
3406
- # operation for any destination except a Lambda function, you must also
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 Centerr, the valid value is `ERROR_LOGS`.
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][2].
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/monitoring/monitor_estimated_charges_with_cloudwatch.html
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/API_SessionStreamingException.html
4634
- # [5]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_SessionTimeoutException.html
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.88.0'
5614
+ context[:gem_version] = '1.96.0'
5386
5615
  Seahorse::Client::Request.new(handlers, context)
5387
5616
  end
5388
5617