aws-sdk-s3 1.215.0 → 1.216.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 78dbac7be5f04099a22976fa24d809974cf955579dbd0763ca2d65f6cd1bf4e9
4
- data.tar.gz: 5f51620aa5b2e452e70fb7074b62533e366f782dc0c6f977929255c5bfdc1d7e
3
+ metadata.gz: 539fec24f4c751a012ca361d7be60a80f94b1d07fbb181632765d516a21008a3
4
+ data.tar.gz: 2e54a909515cfbdb880efacfd805d9971a57fcb4a8a370ebde34b701d81458a2
5
5
  SHA512:
6
- metadata.gz: 849edcef5ad4ca08996c96bd49025a6fea354d432a0a9d4afa8de5d82821aedf8d836b7bf2eb57f243422c47f805172407b7bc9ae4d3d285ab752e14828d4eab
7
- data.tar.gz: 6c855768321f1fd0346061d27b9f0db98bf3e41758d3dd43e81b57333239ed8a33b286bdf92ab49777934ad0db3d098ce887e8b4efde3d181f070f2088663c5d
6
+ metadata.gz: 9f59e1c190f315dc70535a1a1afb32c2423c346dde0ba1743ae9f9afca795b81745da63bc60aa0db5b969099612c3e171caeabfd48e00c7d0966e7708462ba56
7
+ data.tar.gz: 1de88d9a5e2fe6d2a39bb85420e3099794b5fe0932fe3040db51a5c731a72a12b101ac750715278afe8565d49b4b97cf54454317b6222d9a4c7feb3086d136aa
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.216.0 (2026-03-12)
5
+ ------------------
6
+
7
+ * Feature - Adds support for account regional namespaces for general purpose buckets. The account regional namespace is a reserved subdivision of the global bucket namespace where only your account can create general purpose buckets.
8
+
4
9
  1.215.0 (2026-03-05)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.215.0
1
+ 1.216.0
@@ -277,6 +277,7 @@ module Aws::S3
277
277
  # grant_write_acp: "GrantWriteACP",
278
278
  # object_lock_enabled_for_bucket: false,
279
279
  # object_ownership: "BucketOwnerPreferred", # accepts BucketOwnerPreferred, ObjectWriter, BucketOwnerEnforced
280
+ # bucket_namespace: "account-regional", # accepts account-regional, global
280
281
  # })
281
282
  # @param [Hash] options ({})
282
283
  # @option options [String] :acl
@@ -362,6 +363,33 @@ module Aws::S3
362
363
  #
363
364
  #
364
365
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
366
+ # @option options [String] :bucket_namespace
367
+ # Specifies the namespace where you want to create your general purpose
368
+ # bucket. When you create a general purpose bucket, you can choose to
369
+ # create a bucket in the shared global namespace or you can choose to
370
+ # create a bucket in your account regional namespace. Your account
371
+ # regional namespace is a subdivision of the global namespace that only
372
+ # your account can create buckets in. For more information on bucket
373
+ # namespaces, see [Namespaces for general purpose buckets][1].
374
+ #
375
+ # General purpose buckets in your account regional namespace must follow
376
+ # a specific naming convention. These buckets consist of a bucket name
377
+ # prefix that you create, and a suffix that contains your 12-digit
378
+ # Amazon Web Services Account ID, the Amazon Web Services Region code,
379
+ # and ends with `-an`. Bucket names must follow the format
380
+ # `bucket-name-prefix-accountId-region-an` (for example,
381
+ # `amzn-s3-demo-bucket-111122223333-us-west-2-an`). For information
382
+ # about bucket naming restrictions, see [Account regional namespace
383
+ # naming rules][2] in the *Amazon S3 User Guide*.
384
+ #
385
+ # <note markdown="1"> This functionality is not supported for directory buckets.
386
+ #
387
+ # </note>
388
+ #
389
+ #
390
+ #
391
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/gpbucketnamespaces.html
392
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html#account-regional-naming-rules
365
393
  # @return [Types::CreateBucketOutput]
366
394
  def create(options = {})
367
395
  options = options.merge(bucket: @name)
