aws-sdk-s3 1.92.0 → 1.95.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 +27 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3.rb +1 -1
- data/lib/aws-sdk-s3/arn/access_point_arn.rb +2 -4
- data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +2 -4
- data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +1 -3
- data/lib/aws-sdk-s3/bucket.rb +11 -11
- data/lib/aws-sdk-s3/bucket_acl.rb +4 -2
- data/lib/aws-sdk-s3/bucket_logging.rb +1 -2
- data/lib/aws-sdk-s3/client.rb +320 -287
- data/lib/aws-sdk-s3/customizations/object.rb +30 -11
- data/lib/aws-sdk-s3/file_uploader.rb +2 -2
- data/lib/aws-sdk-s3/multipart_upload.rb +3 -3
- data/lib/aws-sdk-s3/multipart_upload_part.rb +2 -2
- data/lib/aws-sdk-s3/object.rb +104 -20
- data/lib/aws-sdk-s3/object_acl.rb +5 -3
- data/lib/aws-sdk-s3/object_summary.rb +17 -19
- data/lib/aws-sdk-s3/object_version.rb +4 -4
- data/lib/aws-sdk-s3/plugins/arn.rb +37 -21
- data/lib/aws-sdk-s3/presigner.rb +12 -3
- data/lib/aws-sdk-s3/resource.rb +4 -2
- data/lib/aws-sdk-s3/types.rb +209 -195
- metadata +5 -6
@@ -247,7 +247,7 @@ module Aws::S3
|
|
247
247
|
# request. Bucket owners need not specify this parameter in their
|
248
248
|
# requests. For information about downloading objects from requester
|
249
249
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
250
|
-
# in the *Amazon S3
|
250
|
+
# in the *Amazon S3 User Guide*.
|
251
251
|
#
|
252
252
|
#
|
253
253
|
#
|
@@ -347,7 +347,7 @@ module Aws::S3
|
|
347
347
|
# request. Bucket owners need not specify this parameter in their
|
348
348
|
# requests. For information about downloading objects from requester
|
349
349
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
350
|
-
# in the *Amazon S3
|
350
|
+
# in the *Amazon S3 User Guide*.
|
351
351
|
#
|
352
352
|
#
|
353
353
|
#
|
@@ -431,7 +431,7 @@ module Aws::S3
|
|
431
431
|
# request. Bucket owners need not specify this parameter in their
|
432
432
|
# requests. For information about downloading objects from requester
|
433
433
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
434
|
-
# in the *Amazon S3
|
434
|
+
# in the *Amazon S3 User Guide*.
|
435
435
|
#
|
436
436
|
#
|
437
437
|
#
|
@@ -536,7 +536,7 @@ module Aws::S3
|
|
536
536
|
# request. Bucket owners need not specify this parameter in their
|
537
537
|
# requests. For information about downloading objects from requester
|
538
538
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
539
|
-
# in the *Amazon S3
|
539
|
+
# in the *Amazon S3 User Guide*.
|
540
540
|
#
|
541
541
|
#
|
542
542
|
#
|
@@ -39,6 +39,7 @@ be made. Set to `false` to use the client's region instead.
|
|
39
39
|
context.http_request.endpoint,
|
40
40
|
context.metadata[:s3_arn][:arn],
|
41
41
|
context.metadata[:s3_arn][:resolved_region],
|
42
|
+
context.metadata[:s3_arn][:fips],
|
42
43
|
context.metadata[:s3_arn][:dualstack],
|
43
44
|
# if regional_endpoint is false, a custom endpoint was provided
|
44
45
|
# in this case, we want to prefix the endpoint using the ARN
|
@@ -63,9 +64,17 @@ be made. Set to `false` to use the client's region instead.
|
|
63
64
|
if arn
|
64
65
|
validate_config!(context, arn)
|
65
66
|
|
67
|
+
fips = false
|
68
|
+
if resolved_region.include?('fips')
|
69
|
+
fips = true
|
70
|
+
resolved_region = resolved_region.gsub('fips-', '')
|
71
|
+
.gsub('-fips', '')
|
72
|
+
end
|
73
|
+
|
66
74
|
context.metadata[:s3_arn] = {
|
67
75
|
arn: arn,
|
68
76
|
resolved_region: resolved_region,
|
77
|
+
fips: fips,
|
69
78
|
dualstack: extract_dualstack_config!(context)
|
70
79
|
}
|
71
80
|
end
|
@@ -118,7 +127,7 @@ be made. Set to `false` to use the client's region instead.
|
|
118
127
|
s3_arn = resolve_arn_type!(arn)
|
119
128
|
s3_arn.validate_arn!
|
120
129
|
validate_region_config!(s3_arn, region, use_arn_region)
|
121
|
-
region = s3_arn.region if use_arn_region
|
130
|
+
region = s3_arn.region if use_arn_region && !region.include?('fips')
|
122
131
|
[region, s3_arn]
|
123
132
|
else
|
124
133
|
[region]
|
@@ -126,9 +135,9 @@ be made. Set to `false` to use the client's region instead.
|
|
126
135
|
end
|
127
136
|
|
128
137
|
# @api private
|
129
|
-
def resolve_url!(url, arn, region, dualstack = false, has_custom_endpoint = false)
|
138
|
+
def resolve_url!(url, arn, region, fips = false, dualstack = false, has_custom_endpoint = false)
|
130
139
|
custom_endpoint = url.host if has_custom_endpoint
|
131
|
-
url.host = arn.host_url(region, dualstack, custom_endpoint)
|
140
|
+
url.host = arn.host_url(region, fips, dualstack, custom_endpoint)
|
132
141
|
url.path = url_path(url.path, arn)
|
133
142
|
url
|
134
143
|
end
|
@@ -174,33 +183,40 @@ be made. Set to `false` to use the client's region instead.
|
|
174
183
|
end
|
175
184
|
|
176
185
|
def validate_region_config!(arn, region, use_arn_region)
|
177
|
-
|
178
|
-
|
179
|
-
|
180
|
-
|
181
|
-
|
182
|
-
(region == 's3-external-1' || region == 'aws-global')
|
183
|
-
if !fips && arn.region.include?('fips')
|
184
|
-
raise ArgumentError,
|
185
|
-
'FIPS region ARNs are not supported for this type of ARN.'
|
186
|
+
if ['s3-external-1', 'aws-global'].include?(region)
|
187
|
+
# These "regions" are not regional endpoints
|
188
|
+
unless use_arn_region
|
189
|
+
raise Aws::Errors::InvalidARNRegionError,
|
190
|
+
'Configured client region is not a regional endpoint.'
|
186
191
|
end
|
187
|
-
|
188
|
-
|
189
|
-
|
190
|
-
|
191
|
-
'ARN without `:s3_use_arn_region`.'
|
192
|
+
# These "regions" are in the AWS partition
|
193
|
+
# Cannot use ARN region unless it's the same partition
|
194
|
+
unless arn.partition == 'aws'
|
195
|
+
raise Aws::Errors::InvalidARNPartitionError
|
192
196
|
end
|
193
|
-
|
194
|
-
|
195
|
-
|
197
|
+
else
|
198
|
+
if region.include?('fips')
|
199
|
+
# If ARN type doesn't support FIPS but the client region is FIPS
|
200
|
+
unless arn.support_fips?
|
201
|
+
raise ArgumentError,
|
202
|
+
'FIPS client regions are not supported for this type '\
|
203
|
+
'of ARN.'
|
204
|
+
end
|
205
|
+
|
206
|
+
fips = true
|
207
|
+
# Normalize the region so we can compare partition and regions
|
196
208
|
region = region.gsub('fips-', '').gsub('-fips', '')
|
197
209
|
end
|
210
|
+
|
211
|
+
# Raise if the ARN and client regions are in different partitions
|
198
212
|
if use_arn_region &&
|
199
213
|
!Aws::Partitions.partition(arn.partition).region?(region)
|
200
214
|
raise Aws::Errors::InvalidARNPartitionError
|
201
215
|
end
|
202
216
|
|
203
|
-
|
217
|
+
# Raise if regions mismatch
|
218
|
+
# Either when it's a fips client or not using the ARN region
|
219
|
+
if (!use_arn_region || fips) && region != arn.region
|
204
220
|
raise Aws::Errors::InvalidARNRegionError
|
205
221
|
end
|
206
222
|
end
|
data/lib/aws-sdk-s3/presigner.rb
CHANGED
@@ -138,6 +138,7 @@ module Aws
|
|
138
138
|
|
139
139
|
req = @client.build_request(method, params)
|
140
140
|
use_bucket_as_hostname(req) if virtual_host
|
141
|
+
handle_presigned_url_context(req)
|
141
142
|
|
142
143
|
x_amz_headers = sign_but_dont_send(
|
143
144
|
req, expires_in, scheme, time, unsigned_headers, hoist
|
@@ -183,6 +184,17 @@ module Aws
|
|
183
184
|
end
|
184
185
|
end
|
185
186
|
|
187
|
+
# Used for excluding presigned_urls from API request count.
|
188
|
+
#
|
189
|
+
# Store context information as early as possible, to allow
|
190
|
+
# handlers to perform decisions based on this flag if need.
|
191
|
+
def handle_presigned_url_context(req)
|
192
|
+
req.handle(step: :initialize, priority: 98) do |context|
|
193
|
+
context[:presigned_url] = true
|
194
|
+
@handler.call(context)
|
195
|
+
end
|
196
|
+
end
|
197
|
+
|
186
198
|
# @param [Seahorse::Client::Request] req
|
187
199
|
def sign_but_dont_send(
|
188
200
|
req, expires_in, scheme, time, unsigned_headers, hoist = true
|
@@ -242,9 +254,6 @@ module Aws
|
|
242
254
|
time: time
|
243
255
|
).to_s
|
244
256
|
|
245
|
-
# Used for excluding presigned_urls from API request count
|
246
|
-
context[:presigned_url] = true
|
247
|
-
|
248
257
|
Seahorse::Client::Response.new(context: context, data: url)
|
249
258
|
end
|
250
259
|
# Return the headers
|
data/lib/aws-sdk-s3/resource.rb
CHANGED
@@ -65,8 +65,10 @@ module Aws::S3
|
|
65
65
|
# @option options [String] :grant_read_acp
|
66
66
|
# Allows grantee to read the bucket ACL.
|
67
67
|
# @option options [String] :grant_write
|
68
|
-
# Allows grantee to create
|
69
|
-
#
|
68
|
+
# Allows grantee to create new objects in the bucket.
|
69
|
+
#
|
70
|
+
# For the bucket and object owners of existing objects, also allows
|
71
|
+
# deletions and overwrites of those objects.
|
70
72
|
# @option options [String] :grant_write_acp
|
71
73
|
# Allows grantee to write the ACL for the applicable bucket.
|
72
74
|
# @option options [Boolean] :object_lock_enabled_for_bucket
|
data/lib/aws-sdk-s3/types.rb
CHANGED
@@ -14,7 +14,7 @@ module Aws::S3
|
|
14
14
|
# upload that Amazon S3 will wait before permanently removing all parts
|
15
15
|
# of the upload. For more information, see [ Aborting Incomplete
|
16
16
|
# Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
|
17
|
-
#
|
17
|
+
# S3 User Guide*.
|
18
18
|
#
|
19
19
|
#
|
20
20
|
#
|
@@ -73,8 +73,8 @@ module Aws::S3
|
|
73
73
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
74
74
|
# When using this action with an access point through the AWS SDKs,
|
75
75
|
# you provide the access point ARN in place of the bucket name. For
|
76
|
-
# more information about access point ARNs, see [Using
|
77
|
-
#
|
76
|
+
# more information about access point ARNs, see [Using access
|
77
|
+
# points][1] in the *Amazon S3 User Guide*.
|
78
78
|
#
|
79
79
|
# When using this action with Amazon S3 on Outposts, you must direct
|
80
80
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -83,7 +83,7 @@ module Aws::S3
|
|
83
83
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
84
84
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
85
85
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
86
|
-
# Outposts][2] in the *Amazon
|
86
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
87
87
|
#
|
88
88
|
#
|
89
89
|
#
|
@@ -104,7 +104,7 @@ module Aws::S3
|
|
104
104
|
# request. Bucket owners need not specify this parameter in their
|
105
105
|
# requests. For information about downloading objects from requester
|
106
106
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
107
|
-
# in the *Amazon S3
|
107
|
+
# in the *Amazon S3 User Guide*.
|
108
108
|
#
|
109
109
|
#
|
110
110
|
#
|
@@ -131,7 +131,7 @@ module Aws::S3
|
|
131
131
|
|
132
132
|
# Configures the transfer acceleration state for an Amazon S3 bucket.
|
133
133
|
# For more information, see [Amazon S3 Transfer Acceleration][1] in the
|
134
|
-
# *Amazon
|
134
|
+
# *Amazon S3 User Guide*.
|
135
135
|
#
|
136
136
|
#
|
137
137
|
#
|
@@ -209,8 +209,7 @@ module Aws::S3
|
|
209
209
|
#
|
210
210
|
# @!attribute [rw] owner
|
211
211
|
# Specifies the replica ownership. For default and valid values, see
|
212
|
-
# [PUT bucket replication][1] in the *Amazon
|
213
|
-
# API Reference*.
|
212
|
+
# [PUT bucket replication][1] in the *Amazon S3 API Reference*.
|
214
213
|
#
|
215
214
|
#
|
216
215
|
#
|
@@ -492,7 +491,7 @@ module Aws::S3
|
|
492
491
|
|
493
492
|
# Specifies the lifecycle configuration for objects in an Amazon S3
|
494
493
|
# bucket. For more information, see [Object Lifecycle Management][1] in
|
495
|
-
# the *Amazon
|
494
|
+
# the *Amazon S3 User Guide*.
|
496
495
|
#
|
497
496
|
#
|
498
497
|
#
|
@@ -590,8 +589,7 @@ module Aws::S3
|
|
590
589
|
# @!attribute [rw] logging_enabled
|
591
590
|
# Describes where logs are stored and the prefix that Amazon S3
|
592
591
|
# assigns to all log object keys for a bucket. For more information,
|
593
|
-
# see [PUT Bucket logging][1] in the *Amazon
|
594
|
-
# API Reference*.
|
592
|
+
# see [PUT Bucket logging][1] in the *Amazon S3 API Reference*.
|
595
593
|
#
|
596
594
|
#
|
597
595
|
#
|
@@ -608,8 +606,7 @@ module Aws::S3
|
|
608
606
|
|
609
607
|
# Describes the cross-origin access configuration for objects in an
|
610
608
|
# Amazon S3 bucket. For more information, see [Enabling Cross-Origin
|
611
|
-
# Resource Sharing][1] in the *Amazon
|
612
|
-
# Guide*.
|
609
|
+
# Resource Sharing][1] in the *Amazon S3 User Guide*.
|
613
610
|
#
|
614
611
|
#
|
615
612
|
#
|
@@ -925,8 +922,8 @@ module Aws::S3
|
|
925
922
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
926
923
|
# When using this action with an access point through the AWS SDKs,
|
927
924
|
# you provide the access point ARN in place of the bucket name. For
|
928
|
-
# more information about access point ARNs, see [Using
|
929
|
-
#
|
925
|
+
# more information about access point ARNs, see [Using access
|
926
|
+
# points][1] in the *Amazon S3 User Guide*.
|
930
927
|
#
|
931
928
|
# When using this action with Amazon S3 on Outposts, you must direct
|
932
929
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -935,7 +932,7 @@ module Aws::S3
|
|
935
932
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
936
933
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
937
934
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
938
|
-
# Outposts][2] in the *Amazon
|
935
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
939
936
|
#
|
940
937
|
#
|
941
938
|
#
|
@@ -1049,7 +1046,7 @@ module Aws::S3
|
|
1049
1046
|
# request. Bucket owners need not specify this parameter in their
|
1050
1047
|
# requests. For information about downloading objects from requester
|
1051
1048
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
1052
|
-
# in the *Amazon S3
|
1049
|
+
# in the *Amazon S3 User Guide*.
|
1053
1050
|
#
|
1054
1051
|
#
|
1055
1052
|
#
|
@@ -1327,8 +1324,8 @@ module Aws::S3
|
|
1327
1324
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
1328
1325
|
# When using this action with an access point through the AWS SDKs,
|
1329
1326
|
# you provide the access point ARN in place of the bucket name. For
|
1330
|
-
# more information about access point ARNs, see [Using
|
1331
|
-
#
|
1327
|
+
# more information about access point ARNs, see [Using access
|
1328
|
+
# points][1] in the *Amazon S3 User Guide*.
|
1332
1329
|
#
|
1333
1330
|
# When using this action with Amazon S3 on Outposts, you must direct
|
1334
1331
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -1337,7 +1334,7 @@ module Aws::S3
|
|
1337
1334
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
1338
1335
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
1339
1336
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
1340
|
-
# Outposts][2] in the *Amazon
|
1337
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
1341
1338
|
#
|
1342
1339
|
#
|
1343
1340
|
#
|
@@ -1491,7 +1488,7 @@ module Aws::S3
|
|
1491
1488
|
# and high availability. Depending on performance needs, you can
|
1492
1489
|
# specify a different Storage Class. Amazon S3 on Outposts only uses
|
1493
1490
|
# the OUTPOSTS Storage Class. For more information, see [Storage
|
1494
|
-
# Classes][1] in the *Amazon S3
|
1491
|
+
# Classes][1] in the *Amazon S3 User Guide*.
|
1495
1492
|
#
|
1496
1493
|
#
|
1497
1494
|
#
|
@@ -1530,7 +1527,7 @@ module Aws::S3
|
|
1530
1527
|
# made via SSL or using SigV4. For information about configuring using
|
1531
1528
|
# any of the officially supported AWS SDKs and AWS CLI, see
|
1532
1529
|
# [Specifying the Signature Version in Request Authentication][1] in
|
1533
|
-
# the *Amazon S3
|
1530
|
+
# the *Amazon S3 User Guide*.
|
1534
1531
|
#
|
1535
1532
|
#
|
1536
1533
|
#
|
@@ -1575,7 +1572,7 @@ module Aws::S3
|
|
1575
1572
|
# request. Bucket owners need not specify this parameter in their
|
1576
1573
|
# requests. For information about downloading objects from requester
|
1577
1574
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
1578
|
-
# in the *Amazon S3
|
1575
|
+
# in the *Amazon S3 User Guide*.
|
1579
1576
|
#
|
1580
1577
|
#
|
1581
1578
|
#
|
@@ -1782,8 +1779,10 @@ module Aws::S3
|
|
1782
1779
|
# @return [String]
|
1783
1780
|
#
|
1784
1781
|
# @!attribute [rw] grant_write
|
1785
|
-
# Allows grantee to create
|
1786
|
-
#
|
1782
|
+
# Allows grantee to create new objects in the bucket.
|
1783
|
+
#
|
1784
|
+
# For the bucket and object owners of existing objects, also allows
|
1785
|
+
# deletions and overwrites of those objects.
|
1787
1786
|
# @return [String]
|
1788
1787
|
#
|
1789
1788
|
# @!attribute [rw] grant_write_acp
|
@@ -1844,8 +1843,8 @@ module Aws::S3
|
|
1844
1843
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
1845
1844
|
# When using this action with an access point through the AWS SDKs,
|
1846
1845
|
# you provide the access point ARN in place of the bucket name. For
|
1847
|
-
# more information about access point ARNs, see [Using
|
1848
|
-
#
|
1846
|
+
# more information about access point ARNs, see [Using access
|
1847
|
+
# points][1] in the *Amazon S3 User Guide*.
|
1849
1848
|
#
|
1850
1849
|
# When using this action with Amazon S3 on Outposts, you must direct
|
1851
1850
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -1854,7 +1853,7 @@ module Aws::S3
|
|
1854
1853
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
1855
1854
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
1856
1855
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
1857
|
-
# Outposts][2] in the *Amazon
|
1856
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
1858
1857
|
#
|
1859
1858
|
#
|
1860
1859
|
#
|
@@ -1982,8 +1981,8 @@ module Aws::S3
|
|
1982
1981
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
1983
1982
|
# When using this action with an access point through the AWS SDKs,
|
1984
1983
|
# you provide the access point ARN in place of the bucket name. For
|
1985
|
-
# more information about access point ARNs, see [Using
|
1986
|
-
#
|
1984
|
+
# more information about access point ARNs, see [Using access
|
1985
|
+
# points][1] in the *Amazon S3 User Guide*.
|
1987
1986
|
#
|
1988
1987
|
# When using this action with Amazon S3 on Outposts, you must direct
|
1989
1988
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -1992,7 +1991,7 @@ module Aws::S3
|
|
1992
1991
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
1993
1992
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
1994
1993
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
1995
|
-
# Outposts][2] in the *Amazon
|
1994
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
1996
1995
|
#
|
1997
1996
|
#
|
1998
1997
|
#
|
@@ -2070,7 +2069,7 @@ module Aws::S3
|
|
2070
2069
|
# and high availability. Depending on performance needs, you can
|
2071
2070
|
# specify a different Storage Class. Amazon S3 on Outposts only uses
|
2072
2071
|
# the OUTPOSTS Storage Class. For more information, see [Storage
|
2073
|
-
# Classes][1] in the *Amazon S3
|
2072
|
+
# Classes][1] in the *Amazon S3 User Guide*.
|
2074
2073
|
#
|
2075
2074
|
#
|
2076
2075
|
#
|
@@ -2109,8 +2108,7 @@ module Aws::S3
|
|
2109
2108
|
# protected by AWS KMS will fail if not made via SSL or using SigV4.
|
2110
2109
|
# For information about configuring using any of the officially
|
2111
2110
|
# supported AWS SDKs and AWS CLI, see [Specifying the Signature
|
2112
|
-
# Version in Request Authentication][1] in the *Amazon S3
|
2113
|
-
# Guide*.
|
2111
|
+
# Version in Request Authentication][1] in the *Amazon S3 User Guide*.
|
2114
2112
|
#
|
2115
2113
|
#
|
2116
2114
|
#
|
@@ -2138,7 +2136,7 @@ module Aws::S3
|
|
2138
2136
|
# request. Bucket owners need not specify this parameter in their
|
2139
2137
|
# requests. For information about downloading objects from requester
|
2140
2138
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
2141
|
-
# in the *Amazon S3
|
2139
|
+
# in the *Amazon S3 User Guide*.
|
2142
2140
|
#
|
2143
2141
|
#
|
2144
2142
|
#
|
@@ -2209,6 +2207,14 @@ module Aws::S3
|
|
2209
2207
|
# The container element for specifying the default Object Lock retention
|
2210
2208
|
# settings for new objects placed in the specified bucket.
|
2211
2209
|
#
|
2210
|
+
# <note markdown="1"> * The `DefaultRetention` settings require both a mode and a period.
|
2211
|
+
#
|
2212
|
+
# * The `DefaultRetention` period can be either `Days` or `Years` but
|
2213
|
+
# you must select one. You cannot specify `Days` and `Years` at the
|
2214
|
+
# same time.
|
2215
|
+
#
|
2216
|
+
# </note>
|
2217
|
+
#
|
2212
2218
|
# @note When making an API call, you may pass DefaultRetention
|
2213
2219
|
# data as a hash:
|
2214
2220
|
#
|
@@ -2220,17 +2226,18 @@ module Aws::S3
|
|
2220
2226
|
#
|
2221
2227
|
# @!attribute [rw] mode
|
2222
2228
|
# The default Object Lock retention mode you want to apply to new
|
2223
|
-
# objects placed in the specified bucket.
|
2229
|
+
# objects placed in the specified bucket. Must be used with either
|
2230
|
+
# `Days` or `Years`.
|
2224
2231
|
# @return [String]
|
2225
2232
|
#
|
2226
2233
|
# @!attribute [rw] days
|
2227
2234
|
# The number of days that you want to specify for the default
|
2228
|
-
# retention period.
|
2235
|
+
# retention period. Must be used with `Mode`.
|
2229
2236
|
# @return [Integer]
|
2230
2237
|
#
|
2231
2238
|
# @!attribute [rw] years
|
2232
2239
|
# The number of years that you want to specify for the default
|
2233
|
-
# retention period.
|
2240
|
+
# retention period. Must be used with `Mode`.
|
2234
2241
|
# @return [Integer]
|
2235
2242
|
#
|
2236
2243
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DefaultRetention AWS API Documentation
|
@@ -2777,8 +2784,8 @@ module Aws::S3
|
|
2777
2784
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
2778
2785
|
# When using this action with an access point through the AWS SDKs,
|
2779
2786
|
# you provide the access point ARN in place of the bucket name. For
|
2780
|
-
# more information about access point ARNs, see [Using
|
2781
|
-
#
|
2787
|
+
# more information about access point ARNs, see [Using access
|
2788
|
+
# points][1] in the *Amazon S3 User Guide*.
|
2782
2789
|
#
|
2783
2790
|
# When using this action with Amazon S3 on Outposts, you must direct
|
2784
2791
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -2787,7 +2794,7 @@ module Aws::S3
|
|
2787
2794
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
2788
2795
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
2789
2796
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
2790
|
-
# Outposts][2] in the *Amazon
|
2797
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
2791
2798
|
#
|
2792
2799
|
#
|
2793
2800
|
#
|
@@ -2815,7 +2822,7 @@ module Aws::S3
|
|
2815
2822
|
# request. Bucket owners need not specify this parameter in their
|
2816
2823
|
# requests. For information about downloading objects from requester
|
2817
2824
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
2818
|
-
# in the *Amazon S3
|
2825
|
+
# in the *Amazon S3 User Guide*.
|
2819
2826
|
#
|
2820
2827
|
#
|
2821
2828
|
#
|
@@ -2879,8 +2886,8 @@ module Aws::S3
|
|
2879
2886
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
2880
2887
|
# When using this action with an access point through the AWS SDKs,
|
2881
2888
|
# you provide the access point ARN in place of the bucket name. For
|
2882
|
-
# more information about access point ARNs, see [Using
|
2883
|
-
#
|
2889
|
+
# more information about access point ARNs, see [Using access
|
2890
|
+
# points][1] in the *Amazon S3 User Guide*.
|
2884
2891
|
#
|
2885
2892
|
# When using this action with Amazon S3 on Outposts, you must direct
|
2886
2893
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -2889,7 +2896,7 @@ module Aws::S3
|
|
2889
2896
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
2890
2897
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
2891
2898
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
2892
|
-
# Outposts][2] in the *Amazon
|
2899
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
2893
2900
|
#
|
2894
2901
|
#
|
2895
2902
|
#
|
@@ -2977,8 +2984,8 @@ module Aws::S3
|
|
2977
2984
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
2978
2985
|
# When using this action with an access point through the AWS SDKs,
|
2979
2986
|
# you provide the access point ARN in place of the bucket name. For
|
2980
|
-
# more information about access point ARNs, see [Using
|
2981
|
-
#
|
2987
|
+
# more information about access point ARNs, see [Using access
|
2988
|
+
# points][1] in the *Amazon S3 User Guide*.
|
2982
2989
|
#
|
2983
2990
|
# When using this action with Amazon S3 on Outposts, you must direct
|
2984
2991
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -2987,7 +2994,7 @@ module Aws::S3
|
|
2987
2994
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
2988
2995
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
2989
2996
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
2990
|
-
# Outposts][2] in the *Amazon
|
2997
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
2991
2998
|
#
|
2992
2999
|
#
|
2993
3000
|
#
|
@@ -3011,7 +3018,7 @@ module Aws::S3
|
|
3011
3018
|
# request. Bucket owners need not specify this parameter in their
|
3012
3019
|
# requests. For information about downloading objects from requester
|
3013
3020
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
3014
|
-
# in the *Amazon S3
|
3021
|
+
# in the *Amazon S3 User Guide*.
|
3015
3022
|
#
|
3016
3023
|
#
|
3017
3024
|
#
|
@@ -3149,7 +3156,7 @@ module Aws::S3
|
|
3149
3156
|
# `AccessControlTranslation` property, this is the account ID of the
|
3150
3157
|
# destination bucket owner. For more information, see [Replication
|
3151
3158
|
# Additional Configuration: Changing the Replica Owner][1] in the
|
3152
|
-
# *Amazon
|
3159
|
+
# *Amazon S3 User Guide*.
|
3153
3160
|
#
|
3154
3161
|
#
|
3155
3162
|
#
|
@@ -3162,8 +3169,7 @@ module Aws::S3
|
|
3162
3169
|
# storage class of the source object to create the object replica.
|
3163
3170
|
#
|
3164
3171
|
# For valid values, see the `StorageClass` element of the [PUT Bucket
|
3165
|
-
# replication][1] action in the *Amazon
|
3166
|
-
# Reference*.
|
3172
|
+
# replication][1] action in the *Amazon S3 API Reference*.
|
3167
3173
|
#
|
3168
3174
|
#
|
3169
3175
|
#
|
@@ -3231,7 +3237,7 @@ module Aws::S3
|
|
3231
3237
|
# If the encryption type is `aws:kms`, this optional value specifies
|
3232
3238
|
# the ID of the symmetric customer managed AWS KMS CMK to use for
|
3233
3239
|
# encryption of job results. Amazon S3 only supports symmetric CMKs.
|
3234
|
-
# For more information, see [Using
|
3240
|
+
# For more information, see [Using symmetric and asymmetric keys][1]
|
3235
3241
|
# in the *AWS Key Management Service Developer Guide*.
|
3236
3242
|
#
|
3237
3243
|
#
|
@@ -3265,12 +3271,12 @@ module Aws::S3
|
|
3265
3271
|
# }
|
3266
3272
|
#
|
3267
3273
|
# @!attribute [rw] replica_kms_key_id
|
3268
|
-
# Specifies the ID (Key ARN or Alias ARN) of the customer managed
|
3269
|
-
#
|
3270
|
-
#
|
3271
|
-
#
|
3272
|
-
#
|
3273
|
-
#
|
3274
|
+
# Specifies the ID (Key ARN or Alias ARN) of the customer managed AWS
|
3275
|
+
# KMS key stored in AWS Key Management Service (KMS) for the
|
3276
|
+
# destination bucket. Amazon S3 uses this key to encrypt replica
|
3277
|
+
# objects. Amazon S3 only supports symmetric, customer managed KMS
|
3278
|
+
# keys. For more information, see [Using symmetric and asymmetric
|
3279
|
+
# keys][1] in the *AWS Key Management Service Developer Guide*.
|
3274
3280
|
#
|
3275
3281
|
#
|
3276
3282
|
#
|
@@ -4158,7 +4164,7 @@ module Aws::S3
|
|
4158
4164
|
|
4159
4165
|
# Optional configuration to replicate existing source bucket objects.
|
4160
4166
|
# For more information, see [Replicating Existing Objects][1] in the
|
4161
|
-
# *Amazon S3
|
4167
|
+
# *Amazon S3 User Guide*.
|
4162
4168
|
#
|
4163
4169
|
#
|
4164
4170
|
#
|
@@ -4198,7 +4204,7 @@ module Aws::S3
|
|
4198
4204
|
# to which the filtering rule applies. The maximum length is 1,024
|
4199
4205
|
# characters. Overlapping prefixes and suffixes are not supported. For
|
4200
4206
|
# more information, see [Configuring Event Notifications][1] in the
|
4201
|
-
# *Amazon
|
4207
|
+
# *Amazon S3 User Guide*.
|
4202
4208
|
#
|
4203
4209
|
#
|
4204
4210
|
#
|
@@ -4639,8 +4645,7 @@ module Aws::S3
|
|
4639
4645
|
# @!attribute [rw] logging_enabled
|
4640
4646
|
# Describes where logs are stored and the prefix that Amazon S3
|
4641
4647
|
# assigns to all log object keys for a bucket. For more information,
|
4642
|
-
# see [PUT Bucket logging][1] in the *Amazon
|
4643
|
-
# API Reference*.
|
4648
|
+
# see [PUT Bucket logging][1] in the *Amazon S3 API Reference*.
|
4644
4649
|
#
|
4645
4650
|
#
|
4646
4651
|
#
|
@@ -5144,8 +5149,8 @@ module Aws::S3
|
|
5144
5149
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5145
5150
|
# When using this action with an access point through the AWS SDKs,
|
5146
5151
|
# you provide the access point ARN in place of the bucket name. For
|
5147
|
-
# more information about access point ARNs, see [Using
|
5148
|
-
#
|
5152
|
+
# more information about access point ARNs, see [Using access
|
5153
|
+
# points][1] in the *Amazon S3 User Guide*.
|
5149
5154
|
#
|
5150
5155
|
#
|
5151
5156
|
#
|
@@ -5165,7 +5170,7 @@ module Aws::S3
|
|
5165
5170
|
# request. Bucket owners need not specify this parameter in their
|
5166
5171
|
# requests. For information about downloading objects from requester
|
5167
5172
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
5168
|
-
# in the *Amazon S3
|
5173
|
+
# in the *Amazon S3 User Guide*.
|
5169
5174
|
#
|
5170
5175
|
#
|
5171
5176
|
#
|
@@ -5223,8 +5228,8 @@ module Aws::S3
|
|
5223
5228
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5224
5229
|
# When using this action with an access point through the AWS SDKs,
|
5225
5230
|
# you provide the access point ARN in place of the bucket name. For
|
5226
|
-
# more information about access point ARNs, see [Using
|
5227
|
-
#
|
5231
|
+
# more information about access point ARNs, see [Using access
|
5232
|
+
# points][1] in the *Amazon S3 User Guide*.
|
5228
5233
|
#
|
5229
5234
|
#
|
5230
5235
|
#
|
@@ -5246,7 +5251,7 @@ module Aws::S3
|
|
5246
5251
|
# request. Bucket owners need not specify this parameter in their
|
5247
5252
|
# requests. For information about downloading objects from requester
|
5248
5253
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
5249
|
-
# in the *Amazon S3
|
5254
|
+
# in the *Amazon S3 User Guide*.
|
5250
5255
|
#
|
5251
5256
|
#
|
5252
5257
|
#
|
@@ -5300,8 +5305,8 @@ module Aws::S3
|
|
5300
5305
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5301
5306
|
# When using this action with an access point through the AWS SDKs,
|
5302
5307
|
# you provide the access point ARN in place of the bucket name. For
|
5303
|
-
# more information about access point ARNs, see [Using
|
5304
|
-
#
|
5308
|
+
# more information about access point ARNs, see [Using access
|
5309
|
+
# points][1] in the *Amazon S3 User Guide*.
|
5305
5310
|
#
|
5306
5311
|
#
|
5307
5312
|
#
|
@@ -5560,8 +5565,8 @@ module Aws::S3
|
|
5560
5565
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5561
5566
|
# When using this action with an access point through the AWS SDKs,
|
5562
5567
|
# you provide the access point ARN in place of the bucket name. For
|
5563
|
-
# more information about access point ARNs, see [Using
|
5564
|
-
#
|
5568
|
+
# more information about access point ARNs, see [Using access
|
5569
|
+
# points][1] in the *Amazon S3 User Guide*.
|
5565
5570
|
#
|
5566
5571
|
# When using this action with Amazon S3 on Outposts, you must direct
|
5567
5572
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -5570,7 +5575,7 @@ module Aws::S3
|
|
5570
5575
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
5571
5576
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
5572
5577
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
5573
|
-
# Outposts][2] in the *Amazon
|
5578
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
5574
5579
|
#
|
5575
5580
|
#
|
5576
5581
|
#
|
@@ -5669,7 +5674,7 @@ module Aws::S3
|
|
5669
5674
|
# request. Bucket owners need not specify this parameter in their
|
5670
5675
|
# requests. For information about downloading objects from requester
|
5671
5676
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
5672
|
-
# in the *Amazon S3
|
5677
|
+
# in the *Amazon S3 User Guide*.
|
5673
5678
|
#
|
5674
5679
|
#
|
5675
5680
|
#
|
@@ -5749,8 +5754,8 @@ module Aws::S3
|
|
5749
5754
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5750
5755
|
# When using this action with an access point through the AWS SDKs,
|
5751
5756
|
# you provide the access point ARN in place of the bucket name. For
|
5752
|
-
# more information about access point ARNs, see [Using
|
5753
|
-
#
|
5757
|
+
# more information about access point ARNs, see [Using access
|
5758
|
+
# points][1] in the *Amazon S3 User Guide*.
|
5754
5759
|
#
|
5755
5760
|
#
|
5756
5761
|
#
|
@@ -5772,7 +5777,7 @@ module Aws::S3
|
|
5772
5777
|
# request. Bucket owners need not specify this parameter in their
|
5773
5778
|
# requests. For information about downloading objects from requester
|
5774
5779
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
5775
|
-
# in the *Amazon S3
|
5780
|
+
# in the *Amazon S3 User Guide*.
|
5776
5781
|
#
|
5777
5782
|
#
|
5778
5783
|
#
|
@@ -5836,8 +5841,8 @@ module Aws::S3
|
|
5836
5841
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
5837
5842
|
# When using this action with an access point through the AWS SDKs,
|
5838
5843
|
# you provide the access point ARN in place of the bucket name. For
|
5839
|
-
# more information about access point ARNs, see [Using
|
5840
|
-
#
|
5844
|
+
# more information about access point ARNs, see [Using access
|
5845
|
+
# points][1] in the *Amazon S3 User Guide*.
|
5841
5846
|
#
|
5842
5847
|
# When using this action with Amazon S3 on Outposts, you must direct
|
5843
5848
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -5846,7 +5851,7 @@ module Aws::S3
|
|
5846
5851
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
5847
5852
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
5848
5853
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
5849
|
-
# Outposts][2] in the *Amazon
|
5854
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
5850
5855
|
#
|
5851
5856
|
#
|
5852
5857
|
#
|
@@ -5874,7 +5879,7 @@ module Aws::S3
|
|
5874
5879
|
# request. Bucket owners need not specify this parameter in their
|
5875
5880
|
# requests. For information about downloading objects from requester
|
5876
5881
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
5877
|
-
# in the *Amazon S3
|
5882
|
+
# in the *Amazon S3 User Guide*.
|
5878
5883
|
#
|
5879
5884
|
#
|
5880
5885
|
#
|
@@ -5935,7 +5940,7 @@ module Aws::S3
|
|
5935
5940
|
# request. Bucket owners need not specify this parameter in their
|
5936
5941
|
# requests. For information about downloading objects from requester
|
5937
5942
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
5938
|
-
# in the *Amazon S3
|
5943
|
+
# in the *Amazon S3 User Guide*.
|
5939
5944
|
#
|
5940
5945
|
#
|
5941
5946
|
#
|
@@ -6144,8 +6149,8 @@ module Aws::S3
|
|
6144
6149
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
6145
6150
|
# When using this action with an access point through the AWS SDKs,
|
6146
6151
|
# you provide the access point ARN in place of the bucket name. For
|
6147
|
-
# more information about access point ARNs, see [Using
|
6148
|
-
#
|
6152
|
+
# more information about access point ARNs, see [Using access
|
6153
|
+
# points][1] in the *Amazon S3 User Guide*.
|
6149
6154
|
#
|
6150
6155
|
# When using this action with Amazon S3 on Outposts, you must direct
|
6151
6156
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -6154,7 +6159,7 @@ module Aws::S3
|
|
6154
6159
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
6155
6160
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
6156
6161
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
6157
|
-
# Outposts][2] in the *Amazon
|
6162
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
6158
6163
|
#
|
6159
6164
|
#
|
6160
6165
|
#
|
@@ -6203,7 +6208,7 @@ module Aws::S3
|
|
6203
6208
|
# If an archive copy is already restored, the header value indicates
|
6204
6209
|
# when Amazon S3 is scheduled to delete the object copy. For example:
|
6205
6210
|
#
|
6206
|
-
# `x-amz-restore: ongoing-request="false", expiry-date="Fri,
|
6211
|
+
# `x-amz-restore: ongoing-request="false", expiry-date="Fri, 21 Dec
|
6207
6212
|
# 2012 00:00:00 GMT"`
|
6208
6213
|
#
|
6209
6214
|
# If the object restoration is in progress, the header returns the
|
@@ -6480,8 +6485,8 @@ module Aws::S3
|
|
6480
6485
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
6481
6486
|
# When using this action with an access point through the AWS SDKs,
|
6482
6487
|
# you provide the access point ARN in place of the bucket name. For
|
6483
|
-
# more information about access point ARNs, see [Using
|
6484
|
-
#
|
6488
|
+
# more information about access point ARNs, see [Using access
|
6489
|
+
# points][1] in the *Amazon S3 User Guide*.
|
6485
6490
|
#
|
6486
6491
|
# When using this action with Amazon S3 on Outposts, you must direct
|
6487
6492
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -6490,7 +6495,7 @@ module Aws::S3
|
|
6490
6495
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
6491
6496
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
6492
6497
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
6493
|
-
# Outposts][2] in the *Amazon
|
6498
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
6494
6499
|
#
|
6495
6500
|
#
|
6496
6501
|
#
|
@@ -6565,7 +6570,7 @@ module Aws::S3
|
|
6565
6570
|
# request. Bucket owners need not specify this parameter in their
|
6566
6571
|
# requests. For information about downloading objects from requester
|
6567
6572
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
6568
|
-
# in the *Amazon S3
|
6573
|
+
# in the *Amazon S3 User Guide*.
|
6569
6574
|
#
|
6570
6575
|
#
|
6571
6576
|
#
|
@@ -6890,8 +6895,8 @@ module Aws::S3
|
|
6890
6895
|
end
|
6891
6896
|
|
6892
6897
|
# Specifies the inventory configuration for an Amazon S3 bucket. For
|
6893
|
-
# more information, see [GET Bucket inventory][1] in the *Amazon
|
6894
|
-
#
|
6898
|
+
# more information, see [GET Bucket inventory][1] in the *Amazon S3 API
|
6899
|
+
# Reference*.
|
6895
6900
|
#
|
6896
6901
|
#
|
6897
6902
|
#
|
@@ -7227,7 +7232,7 @@ module Aws::S3
|
|
7227
7232
|
# @!attribute [rw] events
|
7228
7233
|
# The Amazon S3 bucket event for which to invoke the AWS Lambda
|
7229
7234
|
# function. For more information, see [Supported Event Types][1] in
|
7230
|
-
# the *Amazon
|
7235
|
+
# the *Amazon S3 User Guide*.
|
7231
7236
|
#
|
7232
7237
|
#
|
7233
7238
|
#
|
@@ -7237,7 +7242,7 @@ module Aws::S3
|
|
7237
7242
|
# @!attribute [rw] filter
|
7238
7243
|
# Specifies object key name filtering rules. For information about key
|
7239
7244
|
# name filtering, see [Configuring Event Notifications][1] in the
|
7240
|
-
# *Amazon
|
7245
|
+
# *Amazon S3 User Guide*.
|
7241
7246
|
#
|
7242
7247
|
#
|
7243
7248
|
#
|
@@ -7403,7 +7408,7 @@ module Aws::S3
|
|
7403
7408
|
#
|
7404
7409
|
# @!attribute [rw] prefix
|
7405
7410
|
# Prefix identifying one or more objects to which the rule applies.
|
7406
|
-
# This is
|
7411
|
+
# This is no longer used; use `Filter` instead.
|
7407
7412
|
#
|
7408
7413
|
# Replacement must be made for object keys containing special
|
7409
7414
|
# characters (such as carriage returns) when using XML requests. For
|
@@ -7417,7 +7422,8 @@ module Aws::S3
|
|
7417
7422
|
# @!attribute [rw] filter
|
7418
7423
|
# The `Filter` is used to identify objects that a Lifecycle Rule
|
7419
7424
|
# applies to. A `Filter` must have exactly one of `Prefix`, `Tag`, or
|
7420
|
-
# `And` specified.
|
7425
|
+
# `And` specified. `Filter` is required if the `LifecycleRule` does
|
7426
|
+
# not containt a `Prefix` element.
|
7421
7427
|
# @return [Types::LifecycleRuleFilter]
|
7422
7428
|
#
|
7423
7429
|
# @!attribute [rw] status
|
@@ -7453,7 +7459,7 @@ module Aws::S3
|
|
7453
7459
|
# upload that Amazon S3 will wait before permanently removing all
|
7454
7460
|
# parts of the upload. For more information, see [ Aborting Incomplete
|
7455
7461
|
# Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
|
7456
|
-
#
|
7462
|
+
# S3 User Guide*.
|
7457
7463
|
#
|
7458
7464
|
#
|
7459
7465
|
#
|
@@ -7971,8 +7977,8 @@ module Aws::S3
|
|
7971
7977
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
7972
7978
|
# When using this action with an access point through the AWS SDKs,
|
7973
7979
|
# you provide the access point ARN in place of the bucket name. For
|
7974
|
-
# more information about access point ARNs, see [Using
|
7975
|
-
#
|
7980
|
+
# more information about access point ARNs, see [Using access
|
7981
|
+
# points][1] in the *Amazon S3 User Guide*.
|
7976
7982
|
#
|
7977
7983
|
# When using this action with Amazon S3 on Outposts, you must direct
|
7978
7984
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -7981,7 +7987,7 @@ module Aws::S3
|
|
7981
7987
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
7982
7988
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
7983
7989
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
7984
|
-
# Outposts][2] in the *Amazon
|
7990
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
7985
7991
|
#
|
7986
7992
|
#
|
7987
7993
|
#
|
@@ -8356,8 +8362,8 @@ module Aws::S3
|
|
8356
8362
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
8357
8363
|
# When using this action with an access point through the AWS SDKs,
|
8358
8364
|
# you provide the access point ARN in place of the bucket name. For
|
8359
|
-
# more information about access point ARNs, see [Using
|
8360
|
-
#
|
8365
|
+
# more information about access point ARNs, see [Using access
|
8366
|
+
# points][1] in the *Amazon S3 User Guide*.
|
8361
8367
|
#
|
8362
8368
|
# When using this action with Amazon S3 on Outposts, you must direct
|
8363
8369
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -8366,7 +8372,7 @@ module Aws::S3
|
|
8366
8372
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
8367
8373
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
8368
8374
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
8369
|
-
# Outposts][2] in the *Amazon
|
8375
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
8370
8376
|
#
|
8371
8377
|
#
|
8372
8378
|
#
|
@@ -8447,8 +8453,8 @@ module Aws::S3
|
|
8447
8453
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
8448
8454
|
# When using this action with an access point through the AWS SDKs,
|
8449
8455
|
# you provide the access point ARN in place of the bucket name. For
|
8450
|
-
# more information about access point ARNs, see [Using
|
8451
|
-
#
|
8456
|
+
# more information about access point ARNs, see [Using access
|
8457
|
+
# points][1] in the *Amazon S3 User Guide*.
|
8452
8458
|
#
|
8453
8459
|
# When using this action with Amazon S3 on Outposts, you must direct
|
8454
8460
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -8457,7 +8463,7 @@ module Aws::S3
|
|
8457
8463
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
8458
8464
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
8459
8465
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
8460
|
-
# Outposts][2] in the *Amazon
|
8466
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
8461
8467
|
#
|
8462
8468
|
#
|
8463
8469
|
#
|
@@ -8582,8 +8588,8 @@ module Aws::S3
|
|
8582
8588
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
8583
8589
|
# When using this action with an access point through the AWS SDKs,
|
8584
8590
|
# you provide the access point ARN in place of the bucket name. For
|
8585
|
-
# more information about access point ARNs, see [Using
|
8586
|
-
#
|
8591
|
+
# more information about access point ARNs, see [Using access
|
8592
|
+
# points][1] in the *Amazon S3 User Guide*.
|
8587
8593
|
#
|
8588
8594
|
# When using this action with Amazon S3 on Outposts, you must direct
|
8589
8595
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -8592,7 +8598,7 @@ module Aws::S3
|
|
8592
8598
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
8593
8599
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
8594
8600
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
8595
|
-
# Outposts][2] in the *Amazon
|
8601
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
8596
8602
|
#
|
8597
8603
|
#
|
8598
8604
|
#
|
@@ -8797,8 +8803,8 @@ module Aws::S3
|
|
8797
8803
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
8798
8804
|
# When using this action with an access point through the AWS SDKs,
|
8799
8805
|
# you provide the access point ARN in place of the bucket name. For
|
8800
|
-
# more information about access point ARNs, see [Using
|
8801
|
-
#
|
8806
|
+
# more information about access point ARNs, see [Using access
|
8807
|
+
# points][1] in the *Amazon S3 User Guide*.
|
8802
8808
|
#
|
8803
8809
|
# When using this action with Amazon S3 on Outposts, you must direct
|
8804
8810
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -8807,7 +8813,7 @@ module Aws::S3
|
|
8807
8813
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
8808
8814
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
8809
8815
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
8810
|
-
# Outposts][2] in the *Amazon
|
8816
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
8811
8817
|
#
|
8812
8818
|
#
|
8813
8819
|
#
|
@@ -8838,7 +8844,7 @@ module Aws::S3
|
|
8838
8844
|
# request. Bucket owners need not specify this parameter in their
|
8839
8845
|
# requests. For information about downloading objects from requester
|
8840
8846
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
8841
|
-
# in the *Amazon S3
|
8847
|
+
# in the *Amazon S3 User Guide*.
|
8842
8848
|
#
|
8843
8849
|
#
|
8844
8850
|
#
|
@@ -8867,8 +8873,7 @@ module Aws::S3
|
|
8867
8873
|
|
8868
8874
|
# Describes where logs are stored and the prefix that Amazon S3 assigns
|
8869
8875
|
# to all log object keys for a bucket. For more information, see [PUT
|
8870
|
-
# Bucket logging][1] in the *Amazon
|
8871
|
-
# Reference*.
|
8876
|
+
# Bucket logging][1] in the *Amazon S3 API Reference*.
|
8872
8877
|
#
|
8873
8878
|
#
|
8874
8879
|
#
|
@@ -9022,8 +9027,8 @@ module Aws::S3
|
|
9022
9027
|
# If you're updating an existing metrics configuration, note that this
|
9023
9028
|
# is a full replacement of the existing metrics configuration. If you
|
9024
9029
|
# don't include the elements you want to keep, they are erased. For
|
9025
|
-
# more information, see [ PUT Bucket metrics][1] in the *Amazon
|
9026
|
-
#
|
9030
|
+
# more information, see [ PUT Bucket metrics][1] in the *Amazon S3 API
|
9031
|
+
# Reference*.
|
9027
9032
|
#
|
9028
9033
|
#
|
9029
9034
|
#
|
@@ -9195,8 +9200,7 @@ module Aws::S3
|
|
9195
9200
|
# Specifies the number of days an object is noncurrent before Amazon
|
9196
9201
|
# S3 can perform the associated action. For information about the
|
9197
9202
|
# noncurrent days calculations, see [How Amazon S3 Calculates When an
|
9198
|
-
# Object Became Noncurrent][1] in the *Amazon
|
9199
|
-
# Developer Guide*.
|
9203
|
+
# Object Became Noncurrent][1] in the *Amazon S3 User Guide*.
|
9200
9204
|
#
|
9201
9205
|
#
|
9202
9206
|
#
|
@@ -9232,8 +9236,7 @@ module Aws::S3
|
|
9232
9236
|
# Specifies the number of days an object is noncurrent before Amazon
|
9233
9237
|
# S3 can perform the associated action. For information about the
|
9234
9238
|
# noncurrent days calculations, see [How Amazon S3 Calculates How Long
|
9235
|
-
# an Object Has Been Noncurrent][1] in the *Amazon
|
9236
|
-
# Service Developer Guide*.
|
9239
|
+
# an Object Has Been Noncurrent][1] in the *Amazon S3 User Guide*.
|
9237
9240
|
#
|
9238
9241
|
#
|
9239
9242
|
#
|
@@ -9393,7 +9396,7 @@ module Aws::S3
|
|
9393
9396
|
|
9394
9397
|
# Specifies object key name filtering rules. For information about key
|
9395
9398
|
# name filtering, see [Configuring Event Notifications][1] in the
|
9396
|
-
# *Amazon
|
9399
|
+
# *Amazon S3 User Guide*.
|
9397
9400
|
#
|
9398
9401
|
#
|
9399
9402
|
#
|
@@ -9542,11 +9545,16 @@ module Aws::S3
|
|
9542
9545
|
#
|
9543
9546
|
# @!attribute [rw] object_lock_enabled
|
9544
9547
|
# Indicates whether this bucket has an Object Lock configuration
|
9545
|
-
# enabled.
|
9548
|
+
# enabled. Enable `ObjectLockEnabled` when you apply
|
9549
|
+
# `ObjectLockConfiguration` to a bucket.
|
9546
9550
|
# @return [String]
|
9547
9551
|
#
|
9548
9552
|
# @!attribute [rw] rule
|
9549
|
-
#
|
9553
|
+
# Specifies the Object Lock rule for the specified object. Enable the
|
9554
|
+
# this rule when you apply `ObjectLockConfiguration` to a bucket.
|
9555
|
+
# Bucket settings require both a mode and a period. The period can be
|
9556
|
+
# either `Days` or `Years` but you must select one. You cannot specify
|
9557
|
+
# `Days` and `Years` at the same time.
|
9550
9558
|
# @return [Types::ObjectLockRule]
|
9551
9559
|
#
|
9552
9560
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectLockConfiguration AWS API Documentation
|
@@ -9620,8 +9628,11 @@ module Aws::S3
|
|
9620
9628
|
# }
|
9621
9629
|
#
|
9622
9630
|
# @!attribute [rw] default_retention
|
9623
|
-
# The default retention period that you want to
|
9624
|
-
# placed in the specified bucket.
|
9631
|
+
# The default Object Lock retention mode and period that you want to
|
9632
|
+
# apply to new objects placed in the specified bucket. Bucket settings
|
9633
|
+
# require both a mode and a period. The period can be either `Days` or
|
9634
|
+
# `Years` but you must select one. You cannot specify `Days` and
|
9635
|
+
# `Years` at the same time.
|
9625
9636
|
# @return [Types::DefaultRetention]
|
9626
9637
|
#
|
9627
9638
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectLockRule AWS API Documentation
|
@@ -10143,8 +10154,10 @@ module Aws::S3
|
|
10143
10154
|
# @return [String]
|
10144
10155
|
#
|
10145
10156
|
# @!attribute [rw] grant_write
|
10146
|
-
# Allows grantee to create
|
10147
|
-
#
|
10157
|
+
# Allows grantee to create new objects in the bucket.
|
10158
|
+
#
|
10159
|
+
# For the bucket and object owners of existing objects, also allows
|
10160
|
+
# deletions and overwrites of those objects.
|
10148
10161
|
# @return [String]
|
10149
10162
|
#
|
10150
10163
|
# @!attribute [rw] grant_write_acp
|
@@ -10336,8 +10349,7 @@ module Aws::S3
|
|
10336
10349
|
# encryption with Amazon S3-managed keys (SSE-S3) or customer master
|
10337
10350
|
# keys stored in AWS KMS (SSE-KMS). For information about the Amazon
|
10338
10351
|
# S3 default encryption feature, see [Amazon S3 Default Bucket
|
10339
|
-
# Encryption][1] in the *Amazon
|
10340
|
-
# Guide*.
|
10352
|
+
# Encryption][1] in the *Amazon S3 User Guide*.
|
10341
10353
|
#
|
10342
10354
|
#
|
10343
10355
|
#
|
@@ -11441,8 +11453,8 @@ module Aws::S3
|
|
11441
11453
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
11442
11454
|
# When using this action with an access point through the AWS SDKs,
|
11443
11455
|
# you provide the access point ARN in place of the bucket name. For
|
11444
|
-
# more information about access point ARNs, see [Using
|
11445
|
-
#
|
11456
|
+
# more information about access point ARNs, see [Using access
|
11457
|
+
# points][1] in the *Amazon S3 User Guide*.
|
11446
11458
|
#
|
11447
11459
|
#
|
11448
11460
|
#
|
@@ -11483,8 +11495,10 @@ module Aws::S3
|
|
11483
11495
|
# @return [String]
|
11484
11496
|
#
|
11485
11497
|
# @!attribute [rw] grant_write
|
11486
|
-
# Allows grantee to create
|
11487
|
-
#
|
11498
|
+
# Allows grantee to create new objects in the bucket.
|
11499
|
+
#
|
11500
|
+
# For the bucket and object owners of existing objects, also allows
|
11501
|
+
# deletions and overwrites of those objects.
|
11488
11502
|
# @return [String]
|
11489
11503
|
#
|
11490
11504
|
# @!attribute [rw] grant_write_acp
|
@@ -11502,8 +11516,8 @@ module Aws::S3
|
|
11502
11516
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
11503
11517
|
# When using this action with an access point through the AWS SDKs,
|
11504
11518
|
# you provide the access point ARN in place of the bucket name. For
|
11505
|
-
# more information about access point ARNs, see [Using
|
11506
|
-
#
|
11519
|
+
# more information about access point ARNs, see [Using access
|
11520
|
+
# points][1] in the *Amazon S3 User Guide*.
|
11507
11521
|
#
|
11508
11522
|
# When using this action with Amazon S3 on Outposts, you must direct
|
11509
11523
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -11512,7 +11526,7 @@ module Aws::S3
|
|
11512
11526
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
11513
11527
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
11514
11528
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
11515
|
-
# Outposts][2] in the *Amazon
|
11529
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
11516
11530
|
#
|
11517
11531
|
#
|
11518
11532
|
#
|
@@ -11525,7 +11539,7 @@ module Aws::S3
|
|
11525
11539
|
# request. Bucket owners need not specify this parameter in their
|
11526
11540
|
# requests. For information about downloading objects from requester
|
11527
11541
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
11528
|
-
# in the *Amazon S3
|
11542
|
+
# in the *Amazon S3 User Guide*.
|
11529
11543
|
#
|
11530
11544
|
#
|
11531
11545
|
#
|
@@ -11600,8 +11614,8 @@ module Aws::S3
|
|
11600
11614
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
11601
11615
|
# When using this action with an access point through the AWS SDKs,
|
11602
11616
|
# you provide the access point ARN in place of the bucket name. For
|
11603
|
-
# more information about access point ARNs, see [Using
|
11604
|
-
#
|
11617
|
+
# more information about access point ARNs, see [Using access
|
11618
|
+
# points][1] in the *Amazon S3 User Guide*.
|
11605
11619
|
#
|
11606
11620
|
#
|
11607
11621
|
#
|
@@ -11622,7 +11636,7 @@ module Aws::S3
|
|
11622
11636
|
# request. Bucket owners need not specify this parameter in their
|
11623
11637
|
# requests. For information about downloading objects from requester
|
11624
11638
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
11625
|
-
# in the *Amazon S3
|
11639
|
+
# in the *Amazon S3 User Guide*.
|
11626
11640
|
#
|
11627
11641
|
#
|
11628
11642
|
#
|
@@ -11709,7 +11723,7 @@ module Aws::S3
|
|
11709
11723
|
# request. Bucket owners need not specify this parameter in their
|
11710
11724
|
# requests. For information about downloading objects from requester
|
11711
11725
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
11712
|
-
# in the *Amazon S3
|
11726
|
+
# in the *Amazon S3 User Guide*.
|
11713
11727
|
#
|
11714
11728
|
#
|
11715
11729
|
#
|
@@ -11891,8 +11905,8 @@ module Aws::S3
|
|
11891
11905
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
11892
11906
|
# When using this action with an access point through the AWS SDKs,
|
11893
11907
|
# you provide the access point ARN in place of the bucket name. For
|
11894
|
-
# more information about access point ARNs, see [Using
|
11895
|
-
#
|
11908
|
+
# more information about access point ARNs, see [Using access
|
11909
|
+
# points][1] in the *Amazon S3 User Guide*.
|
11896
11910
|
#
|
11897
11911
|
# When using this action with Amazon S3 on Outposts, you must direct
|
11898
11912
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -11901,7 +11915,7 @@ module Aws::S3
|
|
11901
11915
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
11902
11916
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
11903
11917
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
11904
|
-
# Outposts][2] in the *Amazon
|
11918
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
11905
11919
|
#
|
11906
11920
|
#
|
11907
11921
|
#
|
@@ -12034,7 +12048,7 @@ module Aws::S3
|
|
12034
12048
|
# and high availability. Depending on performance needs, you can
|
12035
12049
|
# specify a different Storage Class. Amazon S3 on Outposts only uses
|
12036
12050
|
# the OUTPOSTS Storage Class. For more information, see [Storage
|
12037
|
-
# Classes][1] in the *Amazon S3
|
12051
|
+
# Classes][1] in the *Amazon S3 User Guide*.
|
12038
12052
|
#
|
12039
12053
|
#
|
12040
12054
|
#
|
@@ -12092,14 +12106,12 @@ module Aws::S3
|
|
12092
12106
|
# If `x-amz-server-side-encryption` is present and has the value of
|
12093
12107
|
# `aws:kms`, this header specifies the ID of the AWS Key Management
|
12094
12108
|
# Service (AWS KMS) symmetrical customer managed customer master key
|
12095
|
-
# (CMK) that was used for the object.
|
12096
|
-
#
|
12097
|
-
# If the value of `x-amz-server-side-encryption` is `aws:kms`, this
|
12098
|
-
# header specifies the ID of the symmetric customer managed AWS KMS
|
12099
|
-
# CMK that will be used for the object. If you specify
|
12109
|
+
# (CMK) that was used for the object. If you specify
|
12100
12110
|
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
12101
12111
|
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the AWS
|
12102
|
-
# managed CMK in AWS to protect the data.
|
12112
|
+
# managed CMK in AWS to protect the data. If the KMS key does not
|
12113
|
+
# exist in the same account issuing the command, you must use the full
|
12114
|
+
# ARN and not just the ID.
|
12103
12115
|
# @return [String]
|
12104
12116
|
#
|
12105
12117
|
# @!attribute [rw] ssekms_encryption_context
|
@@ -12123,7 +12135,7 @@ module Aws::S3
|
|
12123
12135
|
# request. Bucket owners need not specify this parameter in their
|
12124
12136
|
# requests. For information about downloading objects from requester
|
12125
12137
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
12126
|
-
# in the *Amazon S3
|
12138
|
+
# in the *Amazon S3 User Guide*.
|
12127
12139
|
#
|
12128
12140
|
#
|
12129
12141
|
#
|
@@ -12238,8 +12250,8 @@ module Aws::S3
|
|
12238
12250
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
12239
12251
|
# When using this action with an access point through the AWS SDKs,
|
12240
12252
|
# you provide the access point ARN in place of the bucket name. For
|
12241
|
-
# more information about access point ARNs, see [Using
|
12242
|
-
#
|
12253
|
+
# more information about access point ARNs, see [Using access
|
12254
|
+
# points][1] in the *Amazon S3 User Guide*.
|
12243
12255
|
#
|
12244
12256
|
#
|
12245
12257
|
#
|
@@ -12260,7 +12272,7 @@ module Aws::S3
|
|
12260
12272
|
# request. Bucket owners need not specify this parameter in their
|
12261
12273
|
# requests. For information about downloading objects from requester
|
12262
12274
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
12263
|
-
# in the *Amazon S3
|
12275
|
+
# in the *Amazon S3 User Guide*.
|
12264
12276
|
#
|
12265
12277
|
#
|
12266
12278
|
#
|
@@ -12346,8 +12358,8 @@ module Aws::S3
|
|
12346
12358
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
12347
12359
|
# When using this action with an access point through the AWS SDKs,
|
12348
12360
|
# you provide the access point ARN in place of the bucket name. For
|
12349
|
-
# more information about access point ARNs, see [Using
|
12350
|
-
#
|
12361
|
+
# more information about access point ARNs, see [Using access
|
12362
|
+
# points][1] in the *Amazon S3 User Guide*.
|
12351
12363
|
#
|
12352
12364
|
# When using this action with Amazon S3 on Outposts, you must direct
|
12353
12365
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -12356,7 +12368,7 @@ module Aws::S3
|
|
12356
12368
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
12357
12369
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
12358
12370
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
12359
|
-
# Outposts][2] in the *Amazon
|
12371
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
12360
12372
|
#
|
12361
12373
|
#
|
12362
12374
|
#
|
@@ -12394,7 +12406,7 @@ module Aws::S3
|
|
12394
12406
|
# request. Bucket owners need not specify this parameter in their
|
12395
12407
|
# requests. For information about downloading objects from requester
|
12396
12408
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
12397
|
-
# in the *Amazon S3
|
12409
|
+
# in the *Amazon S3 User Guide*.
|
12398
12410
|
#
|
12399
12411
|
#
|
12400
12412
|
#
|
@@ -12447,7 +12459,7 @@ module Aws::S3
|
|
12447
12459
|
# Amazon S3 bucket. You can enable the configuration options in any
|
12448
12460
|
# combination. For more information about when Amazon S3 considers a
|
12449
12461
|
# bucket or object public, see [The Meaning of "Public"][1] in the
|
12450
|
-
# *Amazon
|
12462
|
+
# *Amazon S3 User Guide*.
|
12451
12463
|
#
|
12452
12464
|
#
|
12453
12465
|
#
|
@@ -12513,7 +12525,7 @@ module Aws::S3
|
|
12513
12525
|
# @!attribute [rw] filter
|
12514
12526
|
# Specifies object key name filtering rules. For information about key
|
12515
12527
|
# name filtering, see [Configuring Event Notifications][1] in the
|
12516
|
-
# *Amazon
|
12528
|
+
# *Amazon S3 User Guide*.
|
12517
12529
|
#
|
12518
12530
|
#
|
12519
12531
|
#
|
@@ -12804,7 +12816,7 @@ module Aws::S3
|
|
12804
12816
|
# The Amazon Resource Name (ARN) of the AWS Identity and Access
|
12805
12817
|
# Management (IAM) role that Amazon S3 assumes when replicating
|
12806
12818
|
# objects. For more information, see [How to Set Up Replication][1] in
|
12807
|
-
# the *Amazon
|
12819
|
+
# the *Amazon S3 User Guide*.
|
12808
12820
|
#
|
12809
12821
|
#
|
12810
12822
|
#
|
@@ -12905,8 +12917,8 @@ module Aws::S3
|
|
12905
12917
|
# will be replicated according to the rule with the highest priority.
|
12906
12918
|
# The higher the number, the higher the priority.
|
12907
12919
|
#
|
12908
|
-
# For more information, see [Replication][1] in the *Amazon
|
12909
|
-
#
|
12920
|
+
# For more information, see [Replication][1] in the *Amazon S3 User
|
12921
|
+
# Guide*.
|
12910
12922
|
#
|
12911
12923
|
#
|
12912
12924
|
#
|
@@ -13326,8 +13338,8 @@ module Aws::S3
|
|
13326
13338
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
13327
13339
|
# When using this action with an access point through the AWS SDKs,
|
13328
13340
|
# you provide the access point ARN in place of the bucket name. For
|
13329
|
-
# more information about access point ARNs, see [Using
|
13330
|
-
#
|
13341
|
+
# more information about access point ARNs, see [Using access
|
13342
|
+
# points][1] in the *Amazon S3 User Guide*.
|
13331
13343
|
#
|
13332
13344
|
# When using this action with Amazon S3 on Outposts, you must direct
|
13333
13345
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -13336,7 +13348,7 @@ module Aws::S3
|
|
13336
13348
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
13337
13349
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
13338
13350
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
13339
|
-
# Outposts][2] in the *Amazon
|
13351
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
13340
13352
|
#
|
13341
13353
|
#
|
13342
13354
|
#
|
@@ -13361,7 +13373,7 @@ module Aws::S3
|
|
13361
13373
|
# request. Bucket owners need not specify this parameter in their
|
13362
13374
|
# requests. For information about downloading objects from requester
|
13363
13375
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
13364
|
-
# in the *Amazon S3
|
13376
|
+
# in the *Amazon S3 User Guide*.
|
13365
13377
|
#
|
13366
13378
|
#
|
13367
13379
|
#
|
@@ -13571,8 +13583,8 @@ module Aws::S3
|
|
13571
13583
|
|
13572
13584
|
# Specifies lifecycle rules for an Amazon S3 bucket. For more
|
13573
13585
|
# information, see [Put Bucket Lifecycle Configuration][1] in the
|
13574
|
-
# *Amazon
|
13575
|
-
#
|
13586
|
+
# *Amazon S3 API Reference*. For examples, see [Put Bucket Lifecycle
|
13587
|
+
# Configuration Examples][2].
|
13576
13588
|
#
|
13577
13589
|
#
|
13578
13590
|
#
|
@@ -13671,7 +13683,7 @@ module Aws::S3
|
|
13671
13683
|
# upload that Amazon S3 will wait before permanently removing all
|
13672
13684
|
# parts of the upload. For more information, see [ Aborting Incomplete
|
13673
13685
|
# Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
|
13674
|
-
#
|
13686
|
+
# S3 User Guide*.
|
13675
13687
|
#
|
13676
13688
|
#
|
13677
13689
|
#
|
@@ -14131,8 +14143,8 @@ module Aws::S3
|
|
14131
14143
|
# Describes the default server-side encryption to apply to new objects
|
14132
14144
|
# in the bucket. If a PUT Object request doesn't specify any
|
14133
14145
|
# server-side encryption, this default encryption will be applied. For
|
14134
|
-
# more information, see [PUT Bucket encryption][1] in the *Amazon
|
14135
|
-
#
|
14146
|
+
# more information, see [PUT Bucket encryption][1] in the *Amazon S3 API
|
14147
|
+
# Reference*.
|
14136
14148
|
#
|
14137
14149
|
#
|
14138
14150
|
#
|
@@ -14151,13 +14163,13 @@ module Aws::S3
|
|
14151
14163
|
# @return [String]
|
14152
14164
|
#
|
14153
14165
|
# @!attribute [rw] kms_master_key_id
|
14154
|
-
# AWS Key Management Service (KMS) customer
|
14166
|
+
# AWS Key Management Service (KMS) customer AWS KMS key ID to use for
|
14155
14167
|
# the default encryption. This parameter is allowed if and only if
|
14156
14168
|
# `SSEAlgorithm` is set to `aws:kms`.
|
14157
14169
|
#
|
14158
14170
|
# You can specify the key ID or the Amazon Resource Name (ARN) of the
|
14159
|
-
#
|
14160
|
-
# operations, you must use a fully qualified
|
14171
|
+
# KMS key. However, if you are using encryption with cross-account
|
14172
|
+
# operations, you must use a fully qualified KMS key ARN. For more
|
14161
14173
|
# information, see [Using encryption for cross-account operations][1].
|
14162
14174
|
#
|
14163
14175
|
# **For example:**
|
@@ -14167,9 +14179,9 @@ module Aws::S3
|
|
14167
14179
|
# * Key ARN:
|
14168
14180
|
# `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
|
14169
14181
|
#
|
14170
|
-
# Amazon S3 only supports symmetric
|
14171
|
-
# more information, see [Using
|
14172
|
-
# the *AWS Key Management Service Developer Guide*.
|
14182
|
+
# Amazon S3 only supports symmetric KMS keys and not asymmetric KMS
|
14183
|
+
# keys. For more information, see [Using symmetric and asymmetric
|
14184
|
+
# keys][2] in the *AWS Key Management Service Developer Guide*.
|
14173
14185
|
#
|
14174
14186
|
#
|
14175
14187
|
#
|
@@ -14320,8 +14332,8 @@ module Aws::S3
|
|
14320
14332
|
#
|
14321
14333
|
# @!attribute [rw] status
|
14322
14334
|
# Specifies whether Amazon S3 replicates objects created with
|
14323
|
-
# server-side encryption using
|
14324
|
-
#
|
14335
|
+
# server-side encryption using an AWS KMS key stored in AWS Key
|
14336
|
+
# Management Service.
|
14325
14337
|
# @return [String]
|
14326
14338
|
#
|
14327
14339
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SseKmsEncryptedObjects AWS API Documentation
|
@@ -14615,7 +14627,7 @@ module Aws::S3
|
|
14615
14627
|
# @!attribute [rw] filter
|
14616
14628
|
# Specifies object key name filtering rules. For information about key
|
14617
14629
|
# name filtering, see [Configuring Event Notifications][1] in the
|
14618
|
-
# *Amazon
|
14630
|
+
# *Amazon S3 User Guide*.
|
14619
14631
|
#
|
14620
14632
|
#
|
14621
14633
|
#
|
@@ -14818,8 +14830,8 @@ module Aws::S3
|
|
14818
14830
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
14819
14831
|
# When using this action with an access point through the AWS SDKs,
|
14820
14832
|
# you provide the access point ARN in place of the bucket name. For
|
14821
|
-
# more information about access point ARNs, see [Using
|
14822
|
-
#
|
14833
|
+
# more information about access point ARNs, see [Using access
|
14834
|
+
# points][1] in the *Amazon S3 User Guide*.
|
14823
14835
|
#
|
14824
14836
|
# When using this action with Amazon S3 on Outposts, you must direct
|
14825
14837
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -14828,7 +14840,7 @@ module Aws::S3
|
|
14828
14840
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
14829
14841
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
14830
14842
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
14831
|
-
# Outposts][2] in the *Amazon
|
14843
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
14832
14844
|
#
|
14833
14845
|
#
|
14834
14846
|
#
|
@@ -14967,7 +14979,7 @@ module Aws::S3
|
|
14967
14979
|
# request. Bucket owners need not specify this parameter in their
|
14968
14980
|
# requests. For information about downloading objects from requester
|
14969
14981
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
14970
|
-
# in the *Amazon S3
|
14982
|
+
# in the *Amazon S3 User Guide*.
|
14971
14983
|
#
|
14972
14984
|
#
|
14973
14985
|
#
|
@@ -15095,8 +15107,8 @@ module Aws::S3
|
|
15095
15107
|
# *AccessPointName*-*AccountId*.s3-accesspoint.*Region*.amazonaws.com.
|
15096
15108
|
# When using this action with an access point through the AWS SDKs,
|
15097
15109
|
# you provide the access point ARN in place of the bucket name. For
|
15098
|
-
# more information about access point ARNs, see [Using
|
15099
|
-
#
|
15110
|
+
# more information about access point ARNs, see [Using access
|
15111
|
+
# points][1] in the *Amazon S3 User Guide*.
|
15100
15112
|
#
|
15101
15113
|
# When using this action with Amazon S3 on Outposts, you must direct
|
15102
15114
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
@@ -15105,7 +15117,7 @@ module Aws::S3
|
|
15105
15117
|
# When using this action using S3 on Outposts through the AWS SDKs,
|
15106
15118
|
# you provide the Outposts bucket ARN in place of the bucket name. For
|
15107
15119
|
# more information about S3 on Outposts ARNs, see [Using S3 on
|
15108
|
-
# Outposts][2] in the *Amazon
|
15120
|
+
# Outposts][2] in the *Amazon S3 User Guide*.
|
15109
15121
|
#
|
15110
15122
|
#
|
15111
15123
|
#
|
@@ -15164,7 +15176,7 @@ module Aws::S3
|
|
15164
15176
|
# request. Bucket owners need not specify this parameter in their
|
15165
15177
|
# requests. For information about downloading objects from requester
|
15166
15178
|
# pays buckets, see [Downloading Objects in Requestor Pays Buckets][1]
|
15167
|
-
# in the *Amazon S3
|
15179
|
+
# in the *Amazon S3 User Guide*.
|
15168
15180
|
#
|
15169
15181
|
#
|
15170
15182
|
#
|
@@ -15197,8 +15209,8 @@ module Aws::S3
|
|
15197
15209
|
end
|
15198
15210
|
|
15199
15211
|
# Describes the versioning state of an Amazon S3 bucket. For more
|
15200
|
-
# information, see [PUT Bucket versioning][1] in the *Amazon
|
15201
|
-
#
|
15212
|
+
# information, see [PUT Bucket versioning][1] in the *Amazon S3 API
|
15213
|
+
# Reference*.
|
15202
15214
|
#
|
15203
15215
|
#
|
15204
15216
|
#
|
@@ -15392,7 +15404,9 @@ module Aws::S3
|
|
15392
15404
|
# A string that uniquely identifies an error condition. Returned in
|
15393
15405
|
# the <Code> tag of the error XML response for a corresponding
|
15394
15406
|
# `GetObject` call. Cannot be used with a successful `StatusCode`
|
15395
|
-
# header or when the transformed object is provided in the body.
|
15407
|
+
# header or when the transformed object is provided in the body. All
|
15408
|
+
# error codes from S3 are sentence-cased. Regex value is
|
15409
|
+
# "^\[A-Z\]\[a-zA-Z\]+$".
|
15396
15410
|
# @return [String]
|
15397
15411
|
#
|
15398
15412
|
# @!attribute [rw] error_message
|