aws-sdk-cloudwatchlogs 1.105.0 → 1.107.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 71216df90c030796925688169fb96c24dd572f42e6082ed6fb651d65b6e0dffc
-  data.tar.gz: 49ac3bcefb53fb109319d859604ee19e7e5459475169f3d4953785b38ec49527
+  metadata.gz: 62c15304614fa28ce6ab147d2895bc78a93367488b3e5bcd87c5eff32341cabb
+  data.tar.gz: '0417995d810095732e854e3b32237c6cba45e19c8b77d8553db77fd7b669fa79'
 SHA512:
-  metadata.gz: ab47a5a8d1daf55c9573606f7e941bc1db381e67c6486a787c0d100864cbb126e259297fa67ef776b289042c4d05259adcb9545cb959a284f9fd9cf2e47eb030
-  data.tar.gz: bcf815e5bb47cc651e1a2f32b9a5496e996e67115655a284dd2325ff268aa1e9840ca4e314c7fe8413865ed516919452163a2147ffc30b2dfc9943905f690c80
+  metadata.gz: 4552a85c2505a4ba2fd743c6d11aabc58d1b2cd11a4b0b8db84bb58b390741419a32e1a22ae6ffb9856426d713af3c3f4e152c4259bff59e6109b9f46dffda6f
+  data.tar.gz: 73dc9b59d6927777f40f09b567d26d1714d068afa33b3dce3f3f59ab02ded656e151036781f6ec411d756cf0d5026fcc9b2c36eee15332e05ac83d9f499cbc75

data/CHANGELOG.md

@@ -1,6 +1,16 @@
 Unreleased Changes
 ------------------
 
+1.107.0 (2025-01-21)
+------------------
+
+* Feature - Documentation-only update to address doc errors
+
+1.106.0 (2025-01-15)
+------------------
+
+* Feature - Code Generated Changes, see `./build_tools` or `aws-sdk-core`'s CHANGELOG.md for details.
+
 1.105.0 (2024-12-13)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.105.0
+1.107.0

data/lib/aws-sdk-cloudwatchlogs/client.rb

@@ -268,11 +268,34 @@ module Aws::CloudWatchLogs
     #     Used when loading credentials from the shared credentials file
     #     at HOME/.aws/credentials.  When not specified, 'default' is used.
     #
+    #   @option options [String] :request_checksum_calculation ("when_supported")
+    #     Determines when a checksum will be calculated for request payloads. Values are:
+    #
+    #     * `when_supported` - (default) When set, a checksum will be
+    #       calculated for all request payloads of operations modeled with the
+    #       `httpChecksum` trait where `requestChecksumRequired` is `true` and/or a
+    #       `requestAlgorithmMember` is modeled.
+    #     * `when_required` - When set, a checksum will only be calculated for
+    #       request payloads of operations modeled with the  `httpChecksum` trait where
+    #       `requestChecksumRequired` is `true` or where a `requestAlgorithmMember`
+    #       is modeled and supplied.
+    #
     #   @option options [Integer] :request_min_compression_size_bytes (10240)
     #     The minimum size in bytes that triggers compression for request
     #     bodies. The value must be non-negative integer value between 0
     #     and 10485780 bytes inclusive.
     #
+    #   @option options [String] :response_checksum_validation ("when_supported")
+    #     Determines when checksum validation will be performed on response payloads. Values are:
+    #
+    #     * `when_supported` - (default) When set, checksum validation is performed on all
+    #       response payloads of operations modeled with the `httpChecksum` trait where
+    #       `responseAlgorithms` is modeled, except when no modeled checksum algorithms
+    #       are supported.
+    #     * `when_required` - When set, checksum validation is not performed on
+    #       response payloads of operations unless the checksum algorithm is supported and
+    #       the `requestValidationModeMember` member is set to `ENABLED`.
+    #
     #   @option options [Proc] :retry_backoff
     #     A proc or lambda used for backoff. Defaults to 2**retries * retry_base_delay.
     #     This option is only used in the `legacy` retry mode.