@@ -1392,10 +1392,13 @@ module Aws::S3
1392
1392
  # * If the source object that you want to copy is in a directory
1393
1393
  # bucket, you must have the <b>
1394
1394
  # <code>s3express:CreateSession</code> </b> permission in the
1395
- # `Action` element of a policy to read the object. By default, the
1396
- # session is in the `ReadWrite` mode. If you want to restrict the
1397
- # access, you can explicitly set the `s3express:SessionMode`
1398
- # condition key to `ReadOnly` on the copy source bucket.
1395
+ # `Action` element of a policy to read the object. If no session
1396
+ # mode is specified, the session will be created with the maximum
1397
+ # allowable privilege, attempting `ReadWrite` first, then
1398
+ # `ReadOnly` if `ReadWrite` is not permitted. If you want to
1399
+ # explicitly restrict the access to be read-only, you can set the
1400
+ # `s3express:SessionMode` condition key to `ReadOnly` on the copy
1401
+ # source bucket.
1399
1402
  #
1400
1403
  # * If the copy destination is a directory bucket, you must have the
1401
1404
  # <b> <code>s3express:CreateSession</code> </b> permission in the
@@ -2435,6 +2438,20 @@ module Aws::S3
2435
2438
  # configuring, and working with Amazon S3 buckets][2] in the *Amazon S3
2436
2439
  # User Guide*.
2437
2440
  #
2441
+ # General purpose buckets exist in a global namespace, which means that
2442
+ # each bucket name must be unique across all Amazon Web Services
2443
+ # accounts in all the Amazon Web Services Regions within a partition. A
2444
+ # partition is a grouping of Regions. Amazon Web Services currently has
2445
+ # four partitions: `aws` (Standard Regions), `aws-cn` (China Regions),
2446
+ # `aws-us-gov` (Amazon Web Services GovCloud (US)), and `aws-eusc`
2447
+ # (European Sovereign Cloud). When you create a general purpose bucket,
2448
+ # you can choose to create a bucket in the shared global namespace or
2449
+ # you can choose to create a bucket in your account regional namespace.
2450
+ # Your account regional namespace is a subdivision of the global
2451
+ # namespace that only your account can create buckets in. For more
2452
+ # information on account regional namespaces, see [Namespaces for
2453
+ # general purpose buckets][3].
2454
+ #
2438
2455
  # <note markdown="1"> * **General purpose buckets** - If you send your `CreateBucket`
2439
2456
  # request to the `s3.amazonaws.com` global endpoint, the request goes
2440
2457
  # to the `us-east-1` Region. So the signature calculations in
@@ -2443,7 +2460,7 @@ module Aws::S3
2443
2460
  # the bucket is to be created. If you create a bucket in a Region
2444
2461
  # other than US East (N. Virginia), your application must be able to
2445
2462
  # handle 307 redirect. For more information, see [Virtual hosting of
2446
- # buckets][3] in the *Amazon S3 User Guide*.
2463
+ # buckets][4] in the *Amazon S3 User Guide*.
2447
2464
  #
2448
2465
  # * <b>Directory buckets </b> - For directory buckets, you must make
2449
2466
  # requests for this API operation to the Regional endpoint. These
@@ -2451,9 +2468,9 @@ module Aws::S3
2451
2468
  # `https://s3express-control.region-code.amazonaws.com/bucket-name `.
2452
2469
  # Virtual-hosted-style requests aren't supported. For more
2453
2470
  # information about endpoints in Availability Zones, see [Regional and
2454
- # Zonal endpoints for directory buckets in Availability Zones][4] in
2471
+ # Zonal endpoints for directory buckets in Availability Zones][5] in
2455
2472
  # the *Amazon S3 User Guide*. For more information about endpoints in
2456
- # Local Zones, see [Concepts for directory buckets in Local Zones][5]
2473
+ # Local Zones, see [Concepts for directory buckets in Local Zones][6]
2457
2474
  # in the *Amazon S3 User Guide*.
2458
2475
  #
2459
2476
  # </note>
@@ -2496,17 +2513,17 @@ module Aws::S3
2496
2513
  # disabled. If you would like to share data with users outside of
