aws-sdk-s3 1.100.0 → 1.104.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/arn/multi_region_access_point_arn.rb +69 -0
- data/lib/aws-sdk-s3/bucket.rb +5 -5
- data/lib/aws-sdk-s3/client.rb +281 -267
- data/lib/aws-sdk-s3/client_api.rb +3 -0
- data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +0 -4
- data/lib/aws-sdk-s3/object.rb +18 -18
- data/lib/aws-sdk-s3/object_summary.rb +12 -12
- data/lib/aws-sdk-s3/plugins/arn.rb +51 -12
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +10 -1
- data/lib/aws-sdk-s3/presigner.rb +6 -0
- data/lib/aws-sdk-s3/types.rb +78 -57
- data/lib/aws-sdk-s3.rb +1 -1
- metadata +8 -7
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -327,6 +327,11 @@ module Aws::S3
|
|
327
327
|
# in the future.
|
328
328
|
#
|
329
329
|
#
|
330
|
+
# @option options [Boolean] :s3_disable_multiregion_access_points (false)
|
331
|
+
# When set to `false` this will option will raise errors when multi-region
|
332
|
+
# access point ARNs are used. Multi-region access points can potentially
|
333
|
+
# result in cross region requests.
|
334
|
+
#
|
330
335
|
# @option options [String] :s3_us_east_1_regional_endpoint ("legacy")
|
331
336
|
# Pass in `regional` to enable the `us-east-1` regional endpoint.
|
332
337
|
# Defaults to `legacy` mode which uses the global endpoint.
|
@@ -1460,33 +1465,33 @@ module Aws::S3
|
|
1460
1465
|
# * {Types::CreateBucketOutput#location #location} => String
|
1461
1466
|
#
|
1462
1467
|
#
|
1463
|
-
# @example Example: To create a bucket
|
1468
|
+
# @example Example: To create a bucket
|
1464
1469
|
#
|
1465
|
-
# # The following example creates a bucket.
|
1470
|
+
# # The following example creates a bucket.
|
1466
1471
|
#
|
1467
1472
|
# resp = client.create_bucket({
|
1468
1473
|
# bucket: "examplebucket",
|
1469
|
-
# create_bucket_configuration: {
|
1470
|
-
# location_constraint: "eu-west-1",
|
1471
|
-
# },
|
1472
1474
|
# })
|
1473
1475
|
#
|
1474
1476
|
# resp.to_h outputs the following:
|
1475
1477
|
# {
|
1476
|
-
# location: "
|
1478
|
+
# location: "/examplebucket",
|
1477
1479
|
# }
|
1478
1480
|
#
|
1479
|
-
# @example Example: To create a bucket
|
1481
|
+
# @example Example: To create a bucket in a specific region
|
1480
1482
|
#
|
1481
|
-
# # The following example creates a bucket.
|
1483
|
+
# # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
|
1482
1484
|
#
|
1483
1485
|
# resp = client.create_bucket({
|
1484
1486
|
# bucket: "examplebucket",
|
1487
|
+
# create_bucket_configuration: {
|
1488
|
+
# location_constraint: "eu-west-1",
|
1489
|
+
# },
|
1485
1490
|
# })
|
1486
1491
|
#
|
1487
1492
|
# resp.to_h outputs the following:
|
1488
1493
|
# {
|
1489
|
-
# location: "/
|
1494
|
+
# location: "http://examplebucket.<Region>.s3.amazonaws.com/",
|
1490
1495
|
# }
|
1491
1496
|
#
|
1492
1497
|
# @example Request syntax with placeholder values
|
@@ -1557,15 +1562,14 @@ module Aws::S3
|
|
1557
1562
|
# You can optionally request server-side encryption. For server-side
|
1558
1563
|
# encryption, Amazon S3 encrypts your data as it writes it to disks in
|
1559
1564
|
# its data centers and decrypts it when you access it. You can provide
|
1560
|
-
# your own encryption key, or use Amazon Web Services
|
1561
|
-
#
|
1562
|
-
# Amazon S3-managed encryption keys. If you choose to provide your own
|
1565
|
+
# your own encryption key, or use Amazon Web Services KMS keys or Amazon
|
1566
|
+
# S3-managed encryption keys. If you choose to provide your own
|
1563
1567
|
# encryption key, the request headers you provide in [UploadPart][1] and
|
1564
1568
|
# [UploadPartCopy][6] requests must match the headers you used in the
|
1565
1569
|
# request to initiate the upload by using `CreateMultipartUpload`.
|
1566
1570
|
#
|
1567
1571
|
# To perform a multipart upload with encryption using an Amazon Web
|
1568
|
-
# Services KMS
|
1572
|
+
# Services KMS key, the requester must have permission to the
|
1569
1573
|
# `kms:Decrypt` and `kms:GenerateDataKey*` actions on the key. These
|
1570
1574
|
# permissions are required because Amazon S3 must decrypt and read data
|
1571
1575
|
# from the encrypted file parts before it completes the multipart
|
@@ -1573,11 +1577,10 @@ module Aws::S3
|
|
1573
1577
|
# permissions][7] in the *Amazon S3 User Guide*.
|
1574
1578
|
#
|
1575
1579
|
# If your Identity and Access Management (IAM) user or role is in the
|
1576
|
-
# same Amazon Web Services account as the
|
1577
|
-
#
|
1578
|
-
#
|
1579
|
-
#
|
1580
|
-
# role.
|
1580
|
+
# same Amazon Web Services account as the KMS key, then you must have
|
1581
|
+
# these permissions on the key policy. If your IAM user or role belongs
|
1582
|
+
# to a different account than the key, then you must have the
|
1583
|
+
# permissions on both the key policy and your IAM user or role.
|
1581
1584
|
#
|
1582
1585
|
# For more information, see [Protecting Data Using Server-Side
|
1583
1586
|
# Encryption][8].
|
@@ -1610,11 +1613,11 @@ module Aws::S3
|
|
1610
1613
|
# option you use depends on whether you want to use Amazon Web
|
1611
1614
|
# Services managed encryption keys or provide your own encryption key.
|
1612
1615
|
#
|
1613
|
-
# * Use encryption keys managed by Amazon S3 or customer
|
1614
|
-
#
|
1615
|
-
#
|
1616
|
-
#
|
1617
|
-
#
|
1616
|
+
# * Use encryption keys managed by Amazon S3 or customer managed key
|
1617
|
+
# stored in Amazon Web Services Key Management Service (Amazon Web
|
1618
|
+
# Services KMS) – If you want Amazon Web Services to manage the keys
|
1619
|
+
# used to encrypt data, specify the following headers in the
|
1620
|
+
# request.
|
1618
1621
|
#
|
1619
1622
|
# * x-amz-server-side-encryption
|
1620
1623
|
#
|
@@ -1624,7 +1627,7 @@ module Aws::S3
|
|
1624
1627
|
#
|
1625
1628
|
# <note markdown="1"> If you specify `x-amz-server-side-encryption:aws:kms`, but don't
|
1626
1629
|
# provide `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3
|
1627
|
-
# uses the Amazon Web Services managed
|
1630
|
+
# uses the Amazon Web Services managed key in Amazon Web Services
|
1628
1631
|
# KMS to protect the data.
|
1629
1632
|
#
|
1630
1633
|
# </note>
|
@@ -1633,10 +1636,9 @@ module Aws::S3
|
|
1633
1636
|
# Services KMS fail if you don't make them with SSL or by using
|
1634
1637
|
# SigV4.
|
1635
1638
|
#
|
1636
|
-
# For more information about server-side encryption with
|
1637
|
-
#
|
1638
|
-
#
|
1639
|
-
# KMS][11].
|
1639
|
+
# For more information about server-side encryption with KMS key
|
1640
|
+
# (SSE-KMS), see [Protecting Data Using Server-Side Encryption with
|
1641
|
+
# KMS keys][11].
|
1640
1642
|
#
|
1641
1643
|
# * Use customer-provided encryption keys – If you want to manage your
|
1642
1644
|
# own encryption keys, provide all the following headers in the
|
@@ -1648,10 +1650,9 @@ module Aws::S3
|
|
1648
1650
|
#
|
1649
1651
|
# * x-amz-server-side-encryption-customer-key-MD5
|
1650
1652
|
#
|
1651
|
-
# For more information about server-side encryption with
|
1652
|
-
#
|
1653
|
-
#
|
1654
|
-
# KMS][11].
|
1653
|
+
# For more information about server-side encryption with KMS keys
|
1654
|
+
# (SSE-KMS), see [Protecting Data Using Server-Side Encryption with
|
1655
|
+
# KMS keys][11].
|
1655
1656
|
#
|
1656
1657
|
# Access-Control-List (ACL)-Specific Request Headers
|
1657
1658
|
#
|
@@ -1876,13 +1877,13 @@ module Aws::S3
|
|
1876
1877
|
# ensure that the encryption key was transmitted without error.
|
1877
1878
|
#
|
1878
1879
|
# @option params [String] :ssekms_key_id
|
1879
|
-
# Specifies the ID of the symmetric customer managed
|
1880
|
-
#
|
1881
|
-
#
|
1882
|
-
#
|
1883
|
-
#
|
1884
|
-
#
|
1885
|
-
#
|
1880
|
+
# Specifies the ID of the symmetric customer managed key to use for
|
1881
|
+
# object encryption. All GET and PUT requests for an object protected by
|
1882
|
+
# Amazon Web Services KMS will fail if not made via SSL or using SigV4.
|
1883
|
+
# For information about configuring using any of the officially
|
1884
|
+
# supported Amazon Web Services SDKs and Amazon Web Services CLI, see
|
1885
|
+
# [Specifying the Signature Version in Request Authentication][1] in the
|
1886
|
+
# *Amazon S3 User Guide*.
|
1886
1887
|
#
|
1887
1888
|
#
|
1888
1889
|
#
|
@@ -2252,21 +2253,23 @@ module Aws::S3
|
|
2252
2253
|
#
|
2253
2254
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
2254
2255
|
# storage costs by automatically moving data to the most cost-effective
|
2255
|
-
# storage access tier, without
|
2256
|
-
# Intelligent-Tiering delivers automatic cost savings
|
2257
|
-
#
|
2258
|
-
#
|
2259
|
-
#
|
2260
|
-
#
|
2261
|
-
#
|
2262
|
-
#
|
2263
|
-
#
|
2264
|
-
#
|
2265
|
-
#
|
2266
|
-
#
|
2267
|
-
#
|
2268
|
-
#
|
2269
|
-
#
|
2256
|
+
# storage access tier, without performance impact or operational
|
2257
|
+
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
2258
|
+
# two low latency and high throughput access tiers. For data that can be
|
2259
|
+
# accessed asynchronously, you can choose to activate automatic
|
2260
|
+
# archiving capabilities within the S3 Intelligent-Tiering storage
|
2261
|
+
# class.
|
2262
|
+
#
|
2263
|
+
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
2264
|
+
# for data with unknown, changing, or unpredictable access patterns,
|
2265
|
+
# independent of object size or retention period. If the size of an
|
2266
|
+
# object is less than 128 KB, it is not eligible for auto-tiering.
|
2267
|
+
# Smaller objects can be stored, but they are always charged at the
|
2268
|
+
# Frequent Access tier rates in the S3 Intelligent-Tiering storage
|
2269
|
+
# class.
|
2270
|
+
#
|
2271
|
+
# For more information, see [Storage class for automatically optimizing
|
2272
|
+
# frequently and infrequently accessed objects][1].
|
2270
2273
|
#
|
2271
2274
|
# Operations related to `DeleteBucketIntelligentTieringConfiguration`
|
2272
2275
|
# include:
|
@@ -3716,21 +3719,23 @@ module Aws::S3
|
|
3716
3719
|
#
|
3717
3720
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
3718
3721
|
# storage costs by automatically moving data to the most cost-effective
|
3719
|
-
# storage access tier, without
|
3720
|
-
# Intelligent-Tiering delivers automatic cost savings
|
3721
|
-
#
|
3722
|
-
#
|
3723
|
-
#
|
3724
|
-
#
|
3725
|
-
#
|
3726
|
-
#
|
3727
|
-
#
|
3728
|
-
#
|
3729
|
-
#
|
3730
|
-
#
|
3731
|
-
#
|
3732
|
-
#
|
3733
|
-
#
|
3722
|
+
# storage access tier, without performance impact or operational
|
3723
|
+
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
3724
|
+
# two low latency and high throughput access tiers. For data that can be
|
3725
|
+
# accessed asynchronously, you can choose to activate automatic
|
3726
|
+
# archiving capabilities within the S3 Intelligent-Tiering storage
|
3727
|
+
# class.
|
3728
|
+
#
|
3729
|
+
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
3730
|
+
# for data with unknown, changing, or unpredictable access patterns,
|
3731
|
+
# independent of object size or retention period. If the size of an
|
3732
|
+
# object is less than 128 KB, it is not eligible for auto-tiering.
|
3733
|
+
# Smaller objects can be stored, but they are always charged at the
|
3734
|
+
# Frequent Access tier rates in the S3 Intelligent-Tiering storage
|
3735
|
+
# class.
|
3736
|
+
#
|
3737
|
+
# For more information, see [Storage class for automatically optimizing
|
3738
|
+
# frequently and infrequently accessed objects][1].
|
3734
3739
|
#
|
3735
3740
|
# Operations related to `GetBucketIntelligentTieringConfiguration`
|
3736
3741
|
# include:
|
@@ -4297,10 +4302,12 @@ module Aws::S3
|
|
4297
4302
|
# resp.metrics_configuration.filter.prefix #=> String
|
4298
4303
|
# resp.metrics_configuration.filter.tag.key #=> String
|
4299
4304
|
# resp.metrics_configuration.filter.tag.value #=> String
|
4305
|
+
# resp.metrics_configuration.filter.access_point_arn #=> String
|
4300
4306
|
# resp.metrics_configuration.filter.and.prefix #=> String
|
4301
4307
|
# resp.metrics_configuration.filter.and.tags #=> Array
|
4302
4308
|
# resp.metrics_configuration.filter.and.tags[0].key #=> String
|
4303
4309
|
# resp.metrics_configuration.filter.and.tags[0].value #=> String
|
4310
|
+
# resp.metrics_configuration.filter.and.access_point_arn #=> String
|
4304
4311
|
#
|
4305
4312
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetricsConfiguration AWS API Documentation
|
4306
4313
|
#
|
@@ -5158,10 +5165,9 @@ module Aws::S3
|
|
5158
5165
|
#
|
5159
5166
|
# Encryption request headers, like `x-amz-server-side-encryption`,
|
5160
5167
|
# should not be sent for GET requests if your object uses server-side
|
5161
|
-
# encryption with
|
5162
|
-
#
|
5163
|
-
#
|
5164
|
-
# HTTP 400 BadRequest error.
|
5168
|
+
# encryption with KMS keys (SSE-KMS) or server-side encryption with
|
5169
|
+
# Amazon S3–managed encryption keys (SSE-S3). If your object does use
|
5170
|
+
# these types of keys, you’ll get an HTTP 400 BadRequest error.
|
5165
5171
|
#
|
5166
5172
|
# If you encrypt an object by using server-side encryption with
|
5167
5173
|
# customer-provided encryption keys (SSE-C) when you store the object in
|
@@ -5296,6 +5302,9 @@ module Aws::S3
|
|
5296
5302
|
# name. For more information about access point ARNs, see [Using access
|
5297
5303
|
# points][1] in the *Amazon S3 User Guide*.
|
5298
5304
|
#
|
5305
|
+
# When using an Object Lambda access point the hostname takes the form
|
5306
|
+
# *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com.
|
5307
|
+
#
|
5299
5308
|
# When using this action with Amazon S3 on Outposts, you must direct
|
5300
5309
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
5301
5310
|
# takes the form
|
@@ -5439,49 +5448,49 @@ module Aws::S3
|
|
5439
5448
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
5440
5449
|
#
|
5441
5450
|
#
|
5442
|
-
# @example Example: To retrieve
|
5451
|
+
# @example Example: To retrieve an object
|
5443
5452
|
#
|
5444
|
-
# # The following example retrieves an object for an S3 bucket.
|
5445
|
-
# # specific byte range.
|
5453
|
+
# # The following example retrieves an object for an S3 bucket.
|
5446
5454
|
#
|
5447
5455
|
# resp = client.get_object({
|
5448
5456
|
# bucket: "examplebucket",
|
5449
|
-
# key: "
|
5450
|
-
# range: "bytes=0-9",
|
5457
|
+
# key: "HappyFace.jpg",
|
5451
5458
|
# })
|
5452
5459
|
#
|
5453
5460
|
# resp.to_h outputs the following:
|
5454
5461
|
# {
|
5455
5462
|
# accept_ranges: "bytes",
|
5456
|
-
# content_length:
|
5457
|
-
#
|
5458
|
-
#
|
5459
|
-
#
|
5460
|
-
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
5463
|
+
# content_length: 3191,
|
5464
|
+
# content_type: "image/jpeg",
|
5465
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
5466
|
+
# last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
|
5461
5467
|
# metadata: {
|
5462
5468
|
# },
|
5469
|
+
# tag_count: 2,
|
5463
5470
|
# version_id: "null",
|
5464
5471
|
# }
|
5465
5472
|
#
|
5466
|
-
# @example Example: To retrieve an object
|
5473
|
+
# @example Example: To retrieve a byte range of an object
|
5467
5474
|
#
|
5468
|
-
# # The following example retrieves an object for an S3 bucket.
|
5475
|
+
# # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
|
5476
|
+
# # specific byte range.
|
5469
5477
|
#
|
5470
5478
|
# resp = client.get_object({
|
5471
5479
|
# bucket: "examplebucket",
|
5472
|
-
# key: "
|
5480
|
+
# key: "SampleFile.txt",
|
5481
|
+
# range: "bytes=0-9",
|
5473
5482
|
# })
|
5474
5483
|
#
|
5475
5484
|
# resp.to_h outputs the following:
|
5476
5485
|
# {
|
5477
5486
|
# accept_ranges: "bytes",
|
5478
|
-
# content_length:
|
5479
|
-
#
|
5480
|
-
#
|
5481
|
-
#
|
5487
|
+
# content_length: 10,
|
5488
|
+
# content_range: "bytes 0-9/43",
|
5489
|
+
# content_type: "text/plain",
|
5490
|
+
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
5491
|
+
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
5482
5492
|
# metadata: {
|
5483
5493
|
# },
|
5484
|
-
# tag_count: 2,
|
5485
5494
|
# version_id: "null",
|
5486
5495
|
# }
|
5487
5496
|
#
|
@@ -6029,49 +6038,49 @@ module Aws::S3
|
|
6029
6038
|
# * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
|
6030
6039
|
#
|
6031
6040
|
#
|
6032
|
-
# @example Example: To retrieve tag set of
|
6041
|
+
# @example Example: To retrieve tag set of a specific object version
|
6033
6042
|
#
|
6034
|
-
# # The following example retrieves tag set of an object.
|
6043
|
+
# # The following example retrieves tag set of an object. The request specifies object version.
|
6035
6044
|
#
|
6036
6045
|
# resp = client.get_object_tagging({
|
6037
6046
|
# bucket: "examplebucket",
|
6038
|
-
# key: "
|
6047
|
+
# key: "exampleobject",
|
6048
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6039
6049
|
# })
|
6040
6050
|
#
|
6041
6051
|
# resp.to_h outputs the following:
|
6042
6052
|
# {
|
6043
6053
|
# tag_set: [
|
6044
6054
|
# {
|
6045
|
-
# key: "
|
6046
|
-
# value: "
|
6047
|
-
# },
|
6048
|
-
# {
|
6049
|
-
# key: "Key3",
|
6050
|
-
# value: "Value3",
|
6055
|
+
# key: "Key1",
|
6056
|
+
# value: "Value1",
|
6051
6057
|
# },
|
6052
6058
|
# ],
|
6053
|
-
# version_id: "
|
6059
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6054
6060
|
# }
|
6055
6061
|
#
|
6056
|
-
# @example Example: To retrieve tag set of
|
6062
|
+
# @example Example: To retrieve tag set of an object
|
6057
6063
|
#
|
6058
|
-
# # The following example retrieves tag set of an object.
|
6064
|
+
# # The following example retrieves tag set of an object.
|
6059
6065
|
#
|
6060
6066
|
# resp = client.get_object_tagging({
|
6061
6067
|
# bucket: "examplebucket",
|
6062
|
-
# key: "
|
6063
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6068
|
+
# key: "HappyFace.jpg",
|
6064
6069
|
# })
|
6065
6070
|
#
|
6066
6071
|
# resp.to_h outputs the following:
|
6067
6072
|
# {
|
6068
6073
|
# tag_set: [
|
6069
6074
|
# {
|
6070
|
-
# key: "
|
6071
|
-
# value: "
|
6075
|
+
# key: "Key4",
|
6076
|
+
# value: "Value4",
|
6077
|
+
# },
|
6078
|
+
# {
|
6079
|
+
# key: "Key3",
|
6080
|
+
# value: "Value3",
|
6072
6081
|
# },
|
6073
6082
|
# ],
|
6074
|
-
# version_id: "
|
6083
|
+
# version_id: "null",
|
6075
6084
|
# }
|
6076
6085
|
#
|
6077
6086
|
# @example Request syntax with placeholder values
|
@@ -6385,10 +6394,9 @@ module Aws::S3
|
|
6385
6394
|
#
|
6386
6395
|
# <note markdown="1"> * Encryption request headers, like `x-amz-server-side-encryption`,
|
6387
6396
|
# should not be sent for GET requests if your object uses server-side
|
6388
|
-
# encryption with
|
6389
|
-
#
|
6390
|
-
#
|
6391
|
-
# HTTP 400 BadRequest error.
|
6397
|
+
# encryption with KMS keys (SSE-KMS) or server-side encryption with
|
6398
|
+
# Amazon S3–managed encryption keys (SSE-S3). If your object does use
|
6399
|
+
# these types of keys, you’ll get an HTTP 400 BadRequest error.
|
6392
6400
|
#
|
6393
6401
|
# * The last modified property in this case is the creation date of the
|
6394
6402
|
# object.
|
@@ -6774,21 +6782,23 @@ module Aws::S3
|
|
6774
6782
|
#
|
6775
6783
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
6776
6784
|
# storage costs by automatically moving data to the most cost-effective
|
6777
|
-
# storage access tier, without
|
6778
|
-
# Intelligent-Tiering delivers automatic cost savings
|
6779
|
-
#
|
6780
|
-
#
|
6781
|
-
#
|
6782
|
-
#
|
6783
|
-
#
|
6784
|
-
#
|
6785
|
-
#
|
6786
|
-
#
|
6787
|
-
#
|
6788
|
-
#
|
6789
|
-
#
|
6790
|
-
#
|
6791
|
-
#
|
6785
|
+
# storage access tier, without performance impact or operational
|
6786
|
+
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
6787
|
+
# two low latency and high throughput access tiers. For data that can be
|
6788
|
+
# accessed asynchronously, you can choose to activate automatic
|
6789
|
+
# archiving capabilities within the S3 Intelligent-Tiering storage
|
6790
|
+
# class.
|
6791
|
+
#
|
6792
|
+
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
6793
|
+
# for data with unknown, changing, or unpredictable access patterns,
|
6794
|
+
# independent of object size or retention period. If the size of an
|
6795
|
+
# object is less than 128 KB, it is not eligible for auto-tiering.
|
6796
|
+
# Smaller objects can be stored, but they are always charged at the
|
6797
|
+
# Frequent Access tier rates in the S3 Intelligent-Tiering storage
|
6798
|
+
# class.
|
6799
|
+
#
|
6800
|
+
# For more information, see [Storage class for automatically optimizing
|
6801
|
+
# frequently and infrequently accessed objects][1].
|
6792
6802
|
#
|
6793
6803
|
# Operations related to `ListBucketIntelligentTieringConfigurations`
|
6794
6804
|
# include:
|
@@ -7036,10 +7046,12 @@ module Aws::S3
|
|
7036
7046
|
# resp.metrics_configuration_list[0].filter.prefix #=> String
|
7037
7047
|
# resp.metrics_configuration_list[0].filter.tag.key #=> String
|
7038
7048
|
# resp.metrics_configuration_list[0].filter.tag.value #=> String
|
7049
|
+
# resp.metrics_configuration_list[0].filter.access_point_arn #=> String
|
7039
7050
|
# resp.metrics_configuration_list[0].filter.and.prefix #=> String
|
7040
7051
|
# resp.metrics_configuration_list[0].filter.and.tags #=> Array
|
7041
7052
|
# resp.metrics_configuration_list[0].filter.and.tags[0].key #=> String
|
7042
7053
|
# resp.metrics_configuration_list[0].filter.and.tags[0].value #=> String
|
7054
|
+
# resp.metrics_configuration_list[0].filter.and.access_point_arn #=> String
|
7043
7055
|
#
|
7044
7056
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketMetricsConfigurations AWS API Documentation
|
7045
7057
|
#
|
@@ -7253,97 +7265,97 @@ module Aws::S3
|
|
7253
7265
|
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
7254
7266
|
#
|
7255
7267
|
#
|
7256
|
-
# @example Example:
|
7268
|
+
# @example Example: To list in-progress multipart uploads on a bucket
|
7257
7269
|
#
|
7258
|
-
# # The following example
|
7259
|
-
# # setup of multipart uploads.
|
7270
|
+
# # The following example lists in-progress multipart uploads on a specific bucket.
|
7260
7271
|
#
|
7261
7272
|
# resp = client.list_multipart_uploads({
|
7262
7273
|
# bucket: "examplebucket",
|
7263
|
-
# key_marker: "nextkeyfrompreviousresponse",
|
7264
|
-
# max_uploads: 2,
|
7265
|
-
# upload_id_marker: "valuefrompreviousresponse",
|
7266
7274
|
# })
|
7267
7275
|
#
|
7268
7276
|
# resp.to_h outputs the following:
|
7269
7277
|
# {
|
7270
|
-
# bucket: "acl1",
|
7271
|
-
# is_truncated: true,
|
7272
|
-
# key_marker: "",
|
7273
|
-
# max_uploads: 2,
|
7274
|
-
# next_key_marker: "someobjectkey",
|
7275
|
-
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7276
|
-
# upload_id_marker: "",
|
7277
7278
|
# uploads: [
|
7278
7279
|
# {
|
7279
7280
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
7280
7281
|
# initiator: {
|
7281
|
-
# display_name: "
|
7282
|
+
# display_name: "display-name",
|
7282
7283
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7283
7284
|
# },
|
7284
7285
|
# key: "JavaFile",
|
7285
7286
|
# owner: {
|
7286
|
-
# display_name: "
|
7287
|
-
# id: "
|
7287
|
+
# display_name: "display-name",
|
7288
|
+
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7288
7289
|
# },
|
7289
7290
|
# storage_class: "STANDARD",
|
7290
|
-
# upload_id: "
|
7291
|
+
# upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
7291
7292
|
# },
|
7292
7293
|
# {
|
7293
7294
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
7294
7295
|
# initiator: {
|
7295
|
-
# display_name: "
|
7296
|
+
# display_name: "display-name",
|
7296
7297
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7297
7298
|
# },
|
7298
7299
|
# key: "JavaFile",
|
7299
7300
|
# owner: {
|
7300
|
-
# display_name: "
|
7301
|
+
# display_name: "display-name",
|
7301
7302
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7302
7303
|
# },
|
7303
7304
|
# storage_class: "STANDARD",
|
7304
|
-
# upload_id: "
|
7305
|
+
# upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7305
7306
|
# },
|
7306
7307
|
# ],
|
7307
7308
|
# }
|
7308
7309
|
#
|
7309
|
-
# @example Example:
|
7310
|
+
# @example Example: List next set of multipart uploads when previous result is truncated
|
7310
7311
|
#
|
7311
|
-
# # The following example
|
7312
|
+
# # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
|
7313
|
+
# # setup of multipart uploads.
|
7312
7314
|
#
|
7313
7315
|
# resp = client.list_multipart_uploads({
|
7314
7316
|
# bucket: "examplebucket",
|
7317
|
+
# key_marker: "nextkeyfrompreviousresponse",
|
7318
|
+
# max_uploads: 2,
|
7319
|
+
# upload_id_marker: "valuefrompreviousresponse",
|
7315
7320
|
# })
|
7316
7321
|
#
|
7317
7322
|
# resp.to_h outputs the following:
|
7318
7323
|
# {
|
7324
|
+
# bucket: "acl1",
|
7325
|
+
# is_truncated: true,
|
7326
|
+
# key_marker: "",
|
7327
|
+
# max_uploads: 2,
|
7328
|
+
# next_key_marker: "someobjectkey",
|
7329
|
+
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7330
|
+
# upload_id_marker: "",
|
7319
7331
|
# uploads: [
|
7320
7332
|
# {
|
7321
7333
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
7322
7334
|
# initiator: {
|
7323
|
-
# display_name: "display-name",
|
7335
|
+
# display_name: "ownder-display-name",
|
7324
7336
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7325
7337
|
# },
|
7326
7338
|
# key: "JavaFile",
|
7327
7339
|
# owner: {
|
7328
|
-
# display_name: "
|
7329
|
-
# id: "
|
7340
|
+
# display_name: "mohanataws",
|
7341
|
+
# id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7330
7342
|
# },
|
7331
7343
|
# storage_class: "STANDARD",
|
7332
|
-
# upload_id: "
|
7344
|
+
# upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
7333
7345
|
# },
|
7334
7346
|
# {
|
7335
7347
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
7336
7348
|
# initiator: {
|
7337
|
-
# display_name: "display-name",
|
7349
|
+
# display_name: "ownder-display-name",
|
7338
7350
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7339
7351
|
# },
|
7340
7352
|
# key: "JavaFile",
|
7341
7353
|
# owner: {
|
7342
|
-
# display_name: "display-name",
|
7354
|
+
# display_name: "ownder-display-name",
|
7343
7355
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7344
7356
|
# },
|
7345
7357
|
# storage_class: "STANDARD",
|
7346
|
-
# upload_id: "
|
7358
|
+
# upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7347
7359
|
# },
|
7348
7360
|
# ],
|
7349
7361
|
# }
|
@@ -8817,12 +8829,12 @@ module Aws::S3
|
|
8817
8829
|
# encryption and Amazon S3 Bucket Key for an existing bucket.
|
8818
8830
|
#
|
8819
8831
|
# Default encryption for a bucket can use server-side encryption with
|
8820
|
-
# Amazon S3-managed keys (SSE-S3) or
|
8821
|
-
#
|
8822
|
-
#
|
8823
|
-
#
|
8824
|
-
#
|
8825
|
-
#
|
8832
|
+
# Amazon S3-managed keys (SSE-S3) or customer managed keys (SSE-KMS). If
|
8833
|
+
# you specify default encryption using SSE-KMS, you can also configure
|
8834
|
+
# Amazon S3 Bucket Key. For information about default encryption, see
|
8835
|
+
# [Amazon S3 default bucket encryption][1] in the *Amazon S3 User
|
8836
|
+
# Guide*. For more information about S3 Bucket Keys, see [Amazon S3
|
8837
|
+
# Bucket Keys][2] in the *Amazon S3 User Guide*.
|
8826
8838
|
#
|
8827
8839
|
# This action requires Amazon Web Services Signature Version 4. For more
|
8828
8840
|
# information, see [ Authenticating Requests (Amazon Web Services
|
@@ -8854,10 +8866,10 @@ module Aws::S3
|
|
8854
8866
|
#
|
8855
8867
|
# @option params [required, String] :bucket
|
8856
8868
|
# Specifies default encryption for a bucket using server-side encryption
|
8857
|
-
# with Amazon S3-managed keys (SSE-S3) or customer
|
8858
|
-
#
|
8859
|
-
#
|
8860
|
-
#
|
8869
|
+
# with Amazon S3-managed keys (SSE-S3) or customer managed keys
|
8870
|
+
# (SSE-KMS). For information about the Amazon S3 default encryption
|
8871
|
+
# feature, see [Amazon S3 Default Bucket Encryption][1] in the *Amazon
|
8872
|
+
# S3 User Guide*.
|
8861
8873
|
#
|
8862
8874
|
#
|
8863
8875
|
#
|
@@ -8915,21 +8927,23 @@ module Aws::S3
|
|
8915
8927
|
#
|
8916
8928
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
8917
8929
|
# storage costs by automatically moving data to the most cost-effective
|
8918
|
-
# storage access tier, without
|
8919
|
-
# Intelligent-Tiering delivers automatic cost savings
|
8920
|
-
#
|
8921
|
-
#
|
8922
|
-
#
|
8923
|
-
#
|
8924
|
-
#
|
8925
|
-
#
|
8926
|
-
#
|
8927
|
-
#
|
8928
|
-
#
|
8929
|
-
#
|
8930
|
-
#
|
8931
|
-
#
|
8932
|
-
#
|
8930
|
+
# storage access tier, without performance impact or operational
|
8931
|
+
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
8932
|
+
# two low latency and high throughput access tiers. For data that can be
|
8933
|
+
# accessed asynchronously, you can choose to activate automatic
|
8934
|
+
# archiving capabilities within the S3 Intelligent-Tiering storage
|
8935
|
+
# class.
|
8936
|
+
#
|
8937
|
+
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
8938
|
+
# for data with unknown, changing, or unpredictable access patterns,
|
8939
|
+
# independent of object size or retention period. If the size of an
|
8940
|
+
# object is less than 128 KB, it is not eligible for auto-tiering.
|
8941
|
+
# Smaller objects can be stored, but they are always charged at the
|
8942
|
+
# Frequent Access tier rates in the S3 Intelligent-Tiering storage
|
8943
|
+
# class.
|
8944
|
+
#
|
8945
|
+
# For more information, see [Storage class for automatically optimizing
|
8946
|
+
# frequently and infrequently accessed objects][1].
|
8933
8947
|
#
|
8934
8948
|
# Operations related to `PutBucketIntelligentTieringConfiguration`
|
8935
8949
|
# include:
|
@@ -9647,7 +9661,7 @@ module Aws::S3
|
|
9647
9661
|
#
|
9648
9662
|
# * [DeleteBucketMetricsConfiguration][4]
|
9649
9663
|
#
|
9650
|
-
# * [
|
9664
|
+
# * [GetBucketMetricsConfiguration][5]
|
9651
9665
|
#
|
9652
9666
|
# * [ListBucketMetricsConfigurations][6]
|
9653
9667
|
#
|
@@ -9666,7 +9680,7 @@ module Aws::S3
|
|
9666
9680
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
9667
9681
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
|
9668
9682
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
|
9669
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
9683
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
|
9670
9684
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
|
9671
9685
|
#
|
9672
9686
|
# @option params [required, String] :bucket
|
@@ -9698,6 +9712,7 @@ module Aws::S3
|
|
9698
9712
|
# key: "ObjectKey", # required
|
9699
9713
|
# value: "Value", # required
|
9700
9714
|
# },
|
9715
|
+
# access_point_arn: "AccessPointArn",
|
9701
9716
|
# and: {
|
9702
9717
|
# prefix: "Prefix",
|
9703
9718
|
# tags: [
|
@@ -9706,6 +9721,7 @@ module Aws::S3
|
|
9706
9721
|
# value: "Value", # required
|
9707
9722
|
# },
|
9708
9723
|
# ],
|
9724
|
+
# access_point_arn: "AccessPointArn",
|
9709
9725
|
# },
|
9710
9726
|
# },
|
9711
9727
|
# },
|
@@ -10138,13 +10154,12 @@ module Aws::S3
|
|
10138
10154
|
# **Handling Replication of Encrypted Objects**
|
10139
10155
|
#
|
10140
10156
|
# By default, Amazon S3 doesn't replicate objects that are stored at
|
10141
|
-
# rest using server-side encryption with
|
10142
|
-
#
|
10143
|
-
#
|
10144
|
-
# `
|
10145
|
-
#
|
10146
|
-
#
|
10147
|
-
# Web Services KMS][4].
|
10157
|
+
# rest using server-side encryption with KMS keys. To replicate Amazon
|
10158
|
+
# Web Services KMS-encrypted objects, add the following:
|
10159
|
+
# `SourceSelectionCriteria`, `SseKmsEncryptedObjects`, `Status`,
|
10160
|
+
# `EncryptionConfiguration`, and `ReplicaKmsKeyID`. For information
|
10161
|
+
# about replication configuration, see [Replicating Objects Created with
|
10162
|
+
# SSE Using KMS keys][4].
|
10148
10163
|
#
|
10149
10164
|
# For information on `PutBucketReplication` errors, see [List of
|
10150
10165
|
# replication-related error codes][5]
|
@@ -11107,12 +11122,12 @@ module Aws::S3
|
|
11107
11122
|
# If `x-amz-server-side-encryption` is present and has the value of
|
11108
11123
|
# `aws:kms`, this header specifies the ID of the Amazon Web Services Key
|
11109
11124
|
# Management Service (Amazon Web Services KMS) symmetrical customer
|
11110
|
-
# managed
|
11111
|
-
#
|
11125
|
+
# managed key that was used for the object. If you specify
|
11126
|
+
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
11112
11127
|
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
11113
|
-
# Amazon Web Services managed
|
11114
|
-
#
|
11115
|
-
#
|
11128
|
+
# Amazon Web Services managed key to protect the data. If the KMS key
|
11129
|
+
# does not exist in the same account issuing the command, you must use
|
11130
|
+
# the full ARN and not just the ID.
|
11116
11131
|
#
|
11117
11132
|
# @option params [String] :ssekms_encryption_context
|
11118
11133
|
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
@@ -11177,134 +11192,134 @@ module Aws::S3
|
|
11177
11192
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
11178
11193
|
#
|
11179
11194
|
#
|
11180
|
-
# @example Example: To upload an object
|
11195
|
+
# @example Example: To upload an object and specify optional tags
|
11181
11196
|
#
|
11182
|
-
# # The following example uploads an object. The request specifies optional
|
11183
|
-
# #
|
11197
|
+
# # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
|
11198
|
+
# # S3 returns version ID of the newly created object.
|
11184
11199
|
#
|
11185
11200
|
# resp = client.put_object({
|
11186
|
-
# body: "HappyFace.jpg",
|
11201
|
+
# body: "c:\\HappyFace.jpg",
|
11187
11202
|
# bucket: "examplebucket",
|
11188
11203
|
# key: "HappyFace.jpg",
|
11189
|
-
#
|
11190
|
-
# storage_class: "STANDARD_IA",
|
11204
|
+
# tagging: "key1=value1&key2=value2",
|
11191
11205
|
# })
|
11192
11206
|
#
|
11193
11207
|
# resp.to_h outputs the following:
|
11194
11208
|
# {
|
11195
11209
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11196
|
-
#
|
11197
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
11210
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
11198
11211
|
# }
|
11199
11212
|
#
|
11200
|
-
# @example Example: To upload an object and specify
|
11213
|
+
# @example Example: To upload an object and specify canned ACL.
|
11201
11214
|
#
|
11202
|
-
# # The following example uploads and object. The request specifies
|
11203
|
-
# #
|
11215
|
+
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
11216
|
+
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
11204
11217
|
#
|
11205
11218
|
# resp = client.put_object({
|
11219
|
+
# acl: "authenticated-read",
|
11206
11220
|
# body: "filetoupload",
|
11207
11221
|
# bucket: "examplebucket",
|
11208
11222
|
# key: "exampleobject",
|
11209
|
-
# server_side_encryption: "AES256",
|
11210
|
-
# tagging: "key1=value1&key2=value2",
|
11211
11223
|
# })
|
11212
11224
|
#
|
11213
11225
|
# resp.to_h outputs the following:
|
11214
11226
|
# {
|
11215
11227
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11216
|
-
#
|
11217
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
11228
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
11218
11229
|
# }
|
11219
11230
|
#
|
11220
|
-
# @example Example: To
|
11231
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
11221
11232
|
#
|
11222
|
-
# # The following example
|
11233
|
+
# # The following example uploads and object. The request specifies the optional server-side encryption option. The request
|
11234
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
11223
11235
|
#
|
11224
11236
|
# resp = client.put_object({
|
11225
11237
|
# body: "filetoupload",
|
11226
11238
|
# bucket: "examplebucket",
|
11227
|
-
# key: "
|
11239
|
+
# key: "exampleobject",
|
11240
|
+
# server_side_encryption: "AES256",
|
11241
|
+
# tagging: "key1=value1&key2=value2",
|
11228
11242
|
# })
|
11229
11243
|
#
|
11230
11244
|
# resp.to_h outputs the following:
|
11231
11245
|
# {
|
11232
11246
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11233
|
-
#
|
11247
|
+
# server_side_encryption: "AES256",
|
11248
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
11234
11249
|
# }
|
11235
11250
|
#
|
11236
|
-
# @example Example: To
|
11251
|
+
# @example Example: To create an object.
|
11237
11252
|
#
|
11238
|
-
# # The following example creates an object.
|
11239
|
-
# # enabled, S3 returns version ID in response.
|
11253
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
11240
11254
|
#
|
11241
11255
|
# resp = client.put_object({
|
11242
11256
|
# body: "filetoupload",
|
11243
11257
|
# bucket: "examplebucket",
|
11244
|
-
# key: "
|
11245
|
-
# metadata: {
|
11246
|
-
# "metadata1" => "value1",
|
11247
|
-
# "metadata2" => "value2",
|
11248
|
-
# },
|
11258
|
+
# key: "objectkey",
|
11249
11259
|
# })
|
11250
11260
|
#
|
11251
11261
|
# resp.to_h outputs the following:
|
11252
11262
|
# {
|
11253
11263
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11254
|
-
# version_id: "
|
11264
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
11255
11265
|
# }
|
11256
11266
|
#
|
11257
|
-
# @example Example: To upload an object
|
11267
|
+
# @example Example: To upload an object
|
11258
11268
|
#
|
11259
|
-
# # The following example uploads
|
11260
|
-
# #
|
11269
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
11270
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
11261
11271
|
#
|
11262
11272
|
# resp = client.put_object({
|
11263
|
-
#
|
11264
|
-
# body: "filetoupload",
|
11273
|
+
# body: "HappyFace.jpg",
|
11265
11274
|
# bucket: "examplebucket",
|
11266
|
-
# key: "
|
11275
|
+
# key: "HappyFace.jpg",
|
11267
11276
|
# })
|
11268
11277
|
#
|
11269
11278
|
# resp.to_h outputs the following:
|
11270
11279
|
# {
|
11271
11280
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11272
|
-
# version_id: "
|
11281
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
11273
11282
|
# }
|
11274
11283
|
#
|
11275
|
-
# @example Example: To upload an object
|
11284
|
+
# @example Example: To upload an object (specify optional headers)
|
11276
11285
|
#
|
11277
|
-
# # The following example uploads an object
|
11278
|
-
# #
|
11286
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
11287
|
+
# # storage class and use server-side encryption.
|
11279
11288
|
#
|
11280
11289
|
# resp = client.put_object({
|
11281
11290
|
# body: "HappyFace.jpg",
|
11282
11291
|
# bucket: "examplebucket",
|
11283
11292
|
# key: "HappyFace.jpg",
|
11293
|
+
# server_side_encryption: "AES256",
|
11294
|
+
# storage_class: "STANDARD_IA",
|
11284
11295
|
# })
|
11285
11296
|
#
|
11286
11297
|
# resp.to_h outputs the following:
|
11287
11298
|
# {
|
11288
11299
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11289
|
-
#
|
11300
|
+
# server_side_encryption: "AES256",
|
11301
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
11290
11302
|
# }
|
11291
11303
|
#
|
11292
|
-
# @example Example: To upload
|
11304
|
+
# @example Example: To upload object and specify user-defined metadata
|
11293
11305
|
#
|
11294
|
-
# # The following example
|
11295
|
-
# # S3 returns version ID
|
11306
|
+
# # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
|
11307
|
+
# # enabled, S3 returns version ID in response.
|
11296
11308
|
#
|
11297
11309
|
# resp = client.put_object({
|
11298
|
-
# body: "
|
11310
|
+
# body: "filetoupload",
|
11299
11311
|
# bucket: "examplebucket",
|
11300
|
-
# key: "
|
11301
|
-
#
|
11312
|
+
# key: "exampleobject",
|
11313
|
+
# metadata: {
|
11314
|
+
# "metadata1" => "value1",
|
11315
|
+
# "metadata2" => "value2",
|
11316
|
+
# },
|
11302
11317
|
# })
|
11303
11318
|
#
|
11304
11319
|
# resp.to_h outputs the following:
|
11305
11320
|
# {
|
11306
11321
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11307
|
-
# version_id: "
|
11322
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
11308
11323
|
# }
|
11309
11324
|
#
|
11310
11325
|
# @example Streaming a file from disk
|
@@ -12737,12 +12752,11 @@ module Aws::S3
|
|
12737
12752
|
# Encryption Keys)][5] in the *Amazon S3 User Guide*.
|
12738
12753
|
#
|
12739
12754
|
# For objects that are encrypted with Amazon S3 managed encryption
|
12740
|
-
# keys (SSE-S3) and
|
12741
|
-
#
|
12742
|
-
#
|
12743
|
-
#
|
12744
|
-
#
|
12745
|
-
# the *Amazon S3 User Guide*.
|
12755
|
+
# keys (SSE-S3) and Amazon Web Services KMS keys (SSE-KMS),
|
12756
|
+
# server-side encryption is handled transparently, so you don't need
|
12757
|
+
# to specify anything. For more information about server-side
|
12758
|
+
# encryption, including SSE-S3 and SSE-KMS, see [Protecting Data Using
|
12759
|
+
# Server-Side Encryption][6] in the *Amazon S3 User Guide*.
|
12746
12760
|
#
|
12747
12761
|
# **Working with the Response Body**
|
12748
12762
|
#
|
@@ -13649,45 +13663,45 @@ module Aws::S3
|
|
13649
13663
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
13650
13664
|
#
|
13651
13665
|
#
|
13652
|
-
# @example Example: To upload a part by copying
|
13666
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
13653
13667
|
#
|
13654
|
-
# # The following example uploads a part of a multipart upload by copying
|
13655
|
-
# # data source.
|
13668
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
13656
13669
|
#
|
13657
13670
|
# resp = client.upload_part_copy({
|
13658
13671
|
# bucket: "examplebucket",
|
13659
13672
|
# copy_source: "/bucketname/sourceobjectkey",
|
13660
|
-
# copy_source_range: "bytes=1-100000",
|
13661
13673
|
# key: "examplelargeobject",
|
13662
|
-
# part_number:
|
13674
|
+
# part_number: 1,
|
13663
13675
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
13664
13676
|
# })
|
13665
13677
|
#
|
13666
13678
|
# resp.to_h outputs the following:
|
13667
13679
|
# {
|
13668
13680
|
# copy_part_result: {
|
13669
|
-
# etag: "\"
|
13670
|
-
# last_modified: Time.parse("2016-12-29T21:
|
13681
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
13682
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
13671
13683
|
# },
|
13672
13684
|
# }
|
13673
13685
|
#
|
13674
|
-
# @example Example: To upload a part by copying
|
13686
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
13675
13687
|
#
|
13676
|
-
# # The following example uploads a part of a multipart upload by copying
|
13688
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
13689
|
+
# # data source.
|
13677
13690
|
#
|
13678
13691
|
# resp = client.upload_part_copy({
|
13679
13692
|
# bucket: "examplebucket",
|
13680
13693
|
# copy_source: "/bucketname/sourceobjectkey",
|
13694
|
+
# copy_source_range: "bytes=1-100000",
|
13681
13695
|
# key: "examplelargeobject",
|
13682
|
-
# part_number:
|
13696
|
+
# part_number: 2,
|
13683
13697
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
13684
13698
|
# })
|
13685
13699
|
#
|
13686
13700
|
# resp.to_h outputs the following:
|
13687
13701
|
# {
|
13688
13702
|
# copy_part_result: {
|
13689
|
-
# etag: "\"
|
13690
|
-
# last_modified: Time.parse("2016-12-29T21:
|
13703
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
13704
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
13691
13705
|
# },
|
13692
13706
|
# }
|
13693
13707
|
#
|
@@ -13737,9 +13751,9 @@ module Aws::S3
|
|
13737
13751
|
end
|
13738
13752
|
|
13739
13753
|
# Passes transformed objects to a `GetObject` operation when using
|
13740
|
-
# Object Lambda
|
13741
|
-
#
|
13742
|
-
#
|
13754
|
+
# Object Lambda access points. For information about Object Lambda
|
13755
|
+
# access points, see [Transforming objects with Object Lambda access
|
13756
|
+
# points][1] in the *Amazon S3 User Guide*.
|
13743
13757
|
#
|
13744
13758
|
# This operation supports metadata that can be returned by
|
13745
13759
|
# [GetObject][2], in addition to `RequestRoute`, `RequestToken`,
|
@@ -13761,8 +13775,8 @@ module Aws::S3
|
|
13761
13775
|
# identifiable information (PII) and decompress S3 objects. These Lambda
|
13762
13776
|
# functions are available in the Amazon Web Services Serverless
|
13763
13777
|
# Application Repository, and can be selected through the Amazon Web
|
13764
|
-
# Services Management Console when you create your Object Lambda
|
13765
|
-
#
|
13778
|
+
# Services Management Console when you create your Object Lambda access
|
13779
|
+
# point.
|
13766
13780
|
#
|
13767
13781
|
# Example 1: PII Access Control - This Lambda function uses Amazon
|
13768
13782
|
# Comprehend, a natural language processing (NLP) service using machine
|
@@ -13954,8 +13968,8 @@ module Aws::S3
|
|
13954
13968
|
#
|
13955
13969
|
# @option params [String] :ssekms_key_id
|
13956
13970
|
# If present, specifies the ID of the Amazon Web Services Key Management
|
13957
|
-
# Service (Amazon Web Services KMS) symmetric customer managed
|
13958
|
-
#
|
13971
|
+
# Service (Amazon Web Services KMS) symmetric customer managed key that
|
13972
|
+
# was used for stored in Amazon S3 object.
|
13959
13973
|
#
|
13960
13974
|
# @option params [String] :sse_customer_key_md5
|
13961
13975
|
# 128-bit MD5 digest of customer-provided encryption key used in Amazon
|
@@ -14047,7 +14061,7 @@ module Aws::S3
|
|
14047
14061
|
params: params,
|
14048
14062
|
config: config)
|
14049
14063
|
context[:gem_name] = 'aws-sdk-s3'
|
14050
|
-
context[:gem_version] = '1.
|
14064
|
+
context[:gem_version] = '1.104.0'
|
14051
14065
|
Seahorse::Client::Request.new(handlers, context)
|
14052
14066
|
end
|
14053
14067
|
|