@@ -473,9 +496,10 @@ module Aws::CloudWatchLogs
     # parameter or the `resourceIdentifier` parameter. You can't specify
     # both of those parameters in the same operation.
     #
-    # * Specify the `logGroupName` parameter to cause all log events stored
-    #   in the log group to be encrypted with that key. Only the log events
-    #   ingested after the key is associated are encrypted with that key.
+    # * Specify the `logGroupName` parameter to cause log events ingested
+    #   into that log group to be encrypted with that key. Only the log
+    #   events ingested after the key is associated are encrypted with that
+    #   key.
     #
     #   Associating a KMS key with a log group overrides any existing
     #   associations between the log group and a KMS key. After a KMS key is
@@ -759,6 +783,14 @@ module Aws::CloudWatchLogs
     # specify a prefix to be used as the Amazon S3 key prefix for all
     # exported objects.
     #
+    # <note markdown="1"> We recommend that you don't regularly export to Amazon S3 as a way to
+    # continuously archive your logs. For that use case, we instaed
+    # recommend that you use subscriptions. For more information about
+    # subscriptions, see [Real-time processing of log data with
+    # subscriptions][3].
+    #
+    #  </note>
+    #
     # <note markdown="1"> Time-based sorting on chunks of log data inside an exported file is
     # not guaranteed. You can sort the exported log field data by using
     # Linux utilities.
@@ -769,6 +801,7 @@ module Aws::CloudWatchLogs
     #
     # [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeExportTasks.html
     # [2]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_CancelExportTask.html
+    # [3]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/Subscriptions.html
     #
     # @option params [String] :task_name
     #   The name of the export task.
@@ -1189,7 +1222,7 @@ module Aws::CloudWatchLogs
       req.send_request(options)
     end
 
-    # Deletes s *delivery*. A delivery is a connection between a logical
+    # Deletes a *delivery*. A delivery is a connection between a logical
     # *delivery source* and a logical *delivery destination*. Deleting a
     # delivery only deletes the connection between the delivery source and
     # delivery destination. It does not delete the delivery destination or
@@ -1674,6 +1707,25 @@ module Aws::CloudWatchLogs
 
     # Returns a list of all CloudWatch Logs account policies in the account.
     #
+    # To use this operation, you must be signed on with the correct
+    # permissions depending on the type of policy that you are retrieving
+    # information for.
+    #
+    # * To see data protection policies, you must have the
+    #   `logs:GetDataProtectionPolicy` and `logs:DescribeAccountPolicies`
+    #   permissions.
+    #
+    # * To see subscription filter policies, you must have the
+    #   `logs:DescrubeSubscriptionFilters` and
+    #   `logs:DescribeAccountPolicies` permissions.
+    #
+    # * To see transformer policies, you must have the `logs:GetTransformer`
+    #   and `logs:DescribeAccountPolicies` permissions.
+    #
+    # * To see field index policies, you must have the
+    #   `logs:DescribeIndexPolicies` and `logs:DescribeAccountPolicies`
+    #   permissions.
+    #
     # @option params [required, String] :policy_type
     #   Use this parameter to limit the returned policies to only the policies
     #   that match the policy type that you specify.
@@ -2326,8 +2378,8 @@ module Aws::CloudWatchLogs
     # `logGroupIdentifier` or `logGroupName`. You must include one of these
     # two parameters, but you can't include both.
     #
-    # This operation has a limit of five transactions per second, after
-    # which transactions are throttled.
+    # This operation has a limit of 25 transactions per second, after which
+    # transactions are throttled.
     #
     # If you are using CloudWatch cross-account observability, you can use
     # this operation in a monitoring account and view data from the linked
@@ -4022,6 +4074,22 @@ module Aws::CloudWatchLogs
     # policy, or field index policy that applies to all log groups or a
     # subset of log groups in the account.
     #
