Update generated code (#1806)

async-aws-bot · web-flow · commit 467a79e2939a · 2024-11-22T12:21:26.000Z
update generated code
diff --git a/manifest.json b/manifest.json
@@ -1,6 +1,6 @@
 {
     "variables": {
-        "${LATEST}": "3.328.3"
+        "${LATEST}": "3.329.0"
     },
     "endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",
     "services": {
diff --git a/src/Service/AppSync/CHANGELOG.md b/src/Service/AppSync/CHANGELOG.md
@@ -2,6 +2,10 @@
 
 ## NOT RELEASED
 
+### Added
+
+- AWS api-change: Add support for the Amazon Bedrock Runtime.
+
 ### Changed
 
 - use strict comparison `null !==` instead of `!`
diff --git a/src/Service/AppSync/composer.json b/src/Service/AppSync/composer.json
@@ -28,7 +28,7 @@
     },
     "extra": {
         "branch-alias": {
-            "dev-master": "3.0-dev"
+            "dev-master": "3.1-dev"
         }
     }
 }
diff --git a/src/Service/AppSync/src/Enum/DataSourceType.php b/src/Service/AppSync/src/Enum/DataSourceType.php
@@ -4,6 +4,7 @@
 
 final class DataSourceType
 {
+    public const AMAZON_BEDROCK_RUNTIME = 'AMAZON_BEDROCK_RUNTIME';
     public const AMAZON_DYNAMODB = 'AMAZON_DYNAMODB';
     public const AMAZON_ELASTICSEARCH = 'AMAZON_ELASTICSEARCH';
     public const AMAZON_EVENTBRIDGE = 'AMAZON_EVENTBRIDGE';
@@ -16,6 +17,7 @@ final class DataSourceType
     public static function exists(string $value): bool
     {
         return isset([
+            self::AMAZON_BEDROCK_RUNTIME => true,
             self::AMAZON_DYNAMODB => true,
             self::AMAZON_ELASTICSEARCH => true,
             self::AMAZON_EVENTBRIDGE => true,
diff --git a/src/Service/CloudWatchLogs/CHANGELOG.md b/src/Service/CloudWatchLogs/CHANGELOG.md
@@ -5,6 +5,7 @@
 ### Changed
 
 - use strict comparison `null !==` instead of `!`
+- AWS enhancement: Documentation updates.
 
 ## 2.3.0
 
diff --git a/src/Service/CloudWatchLogs/src/Input/PutLogEventsRequest.php b/src/Service/CloudWatchLogs/src/Input/PutLogEventsRequest.php
@@ -50,7 +50,7 @@ final class PutLogEventsRequest extends Input
     private $sequenceToken;
 
     /**
-     * Reserved for internal use.
+     * The entity associated with the log events.
      *
      * @var Entity|null
      */
diff --git a/src/Service/CloudWatchLogs/src/Result/PutLogEventsResponse.php b/src/Service/CloudWatchLogs/src/Result/PutLogEventsResponse.php
@@ -30,7 +30,9 @@ class PutLogEventsResponse extends Result
     private $rejectedLogEventsInfo;
 
     /**
-     * Reserved for internal use.
+     * Information about why the entity is rejected when calling `PutLogEvents`. Only returned when the entity is rejected.
+     *
+     * > When the entity is rejected, the events may still be accepted.
      *
      * @var RejectedEntityInfo|null
      */
diff --git a/src/Service/CloudWatchLogs/src/ValueObject/Entity.php b/src/Service/CloudWatchLogs/src/ValueObject/Entity.php
@@ -3,19 +3,33 @@
 namespace AsyncAws\CloudWatchLogs\ValueObject;
 
 /**
- * Reserved for internal use.
+ * The entity associated with the log events in a `PutLogEvents` call.
  */
 final class Entity
 {
     /**
-     * Reserved for internal use.
+     * The attributes of the entity which identify the specific entity, as a list of key-value pairs. Entities with the same
+     * `keyAttributes` are considered to be the same entity.
+     *
+     * There are five allowed attributes (key names): `Type`, `ResourceType`, `Identifier``Name`, and `Environment`.
+     *
+     * For details about how to use the key attributes, see How to add related information to telemetry [^1] in the
+     * *CloudWatch User Guide*.
+     *
+     * [^1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/adding-your-own-related-telemetry.html
      *
      * @var array<string, string>|null
      */
     private $keyAttributes;
 
     /**
-     * Reserved for internal use.
+     * Additional attributes of the entity that are not used to specify the identity of the entity. A list of key-value
+     * pairs.
+     *
+     * For details about how to use the attributes, see How to add related information to telemetry [^1] in the *CloudWatch
+     * User Guide*.
+     *
+     * [^1]: https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/adding-your-own-related-telemetry.html
      *
      * @var array<string, string>|null
      */
diff --git a/src/Service/CloudWatchLogs/src/ValueObject/RejectedEntityInfo.php b/src/Service/CloudWatchLogs/src/ValueObject/RejectedEntityInfo.php
@@ -6,12 +6,13 @@
 use AsyncAws\Core\Exception\InvalidArgument;
 
 /**
- * Reserved for internal use.
+ * If an entity is rejected when a `PutLogEvents` request was made, this includes details about the reason for the
+ * rejection.
  */
 final class RejectedEntityInfo
 {
     /**
-     * Reserved for internal use.
+     * The type of error that caused the rejection of the entity when calling `PutLogEvents`.
      *
      * @var EntityRejectionErrorType::*
      */
diff --git a/src/Service/ElastiCache/CHANGELOG.md b/src/Service/ElastiCache/CHANGELOG.md
@@ -5,6 +5,7 @@
 ### Changed
 
 - use strict comparison `null !==` instead of `!`
+- AWS enhancement: Documentation updates.
 
 ## 1.2.3
 
diff --git a/src/Service/ElastiCache/src/ValueObject/CacheCluster.php b/src/Service/ElastiCache/src/ValueObject/CacheCluster.php
@@ -116,8 +116,8 @@ final class CacheCluster
      * - The configuration variables `appendonly` and `appendfsync` are not supported on Valkey, or on Redis OSS version
      *   2.8.22 and later.
      *
-     * [^1]: https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/CacheNodes.SupportedTypes.html#CacheNodes.SupportedTypesByRegion
-     * [^2]: https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/CacheNodes.SupportedTypes.html#CacheNodes.SupportedTypesByRegion
+     * [^1]: https://docs.aws.amazon.com/AmazonElastiCache/latest/dg/CacheNodes.SupportedTypes.html#CacheNodes.SupportedTypesByRegion
+     * [^2]: https://docs.aws.amazon.com/AmazonElastiCache/latest/dg/CacheNodes.SupportedTypes.html#CacheNodes.SupportedTypesByRegion
      *
      * @var string|null
      */
diff --git a/src/Service/ElastiCache/src/ValueObject/CacheNode.php b/src/Service/ElastiCache/src/ValueObject/CacheNode.php
@@ -84,8 +84,8 @@
  * - The configuration variables `appendonly` and `appendfsync` are not supported on Valkey, or on Redis OSS version
  *   2.8.22 and later.
  *
- * [^1]: https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/CacheNodes.SupportedTypes.html#CacheNodes.SupportedTypesByRegion
- * [^2]: https://docs.aws.amazon.com/AmazonElastiCache/latest/red-ug/CacheNodes.SupportedTypes.html#CacheNodes.SupportedTypesByRegion
+ * [^1]: https://docs.aws.amazon.com/AmazonElastiCache/latest/dg/CacheNodes.SupportedTypes.html#CacheNodes.SupportedTypesByRegion
+ * [^2]: https://docs.aws.amazon.com/AmazonElastiCache/latest/dg/CacheNodes.SupportedTypes.html#CacheNodes.SupportedTypesByRegion
  */
 final class CacheNode
 {
diff --git a/src/Service/S3/CHANGELOG.md b/src/Service/S3/CHANGELOG.md
@@ -5,6 +5,7 @@
 ### Added
 
 - AWS api-change: Add support for the new optional bucket-region and prefix query parameters in the ListBuckets API. For ListBuckets requests that express pagination, Amazon S3 will now return both the bucket names and associated AWS regions in the response.
+- AWS api-change: Add support for conditional deletes for the S3 DeleteObject and DeleteObjects APIs. Add support for write offset bytes option used to append to objects with the S3 PutObject API.
 
 ### Changed
 
diff --git a/src/Service/S3/src/Exception/EncryptionTypeMismatchException.php b/src/Service/S3/src/Exception/EncryptionTypeMismatchException.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace AsyncAws\S3\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The existing object was created with a different encryption type. Subsequent write requests must include the
+ * appropriate encryption parameters in the request or while creating the session.
+ */
+final class EncryptionTypeMismatchException extends ClientException
+{
+}
diff --git a/src/Service/S3/src/Exception/InvalidRequestException.php b/src/Service/S3/src/Exception/InvalidRequestException.php
@@ -0,0 +1,17 @@
+<?php
+
+namespace AsyncAws\S3\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * You may receive this error in multiple cases. Depending on the reason for the error, you may receive one of the
+ * messages below:
+ *
+ * - Cannot specify both a write offset value and user-defined object metadata for existing objects.
+ * - Checksum Type mismatch occurred, expected checksum Type: sha1, actual checksum Type: crc32c.
+ * - Request body cannot be empty when 'write offset' is specified.
+ */
+final class InvalidRequestException extends ClientException
+{
+}
diff --git a/src/Service/S3/src/Exception/InvalidWriteOffsetException.php b/src/Service/S3/src/Exception/InvalidWriteOffsetException.php
@@ -0,0 +1,12 @@
+<?php
+
+namespace AsyncAws\S3\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * The write offset value that you specified does not match the current object size.
+ */
+final class InvalidWriteOffsetException extends ClientException
+{
+}
diff --git a/src/Service/S3/src/Exception/TooManyPartsException.php b/src/Service/S3/src/Exception/TooManyPartsException.php
@@ -0,0 +1,13 @@
+<?php
+
+namespace AsyncAws\S3\Exception;
+
+use AsyncAws\Core\Exception\Http\ClientException;
+
+/**
+ * You have attempted to add more parts than the maximum of 10000 that are allowed for this object. You can use the
+ * CopyObject operation to copy this object to another and then add more data to the newly copied object.
+ */
+final class TooManyPartsException extends ClientException
+{
+}
diff --git a/src/Service/S3/src/Input/AbortMultipartUploadRequest.php b/src/Service/S3/src/Input/AbortMultipartUploadRequest.php
@@ -75,13 +75,26 @@ final class AbortMultipartUploadRequest extends Input
      */
     private $expectedBucketOwner;
 
+    /**
+     * If present, this header aborts an in progress multipart upload only if it was initiated on the provided timestamp. If
+     * the initiated timestamp of the multipart upload does not match the provided value, the operation returns a `412
+     * Precondition Failed` error. If the initiated timestamp matches or if the multipart upload doesn’t exist, the
+     * operation returns a `204 Success (No Content)` response.
+     *
+     * > This functionality is only supported for directory buckets.
+     *
+     * @var \DateTimeImmutable|null
+     */
+    private $ifMatchInitiatedTime;
+
     /**
      * @param array{
      *   Bucket?: string,
      *   Key?: string,
      *   UploadId?: string,
      *   RequestPayer?: null|RequestPayer::*,
      *   ExpectedBucketOwner?: null|string,
+     *   IfMatchInitiatedTime?: null|\DateTimeImmutable|string,
      *   '@region'?: string|null,
      * } $input
      */
@@ -92,6 +105,7 @@ public function __construct(array $input = [])
         $this->uploadId = $input['UploadId'] ?? null;
         $this->requestPayer = $input['RequestPayer'] ?? null;
         $this->expectedBucketOwner = $input['ExpectedBucketOwner'] ?? null;
+        $this->ifMatchInitiatedTime = !isset($input['IfMatchInitiatedTime']) ? null : ($input['IfMatchInitiatedTime'] instanceof \DateTimeImmutable ? $input['IfMatchInitiatedTime'] : new \DateTimeImmutable($input['IfMatchInitiatedTime']));
         parent::__construct($input);
     }
 
@@ -102,6 +116,7 @@ public function __construct(array $input = [])
      *   UploadId?: string,
      *   RequestPayer?: null|RequestPayer::*,
      *   ExpectedBucketOwner?: null|string,
+     *   IfMatchInitiatedTime?: null|\DateTimeImmutable|string,
      *   '@region'?: string|null,
      * }|AbortMultipartUploadRequest $input
      */
@@ -120,6 +135,11 @@ public function getExpectedBucketOwner(): ?string
         return $this->expectedBucketOwner;
     }
 
+    public function getIfMatchInitiatedTime(): ?\DateTimeImmutable
+    {
+        return $this->ifMatchInitiatedTime;
+    }
+
     public function getKey(): ?string
     {
         return $this->key;
@@ -154,6 +174,9 @@ public function request(): Request
         if (null !== $this->expectedBucketOwner) {
             $headers['x-amz-expected-bucket-owner'] = $this->expectedBucketOwner;
         }
+        if (null !== $this->ifMatchInitiatedTime) {
+            $headers['x-amz-if-match-initiated-time'] = $this->ifMatchInitiatedTime->setTimezone(new \DateTimeZone('GMT'))->format(\DateTimeInterface::RFC7231);
+        }
 
         // Prepare query
         $query = [];
@@ -195,6 +218,13 @@ public function setExpectedBucketOwner(?string $value): self
         return $this;
     }
 
+    public function setIfMatchInitiatedTime(?\DateTimeImmutable $value): self
+    {
+        $this->ifMatchInitiatedTime = $value;
+
+        return $this;
+    }
+
     public function setKey(?string $value): self
     {
         $this->key = $value;
diff --git a/src/Service/S3/src/Input/DeleteObjectRequest.php b/src/Service/S3/src/Input/DeleteObjectRequest.php
diff --git a/src/Service/S3/src/Input/PutObjectRequest.php b/src/Service/S3/src/Input/PutObjectRequest.php
diff --git a/src/Service/S3/src/Result/PutObjectOutput.php b/src/Service/S3/src/Result/PutObjectOutput.php
diff --git a/src/Service/S3/src/S3Client.php b/src/Service/S3/src/S3Client.php
diff --git a/src/Service/S3/src/ValueObject/ObjectIdentifier.php b/src/Service/S3/src/ValueObject/ObjectIdentifier.php
diff --git a/src/Service/XRay/CHANGELOG.md b/src/Service/XRay/CHANGELOG.md
diff --git a/src/Service/XRay/src/XRayClient.php b/src/Service/XRay/src/XRayClient.php

Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"variables": {`
`3`		`- "${LATEST}": "3.328.3"`
	`3`	`+ "${LATEST}": "3.329.0"`
`4`	`4`	`},`
`5`	`5`	`"endpoints": "https://raw.githubusercontent.com/aws/aws-sdk-php/${LATEST}/src/data/endpoints.json",`
`6`	`6`	`"services": {`
Original file line number	Diff line number	Diff line change
`@@ -28,7 +28,7 @@`
`28`	`28`	`},`
`29`	`29`	`"extra": {`
`30`	`30`	`"branch-alias": {`
`31`		`- "dev-master": "3.0-dev"`
	`31`	`+ "dev-master": "3.1-dev"`
`32`	`32`	`}`
`33`	`33`	`}`
`34`	`34`	`}`
Original file line number	Diff line number	Diff line change
`@@ -4,6 +4,7 @@`
`4`	`4`
`5`	`5`	`final class DataSourceType`
`6`	`6`	`{`
	`7`	`+ public const AMAZON_BEDROCK_RUNTIME = 'AMAZON_BEDROCK_RUNTIME';`
`7`	`8`	`public const AMAZON_DYNAMODB = 'AMAZON_DYNAMODB';`
`8`	`9`	`public const AMAZON_ELASTICSEARCH = 'AMAZON_ELASTICSEARCH';`
`9`	`10`	`public const AMAZON_EVENTBRIDGE = 'AMAZON_EVENTBRIDGE';`
`@@ -16,6 +17,7 @@ final class DataSourceType`
`16`	`17`	`public static function exists(string $value): bool`
`17`	`18`	`{`
`18`	`19`	`return isset([`
	`20`	`+ self::AMAZON_BEDROCK_RUNTIME => true,`
`19`	`21`	`self::AMAZON_DYNAMODB => true,`
`20`	`22`	`self::AMAZON_ELASTICSEARCH => true,`
`21`	`23`	`self::AMAZON_EVENTBRIDGE => true,`
Original file line number	Diff line number	Diff line change
`@@ -50,7 +50,7 @@ final class PutLogEventsRequest extends Input`
`50`	`50`	`private $sequenceToken;`
`51`	`51`
`52`	`52`	`/**`
`53`		`- * Reserved for internal use.`
	`53`	`+ * The entity associated with the log events.`
`54`	`54`	`*`
`55`	`55`	`* @var Entity\|null`
`56`	`56`	`*/`