@aws-sdk/client-s3 3.1069.0 → 3.1071.0

package/dist-types/commands/ListObjectAnnotationsCommand.d.ts

@@ -0,0 +1,138 @@
+import { Command as $Command } from "@smithy/core/client";
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { ListObjectAnnotationsOutput, ListObjectAnnotationsRequest } from "../models/models_0";
+import type { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link ListObjectAnnotationsCommand}.
+ */
+export interface ListObjectAnnotationsCommandInput extends ListObjectAnnotationsRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link ListObjectAnnotationsCommand}.
+ */
+export interface ListObjectAnnotationsCommandOutput extends ListObjectAnnotationsOutput, __MetadataBearer {
+}
+declare const ListObjectAnnotationsCommand_base: {
+    new (input: ListObjectAnnotationsCommandInput): import("@smithy/core/client").CommandImpl<ListObjectAnnotationsCommandInput, ListObjectAnnotationsCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: ListObjectAnnotationsCommandInput): import("@smithy/core/client").CommandImpl<ListObjectAnnotationsCommandInput, ListObjectAnnotationsCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): {
+        [x: string]: unknown;
+    };
+};
+/**
+ * <p>Lists the annotations attached to an Amazon S3 object. Results are paginated, with a maximum of
+ *       1,000 annotations per object. Use the <code>AnnotationPrefix</code> parameter to filter the
+ *       results by name prefix.</p>
+ *          <p>To use this operation, you must have the <code>s3:ListObjectAnnotations</code> permission.</p>
+ *          <note>
+ *             <p>Annotations are not supported by the following features: S3 Inventory Reports,
+ *       API Gateway, S3 Storage Lens, Amazon S3 File Gateway, Amazon FSx, S3 on Outposts, and
+ *       S3 Express One Zone (directory buckets).</p>
+ *          </note>
+ *          <p>The following operations are related to <code>ListObjectAnnotations</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObjectAnnotation.html">PutObjectAnnotation</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAnnotation.html">GetObjectAnnotation</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectAnnotation.html">DeleteObjectAnnotation</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, ListObjectAnnotationsCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, ListObjectAnnotationsCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * // import type { S3ClientConfig } from "@aws-sdk/client-s3";
+ * const config = {}; // type is S3ClientConfig
+ * const client = new S3Client(config);
+ * const input = { // ListObjectAnnotationsRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   Key: "STRING_VALUE", // required
+ *   VersionId: "STRING_VALUE",
+ *   MaxAnnotationResults: Number("int"),
+ *   AnnotationPrefix: "STRING_VALUE",
+ *   ContinuationToken: "STRING_VALUE",
+ *   RequestPayer: "requester",
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
+ * const command = new ListObjectAnnotationsCommand(input);
+ * const response = await client.send(command);
+ * // { // ListObjectAnnotationsOutput
+ * //   Annotations: [ // AnnotationList
+ * //     { // AnnotationEntry
+ * //       AnnotationName: "STRING_VALUE", // required
+ * //       LastModified: new Date("TIMESTAMP"), // required
+ * //       ETag: "STRING_VALUE",
+ * //       ChecksumAlgorithm: [ // ChecksumAlgorithmList
+ * //         "CRC32" || "CRC32C" || "SHA1" || "SHA256" || "CRC64NVME" || "SHA512" || "MD5" || "XXHASH64" || "XXHASH3" || "XXHASH128",
+ * //       ],
+ * //       Size: Number("long"), // required
+ * //       ReplicationStatus: "COMPLETE" || "PENDING" || "FAILED" || "REPLICA" || "COMPLETED",
+ * //     },
+ * //   ],
+ * //   Bucket: "STRING_VALUE",
+ * //   Key: "STRING_VALUE",
+ * //   ObjectVersionId: "STRING_VALUE",
+ * //   AnnotationPrefix: "STRING_VALUE",
+ * //   MaxAnnotationResults: Number("int"),
+ * //   AnnotationCount: Number("int"),
+ * //   ContinuationToken: "STRING_VALUE",
+ * //   NextContinuationToken: "STRING_VALUE",
+ * //   RequestCharged: "requester",
+ * // };
+ *
+ * ```
+ *
+ * @param ListObjectAnnotationsCommandInput - {@link ListObjectAnnotationsCommandInput}
+ * @returns {@link ListObjectAnnotationsCommandOutput}
+ * @see {@link ListObjectAnnotationsCommandInput} for command's `input` shape.
+ * @see {@link ListObjectAnnotationsCommandOutput} for command's `response` shape.
+ * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
+ *
+ * @throws {@link InvalidPrefix} (client fault)
+ *  <p>The annotation prefix you provided is invalid.</p>
+ *
+ * @throws {@link NoSuchBucket} (client fault)
+ *  <p>The specified bucket does not exist.</p>
+ *
+ * @throws {@link NoSuchKey} (client fault)
+ *  <p>The specified key does not exist.</p>
+ *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
+ *
+ *
+ * @public
+ */
+export declare class ListObjectAnnotationsCommand extends ListObjectAnnotationsCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: ListObjectAnnotationsRequest;
+            output: ListObjectAnnotationsOutput;
+        };
+        sdk: {
+            input: ListObjectAnnotationsCommandInput;
+            output: ListObjectAnnotationsCommandOutput;
+        };
+    };
+}

