update generated code

Author: async-aws-bot

manifest.json

@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.337.1"
+        "${LATEST}": "3.337.3"
     },
     "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
     "services": {

src/Service/CloudWatchLogs/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Changed
+
+- AWS enhancement: Documentation updates.
+
 ## 2.4.0
 
 ### Added

src/Service/CloudWatchLogs/src/CloudWatchLogsClient.php

@@ -138,7 +138,7 @@ public function createLogStream($input): Result
      * You can specify the log group to search by using either `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 source accounts. For more information, see CloudWatch cross-account observability [^1].

src/Service/Sns/CHANGELOG.md

@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Changed
+
+- AWS enhancement: Documentation updates.
+
 ## 1.7.5
 
 ### Changed

src/Service/Sns/src/Input/CreateTopicInput.php

@@ -66,11 +66,23 @@ final class CreateTopicInput extends Input
      *     (Optional) To override the generated value, you can specify a value for the `MessageDeduplicationId` parameter
      *     for the `Publish` action.
      *
+     *
+     * - `FifoThroughputScope` – Enables higher throughput for your FIFO topic by adjusting the scope of deduplication.
+     *   This attribute has two possible values:
+     *
+     *   - `Topic` – The scope of message deduplication is across the entire topic. This is the default value and
+     *     maintains existing behavior, with a maximum throughput of 3000 messages per second or 20MB per second, whichever
+     *     comes first.
+     *   - `MessageGroup` – The scope of deduplication is within each individual message group, which enables higher
+     *     throughput per topic subject to regional quotas. For more information on quotas or to request an increase, see
+     *     Amazon SNS service quotas [^6] in the Amazon Web Services General Reference.
+     *
      * [^1]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html
      * [^2]: https://docs.aws.amazon.com/sns/latest/dg/sns-server-side-encryption.html#sse-key-terms
      * [^3]: https://docs.aws.amazon.com/kms/latest/APIReference/API_DescribeKey.html#API_DescribeKey_RequestParameters
      * [^4]: https://docs.aws.amazon.com/sns/latest/dg/sns-fifo-topics.html
      * [^5]: https://docs.aws.amazon.com/sns/latest/api/API_Publish.html
+     * [^6]: https://docs.aws.amazon.com/general/latest/gr/sns.html
      *
      * @var array<string, string>|null
      */

src/Service/Sns/src/Input/PublishInput.php

@@ -116,15 +116,32 @@ final class PublishInput extends Input
     private $messageAttributes;
 
     /**
-     * This parameter applies only to FIFO (first-in-first-out) topics. The `MessageDeduplicationId` can contain up to 128
-     * alphanumeric characters `(a-z, A-Z, 0-9)` and punctuation `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`.
+     * - This parameter applies only to FIFO (first-in-first-out) topics. The `MessageDeduplicationId` can contain up to 128
+     *   alphanumeric characters `(a-z, A-Z, 0-9)` and punctuation `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`.
+     * - Every message must have a unique `MessageDeduplicationId`, which is a token used for deduplication of sent messages
+     *   within the 5 minute minimum deduplication interval.
+     * - The scope of deduplication depends on the `FifoThroughputScope` attribute, when set to `Topic` the message
+     *   deduplication scope is across the entire topic, when set to `MessageGroup` the message deduplication scope is
+     *   within each individual message group.
+     * - If a message with a particular `MessageDeduplicationId` is sent successfully, subsequent messages within the
+     *   deduplication scope and interval, with the same `MessageDeduplicationId`, are accepted successfully but aren't
+     *   delivered.
+     * - Every message must have a unique `MessageDeduplicationId`:
      *
-     * Every message must have a unique `MessageDeduplicationId`, which is a token used for deduplication of sent messages.
-     * If a message with a particular `MessageDeduplicationId` is sent successfully, any message sent with the same
-     * `MessageDeduplicationId` during the 5-minute deduplication interval is treated as a duplicate.
+     *   - You may provide a `MessageDeduplicationId` explicitly.
+     *   - If you aren't able to provide a `MessageDeduplicationId` and you enable `ContentBasedDeduplication` for your
+     *     topic, Amazon SNS uses a SHA-256 hash to generate the `MessageDeduplicationId` using the body of the message (but
+     *     not the attributes of the message).
+     *   - If you don't provide a `MessageDeduplicationId` and the topic doesn't have `ContentBasedDeduplication` set, the
+     *     action fails with an error.
+     *   - If the topic has a `ContentBasedDeduplication` set, your `MessageDeduplicationId` overrides the generated one.
      *
-     * If the topic has `ContentBasedDeduplication` set, the system generates a `MessageDeduplicationId` based on the
-     * contents of the message. Your `MessageDeduplicationId` overrides the generated one.
+     * - When `ContentBasedDeduplication` is in effect, messages with identical content sent within the deduplication scope
+     *   and interval are treated as duplicates and only one copy of the message is delivered.
+     * - If you send one message with `ContentBasedDeduplication` enabled, and then another message with a
+     *   `MessageDeduplicationId` that is the same as the one generated for the first `MessageDeduplicationId`, the two
+     *   messages are treated as duplicates, within the deduplication scope and interval, and only one copy of the message
+     *   is delivered.
      *
      * @var string|null
      */

src/Service/Sns/src/ValueObject/PublishBatchRequestEntry.php

@@ -63,10 +63,16 @@ final class PublishBatchRequestEntry
     /**
      * This parameter applies only to FIFO (first-in-first-out) topics.
      *
-     * The token used for deduplication of messages within a 5-minute minimum deduplication interval. If a message with a
-     * particular `MessageDeduplicationId` is sent successfully, subsequent messages with the same `MessageDeduplicationId`
-     * are accepted successfully but aren't delivered.
-     *
+     * - This parameter applies only to FIFO (first-in-first-out) topics. The `MessageDeduplicationId` can contain up to 128
+     *   alphanumeric characters `(a-z, A-Z, 0-9)` and punctuation `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`.
+     * - Every message must have a unique `MessageDeduplicationId`, which is a token used for deduplication of sent messages
+     *   within the 5 minute minimum deduplication interval.
+     * - The scope of deduplication depends on the `FifoThroughputScope` attribute, when set to `Topic` the message
+     *   deduplication scope is across the entire topic, when set to `MessageGroup` the message deduplication scope is
+     *   within each individual message group.
+     * - If a message with a particular `MessageDeduplicationId` is sent successfully, subsequent messages within the
+     *   deduplication scope and interval, with the same `MessageDeduplicationId`, are accepted successfully but aren't
+     *   delivered.
      * - Every message must have a unique `MessageDeduplicationId`.
      *
      *   - You may provide a `MessageDeduplicationId` explicitly.
@@ -77,11 +83,12 @@ final class PublishBatchRequestEntry
      *     action fails with an error.
      *   - If the topic has a `ContentBasedDeduplication` set, your `MessageDeduplicationId` overrides the generated one.
      *
-     * - When `ContentBasedDeduplication` is in effect, messages with identical content sent within the deduplication
-     *   interval are treated as duplicates and only one copy of the message is delivered.
+     * - When `ContentBasedDeduplication` is in effect, messages with identical content sent within the deduplication scope
+     *   and interval are treated as duplicates and only one copy of the message is delivered.
      * - If you send one message with `ContentBasedDeduplication` enabled, and then another message with a
      *   `MessageDeduplicationId` that is the same as the one generated for the first `MessageDeduplicationId`, the two
-     *   messages are treated as duplicates and only one copy of the message is delivered.
+     *   messages are treated as duplicates, within the deduplication scope and interval, and only one copy of the message
+     *   is delivered.
      *
      * > The `MessageDeduplicationId` is available to the consumer of the message (this can be useful for troubleshooting
      * > delivery issues).
@@ -91,11 +98,6 @@ final class PublishBatchRequestEntry
      * >
      * > Amazon SNS continues to keep track of the message deduplication ID even after the message is received and deleted.
      *
-     * The length of `MessageDeduplicationId` is 128 characters.
-     *
-     * `MessageDeduplicationId` can contain alphanumeric characters `(a-z, A-Z, 0-9)` and punctuation
-     * `(!"#$%&'()*+,-./:;<=>?@[\]^_`{|}~)`.
-     *
      * @var string|null
      */
     private $messageDeduplicationId;