2497
2514
  # your account, you can use bucket policies as needed. For more
2498
2515
  # information, see [Controlling ownership of objects and disabling
2499
- # ACLs for your bucket ][6] and [Blocking public access to your
2500
- # Amazon S3 storage ][7] in the *Amazon S3 User Guide*.
2516
+ # ACLs for your bucket ][7] and [Blocking public access to your
2517
+ # Amazon S3 storage ][8] in the *Amazon S3 User Guide*.
2501
2518
  #
2502
2519
  # * **S3 Block Public Access** - If your specific use case requires
2503
2520
  # granting public access to your S3 resources, you can disable
2504
2521
  # Block Public Access. Specifically, you can create a new bucket
2505
2522
  # with Block Public Access enabled, then separately call the [
2506
- # `DeletePublicAccessBlock` ][8] API. To use this operation, you
2523
+ # `DeletePublicAccessBlock` ][9] API. To use this operation, you
2507
2524
  # must have the `s3:PutBucketPublicAccessBlock` permission. For
2508
2525
  # more information about S3 Block Public Access, see [Blocking
2509
- # public access to your Amazon S3 storage ][7] in the *Amazon S3
2526
+ # public access to your Amazon S3 storage ][8] in the *Amazon S3
2510
2527
  # User Guide*.
2511
2528
  # * **Directory bucket permissions** - You must have the
2512
2529
  # `s3express:CreateBucket` permission in an IAM identity-based
@@ -2515,7 +2532,7 @@ module Aws::S3
2515
2532
  # performed by the Amazon Web Services account that owns the
2516
2533
  # resource. For more information about directory bucket policies and
2517
2534
  # permissions, see [Amazon Web Services Identity and Access
2518
- # Management (IAM) for S3 Express One Zone][9] in the *Amazon S3
2535
+ # Management (IAM) for S3 Express One Zone][10] in the *Amazon S3
2519
2536
  # User Guide*.
2520
2537
  #
2521
2538
  # The permissions for ACLs, Object Lock, S3 Object Ownership, and S3
@@ -2525,9 +2542,9 @@ module Aws::S3
2525
2542
  # enforced (ACLs disabled). These settings can't be modified.
2526
2543
  #
2527
2544
  # For more information about permissions for creating and working
2528
- # with directory buckets, see [Directory buckets][10] in the *Amazon
2545
+ # with directory buckets, see [Directory buckets][11] in the *Amazon
2529
2546
  # S3 User Guide*. For more information about supported S3 features
2530
- # for directory buckets, see [Features of S3 Express One Zone][11]
2547
+ # for directory buckets, see [Features of S3 Express One Zone][12]
2531
2548
  # in the *Amazon S3 User Guide*.
2532
2549
  #
2533
2550
  # HTTP Host header syntax
@@ -2537,9 +2554,9 @@ module Aws::S3
2537
2554
  #
2538
2555
  # The following operations are related to `CreateBucket`:
2539
2556
  #
2540
- # * [PutObject][12]
2557
+ # * [PutObject][13]
2541
2558
  #
2542
- # * [DeleteBucket][13]
2559
+ # * [DeleteBucket][14]
2543
2560
  #
2544
2561
  # You must URL encode any signed header values that contain spaces. For
2545
2562
  # example, if your header value is `my file.txt`, containing two spaces
@@ -2549,17 +2566,18 @@ module Aws::S3
2549
2566
  #
2550
2567
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
2551
2568
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html
2552
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
2553
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
2554
- # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
2555
- # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2556
- # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
2557
- # [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
2558
- # [9]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
2559
- # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
2560
- # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
2561
- # [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
2562
- # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
2569
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/gpbucketnamespaces.html
2570
+ # [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
2571
+ # [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/endpoint-directory-buckets-AZ.html
2572
+ # [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-lzs-for-directory-buckets.html
2573
+ # [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2574
+ # [8]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-control-block-public-access.html
2575
+ # [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeletePublicAccessBlock.html
2576
+ # [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-security-iam.html
2577
+ # [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/directory-buckets-overview.html
2578
+ # [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-express-one-zone.html#s3-express-features
2579
+ # [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
2580
+ # [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
2563
2581
  #
