aws-sdk-s3 1.107.0 → 1.111.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 +20 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +19 -1
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +2 -2
- data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +2 -2
- data/lib/aws-sdk-s3/bucket_notification.rb +15 -3
- data/lib/aws-sdk-s3/client.rb +437 -310
- data/lib/aws-sdk-s3/client_api.rb +7 -0
- data/lib/aws-sdk-s3/object.rb +6 -16
- data/lib/aws-sdk-s3/object_summary.rb +4 -4
- data/lib/aws-sdk-s3/object_version.rb +2 -12
- data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +6 -0
- data/lib/aws-sdk-s3/resource.rb +18 -0
- data/lib/aws-sdk-s3/types.rb +160 -93
- data/lib/aws-sdk-s3.rb +1 -1
- metadata +4 -4
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -27,6 +27,7 @@ require 'aws-sdk-core/plugins/client_metrics_plugin.rb'
|
|
27
27
|
require 'aws-sdk-core/plugins/client_metrics_send_plugin.rb'
|
28
28
|
require 'aws-sdk-core/plugins/transfer_encoding.rb'
|
29
29
|
require 'aws-sdk-core/plugins/http_checksum.rb'
|
30
|
+
require 'aws-sdk-core/plugins/defaults_mode.rb'
|
30
31
|
require 'aws-sdk-core/plugins/protocols/rest_xml.rb'
|
31
32
|
require 'aws-sdk-s3/plugins/accelerate.rb'
|
32
33
|
require 'aws-sdk-s3/plugins/arn.rb'
|
@@ -91,6 +92,7 @@ module Aws::S3
|
|
91
92
|
add_plugin(Aws::Plugins::ClientMetricsSendPlugin)
|
92
93
|
add_plugin(Aws::Plugins::TransferEncoding)
|
93
94
|
add_plugin(Aws::Plugins::HttpChecksum)
|
95
|
+
add_plugin(Aws::Plugins::DefaultsMode)
|
94
96
|
add_plugin(Aws::Plugins::Protocols::RestXml)
|
95
97
|
add_plugin(Aws::S3::Plugins::Accelerate)
|
96
98
|
add_plugin(Aws::S3::Plugins::ARN)
|
@@ -155,7 +157,9 @@ module Aws::S3
|
|
155
157
|
# * EC2/ECS IMDS instance profile - When used by default, the timeouts
|
156
158
|
# are very aggressive. Construct and pass an instance of
|
157
159
|
# `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
|
158
|
-
# enable retries and extended timeouts.
|
160
|
+
# enable retries and extended timeouts. Instance profile credential
|
161
|
+
# fetching can be disabled by setting ENV['AWS_EC2_METADATA_DISABLED']
|
162
|
+
# to true.
|
159
163
|
#
|
160
164
|
# @option options [required, String] :region
|
161
165
|
# The AWS region to connect to. The configured `:region` is
|
@@ -216,6 +220,10 @@ module Aws::S3
|
|
216
220
|
# Used only in `standard` and adaptive retry modes. Specifies whether to apply
|
217
221
|
# a clock skew correction and retry requests with skewed client clocks.
|
218
222
|
#
|
223
|
+
# @option options [String] :defaults_mode ("legacy")
|
224
|
+
# See {Aws::DefaultsModeConfiguration} for a list of the
|
225
|
+
# accepted modes and the configuration defaults that are included.
|
226
|
+
#
|
219
227
|
# @option options [Boolean] :disable_host_prefix_injection (false)
|
220
228
|
# Set to true to disable SDK automatically adding host prefix
|
221
229
|
# to default service endpoint when available.
|
@@ -379,7 +387,7 @@ module Aws::S3
|
|
379
387
|
# seconds to wait when opening a HTTP session before raising a
|
380
388
|
# `Timeout::Error`.
|
381
389
|
#
|
382
|
-
# @option options [
|
390
|
+
# @option options [Float] :http_read_timeout (60) The default
|
383
391
|
# number of seconds to wait for response data. This value can
|
384
392
|
# safely be set per-request on the session.
|
385
393
|
#
|
@@ -395,6 +403,9 @@ module Aws::S3
|
|
395
403
|
# disables this behaviour. This value can safely be set per
|
396
404
|
# request on the session.
|
397
405
|
#
|
406
|
+
# @option options [Float] :ssl_timeout (nil) Sets the SSL timeout
|
407
|
+
# in seconds.
|
408
|
+
#
|
398
409
|
# @option options [Boolean] :http_wire_trace (false) When `true`,
|
399
410
|
# HTTP debug output will be sent to the `:logger`.
|
400
411
|
#
|
@@ -896,11 +907,28 @@ module Aws::S3
|
|
896
907
|
# Control List (ACL) Overview][10] and [Managing ACLs Using the REST
|
897
908
|
# API][11].
|
898
909
|
#
|
910
|
+
# If the bucket that you're copying objects to uses the bucket owner
|
911
|
+
# enforced setting for S3 Object Ownership, ACLs are disabled and no
|
912
|
+
# longer affect permissions. Buckets that use this setting only accept
|
913
|
+
# PUT requests that don't specify an ACL or PUT requests that specify
|
914
|
+
# bucket owner full control ACLs, such as the
|
915
|
+
# `bucket-owner-full-control` canned ACL or an equivalent form of this
|
916
|
+
# ACL expressed in the XML format.
|
917
|
+
#
|
918
|
+
# For more information, see [ Controlling ownership of objects and
|
919
|
+
# disabling ACLs][12] in the *Amazon S3 User Guide*.
|
920
|
+
#
|
921
|
+
# <note markdown="1"> If your bucket uses the bucket owner enforced setting for Object
|
922
|
+
# Ownership, all objects written to the bucket by any account will be
|
923
|
+
# owned by the bucket owner.
|
924
|
+
#
|
925
|
+
# </note>
|
926
|
+
#
|
899
927
|
# **Storage Class Options**
|
900
928
|
#
|
901
929
|
# You can use the `CopyObject` action to change the storage class of an
|
902
930
|
# object that is already stored in Amazon S3 using the `StorageClass`
|
903
|
-
# parameter. For more information, see [Storage Classes][
|
931
|
+
# parameter. For more information, see [Storage Classes][13] in the
|
904
932
|
# *Amazon S3 User Guide*.
|
905
933
|
#
|
906
934
|
# **Versioning**
|
@@ -921,15 +949,15 @@ module Aws::S3
|
|
921
949
|
#
|
922
950
|
# If the source object's storage class is GLACIER, you must restore a
|
923
951
|
# copy of this object before you can use it as a source object for the
|
924
|
-
# copy operation. For more information, see [RestoreObject][
|
952
|
+
# copy operation. For more information, see [RestoreObject][14].
|
925
953
|
#
|
926
954
|
# The following operations are related to `CopyObject`\:
|
927
955
|
#
|
928
|
-
# * [PutObject][
|
956
|
+
# * [PutObject][15]
|
929
957
|
#
|
930
|
-
# * [GetObject][
|
958
|
+
# * [GetObject][16]
|
931
959
|
#
|
932
|
-
# For more information, see [Copying Objects][
|
960
|
+
# For more information, see [Copying Objects][17].
|
933
961
|
#
|
934
962
|
#
|
935
963
|
#
|
@@ -944,11 +972,12 @@ module Aws::S3
|
|
944
972
|
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
|
945
973
|
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
946
974
|
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html
|
947
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/
|
948
|
-
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/
|
949
|
-
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
950
|
-
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
951
|
-
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/
|
975
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
976
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
977
|
+
# [14]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_RestoreObject.html
|
978
|
+
# [15]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
979
|
+
# [16]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
980
|
+
# [17]: https://docs.aws.amazon.com/AmazonS3/latest/dev/CopyingObjectsExamples.html
|
952
981
|
#
|
953
982
|
# @option params [String] :acl
|
954
983
|
# The canned ACL to apply to the object.
|
@@ -1270,7 +1299,7 @@ module Aws::S3
|
|
1270
1299
|
# metadata_directive: "COPY", # accepts COPY, REPLACE
|
1271
1300
|
# tagging_directive: "COPY", # accepts COPY, REPLACE
|
1272
1301
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
1273
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
1302
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
1274
1303
|
# website_redirect_location: "WebsiteRedirectLocation",
|
1275
1304
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
1276
1305
|
# sse_customer_key: "SSECustomerKey",
|
@@ -1343,22 +1372,33 @@ module Aws::S3
|
|
1343
1372
|
#
|
1344
1373
|
# </note>
|
1345
1374
|
#
|
1375
|
+
# **Access control lists (ACLs)**
|
1376
|
+
#
|
1346
1377
|
# When creating a bucket using this operation, you can optionally
|
1347
|
-
# specify the accounts or groups that should
|
1348
|
-
# permissions on the bucket.
|
1349
|
-
#
|
1378
|
+
# configure the bucket ACL to specify the accounts or groups that should
|
1379
|
+
# be granted specific permissions on the bucket.
|
1380
|
+
#
|
1381
|
+
# If your CreateBucket request sets bucket owner enforced for S3 Object
|
1382
|
+
# Ownership and specifies a bucket ACL that provides access to an
|
1383
|
+
# external Amazon Web Services account, your request fails with a `400`
|
1384
|
+
# error and returns the `InvalidBucketAclWithObjectOwnership` error
|
1385
|
+
# code. For more information, see [Controlling object ownership][5] in
|
1386
|
+
# the *Amazon S3 User Guide*.
|
1387
|
+
#
|
1388
|
+
# There are two ways to grant the appropriate permissions using the
|
1389
|
+
# request headers.
|
1350
1390
|
#
|
1351
1391
|
# * Specify a canned ACL using the `x-amz-acl` request header. Amazon S3
|
1352
1392
|
# supports a set of predefined ACLs, known as *canned ACLs*. Each
|
1353
1393
|
# canned ACL has a predefined set of grantees and permissions. For
|
1354
|
-
# more information, see [Canned ACL][
|
1394
|
+
# more information, see [Canned ACL][6].
|
1355
1395
|
#
|
1356
1396
|
# * Specify access permissions explicitly using the `x-amz-grant-read`,
|
1357
1397
|
# `x-amz-grant-write`, `x-amz-grant-read-acp`,
|
1358
1398
|
# `x-amz-grant-write-acp`, and `x-amz-grant-full-control` headers.
|
1359
1399
|
# These headers map to the set of permissions Amazon S3 supports in an
|
1360
1400
|
# ACL. For more information, see [Access control list (ACL)
|
1361
|
-
# overview][
|
1401
|
+
# overview][7].
|
1362
1402
|
#
|
1363
1403
|
# You specify each grantee as a type=value pair, where the type is one
|
1364
1404
|
# of the following:
|
@@ -1391,7 +1431,7 @@ module Aws::S3
|
|
1391
1431
|
# * South America (São Paulo)
|
1392
1432
|
#
|
1393
1433
|
# For a list of all the Amazon S3 supported Regions and endpoints,
|
1394
|
-
# see [Regions and Endpoints][
|
1434
|
+
# see [Regions and Endpoints][8] in the Amazon Web Services General
|
1395
1435
|
# Reference.
|
1396
1436
|
#
|
1397
1437
|
# </note>
|
@@ -1409,22 +1449,29 @@ module Aws::S3
|
|
1409
1449
|
#
|
1410
1450
|
# **Permissions**
|
1411
1451
|
#
|
1412
|
-
#
|
1413
|
-
#
|
1414
|
-
#
|
1415
|
-
#
|
1416
|
-
#
|
1417
|
-
#
|
1452
|
+
# In addition to `s3:CreateBucket`, the following permissions are
|
1453
|
+
# required when your CreateBucket includes specific headers:
|
1454
|
+
#
|
1455
|
+
# * **ACLs** - If your `CreateBucket` request specifies ACL permissions
|
1456
|
+
# and the ACL is public-read, public-read-write, authenticated-read,
|
1457
|
+
# or if you specify access permissions explicitly through any other
|
1458
|
+
# ACL, both `s3:CreateBucket` and `s3:PutBucketAcl` permissions are
|
1459
|
+
# needed. If the ACL the `CreateBucket` request is private or doesn't
|
1460
|
+
# specify any ACLs, only `s3:CreateBucket` permission is needed.
|
1461
|
+
#
|
1462
|
+
# * **Object Lock** - If `ObjectLockEnabledForBucket` is set to true in
|
1463
|
+
# your `CreateBucket` request, `s3:PutBucketObjectLockConfiguration`
|
1464
|
+
# and `s3:PutBucketVersioning` permissions are required.
|
1418
1465
|
#
|
1419
|
-
#
|
1420
|
-
#
|
1421
|
-
#
|
1466
|
+
# * **S3 Object Ownership** - If your CreateBucket request includes the
|
1467
|
+
# the `x-amz-object-ownership` header, `s3:PutBucketOwnershipControls`
|
1468
|
+
# permission is required.
|
1422
1469
|
#
|
1423
1470
|
# The following operations are related to `CreateBucket`\:
|
1424
1471
|
#
|
1425
|
-
# * [PutObject][
|
1472
|
+
# * [PutObject][9]
|
1426
1473
|
#
|
1427
|
-
# * [DeleteBucket][
|
1474
|
+
# * [DeleteBucket][10]
|
1428
1475
|
#
|
1429
1476
|
#
|
1430
1477
|
#
|
@@ -1432,11 +1479,12 @@ module Aws::S3
|
|
1432
1479
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateBucket.html
|
1433
1480
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro
|
1434
1481
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/VirtualHosting.html
|
1435
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
1436
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
1437
|
-
# [7]: https://docs.aws.amazon.com/
|
1438
|
-
# [8]: https://docs.aws.amazon.com/
|
1439
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
1482
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
1483
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
1484
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/acl-overview.html
|
1485
|
+
# [8]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
1486
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
1487
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
1440
1488
|
#
|
1441
1489
|
# @option params [String] :acl
|
1442
1490
|
# The canned ACL to apply to the bucket.
|
@@ -1470,6 +1518,24 @@ module Aws::S3
|
|
1470
1518
|
# Specifies whether you want S3 Object Lock to be enabled for the new
|
1471
1519
|
# bucket.
|
1472
1520
|
#
|
1521
|
+
# @option params [String] :object_ownership
|
1522
|
+
# The container element for object ownership for a bucket's ownership
|
1523
|
+
# controls.
|
1524
|
+
#
|
1525
|
+
# BucketOwnerPreferred - Objects uploaded to the bucket change ownership
|
1526
|
+
# to the bucket owner if the objects are uploaded with the
|
1527
|
+
# `bucket-owner-full-control` canned ACL.
|
1528
|
+
#
|
1529
|
+
# ObjectWriter - The uploading account will own the object if the object
|
1530
|
+
# is uploaded with the `bucket-owner-full-control` canned ACL.
|
1531
|
+
#
|
1532
|
+
# BucketOwnerEnforced - Access control lists (ACLs) are disabled and no
|
1533
|
+
# longer affect permissions. The bucket owner automatically owns and has
|
1534
|
+
# full control over every object in the bucket. The bucket only accepts
|
1535
|
+
# PUT requests that don't specify an ACL or bucket owner full control
|
1536
|
+
# ACLs, such as the `bucket-owner-full-control` canned ACL or an
|
1537
|
+
# equivalent form of this ACL expressed in the XML format.
|
1538
|
+
#
|
1473
1539
|
# @return [Types::CreateBucketOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
|
1474
1540
|
#
|
1475
1541
|
# * {Types::CreateBucketOutput#location #location} => String
|
@@ -1518,6 +1584,7 @@ module Aws::S3
|
|
1518
1584
|
# grant_write: "GrantWrite",
|
1519
1585
|
# grant_write_acp: "GrantWriteACP",
|
1520
1586
|
# object_lock_enabled_for_bucket: false,
|
1587
|
+
# object_ownership: "BucketOwnerPreferred", # accepts BucketOwnerPreferred, ObjectWriter, BucketOwnerEnforced
|
1521
1588
|
# })
|
1522
1589
|
#
|
1523
1590
|
# @example Response structure
|
@@ -1996,7 +2063,7 @@ module Aws::S3
|
|
1996
2063
|
# "MetadataKey" => "MetadataValue",
|
1997
2064
|
# },
|
1998
2065
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
1999
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
2066
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
2000
2067
|
# website_redirect_location: "WebsiteRedirectLocation",
|
2001
2068
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
2002
2069
|
# sse_customer_key: "SSECustomerKey",
|
@@ -2265,18 +2332,17 @@ module Aws::S3
|
|
2265
2332
|
# storage costs by automatically moving data to the most cost-effective
|
2266
2333
|
# storage access tier, without performance impact or operational
|
2267
2334
|
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
2268
|
-
#
|
2269
|
-
#
|
2270
|
-
#
|
2271
|
-
# class.
|
2335
|
+
# three low latency and high throughput access tiers. To get the lowest
|
2336
|
+
# storage cost on data that can be accessed in minutes to hours, you can
|
2337
|
+
# choose to activate additional archiving capabilities.
|
2272
2338
|
#
|
2273
2339
|
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
2274
2340
|
# for data with unknown, changing, or unpredictable access patterns,
|
2275
2341
|
# independent of object size or retention period. If the size of an
|
2276
|
-
# object is less than 128 KB, it is not eligible for
|
2277
|
-
# Smaller objects can be stored, but they are always
|
2278
|
-
# Frequent Access tier rates in the S3
|
2279
|
-
# class.
|
2342
|
+
# object is less than 128 KB, it is not monitored and not eligible for
|
2343
|
+
# auto-tiering. Smaller objects can be stored, but they are always
|
2344
|
+
# charged at the Frequent Access tier rates in the S3
|
2345
|
+
# Intelligent-Tiering storage class.
|
2280
2346
|
#
|
2281
2347
|
# For more information, see [Storage class for automatically optimizing
|
2282
2348
|
# frequently and infrequently accessed objects][1].
|
@@ -3024,35 +3090,35 @@ module Aws::S3
|
|
3024
3090
|
# * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
|
3025
3091
|
#
|
3026
3092
|
#
|
3027
|
-
# @example Example: To remove tag set from an object
|
3093
|
+
# @example Example: To remove tag set from an object version
|
3028
3094
|
#
|
3029
|
-
# # The following example removes tag set associated with the specified object.
|
3030
|
-
# #
|
3095
|
+
# # The following example removes tag set associated with the specified object version. The request specifies both the
|
3096
|
+
# # object key and object version.
|
3031
3097
|
#
|
3032
3098
|
# resp = client.delete_object_tagging({
|
3033
3099
|
# bucket: "examplebucket",
|
3034
3100
|
# key: "HappyFace.jpg",
|
3101
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
3035
3102
|
# })
|
3036
3103
|
#
|
3037
3104
|
# resp.to_h outputs the following:
|
3038
3105
|
# {
|
3039
|
-
# version_id: "
|
3106
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
3040
3107
|
# }
|
3041
3108
|
#
|
3042
|
-
# @example Example: To remove tag set from an object
|
3109
|
+
# @example Example: To remove tag set from an object
|
3043
3110
|
#
|
3044
|
-
# # The following example removes tag set associated with the specified object
|
3045
|
-
# #
|
3111
|
+
# # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
|
3112
|
+
# # operation removes tag set from the latest object version.
|
3046
3113
|
#
|
3047
3114
|
# resp = client.delete_object_tagging({
|
3048
3115
|
# bucket: "examplebucket",
|
3049
3116
|
# key: "HappyFace.jpg",
|
3050
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
3051
3117
|
# })
|
3052
3118
|
#
|
3053
3119
|
# resp.to_h outputs the following:
|
3054
3120
|
# {
|
3055
|
-
# version_id: "
|
3121
|
+
# version_id: "null",
|
3056
3122
|
# }
|
3057
3123
|
#
|
3058
3124
|
# @example Request syntax with placeholder values
|
@@ -3437,15 +3503,24 @@ module Aws::S3
|
|
3437
3503
|
# can return the ACL of the bucket without using an authorization
|
3438
3504
|
# header.
|
3439
3505
|
#
|
3506
|
+
# <note markdown="1"> If your bucket uses the bucket owner enforced setting for S3 Object
|
3507
|
+
# Ownership, requests to read ACLs are still supported and return the
|
3508
|
+
# `bucket-owner-full-control` ACL with the owner being the account that
|
3509
|
+
# created the bucket. For more information, see [ Controlling object
|
3510
|
+
# ownership and disabling ACLs][1] in the *Amazon S3 User Guide*.
|
3511
|
+
#
|
3512
|
+
# </note>
|
3513
|
+
#
|
3440
3514
|
# **Related Resources**
|
3441
3515
|
#
|
3442
|
-
# * [ListObjects][
|
3516
|
+
# * [ListObjects][2]
|
3443
3517
|
#
|
3444
3518
|
# ^
|
3445
3519
|
#
|
3446
3520
|
#
|
3447
3521
|
#
|
3448
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
3522
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
3523
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListObjects.html
|
3449
3524
|
#
|
3450
3525
|
# @option params [required, String] :bucket
|
3451
3526
|
# Specifies the S3 bucket whose ACL is being requested.
|
@@ -3731,18 +3806,17 @@ module Aws::S3
|
|
3731
3806
|
# storage costs by automatically moving data to the most cost-effective
|
3732
3807
|
# storage access tier, without performance impact or operational
|
3733
3808
|
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
3734
|
-
#
|
3735
|
-
#
|
3736
|
-
#
|
3737
|
-
# class.
|
3809
|
+
# three low latency and high throughput access tiers. To get the lowest
|
3810
|
+
# storage cost on data that can be accessed in minutes to hours, you can
|
3811
|
+
# choose to activate additional archiving capabilities.
|
3738
3812
|
#
|
3739
3813
|
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
3740
3814
|
# for data with unknown, changing, or unpredictable access patterns,
|
3741
3815
|
# independent of object size or retention period. If the size of an
|
3742
|
-
# object is less than 128 KB, it is not eligible for
|
3743
|
-
# Smaller objects can be stored, but they are always
|
3744
|
-
# Frequent Access tier rates in the S3
|
3745
|
-
# class.
|
3816
|
+
# object is less than 128 KB, it is not monitored and not eligible for
|
3817
|
+
# auto-tiering. Smaller objects can be stored, but they are always
|
3818
|
+
# charged at the Frequent Access tier rates in the S3
|
3819
|
+
# Intelligent-Tiering storage class.
|
3746
3820
|
#
|
3747
3821
|
# For more information, see [Storage class for automatically optimizing
|
3748
3822
|
# frequently and infrequently accessed objects][1].
|
@@ -3981,9 +4055,9 @@ module Aws::S3
|
|
3981
4055
|
# resp.rules[0].status #=> String, one of "Enabled", "Disabled"
|
3982
4056
|
# resp.rules[0].transition.date #=> Time
|
3983
4057
|
# resp.rules[0].transition.days #=> Integer
|
3984
|
-
# resp.rules[0].transition.storage_class #=> String, one of "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE"
|
4058
|
+
# resp.rules[0].transition.storage_class #=> String, one of "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "GLACIER_IR"
|
3985
4059
|
# resp.rules[0].noncurrent_version_transition.noncurrent_days #=> Integer
|
3986
|
-
# resp.rules[0].noncurrent_version_transition.storage_class #=> String, one of "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE"
|
4060
|
+
# resp.rules[0].noncurrent_version_transition.storage_class #=> String, one of "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "GLACIER_IR"
|
3987
4061
|
# resp.rules[0].noncurrent_version_transition.newer_noncurrent_versions #=> Integer
|
3988
4062
|
# resp.rules[0].noncurrent_version_expiration.noncurrent_days #=> Integer
|
3989
4063
|
# resp.rules[0].noncurrent_version_expiration.newer_noncurrent_versions #=> Integer
|
@@ -4116,10 +4190,10 @@ module Aws::S3
|
|
4116
4190
|
# resp.rules[0].transitions #=> Array
|
4117
4191
|
# resp.rules[0].transitions[0].date #=> Time
|
4118
4192
|
# resp.rules[0].transitions[0].days #=> Integer
|
4119
|
-
# resp.rules[0].transitions[0].storage_class #=> String, one of "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE"
|
4193
|
+
# resp.rules[0].transitions[0].storage_class #=> String, one of "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "GLACIER_IR"
|
4120
4194
|
# resp.rules[0].noncurrent_version_transitions #=> Array
|
4121
4195
|
# resp.rules[0].noncurrent_version_transitions[0].noncurrent_days #=> Integer
|
4122
|
-
# resp.rules[0].noncurrent_version_transitions[0].storage_class #=> String, one of "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE"
|
4196
|
+
# resp.rules[0].noncurrent_version_transitions[0].storage_class #=> String, one of "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "GLACIER_IR"
|
4123
4197
|
# resp.rules[0].noncurrent_version_transitions[0].newer_noncurrent_versions #=> Integer
|
4124
4198
|
# resp.rules[0].noncurrent_version_expiration.noncurrent_days #=> Integer
|
4125
4199
|
# resp.rules[0].noncurrent_version_expiration.newer_noncurrent_versions #=> Integer
|
@@ -4425,18 +4499,18 @@ module Aws::S3
|
|
4425
4499
|
#
|
4426
4500
|
# resp.topic_configuration.id #=> String
|
4427
4501
|
# resp.topic_configuration.events #=> Array
|
4428
|
-
# resp.topic_configuration.events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4429
|
-
# resp.topic_configuration.event #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4502
|
+
# resp.topic_configuration.events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4503
|
+
# resp.topic_configuration.event #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4430
4504
|
# resp.topic_configuration.topic #=> String
|
4431
4505
|
# resp.queue_configuration.id #=> String
|
4432
|
-
# resp.queue_configuration.event #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4506
|
+
# resp.queue_configuration.event #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4433
4507
|
# resp.queue_configuration.events #=> Array
|
4434
|
-
# resp.queue_configuration.events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4508
|
+
# resp.queue_configuration.events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4435
4509
|
# resp.queue_configuration.queue #=> String
|
4436
4510
|
# resp.cloud_function_configuration.id #=> String
|
4437
|
-
# resp.cloud_function_configuration.event #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4511
|
+
# resp.cloud_function_configuration.event #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4438
4512
|
# resp.cloud_function_configuration.events #=> Array
|
4439
|
-
# resp.cloud_function_configuration.events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4513
|
+
# resp.cloud_function_configuration.events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4440
4514
|
# resp.cloud_function_configuration.cloud_function #=> String
|
4441
4515
|
# resp.cloud_function_configuration.invocation_role #=> String
|
4442
4516
|
#
|
@@ -4490,6 +4564,7 @@ module Aws::S3
|
|
4490
4564
|
# * {Types::NotificationConfiguration#topic_configurations #topic_configurations} => Array<Types::TopicConfiguration>
|
4491
4565
|
# * {Types::NotificationConfiguration#queue_configurations #queue_configurations} => Array<Types::QueueConfiguration>
|
4492
4566
|
# * {Types::NotificationConfiguration#lambda_function_configurations #lambda_function_configurations} => Array<Types::LambdaFunctionConfiguration>
|
4567
|
+
# * {Types::NotificationConfiguration#event_bridge_configuration #event_bridge_configuration} => Types::EventBridgeConfiguration
|
4493
4568
|
#
|
4494
4569
|
# @example Request syntax with placeholder values
|
4495
4570
|
#
|
@@ -4504,7 +4579,7 @@ module Aws::S3
|
|
4504
4579
|
# resp.topic_configurations[0].id #=> String
|
4505
4580
|
# resp.topic_configurations[0].topic_arn #=> String
|
4506
4581
|
# resp.topic_configurations[0].events #=> Array
|
4507
|
-
# resp.topic_configurations[0].events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4582
|
+
# resp.topic_configurations[0].events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4508
4583
|
# resp.topic_configurations[0].filter.key.filter_rules #=> Array
|
4509
4584
|
# resp.topic_configurations[0].filter.key.filter_rules[0].name #=> String, one of "prefix", "suffix"
|
4510
4585
|
# resp.topic_configurations[0].filter.key.filter_rules[0].value #=> String
|
@@ -4512,7 +4587,7 @@ module Aws::S3
|
|
4512
4587
|
# resp.queue_configurations[0].id #=> String
|
4513
4588
|
# resp.queue_configurations[0].queue_arn #=> String
|
4514
4589
|
# resp.queue_configurations[0].events #=> Array
|
4515
|
-
# resp.queue_configurations[0].events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4590
|
+
# resp.queue_configurations[0].events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4516
4591
|
# resp.queue_configurations[0].filter.key.filter_rules #=> Array
|
4517
4592
|
# resp.queue_configurations[0].filter.key.filter_rules[0].name #=> String, one of "prefix", "suffix"
|
4518
4593
|
# resp.queue_configurations[0].filter.key.filter_rules[0].value #=> String
|
@@ -4520,7 +4595,7 @@ module Aws::S3
|
|
4520
4595
|
# resp.lambda_function_configurations[0].id #=> String
|
4521
4596
|
# resp.lambda_function_configurations[0].lambda_function_arn #=> String
|
4522
4597
|
# resp.lambda_function_configurations[0].events #=> Array
|
4523
|
-
# resp.lambda_function_configurations[0].events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold"
|
4598
|
+
# resp.lambda_function_configurations[0].events[0] #=> String, one of "s3:ReducedRedundancyLostObject", "s3:ObjectCreated:*", "s3:ObjectCreated:Put", "s3:ObjectCreated:Post", "s3:ObjectCreated:Copy", "s3:ObjectCreated:CompleteMultipartUpload", "s3:ObjectRemoved:*", "s3:ObjectRemoved:Delete", "s3:ObjectRemoved:DeleteMarkerCreated", "s3:ObjectRestore:*", "s3:ObjectRestore:Post", "s3:ObjectRestore:Completed", "s3:Replication:*", "s3:Replication:OperationFailedReplication", "s3:Replication:OperationNotTracked", "s3:Replication:OperationMissedThreshold", "s3:Replication:OperationReplicatedAfterThreshold", "s3:ObjectRestore:Delete", "s3:LifecycleTransition", "s3:IntelligentTiering", "s3:ObjectAcl:Put", "s3:LifecycleExpiration:*", "s3:LifecycleExpiration:Delete", "s3:LifecycleExpiration:DeleteMarkerCreated", "s3:ObjectTagging:*", "s3:ObjectTagging:Put", "s3:ObjectTagging:Delete"
|
4524
4599
|
# resp.lambda_function_configurations[0].filter.key.filter_rules #=> Array
|
4525
4600
|
# resp.lambda_function_configurations[0].filter.key.filter_rules[0].name #=> String, one of "prefix", "suffix"
|
4526
4601
|
# resp.lambda_function_configurations[0].filter.key.filter_rules[0].value #=> String
|
@@ -4537,7 +4612,7 @@ module Aws::S3
|
|
4537
4612
|
# Retrieves `OwnershipControls` for an Amazon S3 bucket. To use this
|
4538
4613
|
# operation, you must have the `s3:GetBucketOwnershipControls`
|
4539
4614
|
# permission. For more information about Amazon S3 permissions, see
|
4540
|
-
# [Specifying
|
4615
|
+
# [Specifying permissions in a policy][1].
|
4541
4616
|
#
|
4542
4617
|
# For information about Amazon S3 Object Ownership, see [Using Object
|
4543
4618
|
# Ownership][2].
|
@@ -4550,8 +4625,8 @@ module Aws::S3
|
|
4550
4625
|
#
|
4551
4626
|
#
|
4552
4627
|
#
|
4553
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4554
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
4628
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html
|
4629
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
4555
4630
|
#
|
4556
4631
|
# @option params [required, String] :bucket
|
4557
4632
|
# The name of the Amazon S3 bucket whose `OwnershipControls` you want to
|
@@ -4576,7 +4651,7 @@ module Aws::S3
|
|
4576
4651
|
# @example Response structure
|
4577
4652
|
#
|
4578
4653
|
# resp.ownership_controls.rules #=> Array
|
4579
|
-
# resp.ownership_controls.rules[0].object_ownership #=> String, one of "BucketOwnerPreferred", "ObjectWriter"
|
4654
|
+
# resp.ownership_controls.rules[0].object_ownership #=> String, one of "BucketOwnerPreferred", "ObjectWriter", "BucketOwnerEnforced"
|
4580
4655
|
#
|
4581
4656
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketOwnershipControls AWS API Documentation
|
4582
4657
|
#
|
@@ -4825,7 +4900,7 @@ module Aws::S3
|
|
4825
4900
|
# resp.replication_configuration.rules[0].existing_object_replication.status #=> String, one of "Enabled", "Disabled"
|
4826
4901
|
# resp.replication_configuration.rules[0].destination.bucket #=> String
|
4827
4902
|
# resp.replication_configuration.rules[0].destination.account #=> String
|
4828
|
-
# resp.replication_configuration.rules[0].destination.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
|
4903
|
+
# resp.replication_configuration.rules[0].destination.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR"
|
4829
4904
|
# resp.replication_configuration.rules[0].destination.access_control_translation.owner #=> String, one of "Destination"
|
4830
4905
|
# resp.replication_configuration.rules[0].destination.encryption_configuration.replica_kms_key_id #=> String
|
4831
4906
|
# resp.replication_configuration.rules[0].destination.replication_time.status #=> String, one of "Enabled", "Disabled"
|
@@ -5468,49 +5543,49 @@ module Aws::S3
|
|
5468
5543
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
5469
5544
|
#
|
5470
5545
|
#
|
5471
|
-
# @example Example: To retrieve an object
|
5546
|
+
# @example Example: To retrieve a byte range of an object
|
5472
5547
|
#
|
5473
|
-
# # The following example retrieves an object for an S3 bucket.
|
5548
|
+
# # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
|
5549
|
+
# # specific byte range.
|
5474
5550
|
#
|
5475
5551
|
# resp = client.get_object({
|
5476
5552
|
# bucket: "examplebucket",
|
5477
|
-
# key: "
|
5553
|
+
# key: "SampleFile.txt",
|
5554
|
+
# range: "bytes=0-9",
|
5478
5555
|
# })
|
5479
5556
|
#
|
5480
5557
|
# resp.to_h outputs the following:
|
5481
5558
|
# {
|
5482
5559
|
# accept_ranges: "bytes",
|
5483
|
-
# content_length:
|
5484
|
-
#
|
5485
|
-
#
|
5486
|
-
#
|
5560
|
+
# content_length: 10,
|
5561
|
+
# content_range: "bytes 0-9/43",
|
5562
|
+
# content_type: "text/plain",
|
5563
|
+
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
5564
|
+
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
5487
5565
|
# metadata: {
|
5488
5566
|
# },
|
5489
|
-
# tag_count: 2,
|
5490
5567
|
# version_id: "null",
|
5491
5568
|
# }
|
5492
5569
|
#
|
5493
|
-
# @example Example: To retrieve
|
5570
|
+
# @example Example: To retrieve an object
|
5494
5571
|
#
|
5495
|
-
# # The following example retrieves an object for an S3 bucket.
|
5496
|
-
# # specific byte range.
|
5572
|
+
# # The following example retrieves an object for an S3 bucket.
|
5497
5573
|
#
|
5498
5574
|
# resp = client.get_object({
|
5499
5575
|
# bucket: "examplebucket",
|
5500
|
-
# key: "
|
5501
|
-
# range: "bytes=0-9",
|
5576
|
+
# key: "HappyFace.jpg",
|
5502
5577
|
# })
|
5503
5578
|
#
|
5504
5579
|
# resp.to_h outputs the following:
|
5505
5580
|
# {
|
5506
5581
|
# accept_ranges: "bytes",
|
5507
|
-
# content_length:
|
5508
|
-
#
|
5509
|
-
#
|
5510
|
-
#
|
5511
|
-
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
5582
|
+
# content_length: 3191,
|
5583
|
+
# content_type: "image/jpeg",
|
5584
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
5585
|
+
# last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
|
5512
5586
|
# metadata: {
|
5513
5587
|
# },
|
5588
|
+
# tag_count: 2,
|
5514
5589
|
# version_id: "null",
|
5515
5590
|
# }
|
5516
5591
|
#
|
@@ -5596,7 +5671,7 @@ module Aws::S3
|
|
5596
5671
|
# resp.sse_customer_key_md5 #=> String
|
5597
5672
|
# resp.ssekms_key_id #=> String
|
5598
5673
|
# resp.bucket_key_enabled #=> Boolean
|
5599
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
|
5674
|
+
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR"
|
5600
5675
|
# resp.request_charged #=> String, one of "requester"
|
5601
5676
|
# resp.replication_status #=> String, one of "COMPLETE", "PENDING", "FAILED", "REPLICA"
|
5602
5677
|
# resp.parts_count #=> Integer
|
@@ -5625,19 +5700,28 @@ module Aws::S3
|
|
5625
5700
|
# an object. To return ACL information about a different version, use
|
5626
5701
|
# the versionId subresource.
|
5627
5702
|
#
|
5703
|
+
# <note markdown="1"> If your bucket uses the bucket owner enforced setting for S3 Object
|
5704
|
+
# Ownership, requests to read ACLs are still supported and return the
|
5705
|
+
# `bucket-owner-full-control` ACL with the owner being the account that
|
5706
|
+
# created the bucket. For more information, see [ Controlling object
|
5707
|
+
# ownership and disabling ACLs][1] in the *Amazon S3 User Guide*.
|
5708
|
+
#
|
5709
|
+
# </note>
|
5710
|
+
#
|
5628
5711
|
# The following operations are related to `GetObjectAcl`\:
|
5629
5712
|
#
|
5630
|
-
# * [GetObject][
|
5713
|
+
# * [GetObject][2]
|
5631
5714
|
#
|
5632
|
-
# * [DeleteObject][
|
5715
|
+
# * [DeleteObject][3]
|
5633
5716
|
#
|
5634
|
-
# * [PutObject][
|
5717
|
+
# * [PutObject][4]
|
5635
5718
|
#
|
5636
5719
|
#
|
5637
5720
|
#
|
5638
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
5639
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
5640
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
5721
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
5722
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
5723
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
5724
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
5641
5725
|
#
|
5642
5726
|
# @option params [required, String] :bucket
|
5643
5727
|
# The bucket name that contains the object for which to get the ACL
|
@@ -6521,18 +6605,8 @@ module Aws::S3
|
|
6521
6605
|
# The object key.
|
6522
6606
|
#
|
6523
6607
|
# @option params [String] :range
|
6524
|
-
#
|
6525
|
-
#
|
6526
|
-
# [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
|
6527
|
-
#
|
6528
|
-
# <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
|
6529
|
-
# `GET` request.
|
6530
|
-
#
|
6531
|
-
# </note>
|
6532
|
-
#
|
6533
|
-
#
|
6534
|
-
#
|
6535
|
-
# [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
|
6608
|
+
# Because `HeadObject` returns only the metadata for an object, this
|
6609
|
+
# parameter has no effect.
|
6536
6610
|
#
|
6537
6611
|
# @option params [String] :version_id
|
6538
6612
|
# VersionId used to reference a specific version of the object.
|
@@ -6677,7 +6751,7 @@ module Aws::S3
|
|
6677
6751
|
# resp.sse_customer_key_md5 #=> String
|
6678
6752
|
# resp.ssekms_key_id #=> String
|
6679
6753
|
# resp.bucket_key_enabled #=> Boolean
|
6680
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
|
6754
|
+
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR"
|
6681
6755
|
# resp.request_charged #=> String, one of "requester"
|
6682
6756
|
# resp.replication_status #=> String, one of "COMPLETE", "PENDING", "FAILED", "REPLICA"
|
6683
6757
|
# resp.parts_count #=> Integer
|
@@ -6804,18 +6878,17 @@ module Aws::S3
|
|
6804
6878
|
# storage costs by automatically moving data to the most cost-effective
|
6805
6879
|
# storage access tier, without performance impact or operational
|
6806
6880
|
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
6807
|
-
#
|
6808
|
-
#
|
6809
|
-
#
|
6810
|
-
# class.
|
6881
|
+
# three low latency and high throughput access tiers. To get the lowest
|
6882
|
+
# storage cost on data that can be accessed in minutes to hours, you can
|
6883
|
+
# choose to activate additional archiving capabilities.
|
6811
6884
|
#
|
6812
6885
|
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
6813
6886
|
# for data with unknown, changing, or unpredictable access patterns,
|
6814
6887
|
# independent of object size or retention period. If the size of an
|
6815
|
-
# object is less than 128 KB, it is not eligible for
|
6816
|
-
# Smaller objects can be stored, but they are always
|
6817
|
-
# Frequent Access tier rates in the S3
|
6818
|
-
# class.
|
6888
|
+
# object is less than 128 KB, it is not monitored and not eligible for
|
6889
|
+
# auto-tiering. Smaller objects can be stored, but they are always
|
6890
|
+
# charged at the Frequent Access tier rates in the S3
|
6891
|
+
# Intelligent-Tiering storage class.
|
6819
6892
|
#
|
6820
6893
|
# For more information, see [Storage class for automatically optimizing
|
6821
6894
|
# frequently and infrequently accessed objects][1].
|
@@ -7285,97 +7358,97 @@ module Aws::S3
|
|
7285
7358
|
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
7286
7359
|
#
|
7287
7360
|
#
|
7288
|
-
# @example Example:
|
7361
|
+
# @example Example: List next set of multipart uploads when previous result is truncated
|
7289
7362
|
#
|
7290
|
-
# # The following example
|
7363
|
+
# # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
|
7364
|
+
# # setup of multipart uploads.
|
7291
7365
|
#
|
7292
7366
|
# resp = client.list_multipart_uploads({
|
7293
7367
|
# bucket: "examplebucket",
|
7368
|
+
# key_marker: "nextkeyfrompreviousresponse",
|
7369
|
+
# max_uploads: 2,
|
7370
|
+
# upload_id_marker: "valuefrompreviousresponse",
|
7294
7371
|
# })
|
7295
7372
|
#
|
7296
7373
|
# resp.to_h outputs the following:
|
7297
7374
|
# {
|
7375
|
+
# bucket: "acl1",
|
7376
|
+
# is_truncated: true,
|
7377
|
+
# key_marker: "",
|
7378
|
+
# max_uploads: 2,
|
7379
|
+
# next_key_marker: "someobjectkey",
|
7380
|
+
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7381
|
+
# upload_id_marker: "",
|
7298
7382
|
# uploads: [
|
7299
7383
|
# {
|
7300
7384
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
7301
7385
|
# initiator: {
|
7302
|
-
# display_name: "display-name",
|
7386
|
+
# display_name: "ownder-display-name",
|
7303
7387
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7304
7388
|
# },
|
7305
7389
|
# key: "JavaFile",
|
7306
7390
|
# owner: {
|
7307
|
-
# display_name: "
|
7308
|
-
# id: "
|
7391
|
+
# display_name: "mohanataws",
|
7392
|
+
# id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7309
7393
|
# },
|
7310
7394
|
# storage_class: "STANDARD",
|
7311
|
-
# upload_id: "
|
7395
|
+
# upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
7312
7396
|
# },
|
7313
7397
|
# {
|
7314
7398
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
7315
7399
|
# initiator: {
|
7316
|
-
# display_name: "display-name",
|
7400
|
+
# display_name: "ownder-display-name",
|
7317
7401
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7318
7402
|
# },
|
7319
7403
|
# key: "JavaFile",
|
7320
7404
|
# owner: {
|
7321
|
-
# display_name: "display-name",
|
7405
|
+
# display_name: "ownder-display-name",
|
7322
7406
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7323
7407
|
# },
|
7324
7408
|
# storage_class: "STANDARD",
|
7325
|
-
# upload_id: "
|
7409
|
+
# upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7326
7410
|
# },
|
7327
7411
|
# ],
|
7328
7412
|
# }
|
7329
7413
|
#
|
7330
|
-
# @example Example:
|
7414
|
+
# @example Example: To list in-progress multipart uploads on a bucket
|
7331
7415
|
#
|
7332
|
-
# # The following example
|
7333
|
-
# # setup of multipart uploads.
|
7416
|
+
# # The following example lists in-progress multipart uploads on a specific bucket.
|
7334
7417
|
#
|
7335
7418
|
# resp = client.list_multipart_uploads({
|
7336
7419
|
# bucket: "examplebucket",
|
7337
|
-
# key_marker: "nextkeyfrompreviousresponse",
|
7338
|
-
# max_uploads: 2,
|
7339
|
-
# upload_id_marker: "valuefrompreviousresponse",
|
7340
7420
|
# })
|
7341
7421
|
#
|
7342
7422
|
# resp.to_h outputs the following:
|
7343
7423
|
# {
|
7344
|
-
# bucket: "acl1",
|
7345
|
-
# is_truncated: true,
|
7346
|
-
# key_marker: "",
|
7347
|
-
# max_uploads: 2,
|
7348
|
-
# next_key_marker: "someobjectkey",
|
7349
|
-
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7350
|
-
# upload_id_marker: "",
|
7351
7424
|
# uploads: [
|
7352
7425
|
# {
|
7353
7426
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
7354
7427
|
# initiator: {
|
7355
|
-
# display_name: "
|
7428
|
+
# display_name: "display-name",
|
7356
7429
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7357
7430
|
# },
|
7358
7431
|
# key: "JavaFile",
|
7359
7432
|
# owner: {
|
7360
|
-
# display_name: "
|
7361
|
-
# id: "
|
7433
|
+
# display_name: "display-name",
|
7434
|
+
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7362
7435
|
# },
|
7363
7436
|
# storage_class: "STANDARD",
|
7364
|
-
# upload_id: "
|
7437
|
+
# upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
7365
7438
|
# },
|
7366
7439
|
# {
|
7367
7440
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
7368
7441
|
# initiator: {
|
7369
|
-
# display_name: "
|
7442
|
+
# display_name: "display-name",
|
7370
7443
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7371
7444
|
# },
|
7372
7445
|
# key: "JavaFile",
|
7373
7446
|
# owner: {
|
7374
|
-
# display_name: "
|
7447
|
+
# display_name: "display-name",
|
7375
7448
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7376
7449
|
# },
|
7377
7450
|
# storage_class: "STANDARD",
|
7378
|
-
# upload_id: "
|
7451
|
+
# upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7379
7452
|
# },
|
7380
7453
|
# ],
|
7381
7454
|
# }
|
@@ -7408,7 +7481,7 @@ module Aws::S3
|
|
7408
7481
|
# resp.uploads[0].upload_id #=> String
|
7409
7482
|
# resp.uploads[0].key #=> String
|
7410
7483
|
# resp.uploads[0].initiated #=> Time
|
7411
|
-
# resp.uploads[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
|
7484
|
+
# resp.uploads[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR"
|
7412
7485
|
# resp.uploads[0].owner.display_name #=> String
|
7413
7486
|
# resp.uploads[0].owner.id #=> String
|
7414
7487
|
# resp.uploads[0].initiator.id #=> String
|
@@ -7788,7 +7861,7 @@ module Aws::S3
|
|
7788
7861
|
# resp.contents[0].last_modified #=> Time
|
7789
7862
|
# resp.contents[0].etag #=> String
|
7790
7863
|
# resp.contents[0].size #=> Integer
|
7791
|
-
# resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS"
|
7864
|
+
# resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR"
|
7792
7865
|
# resp.contents[0].owner.display_name #=> String
|
7793
7866
|
# resp.contents[0].owner.id #=> String
|
7794
7867
|
# resp.name #=> String
|
@@ -7993,7 +8066,7 @@ module Aws::S3
|
|
7993
8066
|
# resp.contents[0].last_modified #=> Time
|
7994
8067
|
# resp.contents[0].etag #=> String
|
7995
8068
|
# resp.contents[0].size #=> Integer
|
7996
|
-
# resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS"
|
8069
|
+
# resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR"
|
7997
8070
|
# resp.contents[0].owner.display_name #=> String
|
7998
8071
|
# resp.contents[0].owner.id #=> String
|
7999
8072
|
# resp.name #=> String
|
@@ -8202,7 +8275,7 @@ module Aws::S3
|
|
8202
8275
|
# resp.initiator.display_name #=> String
|
8203
8276
|
# resp.owner.display_name #=> String
|
8204
8277
|
# resp.owner.id #=> String
|
8205
|
-
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS"
|
8278
|
+
# resp.storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "GLACIER", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR"
|
8206
8279
|
# resp.request_charged #=> String, one of "requester"
|
8207
8280
|
#
|
8208
8281
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListParts AWS API Documentation
|
@@ -8313,6 +8386,14 @@ module Aws::S3
|
|
8313
8386
|
# you have an existing application that updates a bucket ACL using the
|
8314
8387
|
# request body, then you can continue to use that approach.
|
8315
8388
|
#
|
8389
|
+
# If your bucket uses the bucket owner enforced setting for S3 Object
|
8390
|
+
# Ownership, ACLs are disabled and no longer affect permissions. You
|
8391
|
+
# must use policies to grant access to your bucket and the objects in
|
8392
|
+
# it. Requests to set ACLs or update ACLs fail and return the
|
8393
|
+
# `AccessControlListNotSupported` error code. Requests to read ACLs are
|
8394
|
+
# still supported. For more information, see [Controlling object
|
8395
|
+
# ownership][2] in the *Amazon S3 User Guide*.
|
8396
|
+
#
|
8316
8397
|
# **Access Permissions**
|
8317
8398
|
#
|
8318
8399
|
# You can set access permissions using one of the following methods:
|
@@ -8322,7 +8403,7 @@ module Aws::S3
|
|
8322
8403
|
# canned ACL has a predefined set of grantees and permissions. Specify
|
8323
8404
|
# the canned ACL name as the value of `x-amz-acl`. If you use this
|
8324
8405
|
# header, you cannot use other access control-specific headers in your
|
8325
|
-
# request. For more information, see [Canned ACL][
|
8406
|
+
# request. For more information, see [Canned ACL][3].
|
8326
8407
|
#
|
8327
8408
|
# * Specify access permissions explicitly with the `x-amz-grant-read`,
|
8328
8409
|
# `x-amz-grant-read-acp`, `x-amz-grant-write-acp`, and
|
@@ -8332,7 +8413,7 @@ module Aws::S3
|
|
8332
8413
|
# permission. If you use these ACL-specific headers, you cannot use
|
8333
8414
|
# the `x-amz-acl` header to set a canned ACL. These parameters map to
|
8334
8415
|
# the set of permissions that Amazon S3 supports in an ACL. For more
|
8335
|
-
# information, see [Access Control List (ACL) Overview][
|
8416
|
+
# information, see [Access Control List (ACL) Overview][4].
|
8336
8417
|
#
|
8337
8418
|
# You specify each grantee as a type=value pair, where the type is one
|
8338
8419
|
# of the following:
|
@@ -8365,7 +8446,7 @@ module Aws::S3
|
|
8365
8446
|
# * South America (São Paulo)
|
8366
8447
|
#
|
8367
8448
|
# For a list of all the Amazon S3 supported Regions and endpoints,
|
8368
|
-
# see [Regions and Endpoints][
|
8449
|
+
# see [Regions and Endpoints][5] in the Amazon Web Services General
|
8369
8450
|
# Reference.
|
8370
8451
|
#
|
8371
8452
|
# </note>
|
@@ -8428,28 +8509,29 @@ module Aws::S3
|
|
8428
8509
|
# * South America (São Paulo)
|
8429
8510
|
#
|
8430
8511
|
# For a list of all the Amazon S3 supported Regions and endpoints, see
|
8431
|
-
# [Regions and Endpoints][
|
8512
|
+
# [Regions and Endpoints][5] in the Amazon Web Services General
|
8432
8513
|
# Reference.
|
8433
8514
|
#
|
8434
8515
|
# </note>
|
8435
8516
|
#
|
8436
8517
|
# **Related Resources**
|
8437
8518
|
#
|
8438
|
-
# * [CreateBucket][
|
8519
|
+
# * [CreateBucket][6]
|
8439
8520
|
#
|
8440
|
-
# * [DeleteBucket][
|
8521
|
+
# * [DeleteBucket][7]
|
8441
8522
|
#
|
8442
|
-
# * [GetObjectAcl][
|
8523
|
+
# * [GetObjectAcl][8]
|
8443
8524
|
#
|
8444
8525
|
#
|
8445
8526
|
#
|
8446
8527
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html
|
8447
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
8448
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
8449
|
-
# [4]: https://docs.aws.amazon.com/
|
8450
|
-
# [5]: https://docs.aws.amazon.com/
|
8451
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8452
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
8528
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
8529
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
8530
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
8531
|
+
# [5]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
8532
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
8533
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
8534
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectAcl.html
|
8453
8535
|
#
|
8454
8536
|
# @option params [String] :acl
|
8455
8537
|
# The canned ACL to apply to the bucket.
|
@@ -8949,18 +9031,17 @@ module Aws::S3
|
|
8949
9031
|
# storage costs by automatically moving data to the most cost-effective
|
8950
9032
|
# storage access tier, without performance impact or operational
|
8951
9033
|
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
8952
|
-
#
|
8953
|
-
#
|
8954
|
-
#
|
8955
|
-
# class.
|
9034
|
+
# three low latency and high throughput access tiers. To get the lowest
|
9035
|
+
# storage cost on data that can be accessed in minutes to hours, you can
|
9036
|
+
# choose to activate additional archiving capabilities.
|
8956
9037
|
#
|
8957
9038
|
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
8958
9039
|
# for data with unknown, changing, or unpredictable access patterns,
|
8959
9040
|
# independent of object size or retention period. If the size of an
|
8960
|
-
# object is less than 128 KB, it is not eligible for
|
8961
|
-
# Smaller objects can be stored, but they are always
|
8962
|
-
# Frequent Access tier rates in the S3
|
8963
|
-
# class.
|
9041
|
+
# object is less than 128 KB, it is not monitored and not eligible for
|
9042
|
+
# auto-tiering. Smaller objects can be stored, but they are always
|
9043
|
+
# charged at the Frequent Access tier rates in the S3
|
9044
|
+
# Intelligent-Tiering storage class.
|
8964
9045
|
#
|
8965
9046
|
# For more information, see [Storage class for automatically optimizing
|
8966
9047
|
# frequently and infrequently accessed objects][1].
|
@@ -9297,11 +9378,11 @@ module Aws::S3
|
|
9297
9378
|
# transition: {
|
9298
9379
|
# date: Time.now,
|
9299
9380
|
# days: 1,
|
9300
|
-
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE
|
9381
|
+
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE, GLACIER_IR
|
9301
9382
|
# },
|
9302
9383
|
# noncurrent_version_transition: {
|
9303
9384
|
# noncurrent_days: 1,
|
9304
|
-
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE
|
9385
|
+
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE, GLACIER_IR
|
9305
9386
|
# newer_noncurrent_versions: 1,
|
9306
9387
|
# },
|
9307
9388
|
# noncurrent_version_expiration: {
|
@@ -9487,13 +9568,13 @@ module Aws::S3
|
|
9487
9568
|
# {
|
9488
9569
|
# date: Time.now,
|
9489
9570
|
# days: 1,
|
9490
|
-
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE
|
9571
|
+
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE, GLACIER_IR
|
9491
9572
|
# },
|
9492
9573
|
# ],
|
9493
9574
|
# noncurrent_version_transitions: [
|
9494
9575
|
# {
|
9495
9576
|
# noncurrent_days: 1,
|
9496
|
-
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE
|
9577
|
+
# storage_class: "GLACIER", # accepts GLACIER, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, DEEP_ARCHIVE, GLACIER_IR
|
9497
9578
|
# newer_noncurrent_versions: 1,
|
9498
9579
|
# },
|
9499
9580
|
# ],
|
@@ -9529,6 +9610,12 @@ module Aws::S3
|
|
9529
9610
|
# The `Permissions` request element specifies the kind of access the
|
9530
9611
|
# grantee has to the logs.
|
9531
9612
|
#
|
9613
|
+
# If the target bucket for log delivery uses the bucket owner enforced
|
9614
|
+
# setting for S3 Object Ownership, you can't use the `Grantee` request
|
9615
|
+
# element to grant access to others. Permissions can only be granted
|
9616
|
+
# using policies. For more information, see [Permissions for server
|
9617
|
+
# access log delivery][1] in the *Amazon S3 User Guide*.
|
9618
|
+
#
|
9532
9619
|
# **Grantee Values**
|
9533
9620
|
#
|
9534
9621
|
# You can specify the person (grantee) to whom you're assigning access
|
@@ -9563,29 +9650,30 @@ module Aws::S3
|
|
9563
9650
|
# />`
|
9564
9651
|
#
|
9565
9652
|
# For more information about server access logging, see [Server Access
|
9566
|
-
# Logging][
|
9653
|
+
# Logging][2] in the *Amazon S3 User Guide*.
|
9567
9654
|
#
|
9568
|
-
# For more information about creating a bucket, see [CreateBucket][
|
9655
|
+
# For more information about creating a bucket, see [CreateBucket][3].
|
9569
9656
|
# For more information about returning the logging status of a bucket,
|
9570
|
-
# see [GetBucketLogging][
|
9657
|
+
# see [GetBucketLogging][4].
|
9571
9658
|
#
|
9572
9659
|
# The following operations are related to `PutBucketLogging`\:
|
9573
9660
|
#
|
9574
|
-
# * [PutObject][
|
9661
|
+
# * [PutObject][5]
|
9575
9662
|
#
|
9576
|
-
# * [DeleteBucket][
|
9663
|
+
# * [DeleteBucket][6]
|
9577
9664
|
#
|
9578
|
-
# * [CreateBucket][
|
9665
|
+
# * [CreateBucket][3]
|
9579
9666
|
#
|
9580
|
-
# * [GetBucketLogging][
|
9667
|
+
# * [GetBucketLogging][4]
|
9581
9668
|
#
|
9582
9669
|
#
|
9583
9670
|
#
|
9584
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
9585
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
9586
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
9587
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
9588
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
9671
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general
|
9672
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerLogs.html
|
9673
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html
|
9674
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html
|
9675
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutObject.html
|
9676
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html
|
9589
9677
|
#
|
9590
9678
|
# @option params [required, String] :bucket
|
9591
9679
|
# The name of the bucket for which to set the logging parameters.
|
@@ -9800,20 +9888,20 @@ module Aws::S3
|
|
9800
9888
|
# notification_configuration: { # required
|
9801
9889
|
# topic_configuration: {
|
9802
9890
|
# id: "NotificationId",
|
9803
|
-
# events: ["s3:ReducedRedundancyLostObject"], # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
9804
|
-
# event: "s3:ReducedRedundancyLostObject", # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
9891
|
+
# events: ["s3:ReducedRedundancyLostObject"], # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9892
|
+
# event: "s3:ReducedRedundancyLostObject", # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9805
9893
|
# topic: "TopicArn",
|
9806
9894
|
# },
|
9807
9895
|
# queue_configuration: {
|
9808
9896
|
# id: "NotificationId",
|
9809
|
-
# event: "s3:ReducedRedundancyLostObject", # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
9810
|
-
# events: ["s3:ReducedRedundancyLostObject"], # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
9897
|
+
# event: "s3:ReducedRedundancyLostObject", # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9898
|
+
# events: ["s3:ReducedRedundancyLostObject"], # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9811
9899
|
# queue: "QueueArn",
|
9812
9900
|
# },
|
9813
9901
|
# cloud_function_configuration: {
|
9814
9902
|
# id: "NotificationId",
|
9815
|
-
# event: "s3:ReducedRedundancyLostObject", # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
9816
|
-
# events: ["s3:ReducedRedundancyLostObject"], # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
9903
|
+
# event: "s3:ReducedRedundancyLostObject", # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9904
|
+
# events: ["s3:ReducedRedundancyLostObject"], # accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9817
9905
|
# cloud_function: "CloudFunction",
|
9818
9906
|
# invocation_role: "CloudFunctionInvocationRole",
|
9819
9907
|
# },
|
@@ -9910,6 +9998,10 @@ module Aws::S3
|
|
9910
9998
|
# a different account, the request will fail with an HTTP `403 (Access
|
9911
9999
|
# Denied)` error.
|
9912
10000
|
#
|
10001
|
+
# @option params [Boolean] :skip_destination_validation
|
10002
|
+
# Skips validation of Amazon SQS, Amazon SNS, and Lambda destinations.
|
10003
|
+
# True or false value.
|
10004
|
+
#
|
9913
10005
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
9914
10006
|
#
|
9915
10007
|
#
|
@@ -9940,7 +10032,7 @@ module Aws::S3
|
|
9940
10032
|
# {
|
9941
10033
|
# id: "NotificationId",
|
9942
10034
|
# topic_arn: "TopicArn", # required
|
9943
|
-
# events: ["s3:ReducedRedundancyLostObject"], # required, accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
10035
|
+
# events: ["s3:ReducedRedundancyLostObject"], # required, accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9944
10036
|
# filter: {
|
9945
10037
|
# key: {
|
9946
10038
|
# filter_rules: [
|
@@ -9957,7 +10049,7 @@ module Aws::S3
|
|
9957
10049
|
# {
|
9958
10050
|
# id: "NotificationId",
|
9959
10051
|
# queue_arn: "QueueArn", # required
|
9960
|
-
# events: ["s3:ReducedRedundancyLostObject"], # required, accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
10052
|
+
# events: ["s3:ReducedRedundancyLostObject"], # required, accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9961
10053
|
# filter: {
|
9962
10054
|
# key: {
|
9963
10055
|
# filter_rules: [
|
@@ -9974,7 +10066,7 @@ module Aws::S3
|
|
9974
10066
|
# {
|
9975
10067
|
# id: "NotificationId",
|
9976
10068
|
# lambda_function_arn: "LambdaFunctionArn", # required
|
9977
|
-
# events: ["s3:ReducedRedundancyLostObject"], # required, accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold
|
10069
|
+
# events: ["s3:ReducedRedundancyLostObject"], # required, accepts s3:ReducedRedundancyLostObject, s3:ObjectCreated:*, s3:ObjectCreated:Put, s3:ObjectCreated:Post, s3:ObjectCreated:Copy, s3:ObjectCreated:CompleteMultipartUpload, s3:ObjectRemoved:*, s3:ObjectRemoved:Delete, s3:ObjectRemoved:DeleteMarkerCreated, s3:ObjectRestore:*, s3:ObjectRestore:Post, s3:ObjectRestore:Completed, s3:Replication:*, s3:Replication:OperationFailedReplication, s3:Replication:OperationNotTracked, s3:Replication:OperationMissedThreshold, s3:Replication:OperationReplicatedAfterThreshold, s3:ObjectRestore:Delete, s3:LifecycleTransition, s3:IntelligentTiering, s3:ObjectAcl:Put, s3:LifecycleExpiration:*, s3:LifecycleExpiration:Delete, s3:LifecycleExpiration:DeleteMarkerCreated, s3:ObjectTagging:*, s3:ObjectTagging:Put, s3:ObjectTagging:Delete
|
9978
10070
|
# filter: {
|
9979
10071
|
# key: {
|
9980
10072
|
# filter_rules: [
|
@@ -9987,8 +10079,11 @@ module Aws::S3
|
|
9987
10079
|
# },
|
9988
10080
|
# },
|
9989
10081
|
# ],
|
10082
|
+
# event_bridge_configuration: {
|
10083
|
+
# },
|
9990
10084
|
# },
|
9991
10085
|
# expected_bucket_owner: "AccountId",
|
10086
|
+
# skip_destination_validation: false,
|
9992
10087
|
# })
|
9993
10088
|
#
|
9994
10089
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotificationConfiguration AWS API Documentation
|
@@ -10003,10 +10098,10 @@ module Aws::S3
|
|
10003
10098
|
# Creates or modifies `OwnershipControls` for an Amazon S3 bucket. To
|
10004
10099
|
# use this operation, you must have the `s3:PutBucketOwnershipControls`
|
10005
10100
|
# permission. For more information about Amazon S3 permissions, see
|
10006
|
-
# [Specifying
|
10101
|
+
# [Specifying permissions in a policy][1].
|
10007
10102
|
#
|
10008
|
-
# For information about Amazon S3 Object Ownership, see [Using
|
10009
|
-
#
|
10103
|
+
# For information about Amazon S3 Object Ownership, see [Using object
|
10104
|
+
# ownership][2].
|
10010
10105
|
#
|
10011
10106
|
# The following operations are related to `PutBucketOwnershipControls`\:
|
10012
10107
|
#
|
@@ -10016,8 +10111,8 @@ module Aws::S3
|
|
10016
10111
|
#
|
10017
10112
|
#
|
10018
10113
|
#
|
10019
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10020
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10114
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/user-guide/using-with-s3-actions.html
|
10115
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/user-guide/about-object-ownership.html
|
10021
10116
|
#
|
10022
10117
|
# @option params [required, String] :bucket
|
10023
10118
|
# The name of the Amazon S3 bucket whose `OwnershipControls` you want to
|
@@ -10036,8 +10131,8 @@ module Aws::S3
|
|
10036
10131
|
# Denied)` error.
|
10037
10132
|
#
|
10038
10133
|
# @option params [required, Types::OwnershipControls] :ownership_controls
|
10039
|
-
# The `OwnershipControls` (BucketOwnerPreferred or
|
10040
|
-
# you want to apply to this Amazon S3 bucket.
|
10134
|
+
# The `OwnershipControls` (BucketOwnerEnforced, BucketOwnerPreferred, or
|
10135
|
+
# ObjectWriter) that you want to apply to this Amazon S3 bucket.
|
10041
10136
|
#
|
10042
10137
|
# @return [Struct] Returns an empty {Seahorse::Client::Response response}.
|
10043
10138
|
#
|
@@ -10050,7 +10145,7 @@ module Aws::S3
|
|
10050
10145
|
# ownership_controls: { # required
|
10051
10146
|
# rules: [ # required
|
10052
10147
|
# {
|
10053
|
-
# object_ownership: "BucketOwnerPreferred", # required, accepts BucketOwnerPreferred, ObjectWriter
|
10148
|
+
# object_ownership: "BucketOwnerPreferred", # required, accepts BucketOwnerPreferred, ObjectWriter, BucketOwnerEnforced
|
10054
10149
|
# },
|
10055
10150
|
# ],
|
10056
10151
|
# },
|
@@ -10323,7 +10418,7 @@ module Aws::S3
|
|
10323
10418
|
# destination: { # required
|
10324
10419
|
# bucket: "BucketName", # required
|
10325
10420
|
# account: "AccountId",
|
10326
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
10421
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
10327
10422
|
# access_control_translation: {
|
10328
10423
|
# owner: "Destination", # required, accepts Destination
|
10329
10424
|
# },
|
@@ -10912,13 +11007,33 @@ module Aws::S3
|
|
10912
11007
|
# information, see [Access Control List (ACL) Overview][4] and [Managing
|
10913
11008
|
# ACLs Using the REST API][5].
|
10914
11009
|
#
|
11010
|
+
# If the bucket that you're uploading objects to uses the bucket owner
|
11011
|
+
# enforced setting for S3 Object Ownership, ACLs are disabled and no
|
11012
|
+
# longer affect permissions. Buckets that use this setting only accept
|
11013
|
+
# PUT requests that don't specify an ACL or PUT requests that specify
|
11014
|
+
# bucket owner full control ACLs, such as the
|
11015
|
+
# `bucket-owner-full-control` canned ACL or an equivalent form of this
|
11016
|
+
# ACL expressed in the XML format. PUT requests that contain other ACLs
|
11017
|
+
# (for example, custom grants to certain Amazon Web Services accounts)
|
11018
|
+
# fail and return a `400` error with the error code
|
11019
|
+
# `AccessControlListNotSupported`.
|
11020
|
+
#
|
11021
|
+
# For more information, see [ Controlling ownership of objects and
|
11022
|
+
# disabling ACLs][6] in the *Amazon S3 User Guide*.
|
11023
|
+
#
|
11024
|
+
# <note markdown="1"> If your bucket uses the bucket owner enforced setting for Object
|
11025
|
+
# Ownership, all objects written to the bucket by any account will be
|
11026
|
+
# owned by the bucket owner.
|
11027
|
+
#
|
11028
|
+
# </note>
|
11029
|
+
#
|
10915
11030
|
# **Storage Class Options**
|
10916
11031
|
#
|
10917
11032
|
# By default, Amazon S3 uses the STANDARD Storage Class to store newly
|
10918
11033
|
# created objects. The STANDARD storage class provides high durability
|
10919
11034
|
# and high availability. Depending on performance needs, you can specify
|
10920
11035
|
# a different Storage Class. Amazon S3 on Outposts only uses the
|
10921
|
-
# OUTPOSTS Storage Class. For more information, see [Storage Classes][
|
11036
|
+
# OUTPOSTS Storage Class. For more information, see [Storage Classes][7]
|
10922
11037
|
# in the *Amazon S3 User Guide*.
|
10923
11038
|
#
|
10924
11039
|
# **Versioning**
|
@@ -10930,14 +11045,14 @@ module Aws::S3
|
|
10930
11045
|
# object simultaneously, it stores all of the objects.
|
10931
11046
|
#
|
10932
11047
|
# For more information about versioning, see [Adding Objects to
|
10933
|
-
# Versioning Enabled Buckets][
|
10934
|
-
# versioning state of a bucket, see [GetBucketVersioning][
|
11048
|
+
# Versioning Enabled Buckets][8]. For information about returning the
|
11049
|
+
# versioning state of a bucket, see [GetBucketVersioning][9].
|
10935
11050
|
#
|
10936
11051
|
# **Related Resources**
|
10937
11052
|
#
|
10938
|
-
# * [CopyObject][
|
11053
|
+
# * [CopyObject][10]
|
10939
11054
|
#
|
10940
|
-
# * [DeleteObject][
|
11055
|
+
# * [DeleteObject][11]
|
10941
11056
|
#
|
10942
11057
|
#
|
10943
11058
|
#
|
@@ -10946,11 +11061,12 @@ module Aws::S3
|
|
10946
11061
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html
|
10947
11062
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
10948
11063
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-using-rest-api.html
|
10949
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10950
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
10951
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/
|
10952
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
10953
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
11064
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
11065
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
|
11066
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html
|
11067
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html
|
11068
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
11069
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteObject.html
|
10954
11070
|
#
|
10955
11071
|
# @option params [String] :acl
|
10956
11072
|
# The canned ACL to apply to the object. For more information, see
|
@@ -11220,6 +11336,26 @@ module Aws::S3
|
|
11220
11336
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
11221
11337
|
#
|
11222
11338
|
#
|
11339
|
+
# @example Example: To upload an object (specify optional headers)
|
11340
|
+
#
|
11341
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
11342
|
+
# # storage class and use server-side encryption.
|
11343
|
+
#
|
11344
|
+
# resp = client.put_object({
|
11345
|
+
# body: "HappyFace.jpg",
|
11346
|
+
# bucket: "examplebucket",
|
11347
|
+
# key: "HappyFace.jpg",
|
11348
|
+
# server_side_encryption: "AES256",
|
11349
|
+
# storage_class: "STANDARD_IA",
|
11350
|
+
# })
|
11351
|
+
#
|
11352
|
+
# resp.to_h outputs the following:
|
11353
|
+
# {
|
11354
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11355
|
+
# server_side_encryption: "AES256",
|
11356
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
11357
|
+
# }
|
11358
|
+
#
|
11223
11359
|
# @example Example: To upload an object and specify server-side encryption and object tags
|
11224
11360
|
#
|
11225
11361
|
# # The following example uploads and object. The request specifies the optional server-side encryption option. The request
|
@@ -11240,22 +11376,20 @@ module Aws::S3
|
|
11240
11376
|
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
11241
11377
|
# }
|
11242
11378
|
#
|
11243
|
-
# @example Example: To
|
11379
|
+
# @example Example: To create an object.
|
11244
11380
|
#
|
11245
|
-
# # The following example
|
11246
|
-
# # S3 returns version ID of the newly created object.
|
11381
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
11247
11382
|
#
|
11248
11383
|
# resp = client.put_object({
|
11249
|
-
# body: "
|
11384
|
+
# body: "filetoupload",
|
11250
11385
|
# bucket: "examplebucket",
|
11251
|
-
# key: "
|
11252
|
-
# tagging: "key1=value1&key2=value2",
|
11386
|
+
# key: "objectkey",
|
11253
11387
|
# })
|
11254
11388
|
#
|
11255
11389
|
# resp.to_h outputs the following:
|
11256
11390
|
# {
|
11257
11391
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11258
|
-
# version_id: "
|
11392
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
11259
11393
|
# }
|
11260
11394
|
#
|
11261
11395
|
# @example Example: To upload object and specify user-defined metadata
|
@@ -11279,22 +11413,6 @@ module Aws::S3
|
|
11279
11413
|
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
11280
11414
|
# }
|
11281
11415
|
#
|
11282
|
-
# @example Example: To create an object.
|
11283
|
-
#
|
11284
|
-
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
11285
|
-
#
|
11286
|
-
# resp = client.put_object({
|
11287
|
-
# body: "filetoupload",
|
11288
|
-
# bucket: "examplebucket",
|
11289
|
-
# key: "objectkey",
|
11290
|
-
# })
|
11291
|
-
#
|
11292
|
-
# resp.to_h outputs the following:
|
11293
|
-
# {
|
11294
|
-
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11295
|
-
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
11296
|
-
# }
|
11297
|
-
#
|
11298
11416
|
# @example Example: To upload an object and specify canned ACL.
|
11299
11417
|
#
|
11300
11418
|
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
@@ -11313,41 +11431,39 @@ module Aws::S3
|
|
11313
11431
|
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
11314
11432
|
# }
|
11315
11433
|
#
|
11316
|
-
# @example Example: To upload an object
|
11434
|
+
# @example Example: To upload an object
|
11317
11435
|
#
|
11318
|
-
# # The following example uploads an object
|
11319
|
-
# #
|
11436
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
11437
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
11320
11438
|
#
|
11321
11439
|
# resp = client.put_object({
|
11322
11440
|
# body: "HappyFace.jpg",
|
11323
11441
|
# bucket: "examplebucket",
|
11324
11442
|
# key: "HappyFace.jpg",
|
11325
|
-
# server_side_encryption: "AES256",
|
11326
|
-
# storage_class: "STANDARD_IA",
|
11327
11443
|
# })
|
11328
11444
|
#
|
11329
11445
|
# resp.to_h outputs the following:
|
11330
11446
|
# {
|
11331
11447
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11332
|
-
#
|
11333
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
11448
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
11334
11449
|
# }
|
11335
11450
|
#
|
11336
|
-
# @example Example: To upload an object
|
11451
|
+
# @example Example: To upload an object and specify optional tags
|
11337
11452
|
#
|
11338
|
-
# # The following example uploads an object
|
11339
|
-
# #
|
11453
|
+
# # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
|
11454
|
+
# # S3 returns version ID of the newly created object.
|
11340
11455
|
#
|
11341
11456
|
# resp = client.put_object({
|
11342
|
-
# body: "HappyFace.jpg",
|
11457
|
+
# body: "c:\\HappyFace.jpg",
|
11343
11458
|
# bucket: "examplebucket",
|
11344
11459
|
# key: "HappyFace.jpg",
|
11460
|
+
# tagging: "key1=value1&key2=value2",
|
11345
11461
|
# })
|
11346
11462
|
#
|
11347
11463
|
# resp.to_h outputs the following:
|
11348
11464
|
# {
|
11349
11465
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11350
|
-
# version_id: "
|
11466
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
11351
11467
|
# }
|
11352
11468
|
#
|
11353
11469
|
# @example Streaming a file from disk
|
@@ -11379,7 +11495,7 @@ module Aws::S3
|
|
11379
11495
|
# "MetadataKey" => "MetadataValue",
|
11380
11496
|
# },
|
11381
11497
|
# server_side_encryption: "AES256", # accepts AES256, aws:kms
|
11382
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
11498
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
11383
11499
|
# website_redirect_location: "WebsiteRedirectLocation",
|
11384
11500
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
11385
11501
|
# sse_customer_key: "SSECustomerKey",
|
@@ -11432,6 +11548,14 @@ module Aws::S3
|
|
11432
11548
|
# information, see [Access Control List (ACL) Overview][2] in the
|
11433
11549
|
# *Amazon S3 User Guide*.
|
11434
11550
|
#
|
11551
|
+
# If your bucket uses the bucket owner enforced setting for S3 Object
|
11552
|
+
# Ownership, ACLs are disabled and no longer affect permissions. You
|
11553
|
+
# must use policies to grant access to your bucket and the objects in
|
11554
|
+
# it. Requests to set ACLs or update ACLs fail and return the
|
11555
|
+
# `AccessControlListNotSupported` error code. Requests to read ACLs are
|
11556
|
+
# still supported. For more information, see [Controlling object
|
11557
|
+
# ownership][3] in the *Amazon S3 User Guide*.
|
11558
|
+
#
|
11435
11559
|
# **Access Permissions**
|
11436
11560
|
#
|
11437
11561
|
# You can set access permissions using one of the following methods:
|
@@ -11441,7 +11565,7 @@ module Aws::S3
|
|
11441
11565
|
# ACL has a predefined set of grantees and permissions. Specify the
|
11442
11566
|
# canned ACL name as the value of `x-amz-ac`l. If you use this header,
|
11443
11567
|
# you cannot use other access control-specific headers in your
|
11444
|
-
# request. For more information, see [Canned ACL][
|
11568
|
+
# request. For more information, see [Canned ACL][4].
|
11445
11569
|
#
|
11446
11570
|
# * Specify access permissions explicitly with the `x-amz-grant-read`,
|
11447
11571
|
# `x-amz-grant-read-acp`, `x-amz-grant-write-acp`, and
|
@@ -11484,7 +11608,7 @@ module Aws::S3
|
|
11484
11608
|
# * South America (São Paulo)
|
11485
11609
|
#
|
11486
11610
|
# For a list of all the Amazon S3 supported Regions and endpoints,
|
11487
|
-
# see [Regions and Endpoints][
|
11611
|
+
# see [Regions and Endpoints][5] in the Amazon Web Services General
|
11488
11612
|
# Reference.
|
11489
11613
|
#
|
11490
11614
|
# </note>
|
@@ -11545,7 +11669,7 @@ module Aws::S3
|
|
11545
11669
|
# * South America (São Paulo)
|
11546
11670
|
#
|
11547
11671
|
# For a list of all the Amazon S3 supported Regions and endpoints, see
|
11548
|
-
# [Regions and Endpoints][
|
11672
|
+
# [Regions and Endpoints][5] in the Amazon Web Services General
|
11549
11673
|
# Reference.
|
11550
11674
|
#
|
11551
11675
|
# </note>
|
@@ -11558,18 +11682,19 @@ module Aws::S3
|
|
11558
11682
|
#
|
11559
11683
|
# **Related Resources**
|
11560
11684
|
#
|
11561
|
-
# * [CopyObject][
|
11685
|
+
# * [CopyObject][6]
|
11562
11686
|
#
|
11563
|
-
# * [GetObject][
|
11687
|
+
# * [GetObject][7]
|
11564
11688
|
#
|
11565
11689
|
#
|
11566
11690
|
#
|
11567
11691
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#permissions
|
11568
11692
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html
|
11569
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
11570
|
-
# [4]: https://docs.aws.amazon.com/
|
11571
|
-
# [5]: https://docs.aws.amazon.com/
|
11572
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
11693
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html
|
11694
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
|
11695
|
+
# [5]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
|
11696
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CopyObject.html
|
11697
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
11573
11698
|
#
|
11574
11699
|
# @option params [String] :acl
|
11575
11700
|
# The canned ACL to apply to the object. For more information, see
|
@@ -12703,7 +12828,7 @@ module Aws::S3
|
|
12703
12828
|
# value: "MetadataValue",
|
12704
12829
|
# },
|
12705
12830
|
# ],
|
12706
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
12831
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
12707
12832
|
# },
|
12708
12833
|
# },
|
12709
12834
|
# },
|
@@ -12736,10 +12861,11 @@ module Aws::S3
|
|
12736
12861
|
# This action is not supported by Amazon S3 on Outposts.
|
12737
12862
|
#
|
12738
12863
|
# For more information about Amazon S3 Select, see [Selecting Content
|
12739
|
-
# from Objects][1] in the *Amazon S3 User
|
12864
|
+
# from Objects][1] and [SELECT Command][2] in the *Amazon S3 User
|
12865
|
+
# Guide*.
|
12740
12866
|
#
|
12741
12867
|
# For more information about using SQL with Amazon S3 Select, see [ SQL
|
12742
|
-
# Reference for Amazon S3 Select and S3 Glacier Select][
|
12868
|
+
# Reference for Amazon S3 Select and S3 Glacier Select][3] in the
|
12743
12869
|
# *Amazon S3 User Guide*.
|
12744
12870
|
#
|
12745
12871
|
#
|
@@ -12748,7 +12874,7 @@ module Aws::S3
|
|
12748
12874
|
#
|
12749
12875
|
# You must have `s3:GetObject` permission for this operation. Amazon S3
|
12750
12876
|
# Select does not support anonymous access. For more information about
|
12751
|
-
# permissions, see [Specifying Permissions in a Policy][
|
12877
|
+
# permissions, see [Specifying Permissions in a Policy][4] in the
|
12752
12878
|
# *Amazon S3 User Guide*.
|
12753
12879
|
#
|
12754
12880
|
#
|
@@ -12775,70 +12901,71 @@ module Aws::S3
|
|
12775
12901
|
#
|
12776
12902
|
# For objects that are encrypted with customer-provided encryption
|
12777
12903
|
# keys (SSE-C), you must use HTTPS, and you must use the headers that
|
12778
|
-
# are documented in the [GetObject][
|
12904
|
+
# are documented in the [GetObject][5]. For more information about
|
12779
12905
|
# SSE-C, see [Server-Side Encryption (Using Customer-Provided
|
12780
|
-
# Encryption Keys)][
|
12906
|
+
# Encryption Keys)][6] in the *Amazon S3 User Guide*.
|
12781
12907
|
#
|
12782
12908
|
# For objects that are encrypted with Amazon S3 managed encryption
|
12783
12909
|
# keys (SSE-S3) and Amazon Web Services KMS keys (SSE-KMS),
|
12784
12910
|
# server-side encryption is handled transparently, so you don't need
|
12785
12911
|
# to specify anything. For more information about server-side
|
12786
12912
|
# encryption, including SSE-S3 and SSE-KMS, see [Protecting Data Using
|
12787
|
-
# Server-Side Encryption][
|
12913
|
+
# Server-Side Encryption][7] in the *Amazon S3 User Guide*.
|
12788
12914
|
#
|
12789
12915
|
# **Working with the Response Body**
|
12790
12916
|
#
|
12791
12917
|
# Given the response size is unknown, Amazon S3 Select streams the
|
12792
12918
|
# response as a series of messages and includes a `Transfer-Encoding`
|
12793
12919
|
# header with `chunked` as its value in the response. For more
|
12794
|
-
# information, see [Appendix: SelectObjectContent Response][
|
12920
|
+
# information, see [Appendix: SelectObjectContent Response][8].
|
12795
12921
|
#
|
12796
12922
|
#
|
12797
12923
|
#
|
12798
12924
|
# **GetObject Support**
|
12799
12925
|
#
|
12800
12926
|
# The `SelectObjectContent` action does not support the following
|
12801
|
-
# `GetObject` functionality. For more information, see [GetObject][
|
12927
|
+
# `GetObject` functionality. For more information, see [GetObject][5].
|
12802
12928
|
#
|
12803
12929
|
# * `Range`\: Although you can specify a scan range for an Amazon S3
|
12804
|
-
# Select request (see [SelectObjectContentRequest - ScanRange][
|
12930
|
+
# Select request (see [SelectObjectContentRequest - ScanRange][9] in
|
12805
12931
|
# the request parameters), you cannot specify the range of bytes of an
|
12806
12932
|
# object to return.
|
12807
12933
|
#
|
12808
12934
|
# * GLACIER, DEEP\_ARCHIVE and REDUCED\_REDUNDANCY storage classes: You
|
12809
12935
|
# cannot specify the GLACIER, DEEP\_ARCHIVE, or `REDUCED_REDUNDANCY`
|
12810
12936
|
# storage classes. For more information, about storage classes see
|
12811
|
-
# [Storage Classes][
|
12937
|
+
# [Storage Classes][10] in the *Amazon S3 User Guide*.
|
12812
12938
|
#
|
12813
12939
|
#
|
12814
12940
|
#
|
12815
12941
|
# **Special Errors**
|
12816
12942
|
#
|
12817
12943
|
# For a list of special errors for this operation, see [List of SELECT
|
12818
|
-
# Object Content Error Codes][
|
12944
|
+
# Object Content Error Codes][11]
|
12819
12945
|
#
|
12820
12946
|
# **Related Resources**
|
12821
12947
|
#
|
12822
|
-
# * [GetObject][
|
12948
|
+
# * [GetObject][5]
|
12823
12949
|
#
|
12824
|
-
# * [GetBucketLifecycleConfiguration][
|
12950
|
+
# * [GetBucketLifecycleConfiguration][12]
|
12825
12951
|
#
|
12826
|
-
# * [PutBucketLifecycleConfiguration][
|
12952
|
+
# * [PutBucketLifecycleConfiguration][13]
|
12827
12953
|
#
|
12828
12954
|
#
|
12829
12955
|
#
|
12830
12956
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/selecting-content-from-objects.html
|
12831
|
-
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12832
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
12833
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12834
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12835
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
12836
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12837
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12838
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12839
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/
|
12840
|
-
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12841
|
-
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
12957
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-glacier-select-sql-reference-select.html
|
12958
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/s3-glacier-select-sql-reference.html
|
12959
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html
|
12960
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObject.html
|
12961
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html
|
12962
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/serv-side-encryption.html
|
12963
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTSelectObjectAppendix.html
|
12964
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_SelectObjectContent.html#AmazonS3-SelectObjectContent-request-ScanRange
|
12965
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingMetadata.html#storage-class-intro
|
12966
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#SelectObjectContentErrorCodeList
|
12967
|
+
# [12]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLifecycleConfiguration.html
|
12968
|
+
# [13]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycleConfiguration.html
|
12842
12969
|
#
|
12843
12970
|
# @option params [required, String] :bucket
|
12844
12971
|
# The S3 bucket.
|
@@ -13691,45 +13818,45 @@ module Aws::S3
|
|
13691
13818
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
13692
13819
|
#
|
13693
13820
|
#
|
13694
|
-
# @example Example: To upload a part by copying
|
13821
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
13695
13822
|
#
|
13696
|
-
# # The following example uploads a part of a multipart upload by copying
|
13823
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
13824
|
+
# # data source.
|
13697
13825
|
#
|
13698
13826
|
# resp = client.upload_part_copy({
|
13699
13827
|
# bucket: "examplebucket",
|
13700
13828
|
# copy_source: "/bucketname/sourceobjectkey",
|
13829
|
+
# copy_source_range: "bytes=1-100000",
|
13701
13830
|
# key: "examplelargeobject",
|
13702
|
-
# part_number:
|
13831
|
+
# part_number: 2,
|
13703
13832
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
13704
13833
|
# })
|
13705
13834
|
#
|
13706
13835
|
# resp.to_h outputs the following:
|
13707
13836
|
# {
|
13708
13837
|
# copy_part_result: {
|
13709
|
-
# etag: "\"
|
13710
|
-
# last_modified: Time.parse("2016-12-29T21:
|
13838
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
13839
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
13711
13840
|
# },
|
13712
13841
|
# }
|
13713
13842
|
#
|
13714
|
-
# @example Example: To upload a part by copying
|
13843
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
13715
13844
|
#
|
13716
|
-
# # The following example uploads a part of a multipart upload by copying
|
13717
|
-
# # data source.
|
13845
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
13718
13846
|
#
|
13719
13847
|
# resp = client.upload_part_copy({
|
13720
13848
|
# bucket: "examplebucket",
|
13721
13849
|
# copy_source: "/bucketname/sourceobjectkey",
|
13722
|
-
# copy_source_range: "bytes=1-100000",
|
13723
13850
|
# key: "examplelargeobject",
|
13724
|
-
# part_number:
|
13851
|
+
# part_number: 1,
|
13725
13852
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
13726
13853
|
# })
|
13727
13854
|
#
|
13728
13855
|
# resp.to_h outputs the following:
|
13729
13856
|
# {
|
13730
13857
|
# copy_part_result: {
|
13731
|
-
# etag: "\"
|
13732
|
-
# last_modified: Time.parse("2016-12-29T21:
|
13858
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
13859
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
13733
13860
|
# },
|
13734
13861
|
# }
|
13735
13862
|
#
|
@@ -14061,7 +14188,7 @@ module Aws::S3
|
|
14061
14188
|
# sse_customer_algorithm: "SSECustomerAlgorithm",
|
14062
14189
|
# ssekms_key_id: "SSEKMSKeyId",
|
14063
14190
|
# sse_customer_key_md5: "SSECustomerKeyMD5",
|
14064
|
-
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS
|
14191
|
+
# storage_class: "STANDARD", # accepts STANDARD, REDUCED_REDUNDANCY, STANDARD_IA, ONEZONE_IA, INTELLIGENT_TIERING, GLACIER, DEEP_ARCHIVE, OUTPOSTS, GLACIER_IR
|
14065
14192
|
# tag_count: 1,
|
14066
14193
|
# version_id: "ObjectVersionId",
|
14067
14194
|
# bucket_key_enabled: false,
|
@@ -14089,7 +14216,7 @@ module Aws::S3
|
|
14089
14216
|
params: params,
|
14090
14217
|
config: config)
|
14091
14218
|
context[:gem_name] = 'aws-sdk-s3'
|
14092
|
-
context[:gem_version] = '1.
|
14219
|
+
context[:gem_version] = '1.111.0'
|
14093
14220
|
Seahorse::Client::Request.new(handlers, context)
|
14094
14221
|
end
|
14095
14222
|
|