+    # To use this operation, you must be signed on with the correct
+    # permissions depending on the type of policy that you are creating.
+    #
+    # * To create a data protection policy, you must have the
+    #   `logs:PutDataProtectionPolicy` and `logs:PutAccountPolicy`
+    #   permissions.
+    #
+    # * To create a subscription filter policy, you must have the
+    #   `logs:PutSubscriptionFilter` and `logs:PutccountPolicy` permissions.
+    #
+    # * To create a transformer policy, you must have the
+    #   `logs:PutTransformer` and `logs:PutAccountPolicy` permissions.
+    #
+    # * To create a field index policy, you must have the
+    #   `logs:PutIndexPolicy` and `logs:PutAccountPolicy` permissions.
+    #
     # **Data protection policy**
     #
     # A data protection policy can help safeguard sensitive data that's
@@ -4499,9 +4567,10 @@ module Aws::CloudWatchLogs
     #   the resource that is actually sending the logs. For more
     #   information, see [PutDeliverySource][1].
     #
-    # * Use `PutDeliveryDestination` to create a *delivery destination*,
-    #   which is a logical object that represents the actual delivery
-    #   destination.
+    # * Use `PutDeliveryDestination` to create a *delivery destination* in
+    #   the same account of the actual delivery destination. The delivery
+    #   destination that you create is a logical object that represents the
+    #   actual delivery destination.
     #
     # * If you are delivering logs cross-account, you must use
     #   [PutDeliveryDestinationPolicy][2] in the destination account to
@@ -4718,13 +4787,27 @@ module Aws::CloudWatchLogs
     #
     #   * For Amazon Bedrock, the valid value is `APPLICATION_LOGS`.
     #
+    #   * For CloudFront, the valid value is `ACCESS_LOGS`.
+    #
     #   * For Amazon CodeWhisperer, the valid value is `EVENT_LOGS`.
     #
+    #   * For Elemental MediaPackage, the valid values are
+    #     `EGRESS_ACCESS_LOGS` and `INGRESS_ACCESS_LOGS`.
+    #
+    #   * For Elemental MediaTailor, the valid values are
+    #     `AD_DECISION_SERVER_LOGS`, `MANIFEST_SERVICE_LOGS`, and
+    #     `TRANSCODE_LOGS`.
+    #
     #   * For IAM Identity Center, the valid value is `ERROR_LOGS`.
     #
+    #   * For Amazon Q, the valid value is `EVENT_LOGS`.
+    #
+    #   * For Amazon SES mail manager, the valid value is `APPLICATION_LOG`.
+    #
     #   * For Amazon WorkMail, the valid values are `ACCESS_CONTROL_LOGS`,
-    #     `AUTHENTICATION_LOGS`, `WORKMAIL_AVAILABILITY_PROVIDER_LOGS`, and
-    #     `WORKMAIL_MAILBOX_ACCESS_LOGS`.
+    #     `AUTHENTICATION_LOGS`, `WORKMAIL_AVAILABILITY_PROVIDER_LOGS`,
+    #     `WORKMAIL_MAILBOX_ACCESS_LOGS`, and
+    #     `WORKMAIL_PERSONAL_ACCESS_TOKEN_LOGS`.
     #
     # @option params [Hash<String,String>] :tags
     #   An optional list of key-value pairs to associate with the resource.
@@ -5181,12 +5264,12 @@ module Aws::CloudWatchLogs
     # The maximum number of metric filters that can be associated with a log
     # group is 100.
     #
-    # Using regular expressions to create metric filters is supported. For
-    # these filters, there is a quota of two regular expression patterns
-    # within a single filter pattern. There is also a quota of five regular
+    # Using regular expressions in filter patterns is supported. For these
+    # filters, there is a quota of two regular expression patterns within a
+    # single filter pattern. There is also a quota of five regular
     # expression patterns per log group. For more information about using
-    # regular expressions in metric filters, see [ Filter pattern syntax for
-    # metric filters, subscription filters, filter log events, and Live
+    # regular expressions in filter patterns, see [ Filter pattern syntax
+    # for metric filters, subscription filters, filter log events, and Live
     # Tail][2].
     #
     # When you create a metric filter, you can also optionally assign a unit