2564
2582
  # @option params [String] :acl
2565
2583
  # The canned ACL to apply to the bucket.
@@ -2676,6 +2694,34 @@ module Aws::S3
2676
2694
  #
2677
2695
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
2678
2696
  #
2697
+ # @option params [String] :bucket_namespace
2698
+ # Specifies the namespace where you want to create your general purpose
2699
+ # bucket. When you create a general purpose bucket, you can choose to
2700
+ # create a bucket in the shared global namespace or you can choose to
2701
+ # create a bucket in your account regional namespace. Your account
2702
+ # regional namespace is a subdivision of the global namespace that only
2703
+ # your account can create buckets in. For more information on bucket
2704
+ # namespaces, see [Namespaces for general purpose buckets][1].
2705
+ #
2706
+ # General purpose buckets in your account regional namespace must follow
2707
+ # a specific naming convention. These buckets consist of a bucket name
2708
+ # prefix that you create, and a suffix that contains your 12-digit
2709
+ # Amazon Web Services Account ID, the Amazon Web Services Region code,
2710
+ # and ends with `-an`. Bucket names must follow the format
2711
+ # `bucket-name-prefix-accountId-region-an` (for example,
2712
+ # `amzn-s3-demo-bucket-111122223333-us-west-2-an`). For information
2713
+ # about bucket naming restrictions, see [Account regional namespace
2714
+ # naming rules][2] in the *Amazon S3 User Guide*.
2715
+ #
2716
+ # <note markdown="1"> This functionality is not supported for directory buckets.
2717
+ #
2718
+ # </note>
2719
+ #
2720
+ #
2721
+ #
2722
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/gpbucketnamespaces.html
2723
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html#account-regional-naming-rules
2724
+ #
2679
2725
  # @return [Types::CreateBucketOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
2680
2726
  #
2681
2727
  # * {Types::CreateBucketOutput#location #location} => String
@@ -2740,6 +2786,7 @@ module Aws::S3
2740
2786
  # grant_write_acp: "GrantWriteACP",
2741
2787
  # object_lock_enabled_for_bucket: false,
2742
2788
  # object_ownership: "BucketOwnerPreferred", # accepts BucketOwnerPreferred, ObjectWriter, BucketOwnerEnforced
2789
+ # bucket_namespace: "account-regional", # accepts account-regional, global
2743
2790
  # })
2744
2791
  #
2745
2792
  # @example Response structure
@@ -4146,12 +4193,17 @@ module Aws::S3
4146
4193
  #
4147
4194
  # @option params [String] :session_mode
4148
4195
  # Specifies the mode of the session that will be created, either
4149
- # `ReadWrite` or `ReadOnly`. By default, a `ReadWrite` session is
4150
- # created. A `ReadWrite` session is capable of executing all the Zonal
4151
- # endpoint API operations on a directory bucket. A `ReadOnly` session is
4152
- # constrained to execute the following Zonal endpoint API operations:
4153
- # `GetObject`, `HeadObject`, `ListObjectsV2`, `GetObjectAttributes`,
4154
- # `ListParts`, and `ListMultipartUploads`.
4196
+ # `ReadWrite` or `ReadOnly`. If no session mode is specified, the
4197
+ # default behavior attempts to create a session with the maximum
4198
+ # allowable privilege. It will first attempt to create a `ReadWrite`
4199
+ # session, and if that is not allowed by permissions, it will attempt to
4200
+ # create a `ReadOnly` session. If neither session type is allowed, the
4201
+ # request will return an Access Denied error. A `ReadWrite` session is
4202
+ # capable of executing all the Zonal endpoint API operations on a
4203
+ # directory bucket. A `ReadOnly` session is constrained to execute the
4204
+ # following Zonal endpoint API operations: `GetObject`, `HeadObject`,
4205
+ # `ListObjectsV2`, `GetObjectAttributes`, `ListParts`, and
4206
+ # `ListMultipartUploads`.
4155
4207
  #
4156
4208
  # @option params [required, String] :bucket
4157
4209
  # The name of the bucket that you create a session for.