package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts

@@ -97,7 +97,7 @@ declare const PutBucketNotificationConfigurationCommand_base: {
  *         Id: "STRING_VALUE",
  *         TopicArn: "STRING_VALUE", // required
  *         Events: [ // EventList // required
- *           "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete",
+ *           "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete" || "s3:ObjectAnnotation:*" || "s3:ObjectAnnotation:Put" || "s3:ObjectAnnotation:Delete",
  *         ],
  *         Filter: { // NotificationConfigurationFilter
  *           Key: { // S3KeyFilter
@@ -116,7 +116,7 @@ declare const PutBucketNotificationConfigurationCommand_base: {
  *         Id: "STRING_VALUE",
  *         QueueArn: "STRING_VALUE", // required
  *         Events: [ // required
- *           "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete",
+ *           "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete" || "s3:ObjectAnnotation:*" || "s3:ObjectAnnotation:Put" || "s3:ObjectAnnotation:Delete",
  *         ],
  *         Filter: {
  *           Key: {
@@ -135,7 +135,7 @@ declare const PutBucketNotificationConfigurationCommand_base: {
  *         Id: "STRING_VALUE",
  *         LambdaFunctionArn: "STRING_VALUE", // required
  *         Events: [ // required
- *           "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete",
+ *           "s3:ReducedRedundancyLostObject" || "s3:ObjectCreated:*" || "s3:ObjectCreated:Put" || "s3:ObjectCreated:Post" || "s3:ObjectCreated:Copy" || "s3:ObjectCreated:CompleteMultipartUpload" || "s3:ObjectRemoved:*" || "s3:ObjectRemoved:Delete" || "s3:ObjectRemoved:DeleteMarkerCreated" || "s3:ObjectRestore:*" || "s3:ObjectRestore:Post" || "s3:ObjectRestore:Completed" || "s3:Replication:*" || "s3:Replication:OperationFailedReplication" || "s3:Replication:OperationNotTracked" || "s3:Replication:OperationMissedThreshold" || "s3:Replication:OperationReplicatedAfterThreshold" || "s3:ObjectRestore:Delete" || "s3:LifecycleTransition" || "s3:IntelligentTiering" || "s3:ObjectAcl:Put" || "s3:LifecycleExpiration:*" || "s3:LifecycleExpiration:Delete" || "s3:LifecycleExpiration:DeleteMarkerCreated" || "s3:ObjectTagging:*" || "s3:ObjectTagging:Put" || "s3:ObjectTagging:Delete" || "s3:ObjectAnnotation:*" || "s3:ObjectAnnotation:Put" || "s3:ObjectAnnotation:Delete",
  *         ],
  *         Filter: {
  *           Key: {

package/dist-types/commands/PutObjectAnnotationCommand.d.ts

@@ -0,0 +1,166 @@
+import { Command as $Command } from "@smithy/core/client";
+import type { MetadataBearer as __MetadataBearer, StreamingBlobPayloadInputTypes } from "@smithy/types";
+import type { PutObjectAnnotationOutput, PutObjectAnnotationRequest } from "../models/models_0";
+import type { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link PutObjectAnnotationCommand}.
+ */
+export interface PutObjectAnnotationCommandInput extends Omit<PutObjectAnnotationRequest, "AnnotationPayload"> {
+    AnnotationPayload: StreamingBlobPayloadInputTypes;
+}
+/**
+ * @public
+ *
+ * The output of {@link PutObjectAnnotationCommand}.
+ */
+export interface PutObjectAnnotationCommandOutput extends PutObjectAnnotationOutput, __MetadataBearer {
+}
+declare const PutObjectAnnotationCommand_base: {
+    new (input: PutObjectAnnotationCommandInput): import("@smithy/core/client").CommandImpl<PutObjectAnnotationCommandInput, PutObjectAnnotationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: PutObjectAnnotationCommandInput): import("@smithy/core/client").CommandImpl<PutObjectAnnotationCommandInput, PutObjectAnnotationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): {
+        [x: string]: unknown;
+    };
+};
+/**
+ * <p>Attaches an annotation to an Amazon S3 object. An annotation is a named payload of 1 byte to 1 MiB
+ *       that you can associate with a specific object or object version. Each object can have up to 1,000
+ *       annotations.</p>
+ *          <p>For annotation naming rules and restrictions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/annotations-overview.html">Annotation naming guidelines</a>
+ *       in the <i>Amazon S3 User Guide</i>.</p>
+ *          <p>Annotations inherit the encryption of their parent object. For objects without server-side
+ *       encryption, annotations are encrypted with SSE-S3 (the default for new objects). Objects
+ *       encrypted with SSE-C cannot have annotations.</p>
+ *          <p>To use this operation, you must have the <code>s3:PutObjectAnnotation</code> permission. If the
+ *       bucket has Requester Pays enabled, you must include the <code>x-amz-request-payer</code> header.</p>
+ *          <note>
+ *             <p>Annotations are not supported by the following features: S3 Inventory Reports,
+ *       API Gateway, S3 Storage Lens, Amazon S3 File Gateway, Amazon FSx, S3 on Outposts, and
+ *       S3 Express One Zone (directory buckets).</p>
+ *          </note>
+ *          <p>The following operations are related to <code>PutObjectAnnotation</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAnnotation.html">GetObjectAnnotation</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjectAnnotations.html">ListObjectAnnotations</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObjectAnnotation.html">DeleteObjectAnnotation</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, PutObjectAnnotationCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, PutObjectAnnotationCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * // import type { S3ClientConfig } from "@aws-sdk/client-s3";
+ * const config = {}; // type is S3ClientConfig
+ * const client = new S3Client(config);
+ * const input = { // PutObjectAnnotationRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   Key: "STRING_VALUE", // required
+ *   VersionId: "STRING_VALUE",
+ *   AnnotationName: "STRING_VALUE", // required
+ *   AnnotationPayload: "MULTIPLE_TYPES_ACCEPTED", // see \@smithy/types -> StreamingBlobPayloadInputTypes // required
+ *   ObjectIfMatch: "STRING_VALUE",
+ *   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256" || "CRC64NVME" || "SHA512" || "MD5" || "XXHASH64" || "XXHASH3" || "XXHASH128",
+ *   ChecksumCRC32: "STRING_VALUE",
+ *   ChecksumCRC32C: "STRING_VALUE",
+ *   ChecksumCRC64NVME: "STRING_VALUE",
+ *   ChecksumSHA1: "STRING_VALUE",
+ *   ChecksumSHA256: "STRING_VALUE",
+ *   ChecksumSHA512: "STRING_VALUE",
+ *   ChecksumMD5: "STRING_VALUE",
+ *   ChecksumXXHASH64: "STRING_VALUE",
+ *   ChecksumXXHASH3: "STRING_VALUE",
+ *   ChecksumXXHASH128: "STRING_VALUE",
+ *   ContentMD5: "STRING_VALUE",
+ *   RequestPayer: "requester",
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
+ * const command = new PutObjectAnnotationCommand(input);
+ * const response = await client.send(command);
+ * // { // PutObjectAnnotationOutput
+ * //   Key: "STRING_VALUE",
+ * //   AnnotationName: "STRING_VALUE",
+ * //   ObjectVersionId: "STRING_VALUE",
+ * //   ETag: "STRING_VALUE",
+ * //   ChecksumCRC32: "STRING_VALUE",
+ * //   ChecksumCRC32C: "STRING_VALUE",
+ * //   ChecksumCRC64NVME: "STRING_VALUE",
+ * //   ChecksumSHA1: "STRING_VALUE",
+ * //   ChecksumSHA256: "STRING_VALUE",
+ * //   ChecksumSHA512: "STRING_VALUE",
+ * //   ChecksumMD5: "STRING_VALUE",
+ * //   ChecksumXXHASH64: "STRING_VALUE",
+ * //   ChecksumXXHASH3: "STRING_VALUE",
+ * //   ChecksumXXHASH128: "STRING_VALUE",
+ * //   ChecksumType: "COMPOSITE" || "FULL_OBJECT",
+ * //   ServerSideEncryption: "AES256" || "aws:fsx" || "aws:kms" || "aws:kms:dsse",
+ * //   RequestCharged: "requester",
+ * // };
+ *
+ * ```
+ *
+ * @param PutObjectAnnotationCommandInput - {@link PutObjectAnnotationCommandInput}
+ * @returns {@link PutObjectAnnotationCommandOutput}
+ * @see {@link PutObjectAnnotationCommandInput} for command's `input` shape.
+ * @see {@link PutObjectAnnotationCommandOutput} for command's `response` shape.
+ * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
+ *
+ * @throws {@link AnnotationLimitExceeded} (client fault)
+ *  <p>The request would exceed the maximum number of annotations allowed per object.</p>
+ *
+ * @throws {@link AnnotationNameTooLong} (client fault)
+ *  <p>The annotation name exceeds 512 bytes.</p>
+ *
+ * @throws {@link InvalidAnnotationName} (client fault)
+ *  <p>The annotation name you provided is invalid.</p>
+ *
+ * @throws {@link InvalidRequest} (client fault)
+ *  <p>A parameter or header in your request isn't valid. For details, see the description of this API
+ *       operation.</p>
+ *
+ * @throws {@link NoSuchBucket} (client fault)
+ *  <p>The specified bucket does not exist.</p>
+ *
+ * @throws {@link NoSuchKey} (client fault)
+ *  <p>The specified key does not exist.</p>
+ *
+ * @throws {@link UnsupportedMediaType} (client fault)
+ *  <p>The annotation payload is not valid UTF-8 encoded text.</p>
+ *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
+ *
+ *
+ * @public
+ */
+export declare class PutObjectAnnotationCommand extends PutObjectAnnotationCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: PutObjectAnnotationRequest;
+            output: PutObjectAnnotationOutput;
+        };
+        sdk: {
+            input: PutObjectAnnotationCommandInput;
+            output: PutObjectAnnotationCommandOutput;
+        };
+    };
+}

package/dist-types/commands/RenameObjectCommand.d.ts

@@ -1,6 +1,6 @@
 import { Command as $Command } from "@smithy/core/client";
 import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import type { RenameObjectOutput, RenameObjectRequest } from "../models/models_0";
+import type { RenameObjectOutput, RenameObjectRequest } from "../models/models_1";
 import type { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public

package/dist-types/commands/RestoreObjectCommand.d.ts

@@ -1,7 +1,6 @@
 import { Command as $Command } from "@smithy/core/client";
 import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
-import type { RestoreObjectOutput } from "../models/models_0";
-import type { RestoreObjectRequest } from "../models/models_1";
+import type { RestoreObjectOutput, RestoreObjectRequest } from "../models/models_1";
 import type { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
 /**
  * @public

package/dist-types/commands/UpdateBucketMetadataAnnotationTableConfigurationCommand.d.ts

@@ -0,0 +1,110 @@
+import { Command as $Command } from "@smithy/core/client";
+import type { MetadataBearer as __MetadataBearer } from "@smithy/types";
+import type { UpdateBucketMetadataAnnotationTableConfigurationRequest } from "../models/models_1";
+import type { S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes } from "../S3Client";
+/**
+ * @public
+ */
+export type { __MetadataBearer };
+export { $Command };
+/**
+ * @public
+ *
+ * The input for {@link UpdateBucketMetadataAnnotationTableConfigurationCommand}.
+ */
+export interface UpdateBucketMetadataAnnotationTableConfigurationCommandInput extends UpdateBucketMetadataAnnotationTableConfigurationRequest {
+}
+/**
+ * @public
+ *
+ * The output of {@link UpdateBucketMetadataAnnotationTableConfigurationCommand}.
+ */
+export interface UpdateBucketMetadataAnnotationTableConfigurationCommandOutput extends __MetadataBearer {
+}
+declare const UpdateBucketMetadataAnnotationTableConfigurationCommand_base: {
+    new (input: UpdateBucketMetadataAnnotationTableConfigurationCommandInput): import("@smithy/core/client").CommandImpl<UpdateBucketMetadataAnnotationTableConfigurationCommandInput, UpdateBucketMetadataAnnotationTableConfigurationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    new (input: UpdateBucketMetadataAnnotationTableConfigurationCommandInput): import("@smithy/core/client").CommandImpl<UpdateBucketMetadataAnnotationTableConfigurationCommandInput, UpdateBucketMetadataAnnotationTableConfigurationCommandOutput, S3ClientResolvedConfig, ServiceInputTypes, ServiceOutputTypes>;
+    getEndpointParameterInstructions(): {
+        [x: string]: unknown;
+    };
+};
+/**
+ * <p>Updates the annotation table configuration for an Amazon S3 bucket's metadata configuration. Use this
+ *       operation to enable or disable the annotation table, or to update its associated IAM role.</p>
+ *          <p>An annotation table is a queryable Iceberg table that contains records of all annotations
+ *       attached to objects in the bucket. To use this operation, the bucket must have an existing Amazon S3
+ *       Metadata configuration.</p>
+ *          <p>To use this operation, you must have the
+ *       <code>s3:UpdateBucketMetadataAnnotationTableConfiguration</code> permission. If you are specifying
+ *       or changing the IAM role, you must also have <code>iam:PassRole</code> permission for the role.</p>
+ *          <p>The IAM role must have a trust policy that allows the Amazon S3 metadata service to assume it, and a
+ *       permissions policy that grants the actions needed to read annotations from your bucket. The
+ *       following examples show a trust policy and a permissions policy that you can adapt for your bucket
+ *       and account.</p>
+ *          <p>The following operations are related to
+ *       <code>UpdateBucketMetadataAnnotationTableConfiguration</code>:</p>
+ *          <ul>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucketMetadataConfiguration.html">CreateBucketMetadataConfiguration</a>
+ *                </p>
+ *             </li>
+ *             <li>
+ *                <p>
+ *                   <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetadataConfiguration.html">GetBucketMetadataConfiguration</a>
+ *                </p>
+ *             </li>
+ *          </ul>
+ * @example
+ * Use a bare-bones client and the command you need to make an API call.
+ * ```javascript
+ * import { S3Client, UpdateBucketMetadataAnnotationTableConfigurationCommand } from "@aws-sdk/client-s3"; // ES Modules import
+ * // const { S3Client, UpdateBucketMetadataAnnotationTableConfigurationCommand } = require("@aws-sdk/client-s3"); // CommonJS import
+ * // import type { S3ClientConfig } from "@aws-sdk/client-s3";
+ * const config = {}; // type is S3ClientConfig
+ * const client = new S3Client(config);
+ * const input = { // UpdateBucketMetadataAnnotationTableConfigurationRequest
+ *   Bucket: "STRING_VALUE", // required
+ *   ContentMD5: "STRING_VALUE",
+ *   ChecksumAlgorithm: "CRC32" || "CRC32C" || "SHA1" || "SHA256" || "CRC64NVME" || "SHA512" || "MD5" || "XXHASH64" || "XXHASH3" || "XXHASH128",
+ *   AnnotationTableConfiguration: { // AnnotationTableConfigurationUpdates
+ *     ConfigurationState: "ENABLED" || "DISABLED", // required
+ *     EncryptionConfiguration: { // MetadataTableEncryptionConfiguration
+ *       SseAlgorithm: "aws:kms" || "AES256", // required
+ *       KmsKeyArn: "STRING_VALUE",
+ *     },
+ *     Role: "STRING_VALUE",
+ *   },
+ *   ExpectedBucketOwner: "STRING_VALUE",
+ * };
+ * const command = new UpdateBucketMetadataAnnotationTableConfigurationCommand(input);
+ * const response = await client.send(command);
+ * // {};
+ *
+ * ```
+ *
+ * @param UpdateBucketMetadataAnnotationTableConfigurationCommandInput - {@link UpdateBucketMetadataAnnotationTableConfigurationCommandInput}
+ * @returns {@link UpdateBucketMetadataAnnotationTableConfigurationCommandOutput}
+ * @see {@link UpdateBucketMetadataAnnotationTableConfigurationCommandInput} for command's `input` shape.
+ * @see {@link UpdateBucketMetadataAnnotationTableConfigurationCommandOutput} for command's `response` shape.
+ * @see {@link S3ClientResolvedConfig | config} for S3Client's `config` shape.
+ *
+ * @throws {@link S3ServiceException}
+ * <p>Base exception class for all service exceptions from S3 service.</p>
+ *
+ *
+ * @public
+ */
+export declare class UpdateBucketMetadataAnnotationTableConfigurationCommand extends UpdateBucketMetadataAnnotationTableConfigurationCommand_base {
+    /** @internal type navigation helper, not in runtime. */
+    protected static __types: {
+        api: {
+            input: UpdateBucketMetadataAnnotationTableConfigurationRequest;
+            output: {};
+        };
+        sdk: {
+            input: UpdateBucketMetadataAnnotationTableConfigurationCommandInput;
+            output: UpdateBucketMetadataAnnotationTableConfigurationCommandOutput;
+        };
+    };
+}

package/dist-types/commands/index.d.ts

@@ -21,6 +21,7 @@ export * from "./DeleteBucketPolicyCommand";
 export * from "./DeleteBucketReplicationCommand";
 export * from "./DeleteBucketTaggingCommand";
 export * from "./DeleteBucketWebsiteCommand";
+export * from "./DeleteObjectAnnotationCommand";
 export * from "./DeleteObjectCommand";
 export * from "./DeleteObjectTaggingCommand";
 export * from "./DeleteObjectsCommand";
@@ -49,6 +50,7 @@ export * from "./GetBucketTaggingCommand";
 export * from "./GetBucketVersioningCommand";
 export * from "./GetBucketWebsiteCommand";
 export * from "./GetObjectAclCommand";
+export * from "./GetObjectAnnotationCommand";
 export * from "./GetObjectAttributesCommand";
 export * from "./GetObjectCommand";
 export * from "./GetObjectLegalHoldCommand";
@@ -66,6 +68,7 @@ export * from "./ListBucketMetricsConfigurationsCommand";
 export * from "./ListBucketsCommand";
 export * from "./ListDirectoryBucketsCommand";
 export * from "./ListMultipartUploadsCommand";
+export * from "./ListObjectAnnotationsCommand";
 export * from "./ListObjectVersionsCommand";
 export * from "./ListObjectsCommand";
 export * from "./ListObjectsV2Command";
@@ -90,6 +93,7 @@ export * from "./PutBucketTaggingCommand";
 export * from "./PutBucketVersioningCommand";
 export * from "./PutBucketWebsiteCommand";
 export * from "./PutObjectAclCommand";
+export * from "./PutObjectAnnotationCommand";
 export * from "./PutObjectCommand";
 export * from "./PutObjectLegalHoldCommand";
 export * from "./PutObjectLockConfigurationCommand";
@@ -99,6 +103,7 @@ export * from "./PutPublicAccessBlockCommand";
 export * from "./RenameObjectCommand";
 export * from "./RestoreObjectCommand";
 export * from "./SelectObjectContentCommand";
+export * from "./UpdateBucketMetadataAnnotationTableConfigurationCommand";
 export * from "./UpdateBucketMetadataInventoryTableConfigurationCommand";
 export * from "./UpdateBucketMetadataJournalTableConfigurationCommand";
 export * from "./UpdateObjectEncryptionCommand";

package/dist-types/models/enums.d.ts

@@ -126,6 +126,18 @@ export declare const ObjectCannedACL: {
  * @public
  */
 export type ObjectCannedACL = (typeof ObjectCannedACL)[keyof typeof ObjectCannedACL];
+/**
+ * @public
+ * @enum
+ */
+export declare const AnnotationDirective: {
+    readonly COPY: "COPY";
+    readonly EXCLUDE: "EXCLUDE";
+};
+/**
+ * @public
+ */
+export type AnnotationDirective = (typeof AnnotationDirective)[keyof typeof AnnotationDirective];
 /**
  * @public
  * @enum
@@ -343,14 +355,14 @@ export type ObjectOwnership = (typeof ObjectOwnership)[keyof typeof ObjectOwners
  * @public
  * @enum
  */
-export declare const InventoryConfigurationState: {
+export declare const AnnotationConfigurationState: {
     readonly DISABLED: "DISABLED";
     readonly ENABLED: "ENABLED";
 };
 /**
  * @public
  */
-export type InventoryConfigurationState = (typeof InventoryConfigurationState)[keyof typeof InventoryConfigurationState];
+export type AnnotationConfigurationState = (typeof AnnotationConfigurationState)[keyof typeof AnnotationConfigurationState];
 /**
  * @public
  * @enum
@@ -363,6 +375,18 @@ export declare const TableSseAlgorithm: {
  * @public
  */
 export type TableSseAlgorithm = (typeof TableSseAlgorithm)[keyof typeof TableSseAlgorithm];
+/**
+ * @public
+ * @enum
+ */
+export declare const InventoryConfigurationState: {
+    readonly DISABLED: "DISABLED";
+    readonly ENABLED: "ENABLED";
+};
+/**
+ * @public
+ */
+export type InventoryConfigurationState = (typeof InventoryConfigurationState)[keyof typeof InventoryConfigurationState];
 /**
  * @public
  * @enum
@@ -596,6 +620,9 @@ export declare const Event: {
     readonly s3_LifecycleExpiration_DeleteMarkerCreated: "s3:LifecycleExpiration:DeleteMarkerCreated";
     readonly s3_LifecycleTransition: "s3:LifecycleTransition";
     readonly s3_ObjectAcl_Put: "s3:ObjectAcl:Put";
+    readonly s3_ObjectAnnotation_: "s3:ObjectAnnotation:*";
+    readonly s3_ObjectAnnotation_Delete: "s3:ObjectAnnotation:Delete";
+    readonly s3_ObjectAnnotation_Put: "s3:ObjectAnnotation:Put";
     readonly s3_ObjectCreated_: "s3:ObjectCreated:*";
     readonly s3_ObjectCreated_CompleteMultipartUpload: "s3:ObjectCreated:CompleteMultipartUpload";
     readonly s3_ObjectCreated_Copy: "s3:ObjectCreated:Copy";