|
2655 | 2655 | %% Example: |
2656 | 2656 | %% create_bucket_request() :: #{ |
2657 | 2657 | %% <<"ACL">> => list(any()), |
| 2658 | +%% <<"BucketNamespace">> => list(any()), |
2658 | 2659 | %% <<"CreateBucketConfiguration">> => create_bucket_configuration(), |
2659 | 2660 | %% <<"GrantFullControl">> => string(), |
2660 | 2661 | %% <<"GrantRead">> => string(), |
@@ -4189,12 +4190,15 @@ complete_multipart_upload(Client, Bucket, Key, Input0, Options0) -> |
4189 | 4190 | %% the |
4190 | 4191 | %% `s3express:CreateSession' |
4191 | 4192 | %% permission in |
4192 | | -%% the `Action' element of a policy to read the object. By default, the |
4193 | | -%% session is |
4194 | | -%% in the `ReadWrite' mode. If you want to restrict the access, you can |
4195 | | -%% explicitly |
4196 | | -%% set the `s3express:SessionMode' condition key to `ReadOnly' on the |
4197 | | -%% copy source bucket. |
| 4193 | +%% the `Action' element of a policy to read the object. If no session |
| 4194 | +%% mode is specified, |
| 4195 | +%% the session will be created with the maximum allowable privilege, |
| 4196 | +%% attempting `ReadWrite' |
| 4197 | +%% first, then `ReadOnly' if `ReadWrite' is not permitted. If you |
| 4198 | +%% want to explicitly |
| 4199 | +%% restrict the access to be read-only, you can set the |
| 4200 | +%% `s3express:SessionMode' condition key to |
| 4201 | +%% `ReadOnly' on the copy source bucket. |
4198 | 4202 | %% |
4199 | 4203 | %% If the copy destination is a directory bucket, you must have the |
4200 | 4204 | %% `s3express:CreateSession' |
@@ -4433,6 +4437,24 @@ copy_object(Client, Bucket, Key, Input0, Options0) -> |
4433 | 4437 | %% https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html |
4434 | 4438 | %% in the Amazon S3 User Guide. |
4435 | 4439 | %% |
| 4440 | +%% General purpose buckets exist in a global namespace, which means that each |
| 4441 | +%% bucket name must be unique |
| 4442 | +%% across all Amazon Web Services accounts in all the Amazon Web Services |
| 4443 | +%% Regions within a partition. A partition is a grouping of |
| 4444 | +%% Regions. Amazon Web Services currently has four partitions: `aws' |
| 4445 | +%% (Standard Regions), `aws-cn' |
| 4446 | +%% (China Regions), `aws-us-gov' (Amazon Web Services GovCloud (US)), and |
| 4447 | +%% `aws-eusc' |
| 4448 | +%% (European Sovereign Cloud). When you create a general purpose bucket, you |
| 4449 | +%% can choose to create a bucket in |
| 4450 | +%% the shared global namespace or you can choose to create a bucket in your |
| 4451 | +%% account regional namespace. |
| 4452 | +%% Your account regional namespace is a subdivision of the global namespace |
| 4453 | +%% that only your account can |
| 4454 | +%% create buckets in. For more information on account regional namespaces, |
| 4455 | +%% see Namespaces for general purpose buckets: |
| 4456 | +%% https://docs.aws.amazon.com/AmazonS3/latest/userguide/gpbucketnamespaces.html. |
| 4457 | +%% |
4436 | 4458 | %% General purpose buckets - If you send your |
4437 | 4459 | %% `CreateBucket' request to the `s3.amazonaws.com' global endpoint, |
4438 | 4460 | %% the |
@@ -4607,6 +4629,7 @@ create_bucket(Client, Bucket, Input0, Options0) -> |
4607 | 4629 |
|
4608 | 4630 | HeadersMapping = [ |
4609 | 4631 | {<<"x-amz-acl">>, <<"ACL">>}, |
| 4632 | + {<<"x-amz-bucket-namespace">>, <<"BucketNamespace">>}, |
4610 | 4633 | {<<"x-amz-grant-full-control">>, <<"GrantFullControl">>}, |
4611 | 4634 | {<<"x-amz-grant-read">>, <<"GrantRead">>}, |
4612 | 4635 | {<<"x-amz-grant-read-acp">>, <<"GrantReadACP">>}, |
@@ -6627,14 +6650,6 @@ delete_bucket_replication(Client, Bucket, Input0, Options0) -> |
6627 | 6650 | %% https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html |
6628 | 6651 | %% instead. |
6629 | 6652 | %% |
6630 | | -%% if ABAC is not enabled for the bucket. When you enable ABAC for a general |
6631 | | -%% purpose bucket: |
6632 | | -%% https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html, |
6633 | | -%% you can no longer use this operation for that bucket and must use |
6634 | | -%% UntagResource: |
6635 | | -%% https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_UntagResource.html |
6636 | | -%% instead. |
6637 | | -%% |
6638 | 6653 | %% To use this operation, you must have permission to perform the |
6639 | 6654 | %% `s3:PutBucketTagging' |
6640 | 6655 | %% action. By default, the bucket owner has this permission and can grant |
@@ -9025,14 +9040,6 @@ get_bucket_request_payment(Client, Bucket, QueryMap, HeadersMap, Options0) |
9025 | 9040 | %% |
9026 | 9041 | %% Returns the tag set associated with the general purpose bucket. |
9027 | 9042 | %% |
9028 | | -%% if ABAC is not enabled for the bucket. When you enable ABAC for a general |
9029 | | -%% purpose bucket: |
9030 | | -%% https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging-enable-abac.html, |
9031 | | -%% you can no longer use this operation for that bucket and must use |
9032 | | -%% ListTagsForResource: |
9033 | | -%% https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_ListTagsForResource.html |
9034 | | -%% instead. |
9035 | | -%% |
9036 | 9043 | %% To use this operation, you must have permission to perform the |
9037 | 9044 | %% `s3:GetBucketTagging' |
9038 | 9045 | %% action. By default, the bucket owner has this permission and can grant |
@@ -10442,11 +10449,15 @@ get_public_access_block(Client, Bucket, QueryMap, HeadersMap, Options0) |
10442 | 10449 | %% |
10443 | 10450 | %% `s3express:CreateSession' |
10444 | 10451 | %% permission in the |
10445 | | -%% `Action' element of a policy. By default, the session is in the |
10446 | | -%% `ReadWrite' mode. If you want to restrict the access, you can |
10447 | | -%% explicitly set the |
10448 | | -%% `s3express:SessionMode' condition key to `ReadOnly' on the |
10449 | | -%% bucket. |
| 10452 | +%% `Action' element of a policy. If no session mode is specified, the |
| 10453 | +%% session will be |
| 10454 | +%% created with the maximum allowable privilege, attempting `ReadWrite' |
| 10455 | +%% first, |
| 10456 | +%% then `ReadOnly' if `ReadWrite' is not permitted. If you want to |
| 10457 | +%% explicitly |
| 10458 | +%% restrict the access to be read-only, you can set the |
| 10459 | +%% `s3express:SessionMode' condition key to |
| 10460 | +%% `ReadOnly' on the bucket. |
10450 | 10461 | %% |
10451 | 10462 | %% For more information about example bucket policies, see Example |
10452 | 10463 | %% bucket policies for S3 Express One Zone: |
@@ -16766,12 +16777,15 @@ upload_part(Client, Bucket, Key, Input0, Options0) -> |
16766 | 16777 | %% the |
16767 | 16778 | %% `s3express:CreateSession' |
16768 | 16779 | %% permission in |
16769 | | -%% the `Action' element of a policy to read the object. By default, the |
16770 | | -%% session is |
16771 | | -%% in the `ReadWrite' mode. If you want to restrict the access, you can |
16772 | | -%% explicitly |
16773 | | -%% set the `s3express:SessionMode' condition key to `ReadOnly' on the |
16774 | | -%% copy source bucket. |
| 16780 | +%% the `Action' element of a policy to read the object. If no session |
| 16781 | +%% mode is specified, |
| 16782 | +%% the session will be created with the maximum allowable privilege, |
| 16783 | +%% attempting |
| 16784 | +%% `ReadWrite' first, then `ReadOnly' if `ReadWrite' is not |
| 16785 | +%% permitted. |
| 16786 | +%% If you want to explicitly restrict the access to be read-only, you can set |
| 16787 | +%% the `s3express:SessionMode' |
| 16788 | +%% condition key to `ReadOnly' on the copy source bucket. |
16775 | 16789 | %% |
16776 | 16790 | %% If the copy destination is a directory bucket, you must have the |
16777 | 16791 | %% `s3express:CreateSession' |
|
0 commit comments