@@ -5398,10 +5450,6 @@ module Aws::S3
5398
5450
  # for a general purpose bucket][1], you can no longer use this operation
5399
5451
  # for that bucket and must use [UntagResource][2] instead.
5400
5452
  #
5401
- # if ABAC is not enabled for the bucket. When you [enable ABAC for a
5402
- # general purpose bucket][1], you can no longer use this operation for
5403
- # that bucket and must use [UntagResource][2] instead.
5404
- #
5405
5453
  # To use this operation, you must have permission to perform the
5406
5454
  # `s3:PutBucketTagging` action. By default, the bucket owner has this
5407
5455
  # permission and can grant this permission to others.
@@ -8738,10 +8786,6 @@ module Aws::S3
8738
8786
  #
8739
8787
  # Returns the tag set associated with the general purpose bucket.
8740
8788
  #
8741
- # if ABAC is not enabled for the bucket. When you [enable ABAC for a
8742
- # general purpose bucket][1], you can no longer use this operation for
8743
- # that bucket and must use [ListTagsForResource][2] instead.
8744
- #
8745
8789
  # To use this operation, you must have permission to perform the
8746
8790
  # `s3:GetBucketTagging` action. By default, the bucket owner has this
8747
8791
  # permission and can grant this permission to others.
@@ -8756,9 +8800,9 @@ module Aws::S3
8756
8800
  #
8757
8801
  # The following operations are related to `GetBucketTagging`:
8758
8802
  #
8759
- # * [PutBucketTagging][3]
8803
+ # * [PutBucketTagging][1]
8760
8804
  #
8761
- # * [DeleteBucketTagging][4]
8805
+ # * [DeleteBucketTagging][2]
8762
8806
  #
8763
8807
  # You must URL encode any signed header values that contain spaces. For
8764
8808
  # example, if your header value is `my file.txt`, containing two spaces
@@ -8766,10 +8810,8 @@ module Aws::S3
8766
8810
  #
8767
8811
  #
8768
8812
  #
8769
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html
8770
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html
8771
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
8772
- # [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
8813
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketTagging.html
8814
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html
8773
8815
  #
8774
8816
  # @option params [required, String] :bucket
8775
8817
  # The name of the bucket for which to get the tagging information.
@@ -10950,10 +10992,12 @@ module Aws::S3
10950
10992
  #
10951
10993
  # * **Directory bucket permissions** - You must have the <b>
10952
10994
  # <code>s3express:CreateSession</code> </b> permission in the
10953
- # `Action` element of a policy. By default, the session is in the
10954
- # `ReadWrite` mode. If you want to restrict the access, you can
10955
- # explicitly set the `s3express:SessionMode` condition key to
10956
- # `ReadOnly` on the bucket.
10995
+ # `Action` element of a policy. If no session mode is specified, the
10996
+ # session will be created with the maximum allowable privilege,
10997
+ # attempting `ReadWrite` first, then `ReadOnly` if `ReadWrite` is
10998
+ # not permitted. If you want to explicitly restrict the access to be
10999
+ # read-only, you can set the `s3express:SessionMode` condition key
11000
+ # to `ReadOnly` on the bucket.
10957
11001
  #
10958
11002
  # For more information about example bucket policies, see [Example
10959
11003
  # bucket policies for S3 Express One Zone][3] and [Amazon Web
@@ -21610,10 +21654,13 @@ module Aws::S3
21610
21654
  # * If the source object that you want to copy is in a directory
21611
21655
  # bucket, you must have the <b>
21612
21656
  # <code>s3express:CreateSession</code> </b> permission in the
21613
- # `Action` element of a policy to read the object. By default, the
21614
- # session is in the `ReadWrite` mode. If you want to restrict the
21615
- # access, you can explicitly set the `s3express:SessionMode`
21616
- # condition key to `ReadOnly` on the copy source bucket.
21657
+ # `Action` element of a policy to read the object. If no session
21658
+ # mode is specified, the session will be created with the maximum
21659
+ # allowable privilege, attempting `ReadWrite` first, then
21660
+ # `ReadOnly` if `ReadWrite` is not permitted. If you want to
21661
+ # explicitly restrict the access to be read-only, you can set the
21662
+ # `s3express:SessionMode` condition key to `ReadOnly` on the copy
21663
+ # source bucket.
21617
21664
  #