@@ -5531,13 +5614,13 @@ module Aws::CloudWatchLogs
     # it. If you are updating an existing filter, you must specify the
     # correct name in `filterName`.
     #
-    # Using regular expressions to create subscription filters is supported.
-    # For these filters, there is a quotas of quota of two regular
-    # expression patterns within a single filter pattern. There is also a
-    # quota of five regular expression patterns per log group. For more
-    # information about using regular expressions in subscription filters,
-    # see [ Filter pattern syntax for metric filters, subscription filters,
-    # filter log events, and Live Tail][3].
+    # Using regular expressions in filter patterns is supported. For these
+    # filters, there is a quotas of quota of two regular expression patterns
+    # within a single filter pattern. There is also a quota of five regular
+    # expression patterns per log group. For more information about using
+    # regular expressions in filter patterns, see [ Filter pattern syntax
+    # for metric filters, subscription filters, filter log events, and Live
+    # Tail][3].
     #
     # To perform a `PutSubscriptionFilter` operation for any destination
     # except a Lambda function, you must also have the `iam:PassRole`
@@ -6918,7 +7001,7 @@ module Aws::CloudWatchLogs
         tracer: tracer
       )
       context[:gem_name] = 'aws-sdk-cloudwatchlogs'
-      context[:gem_version] = '1.105.0'
+      context[:gem_version] = '1.107.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-cloudwatchlogs/types.rb

@@ -4949,12 +4949,12 @@ module Aws::CloudWatchLogs
     #   create the integration. This role must have the permissions
     #   necessary to access the OpenSearch Service collection to be able to
     #   create the dashboards. For more information about the permissions
-    #   needed, see [Create an IAM role to access the OpenSearch Service
-    #   collection][1] in the CloudWatch Logs User Guide.
+    #   needed, see [Permissions that the integration needs][1] in the
+    #   CloudWatch Logs User Guide.
     #
     #
     #
-    #   [1]: https://docs.aws.amazon.com/OpenSearch-Dashboards-CreateRole
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/OpenSearch-Dashboards-CreateRole.html
     #   @return [String]
     #
     # @!attribute [rw] dashboard_viewer_principals
@@ -4962,8 +4962,12 @@ module Aws::CloudWatchLogs
     #   permission to for viewing the dashboards.
     #
     #   In addition to specifying these users here, you must also grant them
-    #   the **CloudWatchOpenSearchDashboardsAccess** IAM policy. For more
-    #   information, see
+    #   the **CloudWatchOpenSearchDashboardAccess** IAM policy. For more
+    #   information, see [IAM policies for users][1].
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/OpenSearch-Dashboards-UserRoles.html
     #   @return [Array<String>]
     #
     # @!attribute [rw] application_arn
@@ -5982,13 +5986,27 @@ module Aws::CloudWatchLogs
     #
     #   * For Amazon Bedrock, the valid value is `APPLICATION_LOGS`.
     #
+    #   * For CloudFront, the valid value is `ACCESS_LOGS`.
+    #
     #   * For Amazon CodeWhisperer, the valid value is `EVENT_LOGS`.
     #
+    #   * For Elemental MediaPackage, the valid values are
+    #     `EGRESS_ACCESS_LOGS` and `INGRESS_ACCESS_LOGS`.
+    #
+    #   * For Elemental MediaTailor, the valid values are
+    #     `AD_DECISION_SERVER_LOGS`, `MANIFEST_SERVICE_LOGS`, and
+    #     `TRANSCODE_LOGS`.
+    #
     #   * For IAM Identity Center, the valid value is `ERROR_LOGS`.
     #
+    #   * For Amazon Q, the valid value is `EVENT_LOGS`.
+    #
+    #   * For Amazon SES mail manager, the valid value is `APPLICATION_LOG`.
+    #
     #   * For Amazon WorkMail, the valid values are `ACCESS_CONTROL_LOGS`,
