feat(client-s3): Added support for directory bucket creation with tags and bucket ARN retrieval in CreateBucket, ListDirectoryBuckets, and HeadBucket operations

Author: awstools

clients/client-s3/src/commands/CreateBucketCommand.ts

@@ -213,6 +213,12 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  *       DataRedundancy: "SingleAvailabilityZone" || "SingleLocalZone",
  *       Type: "Directory",
  *     },
+ *     Tags: [ // TagSet
+ *       { // Tag
+ *         Key: "STRING_VALUE", // required
+ *         Value: "STRING_VALUE", // required
+ *       },
+ *     ],
  *   },
  *   GrantFullControl: "STRING_VALUE",
  *   GrantRead: "STRING_VALUE",
@@ -226,6 +232,7 @@ export interface CreateBucketCommandOutput extends CreateBucketOutput, __Metadat
  * const response = await client.send(command);
  * // { // CreateBucketOutput
  * //   Location: "STRING_VALUE",
+ * //   BucketArn: "STRING_VALUE",
  * // };
  *
  * ```

clients/client-s3/src/commands/HeadBucketCommand.ts

@@ -111,6 +111,7 @@ export interface HeadBucketCommandOutput extends HeadBucketOutput, __MetadataBea
  * const command = new HeadBucketCommand(input);
  * const response = await client.send(command);
  * // { // HeadBucketOutput
+ * //   BucketArn: "STRING_VALUE",
  * //   BucketLocationType: "AvailabilityZone" || "LocalZone",
  * //   BucketLocationName: "STRING_VALUE",
  * //   BucketRegion: "STRING_VALUE",

clients/client-s3/src/commands/ListBucketsCommand.ts

@@ -70,6 +70,7 @@ export interface ListBucketsCommandOutput extends ListBucketsOutput, __MetadataB
  * //       Name: "STRING_VALUE",
  * //       CreationDate: new Date("TIMESTAMP"),
  * //       BucketRegion: "STRING_VALUE",
+ * //       BucketArn: "STRING_VALUE",
  * //     },
  * //   ],
  * //   Owner: { // Owner

clients/client-s3/src/commands/ListDirectoryBucketsCommand.ts

@@ -76,6 +76,7 @@ export interface ListDirectoryBucketsCommandOutput extends ListDirectoryBucketsO
  * //       Name: "STRING_VALUE",
  * //       CreationDate: new Date("TIMESTAMP"),
  * //       BucketRegion: "STRING_VALUE",
+ * //       BucketArn: "STRING_VALUE",
  * //     },
  * //   ],
  * //   ContinuationToken: "STRING_VALUE",

clients/client-s3/src/models/models_0.ts

@@ -1983,6 +1983,15 @@ export interface CreateBucketOutput {
    * @public
    */
   Location?: string | undefined;
+
+  /**
+   * <p>The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely identify Amazon Web Services resources across all of Amazon Web Services.</p>
+   *          <note>
+   *             <p>This parameter is only supported for S3 directory buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html">Using tags with directory buckets</a>.</p>
+   *          </note>
+   * @public
+   */
+  BucketArn?: string | undefined;
 }
 
 /**
@@ -2133,6 +2142,24 @@ export const BucketLocationConstraint = {
  */
 export type BucketLocationConstraint = (typeof BucketLocationConstraint)[keyof typeof BucketLocationConstraint];
 
+/**
+ * <p>A container of a key value name pair.</p>
+ * @public
+ */
+export interface Tag {
+  /**
+   * <p>Name of the object key.</p>
+   * @public
+   */
+  Key: string | undefined;
+
+  /**
+   * <p>Value of the tag.</p>
+   * @public
+   */
+  Value: string | undefined;
+}
+
 /**
  * <p>The configuration information for the bucket.</p>
  * @public
@@ -2176,6 +2203,15 @@ export interface CreateBucketConfiguration {
    * @public
    */
   Bucket?: BucketInfo | undefined;
+
+  /**
+   * <p>An array of tags that you can apply to the bucket that you're creating. Tags are key-value pairs of metadata used to categorize and organize your buckets, track costs, and control access. </p>
+   *          <note>
+   *             <p>This parameter is only supported for S3 directory buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html">Using tags with directory buckets</a>.</p>
+   *          </note>
+   * @public
+   */
+  Tags?: Tag[] | undefined;
 }
 
 /**
@@ -6195,24 +6231,6 @@ export interface GetBucketAclRequest {
   ExpectedBucketOwner?: string | undefined;
 }
 
-/**
- * <p>A container of a key value name pair.</p>
- * @public
- */
-export interface Tag {
-  /**
-   * <p>Name of the object key.</p>
-   * @public
-   */
-  Key: string | undefined;
-
-  /**
-   * <p>Value of the tag.</p>
-   * @public
-   */
-  Value: string | undefined;
-}
-
 /**
  * <p>A conjunction (logical AND) of predicates, which is used in evaluating a metrics filter.
  *          The operator must have at least two predicates in any combination, and an object must match
@@ -9002,6 +9020,8 @@ export interface Destination {
    *          object replica. </p>
    *          <p>For valid values, see the <code>StorageClass</code> element of the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTreplication.html">PUT Bucket
    *             replication</a> action in the <i>Amazon S3 API Reference</i>.</p>
+   *          <p>
+   *             <code>FSX_OPENZFS</code> is not an accepted value when replicating objects.</p>
    * @public
    */
   StorageClass?: StorageClass | undefined;
@@ -11496,6 +11516,15 @@ export interface GetPublicAccessBlockRequest {
  * @public
  */
 export interface HeadBucketOutput {
+  /**
+   * <p>The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely identify Amazon Web Services resources across all of Amazon Web Services.</p>
+   *          <note>
+   *             <p>This parameter is only supported for S3 directory buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html">Using tags with directory buckets</a>.</p>
+   *          </note>
+   * @public
+   */
+  BucketArn?: string | undefined;
+
   /**
    * <p>The type of location where the bucket is created.</p>
    *          <note>
@@ -12523,6 +12552,15 @@ export interface Bucket {
    * @public
    */
   BucketRegion?: string | undefined;
+
+  /**
+   * <p>The Amazon Resource Name (ARN) of the S3 bucket. ARNs uniquely identify Amazon Web Services resources across all of Amazon Web Services.</p>
+   *          <note>
+   *             <p>This parameter is only supported for S3 directory buckets. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-tagging.html">Using tags with directory buckets</a>.</p>
+   *          </note>
+   * @public
+   */
+  BucketArn?: string | undefined;
 }
 
 /**
@@ -12936,6 +12974,8 @@ export interface ListMultipartUploadsRequest {
    *          substring starts at the beginning of the key. The keys that are grouped under
    *             <code>CommonPrefixes</code> result element are not returned elsewhere in the
    *          response.</p>
+   *          <p>
+   *             <code>CommonPrefixes</code> is filtered out from results if it is not lexicographically greater than the key-marker.</p>
    *          <note>
    *             <p>
    *                <b>Directory buckets</b> - For directory buckets, <code>/</code> is the only supported delimiter.</p>
@@ -13383,6 +13423,8 @@ export interface ListObjectsRequest {
 
   /**
    * <p>A delimiter is a character that you use to group keys.</p>
+   *          <p>
+   *             <code>CommonPrefixes</code> is filtered out from results if it is not lexicographically greater than the key-marker.</p>
    * @public
    */
   Delimiter?: string | undefined;
@@ -13630,6 +13672,8 @@ export interface ListObjectsV2Request {
 
   /**
    * <p>A delimiter is a character that you use to group keys.</p>
+   *          <p>
+   *             <code>CommonPrefixes</code> is filtered out from results if it is not lexicographically greater than the <code>StartAfter</code> value.</p>
    *          <note>
    *             <ul>
    *                <li>
@@ -14006,6 +14050,8 @@ export interface ListObjectVersionsRequest {
    *          grouped under a single result element in <code>CommonPrefixes</code>. These groups are
    *          counted as one result against the <code>max-keys</code> limitation. These keys are not
    *          returned elsewhere in the response.</p>
+   *          <p>
+   *             <code>CommonPrefixes</code> is filtered out from results if it is not lexicographically greater than the key-marker.</p>
    * @public
    */
   Delimiter?: string | undefined;

clients/client-s3/src/protocols/Aws_restXml.ts

@@ -3384,6 +3384,7 @@ export const de_CreateBucketCommand = async (
   const contents: any = map({
     $metadata: deserializeMetadata(output),
     [_L]: [, output.headers[_lo]],
+    [_BA]: [, output.headers[_xaba]],
   });
   await collectBody(output.body, context);
   return contents;
@@ -4490,6 +4491,7 @@ export const de_HeadBucketCommand = async (
   }
   const contents: any = map({
     $metadata: deserializeMetadata(output),
+    [_BA]: [, output.headers[_xaba]],
     [_BLT]: [, output.headers[_xablt]],
     [_BLN]: [, output.headers[_xabln]],
     [_BR]: [, output.headers[_xabr]],
@@ -6244,6 +6246,7 @@ const se_CreateBucketConfiguration = (input: CreateBucketConfiguration, context:
   if (input[_B] != null) {
     bn.c(se_BucketInfo(input[_B], context).n(_B));
   }
+  bn.lc(input, "Tags", "Tags", () => se_TagSet(input[_Tag]!, context));
   return bn;
 };
 
@@ -8011,6 +8014,9 @@ const de_Bucket = (output: any, context: __SerdeContext): Bucket => {
   if (output[_BR] != null) {
     contents[_BR] = __expectString(output[_BR]);
   }
+  if (output[_BA] != null) {
+    contents[_BA] = __expectString(output[_BA]);
+  }
   return contents;
 };
 
@@ -10136,6 +10142,7 @@ const _ASSEBD = "ApplyServerSideEncryptionByDefault";
 const _AT = "AccessTier";
 const _Ac = "Account";
 const _B = "Bucket";
+const _BA = "BucketArn";
 const _BAI = "BucketAccountId";
 const _BAS = "BucketAccelerateStatus";
 const _BGR = "BypassGovernanceRetention";
@@ -10678,6 +10685,7 @@ const _xaad = "x-amz-abort-date";
 const _xaapa = "x-amz-access-point-alias";
 const _xaari = "x-amz-abort-rule-id";
 const _xaas = "x-amz-archive-status";
+const _xaba = "x-amz-bucket-arn";
 const _xabgr = "x-amz-bypass-governance-retention";
 const _xabln = "x-amz-bucket-location-name";
 const _xablt = "x-amz-bucket-location-type";