21618
21665
  # * If the copy destination is a directory bucket, you must have the
21619
21666
  # <b> <code>s3express:CreateSession</code> </b> permission in the
@@ -22553,7 +22600,7 @@ module Aws::S3
22553
22600
  tracer: tracer
22554
22601
  )
22555
22602
  context[:gem_name] = 'aws-sdk-s3'
22556
- context[:gem_version] = '1.215.0'
22603
+ context[:gem_version] = '1.216.0'
22557
22604
  Seahorse::Client::Request.new(handlers, context)
22558
22605
  end
22559
22606
 
@@ -61,6 +61,7 @@ module Aws::S3
61
61
  BucketLoggingStatus = Shapes::StructureShape.new(name: 'BucketLoggingStatus')
62
62
  BucketLogsPermission = Shapes::StringShape.new(name: 'BucketLogsPermission')
63
63
  BucketName = Shapes::StringShape.new(name: 'BucketName')
64
+ BucketNamespace = Shapes::StringShape.new(name: 'BucketNamespace')
64
65
  BucketRegion = Shapes::StringShape.new(name: 'BucketRegion')
65
66
  BucketType = Shapes::StringShape.new(name: 'BucketType')
66
67
  BucketVersioningStatus = Shapes::StringShape.new(name: 'BucketVersioningStatus')
@@ -1013,6 +1014,7 @@ module Aws::S3
1013
1014
  CreateBucketRequest.add_member(:grant_write_acp, Shapes::ShapeRef.new(shape: GrantWriteACP, location: "header", location_name: "x-amz-grant-write-acp"))
1014
1015
  CreateBucketRequest.add_member(:object_lock_enabled_for_bucket, Shapes::ShapeRef.new(shape: ObjectLockEnabledForBucket, location: "header", location_name: "x-amz-bucket-object-lock-enabled"))
1015
1016
  CreateBucketRequest.add_member(:object_ownership, Shapes::ShapeRef.new(shape: ObjectOwnership, location: "header", location_name: "x-amz-object-ownership"))
1017
+ CreateBucketRequest.add_member(:bucket_namespace, Shapes::ShapeRef.new(shape: BucketNamespace, location: "header", location_name: "x-amz-bucket-namespace"))
1016
1018
  CreateBucketRequest.struct_class = Types::CreateBucketRequest
1017
1019
  CreateBucketRequest[:payload] = :create_bucket_configuration
1018
1020
  CreateBucketRequest[:payload_member] = CreateBucketRequest.member(:create_bucket_configuration)
@@ -64,6 +64,7 @@ module Aws::S3
64
64
  # grant_write_acp: "GrantWriteACP",
65
65
  # object_lock_enabled_for_bucket: false,
66
66
  # object_ownership: "BucketOwnerPreferred", # accepts BucketOwnerPreferred, ObjectWriter, BucketOwnerEnforced
67
+ # bucket_namespace: "account-regional", # accepts account-regional, global
67
68
  # })
68
69
  # @param [Hash] options ({})
69
70
  # @option options [String] :acl
@@ -171,6 +172,33 @@ module Aws::S3
171
172
  #
172
173
  #
173
174
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
175
+ # @option options [String] :bucket_namespace
176
+ # Specifies the namespace where you want to create your general purpose
177
+ # bucket. When you create a general purpose bucket, you can choose to
178
+ # create a bucket in the shared global namespace or you can choose to
179
+ # create a bucket in your account regional namespace. Your account
180
+ # regional namespace is a subdivision of the global namespace that only
181
+ # your account can create buckets in. For more information on bucket
182
+ # namespaces, see [Namespaces for general purpose buckets][1].
183
+ #
184
+ # General purpose buckets in your account regional namespace must follow
185
+ # a specific naming convention. These buckets consist of a bucket name
186
+ # prefix that you create, and a suffix that contains your 12-digit
187
+ # Amazon Web Services Account ID, the Amazon Web Services Region code,
188
+ # and ends with `-an`. Bucket names must follow the format
189
+ # `bucket-name-prefix-accountId-region-an` (for example,
190
+ # `amzn-s3-demo-bucket-111122223333-us-west-2-an`). For information
191
+ # about bucket naming restrictions, see [Account regional namespace
192
+ # naming rules][2] in the *Amazon S3 User Guide*.
193
+ #
194
+ # <note markdown="1"> This functionality is not supported for directory buckets.
195
+ #
196
+ # </note>
197
+ #
198
+ #
199
+ #
200
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/gpbucketnamespaces.html
201
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html#account-regional-naming-rules
174
202
  # @return [Bucket]