-    #     `AUTHENTICATION_LOGS`, `WORKMAIL_AVAILABILITY_PROVIDER_LOGS`, and
-    #     `WORKMAIL_MAILBOX_ACCESS_LOGS`.
+    #     `AUTHENTICATION_LOGS`, `WORKMAIL_AVAILABILITY_PROVIDER_LOGS`,
+    #     `WORKMAIL_MAILBOX_ACCESS_LOGS`, and
+    #     `WORKMAIL_PERSONAL_ACCESS_TOKEN_LOGS`.
     #   @return [String]
     #
     # @!attribute [rw] tags
@@ -7033,9 +7051,14 @@ module Aws::CloudWatchLogs
     # @!attribute [rw] suffix_path
     #   This string allows re-configuring the S3 object prefix to contain
     #   either static or variable sections. The valid variables to use in
-    #   the suffix path will vary by each log source. See
-    #   ConfigurationTemplate$allowedSuffixPathFields for more info on what
-    #   values are supported in the suffix path for each log source.
+    #   the suffix path will vary by each log source. To find the values
+    #   supported for the suffix path for each log source, use the
+    #   [DescribeConfigurationTemplates][1] operation and check the
+    #   `allowedSuffixPathFields` field in the response.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonCloudWatchLogs/latest/APIReference/API_DescribeConfigurationTemplates.html
     #   @return [String]
     #
     # @!attribute [rw] enable_hive_compatible_path
@@ -7083,7 +7106,7 @@ module Aws::CloudWatchLogs
     #
     class ServiceUnavailableException < Aws::EmptyStructure; end
 
-    # his exception is returned if an unknown error occurs during a Live
+    # This exception is returned if an unknown error occurs during a Live
     # Tail session.
     #
     # @!attribute [rw] message

data/lib/aws-sdk-cloudwatchlogs.rb

@@ -55,7 +55,7 @@ module Aws::CloudWatchLogs
   autoload :Endpoints, 'aws-sdk-cloudwatchlogs/endpoints'
   autoload :EventStreams, 'aws-sdk-cloudwatchlogs/event_streams'
 
-  GEM_VERSION = '1.105.0'
+  GEM_VERSION = '1.107.0'
 
 end
 

data/sig/client.rbs

@@ -42,7 +42,9 @@ module Aws
                       ?max_attempts: Integer,
                       ?output_event_stream_handler: Proc,
                       ?profile: String,
+                      ?request_checksum_calculation: String,
                       ?request_min_compression_size_bytes: Integer,
+                      ?response_checksum_validation: String,
                       ?retry_backoff: Proc,
                       ?retry_base_delay: Float,
                       ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),

data/sig/resource.rbs

@@ -42,7 +42,9 @@ module Aws
                         ?max_attempts: Integer,
                         ?output_event_stream_handler: Proc,
                         ?profile: String,
+                        ?request_checksum_calculation: String,
                         ?request_min_compression_size_bytes: Integer,
+                        ?response_checksum_validation: String,
                         ?retry_backoff: Proc,
                         ?retry_base_delay: Float,
                         ?retry_jitter: (:none | :equal | :full | ^(Integer) -> Integer),

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: aws-sdk-cloudwatchlogs
 version: !ruby/object:Gem::Version
-  version: 1.105.0
+  version: 1.107.0
 platform: ruby
 authors:
 - Amazon Web Services
 autorequire:
 bindir: bin
 cert_chain: []
-date: 2024-12-13 00:00:00.000000000 Z
+date: 2025-01-21 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: aws-sdk-core
@@ -19,7 +19,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.210.0
+        version: 3.216.0
   type: :runtime
   prerelease: false
   version_requirements: !ruby/object:Gem::Requirement
@@ -29,7 +29,7 @@ dependencies:
         version: '3'
     - - ">="
       - !ruby/object:Gem::Version
-        version: 3.210.0
+        version: 3.216.0
 - !ruby/object:Gem::Dependency
   name: aws-sigv4
   requirement: !ruby/object:Gem::Requirement