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 +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +28 -0
- data/lib/aws-sdk-s3/client.rb +103 -56
- data/lib/aws-sdk-s3/client_api.rb +2 -0
- data/lib/aws-sdk-s3/resource.rb +28 -0
- data/lib/aws-sdk-s3/types.rb +43 -7
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/bucket.rbs +2 -1
- data/sig/client.rbs +2 -1
- data/sig/resource.rbs +2 -1
- data/sig/types.rbs +1 -0
- metadata +1 -1
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 539fec24f4c751a012ca361d7be60a80f94b1d07fbb181632765d516a21008a3
|
|
4
|
+
data.tar.gz: 2e54a909515cfbdb880efacfd805d9971a57fcb4a8a370ebde34b701d81458a2
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
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.
|
|
1
|
+
1.216.0
|
data/lib/aws-sdk-s3/bucket.rb
CHANGED
|
@@ -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)
|
data/lib/aws-sdk-s3/client.rb
CHANGED
|
@@ -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.
|
|
1396
|
-
#
|
|
1397
|
-
#
|
|
1398
|
-
#
|
|
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][
|
|
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][
|
|
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][
|
|
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 ][
|
|
2500
|
-
# Amazon S3 storage ][
|
|
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` ][
|
|
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 ][
|
|
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][
|
|
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][
|
|
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][
|
|
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][
|
|
2557
|
+
# * [PutObject][13]
|
|
2541
2558
|
#
|
|
2542
|
-
# * [DeleteBucket][
|
|
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/
|
|
2553
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
2554
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
|
2555
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
|
2556
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
|
2557
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
2558
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
2559
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
|
2560
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/
|
|
2561
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
|
2562
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
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`.
|
|
4150
|
-
#
|
|
4151
|
-
#
|
|
4152
|
-
#
|
|
4153
|
-
#
|
|
4154
|
-
# `
|
|
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][
|
|
8803
|
+
# * [PutBucketTagging][1]
|
|
8760
8804
|
#
|
|
8761
|
-
# * [DeleteBucketTagging][
|
|
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/
|
|
8770
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
|
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.
|
|
10954
|
-
#
|
|
10955
|
-
#
|
|
10956
|
-
#
|
|
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.
|
|
21614
|
-
#
|
|
21615
|
-
#
|
|
21616
|
-
#
|
|
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.
|
|
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)
|
data/lib/aws-sdk-s3/resource.rb
CHANGED
|
@@ -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
|
data/lib/aws-sdk-s3/types.rb
CHANGED
|
@@ -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`.
|
|
3985
|
-
#
|
|
3986
|
-
#
|
|
3987
|
-
# is
|
|
3988
|
-
#
|
|
3989
|
-
#
|
|
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
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
|
|