175
203
  def create_bucket(options = {})
176
204
  Aws::Plugins::UserAgent.metric('RESOURCE_MODEL') do
@@ -3075,6 +3075,36 @@ module Aws::S3
3075
3075
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
3076
3076
  # @return [String]
3077
3077
  #
3078
+ # @!attribute [rw] bucket_namespace
3079
+ # Specifies the namespace where you want to create your general
3080
+ # purpose bucket. When you create a general purpose bucket, you can
3081
+ # choose to create a bucket in the shared global namespace or you can
3082
+ # choose to create a bucket in your account regional namespace. Your
3083
+ # account regional namespace is a subdivision of the global namespace
3084
+ # that only your account can create buckets in. For more information
3085
+ # on bucket namespaces, see [Namespaces for general purpose
3086
+ # buckets][1].
3087
+ #
3088
+ # General purpose buckets in your account regional namespace must
3089
+ # follow a specific naming convention. These buckets consist of a
3090
+ # bucket name prefix that you create, and a suffix that contains your
3091
+ # 12-digit Amazon Web Services Account ID, the Amazon Web Services
3092
+ # Region code, and ends with `-an`. Bucket names must follow the
3093
+ # format `bucket-name-prefix-accountId-region-an` (for example,
3094
+ # `amzn-s3-demo-bucket-111122223333-us-west-2-an`). For information
3095
+ # about bucket naming restrictions, see [Account regional namespace
3096
+ # naming rules][2] in the *Amazon S3 User Guide*.
3097
+ #
3098
+ # <note markdown="1"> This functionality is not supported for directory buckets.
3099
+ #
3100
+ # </note>
3101
+ #
3102
+ #
3103
+ #
3104
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/gpbucketnamespaces.html
3105
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/bucketnamingrules.html#account-regional-naming-rules
3106
+ # @return [String]
3107
+ #
3078
3108
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketRequest AWS API Documentation
3079
3109
  #
3080
3110
  class CreateBucketRequest < Struct.new(
@@ -3087,7 +3117,8 @@ module Aws::S3
3087
3117
  :grant_write,
3088
3118
  :grant_write_acp,
3089
3119
  :object_lock_enabled_for_bucket,
3090
- :object_ownership)
3120
+ :object_ownership,
3121
+ :bucket_namespace)
3091
3122
  SENSITIVE = []
3092
3123
  include Aws::Structure
3093
3124
  end
@@ -3981,12 +4012,17 @@ module Aws::S3
3981
4012
 
3982
4013
  # @!attribute [rw] session_mode
3983
4014
  # Specifies the mode of the session that will be created, either
3984
- # `ReadWrite` or `ReadOnly`. By default, a `ReadWrite` session is
3985
- # created. A `ReadWrite` session is capable of executing all the Zonal
3986
- # endpoint API operations on a directory bucket. A `ReadOnly` session
3987
- # is constrained to execute the following Zonal endpoint API
3988
- # operations: `GetObject`, `HeadObject`, `ListObjectsV2`,
3989
- # `GetObjectAttributes`, `ListParts`, and `ListMultipartUploads`.
4015
+ # `ReadWrite` or `ReadOnly`. If no session mode is specified, the
4016
+ # default behavior attempts to create a session with the maximum
4017
+ # allowable privilege. It will first attempt to create a `ReadWrite`
4018
+ # session, and if that is not allowed by permissions, it will attempt
4019
+ # to create a `ReadOnly` session. If neither session type is allowed,
4020
+ # the request will return an Access Denied error. A `ReadWrite`
4021
+ # session is capable of executing all the Zonal endpoint API
4022
+ # operations on a directory bucket. A `ReadOnly` session is
4023
+ # constrained to execute the following Zonal endpoint API operations:
4024
+ # `GetObject`, `HeadObject`, `ListObjectsV2`, `GetObjectAttributes`,
4025
+ # `ListParts`, and `ListMultipartUploads`.
3990
4026
  # @return [String]
