aws-sdk-cloudwatchlogs 1.88.0 → 1.96.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 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