3991
4027
  #
3992
4028
  # @!attribute [rw] bucket
data/lib/aws-sdk-s3.rb CHANGED
@@ -75,7 +75,7 @@ module Aws::S3
75
75
  autoload :ObjectVersion, 'aws-sdk-s3/object_version'
76
76
  autoload :EventStreams, 'aws-sdk-s3/event_streams'
77
77
 
78
- GEM_VERSION = '1.215.0'
78
+ GEM_VERSION = '1.216.0'
79
79
 
80
80
  end
81
81
 
data/sig/bucket.rbs CHANGED
@@ -73,7 +73,8 @@ module Aws
73
73
  ?grant_write: ::String,
74
74
  ?grant_write_acp: ::String,
75
75
  ?object_lock_enabled_for_bucket: bool,
76
- ?object_ownership: ("BucketOwnerPreferred" | "ObjectWriter" | "BucketOwnerEnforced")
76
+ ?object_ownership: ("BucketOwnerPreferred" | "ObjectWriter" | "BucketOwnerEnforced"),
77
+ ?bucket_namespace: ("account-regional" | "global")
77
78
  ) -> Types::CreateBucketOutput
78
79
  | (?Hash[Symbol, untyped]) -> Types::CreateBucketOutput
79
80
 
data/sig/client.rbs CHANGED
@@ -256,7 +256,8 @@ module Aws
256
256
  ?grant_write: ::String,
257
257
  ?grant_write_acp: ::String,
258
258
  ?object_lock_enabled_for_bucket: bool,
259
- ?object_ownership: ("BucketOwnerPreferred" | "ObjectWriter" | "BucketOwnerEnforced")
259
+ ?object_ownership: ("BucketOwnerPreferred" | "ObjectWriter" | "BucketOwnerEnforced"),
260
+ ?bucket_namespace: ("account-regional" | "global")
260
261
  ) -> _CreateBucketResponseSuccess
261
262
  | (Hash[Symbol, untyped] params, ?Hash[Symbol, untyped] options) -> _CreateBucketResponseSuccess
262
263
 
data/sig/resource.rbs CHANGED
@@ -122,7 +122,8 @@ module Aws
122
122
  ?grant_write: ::String,
123
123
  ?grant_write_acp: ::String,
124
124
  ?object_lock_enabled_for_bucket: bool,
125
- ?object_ownership: ("BucketOwnerPreferred" | "ObjectWriter" | "BucketOwnerEnforced")
125
+ ?object_ownership: ("BucketOwnerPreferred" | "ObjectWriter" | "BucketOwnerEnforced"),
126
+ ?bucket_namespace: ("account-regional" | "global")
126
127
  ) -> Bucket
127
128
  | (?Hash[Symbol, untyped]) -> Bucket
128
129
 
data/sig/types.rbs CHANGED
@@ -376,6 +376,7 @@ module Aws::S3
376
376
  attr_accessor grant_write_acp: ::String
377
377
  attr_accessor object_lock_enabled_for_bucket: bool
378
378
  attr_accessor object_ownership: ("BucketOwnerPreferred" | "ObjectWriter" | "BucketOwnerEnforced")
379
+ attr_accessor bucket_namespace: ("account-regional" | "global")
379
380
  SENSITIVE: []
380
381
  end
381
382
 
metadata CHANGED
@@ -1,7 +1,7 @@
1
1
  --- !ruby/object:Gem::Specification
2
2
  name: aws-sdk-s3
3
3
  version: !ruby/object:Gem::Version
4
- version: 1.215.0
4
+ version: 1.216.0
5
5
  platform: ruby
6
6
  authors:
7
7
  - Amazon Web Services