aws-sdk-s3 1.102.0 → 1.103.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +5 -5
- data/lib/aws-sdk-s3/client.rb +276 -267
- data/lib/aws-sdk-s3/client_api.rb +3 -0
- data/lib/aws-sdk-s3/object.rb +18 -18
- data/lib/aws-sdk-s3/object_summary.rb +12 -12
- data/lib/aws-sdk-s3/types.rb +78 -57
- data/lib/aws-sdk-s3.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 15712b72bf9c4eceb463344aa738f5e520a02161776d0a2e0c501c589ffba31b
|
4
|
+
data.tar.gz: 44bd3b0c543a0bb6b31ff26da9e664b431b0497ca5157385671526a9bbe8c589
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: f4dc0b61914a6c48dac9858321b0a6eb972991e2938d39a10d105140c18fcf7a43d1d905654942033f44336e491e82d5ad178eb2fc84beac05ac1e059da98be7
|
7
|
+
data.tar.gz: 709d8e45a27f894622800dabb2ebb300f0d4b6f888c081987e42022b602d703aa22bd42fab179aeb976ee5ef12b98cb6b04d1663a49749b8693ea81b8099a2d3
|
data/CHANGELOG.md
CHANGED
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.103.0
|
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -517,12 +517,12 @@ module Aws::S3
|
|
517
517
|
# If `x-amz-server-side-encryption` is present and has the value of
|
518
518
|
# `aws:kms`, this header specifies the ID of the Amazon Web Services Key
|
519
519
|
# Management Service (Amazon Web Services KMS) symmetrical customer
|
520
|
-
# managed
|
521
|
-
#
|
520
|
+
# managed key that was used for the object. If you specify
|
521
|
+
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
522
522
|
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
523
|
-
# Amazon Web Services managed
|
524
|
-
#
|
525
|
-
#
|
523
|
+
# Amazon Web Services managed key to protect the data. If the KMS key
|
524
|
+
# does not exist in the same account issuing the command, you must use
|
525
|
+
# the full ARN and not just the ID.
|
526
526
|
# @option options [String] :ssekms_encryption_context
|
527
527
|
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
528
528
|
# object encryption. The value of this header is a base64-encoded UTF-8
|
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -1465,33 +1465,33 @@ module Aws::S3
|
|
1465
1465
|
# * {Types::CreateBucketOutput#location #location} => String
|
1466
1466
|
#
|
1467
1467
|
#
|
1468
|
-
# @example Example: To create a bucket
|
1468
|
+
# @example Example: To create a bucket
|
1469
1469
|
#
|
1470
|
-
# # The following example creates a bucket.
|
1470
|
+
# # The following example creates a bucket.
|
1471
1471
|
#
|
1472
1472
|
# resp = client.create_bucket({
|
1473
1473
|
# bucket: "examplebucket",
|
1474
|
-
# create_bucket_configuration: {
|
1475
|
-
# location_constraint: "eu-west-1",
|
1476
|
-
# },
|
1477
1474
|
# })
|
1478
1475
|
#
|
1479
1476
|
# resp.to_h outputs the following:
|
1480
1477
|
# {
|
1481
|
-
# location: "
|
1478
|
+
# location: "/examplebucket",
|
1482
1479
|
# }
|
1483
1480
|
#
|
1484
|
-
# @example Example: To create a bucket
|
1481
|
+
# @example Example: To create a bucket in a specific region
|
1485
1482
|
#
|
1486
|
-
# # The following example creates a bucket.
|
1483
|
+
# # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
|
1487
1484
|
#
|
1488
1485
|
# resp = client.create_bucket({
|
1489
1486
|
# bucket: "examplebucket",
|
1487
|
+
# create_bucket_configuration: {
|
1488
|
+
# location_constraint: "eu-west-1",
|
1489
|
+
# },
|
1490
1490
|
# })
|
1491
1491
|
#
|
1492
1492
|
# resp.to_h outputs the following:
|
1493
1493
|
# {
|
1494
|
-
# location: "/
|
1494
|
+
# location: "http://examplebucket.<Region>.s3.amazonaws.com/",
|
1495
1495
|
# }
|
1496
1496
|
#
|
1497
1497
|
# @example Request syntax with placeholder values
|
@@ -1562,15 +1562,14 @@ module Aws::S3
|
|
1562
1562
|
# You can optionally request server-side encryption. For server-side
|
1563
1563
|
# encryption, Amazon S3 encrypts your data as it writes it to disks in
|
1564
1564
|
# its data centers and decrypts it when you access it. You can provide
|
1565
|
-
# your own encryption key, or use Amazon Web Services
|
1566
|
-
#
|
1567
|
-
# 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
|
1568
1567
|
# encryption key, the request headers you provide in [UploadPart][1] and
|
1569
1568
|
# [UploadPartCopy][6] requests must match the headers you used in the
|
1570
1569
|
# request to initiate the upload by using `CreateMultipartUpload`.
|
1571
1570
|
#
|
1572
1571
|
# To perform a multipart upload with encryption using an Amazon Web
|
1573
|
-
# Services KMS
|
1572
|
+
# Services KMS key, the requester must have permission to the
|
1574
1573
|
# `kms:Decrypt` and `kms:GenerateDataKey*` actions on the key. These
|
1575
1574
|
# permissions are required because Amazon S3 must decrypt and read data
|
1576
1575
|
# from the encrypted file parts before it completes the multipart
|
@@ -1578,11 +1577,10 @@ module Aws::S3
|
|
1578
1577
|
# permissions][7] in the *Amazon S3 User Guide*.
|
1579
1578
|
#
|
1580
1579
|
# If your Identity and Access Management (IAM) user or role is in the
|
1581
|
-
# same Amazon Web Services account as the
|
1582
|
-
#
|
1583
|
-
#
|
1584
|
-
#
|
1585
|
-
# 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.
|
1586
1584
|
#
|
1587
1585
|
# For more information, see [Protecting Data Using Server-Side
|
1588
1586
|
# Encryption][8].
|
@@ -1615,11 +1613,11 @@ module Aws::S3
|
|
1615
1613
|
# option you use depends on whether you want to use Amazon Web
|
1616
1614
|
# Services managed encryption keys or provide your own encryption key.
|
1617
1615
|
#
|
1618
|
-
# * Use encryption keys managed by Amazon S3 or customer
|
1619
|
-
#
|
1620
|
-
#
|
1621
|
-
#
|
1622
|
-
#
|
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.
|
1623
1621
|
#
|
1624
1622
|
# * x-amz-server-side-encryption
|
1625
1623
|
#
|
@@ -1629,7 +1627,7 @@ module Aws::S3
|
|
1629
1627
|
#
|
1630
1628
|
# <note markdown="1"> If you specify `x-amz-server-side-encryption:aws:kms`, but don't
|
1631
1629
|
# provide `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3
|
1632
|
-
# uses the Amazon Web Services managed
|
1630
|
+
# uses the Amazon Web Services managed key in Amazon Web Services
|
1633
1631
|
# KMS to protect the data.
|
1634
1632
|
#
|
1635
1633
|
# </note>
|
@@ -1638,10 +1636,9 @@ module Aws::S3
|
|
1638
1636
|
# Services KMS fail if you don't make them with SSL or by using
|
1639
1637
|
# SigV4.
|
1640
1638
|
#
|
1641
|
-
# For more information about server-side encryption with
|
1642
|
-
#
|
1643
|
-
#
|
1644
|
-
# 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].
|
1645
1642
|
#
|
1646
1643
|
# * Use customer-provided encryption keys – If you want to manage your
|
1647
1644
|
# own encryption keys, provide all the following headers in the
|
@@ -1653,10 +1650,9 @@ module Aws::S3
|
|
1653
1650
|
#
|
1654
1651
|
# * x-amz-server-side-encryption-customer-key-MD5
|
1655
1652
|
#
|
1656
|
-
# For more information about server-side encryption with
|
1657
|
-
#
|
1658
|
-
#
|
1659
|
-
# 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].
|
1660
1656
|
#
|
1661
1657
|
# Access-Control-List (ACL)-Specific Request Headers
|
1662
1658
|
#
|
@@ -1881,13 +1877,13 @@ module Aws::S3
|
|
1881
1877
|
# ensure that the encryption key was transmitted without error.
|
1882
1878
|
#
|
1883
1879
|
# @option params [String] :ssekms_key_id
|
1884
|
-
# Specifies the ID of the symmetric customer managed
|
1885
|
-
#
|
1886
|
-
#
|
1887
|
-
#
|
1888
|
-
#
|
1889
|
-
#
|
1890
|
-
#
|
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*.
|
1891
1887
|
#
|
1892
1888
|
#
|
1893
1889
|
#
|
@@ -2257,21 +2253,23 @@ module Aws::S3
|
|
2257
2253
|
#
|
2258
2254
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
2259
2255
|
# storage costs by automatically moving data to the most cost-effective
|
2260
|
-
# storage access tier, without
|
2261
|
-
# Intelligent-Tiering delivers automatic cost savings
|
2262
|
-
#
|
2263
|
-
#
|
2264
|
-
#
|
2265
|
-
#
|
2266
|
-
#
|
2267
|
-
#
|
2268
|
-
#
|
2269
|
-
#
|
2270
|
-
#
|
2271
|
-
#
|
2272
|
-
#
|
2273
|
-
#
|
2274
|
-
#
|
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].
|
2275
2273
|
#
|
2276
2274
|
# Operations related to `DeleteBucketIntelligentTieringConfiguration`
|
2277
2275
|
# include:
|
@@ -3721,21 +3719,23 @@ module Aws::S3
|
|
3721
3719
|
#
|
3722
3720
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
3723
3721
|
# storage costs by automatically moving data to the most cost-effective
|
3724
|
-
# storage access tier, without
|
3725
|
-
# Intelligent-Tiering delivers automatic cost savings
|
3726
|
-
#
|
3727
|
-
#
|
3728
|
-
#
|
3729
|
-
#
|
3730
|
-
#
|
3731
|
-
#
|
3732
|
-
#
|
3733
|
-
#
|
3734
|
-
#
|
3735
|
-
#
|
3736
|
-
#
|
3737
|
-
#
|
3738
|
-
#
|
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].
|
3739
3739
|
#
|
3740
3740
|
# Operations related to `GetBucketIntelligentTieringConfiguration`
|
3741
3741
|
# include:
|
@@ -4302,10 +4302,12 @@ module Aws::S3
|
|
4302
4302
|
# resp.metrics_configuration.filter.prefix #=> String
|
4303
4303
|
# resp.metrics_configuration.filter.tag.key #=> String
|
4304
4304
|
# resp.metrics_configuration.filter.tag.value #=> String
|
4305
|
+
# resp.metrics_configuration.filter.access_point_arn #=> String
|
4305
4306
|
# resp.metrics_configuration.filter.and.prefix #=> String
|
4306
4307
|
# resp.metrics_configuration.filter.and.tags #=> Array
|
4307
4308
|
# resp.metrics_configuration.filter.and.tags[0].key #=> String
|
4308
4309
|
# resp.metrics_configuration.filter.and.tags[0].value #=> String
|
4310
|
+
# resp.metrics_configuration.filter.and.access_point_arn #=> String
|
4309
4311
|
#
|
4310
4312
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetricsConfiguration AWS API Documentation
|
4311
4313
|
#
|
@@ -5163,10 +5165,9 @@ module Aws::S3
|
|
5163
5165
|
#
|
5164
5166
|
# Encryption request headers, like `x-amz-server-side-encryption`,
|
5165
5167
|
# should not be sent for GET requests if your object uses server-side
|
5166
|
-
# encryption with
|
5167
|
-
#
|
5168
|
-
#
|
5169
|
-
# 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.
|
5170
5171
|
#
|
5171
5172
|
# If you encrypt an object by using server-side encryption with
|
5172
5173
|
# customer-provided encryption keys (SSE-C) when you store the object in
|
@@ -5301,6 +5302,9 @@ module Aws::S3
|
|
5301
5302
|
# name. For more information about access point ARNs, see [Using access
|
5302
5303
|
# points][1] in the *Amazon S3 User Guide*.
|
5303
5304
|
#
|
5305
|
+
# When using an Object Lambda access point the hostname takes the form
|
5306
|
+
# *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com.
|
5307
|
+
#
|
5304
5308
|
# When using this action with Amazon S3 on Outposts, you must direct
|
5305
5309
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
5306
5310
|
# takes the form
|
@@ -5444,49 +5448,49 @@ module Aws::S3
|
|
5444
5448
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
5445
5449
|
#
|
5446
5450
|
#
|
5447
|
-
# @example Example: To retrieve
|
5451
|
+
# @example Example: To retrieve an object
|
5448
5452
|
#
|
5449
|
-
# # The following example retrieves an object for an S3 bucket.
|
5450
|
-
# # specific byte range.
|
5453
|
+
# # The following example retrieves an object for an S3 bucket.
|
5451
5454
|
#
|
5452
5455
|
# resp = client.get_object({
|
5453
5456
|
# bucket: "examplebucket",
|
5454
|
-
# key: "
|
5455
|
-
# range: "bytes=0-9",
|
5457
|
+
# key: "HappyFace.jpg",
|
5456
5458
|
# })
|
5457
5459
|
#
|
5458
5460
|
# resp.to_h outputs the following:
|
5459
5461
|
# {
|
5460
5462
|
# accept_ranges: "bytes",
|
5461
|
-
# content_length:
|
5462
|
-
#
|
5463
|
-
#
|
5464
|
-
#
|
5465
|
-
# 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"),
|
5466
5467
|
# metadata: {
|
5467
5468
|
# },
|
5469
|
+
# tag_count: 2,
|
5468
5470
|
# version_id: "null",
|
5469
5471
|
# }
|
5470
5472
|
#
|
5471
|
-
# @example Example: To retrieve an object
|
5473
|
+
# @example Example: To retrieve a byte range of an object
|
5472
5474
|
#
|
5473
|
-
# # 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.
|
5474
5477
|
#
|
5475
5478
|
# resp = client.get_object({
|
5476
5479
|
# bucket: "examplebucket",
|
5477
|
-
# key: "
|
5480
|
+
# key: "SampleFile.txt",
|
5481
|
+
# range: "bytes=0-9",
|
5478
5482
|
# })
|
5479
5483
|
#
|
5480
5484
|
# resp.to_h outputs the following:
|
5481
5485
|
# {
|
5482
5486
|
# accept_ranges: "bytes",
|
5483
|
-
# content_length:
|
5484
|
-
#
|
5485
|
-
#
|
5486
|
-
#
|
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"),
|
5487
5492
|
# metadata: {
|
5488
5493
|
# },
|
5489
|
-
# tag_count: 2,
|
5490
5494
|
# version_id: "null",
|
5491
5495
|
# }
|
5492
5496
|
#
|
@@ -6034,49 +6038,49 @@ module Aws::S3
|
|
6034
6038
|
# * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
|
6035
6039
|
#
|
6036
6040
|
#
|
6037
|
-
# @example Example: To retrieve tag set of
|
6041
|
+
# @example Example: To retrieve tag set of a specific object version
|
6038
6042
|
#
|
6039
|
-
# # The following example retrieves tag set of an object.
|
6043
|
+
# # The following example retrieves tag set of an object. The request specifies object version.
|
6040
6044
|
#
|
6041
6045
|
# resp = client.get_object_tagging({
|
6042
6046
|
# bucket: "examplebucket",
|
6043
|
-
# key: "
|
6047
|
+
# key: "exampleobject",
|
6048
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6044
6049
|
# })
|
6045
6050
|
#
|
6046
6051
|
# resp.to_h outputs the following:
|
6047
6052
|
# {
|
6048
6053
|
# tag_set: [
|
6049
6054
|
# {
|
6050
|
-
# key: "
|
6051
|
-
# value: "
|
6052
|
-
# },
|
6053
|
-
# {
|
6054
|
-
# key: "Key3",
|
6055
|
-
# value: "Value3",
|
6055
|
+
# key: "Key1",
|
6056
|
+
# value: "Value1",
|
6056
6057
|
# },
|
6057
6058
|
# ],
|
6058
|
-
# version_id: "
|
6059
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6059
6060
|
# }
|
6060
6061
|
#
|
6061
|
-
# @example Example: To retrieve tag set of
|
6062
|
+
# @example Example: To retrieve tag set of an object
|
6062
6063
|
#
|
6063
|
-
# # The following example retrieves tag set of an object.
|
6064
|
+
# # The following example retrieves tag set of an object.
|
6064
6065
|
#
|
6065
6066
|
# resp = client.get_object_tagging({
|
6066
6067
|
# bucket: "examplebucket",
|
6067
|
-
# key: "
|
6068
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6068
|
+
# key: "HappyFace.jpg",
|
6069
6069
|
# })
|
6070
6070
|
#
|
6071
6071
|
# resp.to_h outputs the following:
|
6072
6072
|
# {
|
6073
6073
|
# tag_set: [
|
6074
6074
|
# {
|
6075
|
-
# key: "
|
6076
|
-
# value: "
|
6075
|
+
# key: "Key4",
|
6076
|
+
# value: "Value4",
|
6077
|
+
# },
|
6078
|
+
# {
|
6079
|
+
# key: "Key3",
|
6080
|
+
# value: "Value3",
|
6077
6081
|
# },
|
6078
6082
|
# ],
|
6079
|
-
# version_id: "
|
6083
|
+
# version_id: "null",
|
6080
6084
|
# }
|
6081
6085
|
#
|
6082
6086
|
# @example Request syntax with placeholder values
|
@@ -6390,10 +6394,9 @@ module Aws::S3
|
|
6390
6394
|
#
|
6391
6395
|
# <note markdown="1"> * Encryption request headers, like `x-amz-server-side-encryption`,
|
6392
6396
|
# should not be sent for GET requests if your object uses server-side
|
6393
|
-
# encryption with
|
6394
|
-
#
|
6395
|
-
#
|
6396
|
-
# 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.
|
6397
6400
|
#
|
6398
6401
|
# * The last modified property in this case is the creation date of the
|
6399
6402
|
# object.
|
@@ -6779,21 +6782,23 @@ module Aws::S3
|
|
6779
6782
|
#
|
6780
6783
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
6781
6784
|
# storage costs by automatically moving data to the most cost-effective
|
6782
|
-
# storage access tier, without
|
6783
|
-
# Intelligent-Tiering delivers automatic cost savings
|
6784
|
-
#
|
6785
|
-
#
|
6786
|
-
#
|
6787
|
-
#
|
6788
|
-
#
|
6789
|
-
#
|
6790
|
-
#
|
6791
|
-
#
|
6792
|
-
#
|
6793
|
-
#
|
6794
|
-
#
|
6795
|
-
#
|
6796
|
-
#
|
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].
|
6797
6802
|
#
|
6798
6803
|
# Operations related to `ListBucketIntelligentTieringConfigurations`
|
6799
6804
|
# include:
|
@@ -7041,10 +7046,12 @@ module Aws::S3
|
|
7041
7046
|
# resp.metrics_configuration_list[0].filter.prefix #=> String
|
7042
7047
|
# resp.metrics_configuration_list[0].filter.tag.key #=> String
|
7043
7048
|
# resp.metrics_configuration_list[0].filter.tag.value #=> String
|
7049
|
+
# resp.metrics_configuration_list[0].filter.access_point_arn #=> String
|
7044
7050
|
# resp.metrics_configuration_list[0].filter.and.prefix #=> String
|
7045
7051
|
# resp.metrics_configuration_list[0].filter.and.tags #=> Array
|
7046
7052
|
# resp.metrics_configuration_list[0].filter.and.tags[0].key #=> String
|
7047
7053
|
# resp.metrics_configuration_list[0].filter.and.tags[0].value #=> String
|
7054
|
+
# resp.metrics_configuration_list[0].filter.and.access_point_arn #=> String
|
7048
7055
|
#
|
7049
7056
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketMetricsConfigurations AWS API Documentation
|
7050
7057
|
#
|
@@ -7258,97 +7265,97 @@ module Aws::S3
|
|
7258
7265
|
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
7259
7266
|
#
|
7260
7267
|
#
|
7261
|
-
# @example Example:
|
7268
|
+
# @example Example: To list in-progress multipart uploads on a bucket
|
7262
7269
|
#
|
7263
|
-
# # The following example
|
7264
|
-
# # setup of multipart uploads.
|
7270
|
+
# # The following example lists in-progress multipart uploads on a specific bucket.
|
7265
7271
|
#
|
7266
7272
|
# resp = client.list_multipart_uploads({
|
7267
7273
|
# bucket: "examplebucket",
|
7268
|
-
# key_marker: "nextkeyfrompreviousresponse",
|
7269
|
-
# max_uploads: 2,
|
7270
|
-
# upload_id_marker: "valuefrompreviousresponse",
|
7271
7274
|
# })
|
7272
7275
|
#
|
7273
7276
|
# resp.to_h outputs the following:
|
7274
7277
|
# {
|
7275
|
-
# bucket: "acl1",
|
7276
|
-
# is_truncated: true,
|
7277
|
-
# key_marker: "",
|
7278
|
-
# max_uploads: 2,
|
7279
|
-
# next_key_marker: "someobjectkey",
|
7280
|
-
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7281
|
-
# upload_id_marker: "",
|
7282
7278
|
# uploads: [
|
7283
7279
|
# {
|
7284
7280
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
7285
7281
|
# initiator: {
|
7286
|
-
# display_name: "
|
7282
|
+
# display_name: "display-name",
|
7287
7283
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7288
7284
|
# },
|
7289
7285
|
# key: "JavaFile",
|
7290
7286
|
# owner: {
|
7291
|
-
# display_name: "
|
7292
|
-
# id: "
|
7287
|
+
# display_name: "display-name",
|
7288
|
+
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7293
7289
|
# },
|
7294
7290
|
# storage_class: "STANDARD",
|
7295
|
-
# upload_id: "
|
7291
|
+
# upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
7296
7292
|
# },
|
7297
7293
|
# {
|
7298
7294
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
7299
7295
|
# initiator: {
|
7300
|
-
# display_name: "
|
7296
|
+
# display_name: "display-name",
|
7301
7297
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7302
7298
|
# },
|
7303
7299
|
# key: "JavaFile",
|
7304
7300
|
# owner: {
|
7305
|
-
# display_name: "
|
7301
|
+
# display_name: "display-name",
|
7306
7302
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7307
7303
|
# },
|
7308
7304
|
# storage_class: "STANDARD",
|
7309
|
-
# upload_id: "
|
7305
|
+
# upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7310
7306
|
# },
|
7311
7307
|
# ],
|
7312
7308
|
# }
|
7313
7309
|
#
|
7314
|
-
# @example Example:
|
7310
|
+
# @example Example: List next set of multipart uploads when previous result is truncated
|
7315
7311
|
#
|
7316
|
-
# # 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.
|
7317
7314
|
#
|
7318
7315
|
# resp = client.list_multipart_uploads({
|
7319
7316
|
# bucket: "examplebucket",
|
7317
|
+
# key_marker: "nextkeyfrompreviousresponse",
|
7318
|
+
# max_uploads: 2,
|
7319
|
+
# upload_id_marker: "valuefrompreviousresponse",
|
7320
7320
|
# })
|
7321
7321
|
#
|
7322
7322
|
# resp.to_h outputs the following:
|
7323
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: "",
|
7324
7331
|
# uploads: [
|
7325
7332
|
# {
|
7326
7333
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
7327
7334
|
# initiator: {
|
7328
|
-
# display_name: "display-name",
|
7335
|
+
# display_name: "ownder-display-name",
|
7329
7336
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7330
7337
|
# },
|
7331
7338
|
# key: "JavaFile",
|
7332
7339
|
# owner: {
|
7333
|
-
# display_name: "
|
7334
|
-
# id: "
|
7340
|
+
# display_name: "mohanataws",
|
7341
|
+
# id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7335
7342
|
# },
|
7336
7343
|
# storage_class: "STANDARD",
|
7337
|
-
# upload_id: "
|
7344
|
+
# upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
7338
7345
|
# },
|
7339
7346
|
# {
|
7340
7347
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
7341
7348
|
# initiator: {
|
7342
|
-
# display_name: "display-name",
|
7349
|
+
# display_name: "ownder-display-name",
|
7343
7350
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7344
7351
|
# },
|
7345
7352
|
# key: "JavaFile",
|
7346
7353
|
# owner: {
|
7347
|
-
# display_name: "display-name",
|
7354
|
+
# display_name: "ownder-display-name",
|
7348
7355
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7349
7356
|
# },
|
7350
7357
|
# storage_class: "STANDARD",
|
7351
|
-
# upload_id: "
|
7358
|
+
# upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7352
7359
|
# },
|
7353
7360
|
# ],
|
7354
7361
|
# }
|
@@ -8822,12 +8829,12 @@ module Aws::S3
|
|
8822
8829
|
# encryption and Amazon S3 Bucket Key for an existing bucket.
|
8823
8830
|
#
|
8824
8831
|
# Default encryption for a bucket can use server-side encryption with
|
8825
|
-
# Amazon S3-managed keys (SSE-S3) or
|
8826
|
-
#
|
8827
|
-
#
|
8828
|
-
#
|
8829
|
-
#
|
8830
|
-
#
|
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*.
|
8831
8838
|
#
|
8832
8839
|
# This action requires Amazon Web Services Signature Version 4. For more
|
8833
8840
|
# information, see [ Authenticating Requests (Amazon Web Services
|
@@ -8859,10 +8866,10 @@ module Aws::S3
|
|
8859
8866
|
#
|
8860
8867
|
# @option params [required, String] :bucket
|
8861
8868
|
# Specifies default encryption for a bucket using server-side encryption
|
8862
|
-
# with Amazon S3-managed keys (SSE-S3) or customer
|
8863
|
-
#
|
8864
|
-
#
|
8865
|
-
#
|
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*.
|
8866
8873
|
#
|
8867
8874
|
#
|
8868
8875
|
#
|
@@ -8920,21 +8927,23 @@ module Aws::S3
|
|
8920
8927
|
#
|
8921
8928
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
8922
8929
|
# storage costs by automatically moving data to the most cost-effective
|
8923
|
-
# storage access tier, without
|
8924
|
-
# Intelligent-Tiering delivers automatic cost savings
|
8925
|
-
#
|
8926
|
-
#
|
8927
|
-
#
|
8928
|
-
#
|
8929
|
-
#
|
8930
|
-
#
|
8931
|
-
#
|
8932
|
-
#
|
8933
|
-
#
|
8934
|
-
#
|
8935
|
-
#
|
8936
|
-
#
|
8937
|
-
#
|
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].
|
8938
8947
|
#
|
8939
8948
|
# Operations related to `PutBucketIntelligentTieringConfiguration`
|
8940
8949
|
# include:
|
@@ -9652,7 +9661,7 @@ module Aws::S3
|
|
9652
9661
|
#
|
9653
9662
|
# * [DeleteBucketMetricsConfiguration][4]
|
9654
9663
|
#
|
9655
|
-
# * [
|
9664
|
+
# * [GetBucketMetricsConfiguration][5]
|
9656
9665
|
#
|
9657
9666
|
# * [ListBucketMetricsConfigurations][6]
|
9658
9667
|
#
|
@@ -9671,7 +9680,7 @@ module Aws::S3
|
|
9671
9680
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
9672
9681
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
|
9673
9682
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
|
9674
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
9683
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
|
9675
9684
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
|
9676
9685
|
#
|
9677
9686
|
# @option params [required, String] :bucket
|
@@ -9703,6 +9712,7 @@ module Aws::S3
|
|
9703
9712
|
# key: "ObjectKey", # required
|
9704
9713
|
# value: "Value", # required
|
9705
9714
|
# },
|
9715
|
+
# access_point_arn: "AccessPointArn",
|
9706
9716
|
# and: {
|
9707
9717
|
# prefix: "Prefix",
|
9708
9718
|
# tags: [
|
@@ -9711,6 +9721,7 @@ module Aws::S3
|
|
9711
9721
|
# value: "Value", # required
|
9712
9722
|
# },
|
9713
9723
|
# ],
|
9724
|
+
# access_point_arn: "AccessPointArn",
|
9714
9725
|
# },
|
9715
9726
|
# },
|
9716
9727
|
# },
|
@@ -10143,13 +10154,12 @@ module Aws::S3
|
|
10143
10154
|
# **Handling Replication of Encrypted Objects**
|
10144
10155
|
#
|
10145
10156
|
# By default, Amazon S3 doesn't replicate objects that are stored at
|
10146
|
-
# rest using server-side encryption with
|
10147
|
-
#
|
10148
|
-
#
|
10149
|
-
# `
|
10150
|
-
#
|
10151
|
-
#
|
10152
|
-
# 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].
|
10153
10163
|
#
|
10154
10164
|
# For information on `PutBucketReplication` errors, see [List of
|
10155
10165
|
# replication-related error codes][5]
|
@@ -11112,12 +11122,12 @@ module Aws::S3
|
|
11112
11122
|
# If `x-amz-server-side-encryption` is present and has the value of
|
11113
11123
|
# `aws:kms`, this header specifies the ID of the Amazon Web Services Key
|
11114
11124
|
# Management Service (Amazon Web Services KMS) symmetrical customer
|
11115
|
-
# managed
|
11116
|
-
#
|
11125
|
+
# managed key that was used for the object. If you specify
|
11126
|
+
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
11117
11127
|
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
11118
|
-
# Amazon Web Services managed
|
11119
|
-
#
|
11120
|
-
#
|
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.
|
11121
11131
|
#
|
11122
11132
|
# @option params [String] :ssekms_encryption_context
|
11123
11133
|
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
@@ -11182,134 +11192,134 @@ module Aws::S3
|
|
11182
11192
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
11183
11193
|
#
|
11184
11194
|
#
|
11185
|
-
# @example Example: To upload an object
|
11195
|
+
# @example Example: To upload an object and specify optional tags
|
11186
11196
|
#
|
11187
|
-
# # The following example uploads an object. The request specifies optional
|
11188
|
-
# #
|
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.
|
11189
11199
|
#
|
11190
11200
|
# resp = client.put_object({
|
11191
|
-
# body: "HappyFace.jpg",
|
11201
|
+
# body: "c:\\HappyFace.jpg",
|
11192
11202
|
# bucket: "examplebucket",
|
11193
11203
|
# key: "HappyFace.jpg",
|
11194
|
-
#
|
11195
|
-
# storage_class: "STANDARD_IA",
|
11204
|
+
# tagging: "key1=value1&key2=value2",
|
11196
11205
|
# })
|
11197
11206
|
#
|
11198
11207
|
# resp.to_h outputs the following:
|
11199
11208
|
# {
|
11200
11209
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11201
|
-
#
|
11202
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
11210
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
11203
11211
|
# }
|
11204
11212
|
#
|
11205
|
-
# @example Example: To upload an object and specify
|
11213
|
+
# @example Example: To upload an object and specify canned ACL.
|
11206
11214
|
#
|
11207
|
-
# # The following example uploads and object. The request specifies
|
11208
|
-
# #
|
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.
|
11209
11217
|
#
|
11210
11218
|
# resp = client.put_object({
|
11219
|
+
# acl: "authenticated-read",
|
11211
11220
|
# body: "filetoupload",
|
11212
11221
|
# bucket: "examplebucket",
|
11213
11222
|
# key: "exampleobject",
|
11214
|
-
# server_side_encryption: "AES256",
|
11215
|
-
# tagging: "key1=value1&key2=value2",
|
11216
11223
|
# })
|
11217
11224
|
#
|
11218
11225
|
# resp.to_h outputs the following:
|
11219
11226
|
# {
|
11220
11227
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11221
|
-
#
|
11222
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
11228
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
11223
11229
|
# }
|
11224
11230
|
#
|
11225
|
-
# @example Example: To
|
11231
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
11226
11232
|
#
|
11227
|
-
# # 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.
|
11228
11235
|
#
|
11229
11236
|
# resp = client.put_object({
|
11230
11237
|
# body: "filetoupload",
|
11231
11238
|
# bucket: "examplebucket",
|
11232
|
-
# key: "
|
11239
|
+
# key: "exampleobject",
|
11240
|
+
# server_side_encryption: "AES256",
|
11241
|
+
# tagging: "key1=value1&key2=value2",
|
11233
11242
|
# })
|
11234
11243
|
#
|
11235
11244
|
# resp.to_h outputs the following:
|
11236
11245
|
# {
|
11237
11246
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11238
|
-
#
|
11247
|
+
# server_side_encryption: "AES256",
|
11248
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
11239
11249
|
# }
|
11240
11250
|
#
|
11241
|
-
# @example Example: To
|
11251
|
+
# @example Example: To create an object.
|
11242
11252
|
#
|
11243
|
-
# # The following example creates an object.
|
11244
|
-
# # 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.
|
11245
11254
|
#
|
11246
11255
|
# resp = client.put_object({
|
11247
11256
|
# body: "filetoupload",
|
11248
11257
|
# bucket: "examplebucket",
|
11249
|
-
# key: "
|
11250
|
-
# metadata: {
|
11251
|
-
# "metadata1" => "value1",
|
11252
|
-
# "metadata2" => "value2",
|
11253
|
-
# },
|
11258
|
+
# key: "objectkey",
|
11254
11259
|
# })
|
11255
11260
|
#
|
11256
11261
|
# resp.to_h outputs the following:
|
11257
11262
|
# {
|
11258
11263
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11259
|
-
# version_id: "
|
11264
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
11260
11265
|
# }
|
11261
11266
|
#
|
11262
|
-
# @example Example: To upload an object
|
11267
|
+
# @example Example: To upload an object
|
11263
11268
|
#
|
11264
|
-
# # The following example uploads
|
11265
|
-
# #
|
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.
|
11266
11271
|
#
|
11267
11272
|
# resp = client.put_object({
|
11268
|
-
#
|
11269
|
-
# body: "filetoupload",
|
11273
|
+
# body: "HappyFace.jpg",
|
11270
11274
|
# bucket: "examplebucket",
|
11271
|
-
# key: "
|
11275
|
+
# key: "HappyFace.jpg",
|
11272
11276
|
# })
|
11273
11277
|
#
|
11274
11278
|
# resp.to_h outputs the following:
|
11275
11279
|
# {
|
11276
11280
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11277
|
-
# version_id: "
|
11281
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
11278
11282
|
# }
|
11279
11283
|
#
|
11280
|
-
# @example Example: To upload an object
|
11284
|
+
# @example Example: To upload an object (specify optional headers)
|
11281
11285
|
#
|
11282
|
-
# # The following example uploads an object
|
11283
|
-
# #
|
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.
|
11284
11288
|
#
|
11285
11289
|
# resp = client.put_object({
|
11286
11290
|
# body: "HappyFace.jpg",
|
11287
11291
|
# bucket: "examplebucket",
|
11288
11292
|
# key: "HappyFace.jpg",
|
11293
|
+
# server_side_encryption: "AES256",
|
11294
|
+
# storage_class: "STANDARD_IA",
|
11289
11295
|
# })
|
11290
11296
|
#
|
11291
11297
|
# resp.to_h outputs the following:
|
11292
11298
|
# {
|
11293
11299
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11294
|
-
#
|
11300
|
+
# server_side_encryption: "AES256",
|
11301
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
11295
11302
|
# }
|
11296
11303
|
#
|
11297
|
-
# @example Example: To upload
|
11304
|
+
# @example Example: To upload object and specify user-defined metadata
|
11298
11305
|
#
|
11299
|
-
# # The following example
|
11300
|
-
# # 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.
|
11301
11308
|
#
|
11302
11309
|
# resp = client.put_object({
|
11303
|
-
# body: "
|
11310
|
+
# body: "filetoupload",
|
11304
11311
|
# bucket: "examplebucket",
|
11305
|
-
# key: "
|
11306
|
-
#
|
11312
|
+
# key: "exampleobject",
|
11313
|
+
# metadata: {
|
11314
|
+
# "metadata1" => "value1",
|
11315
|
+
# "metadata2" => "value2",
|
11316
|
+
# },
|
11307
11317
|
# })
|
11308
11318
|
#
|
11309
11319
|
# resp.to_h outputs the following:
|
11310
11320
|
# {
|
11311
11321
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11312
|
-
# version_id: "
|
11322
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
11313
11323
|
# }
|
11314
11324
|
#
|
11315
11325
|
# @example Streaming a file from disk
|
@@ -12742,12 +12752,11 @@ module Aws::S3
|
|
12742
12752
|
# Encryption Keys)][5] in the *Amazon S3 User Guide*.
|
12743
12753
|
#
|
12744
12754
|
# For objects that are encrypted with Amazon S3 managed encryption
|
12745
|
-
# keys (SSE-S3) and
|
12746
|
-
#
|
12747
|
-
#
|
12748
|
-
#
|
12749
|
-
#
|
12750
|
-
# 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*.
|
12751
12760
|
#
|
12752
12761
|
# **Working with the Response Body**
|
12753
12762
|
#
|
@@ -13654,45 +13663,45 @@ module Aws::S3
|
|
13654
13663
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
13655
13664
|
#
|
13656
13665
|
#
|
13657
|
-
# @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
|
13658
13667
|
#
|
13659
|
-
# # The following example uploads a part of a multipart upload by copying
|
13660
|
-
# # data source.
|
13668
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
13661
13669
|
#
|
13662
13670
|
# resp = client.upload_part_copy({
|
13663
13671
|
# bucket: "examplebucket",
|
13664
13672
|
# copy_source: "/bucketname/sourceobjectkey",
|
13665
|
-
# copy_source_range: "bytes=1-100000",
|
13666
13673
|
# key: "examplelargeobject",
|
13667
|
-
# part_number:
|
13674
|
+
# part_number: 1,
|
13668
13675
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
13669
13676
|
# })
|
13670
13677
|
#
|
13671
13678
|
# resp.to_h outputs the following:
|
13672
13679
|
# {
|
13673
13680
|
# copy_part_result: {
|
13674
|
-
# etag: "\"
|
13675
|
-
# last_modified: Time.parse("2016-12-29T21:
|
13681
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
13682
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
13676
13683
|
# },
|
13677
13684
|
# }
|
13678
13685
|
#
|
13679
|
-
# @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
|
13680
13687
|
#
|
13681
|
-
# # 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.
|
13682
13690
|
#
|
13683
13691
|
# resp = client.upload_part_copy({
|
13684
13692
|
# bucket: "examplebucket",
|
13685
13693
|
# copy_source: "/bucketname/sourceobjectkey",
|
13694
|
+
# copy_source_range: "bytes=1-100000",
|
13686
13695
|
# key: "examplelargeobject",
|
13687
|
-
# part_number:
|
13696
|
+
# part_number: 2,
|
13688
13697
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
13689
13698
|
# })
|
13690
13699
|
#
|
13691
13700
|
# resp.to_h outputs the following:
|
13692
13701
|
# {
|
13693
13702
|
# copy_part_result: {
|
13694
|
-
# etag: "\"
|
13695
|
-
# last_modified: Time.parse("2016-12-29T21:
|
13703
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
13704
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
13696
13705
|
# },
|
13697
13706
|
# }
|
13698
13707
|
#
|
@@ -13742,9 +13751,9 @@ module Aws::S3
|
|
13742
13751
|
end
|
13743
13752
|
|
13744
13753
|
# Passes transformed objects to a `GetObject` operation when using
|
13745
|
-
# Object Lambda
|
13746
|
-
#
|
13747
|
-
#
|
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*.
|
13748
13757
|
#
|
13749
13758
|
# This operation supports metadata that can be returned by
|
13750
13759
|
# [GetObject][2], in addition to `RequestRoute`, `RequestToken`,
|
@@ -13766,8 +13775,8 @@ module Aws::S3
|
|
13766
13775
|
# identifiable information (PII) and decompress S3 objects. These Lambda
|
13767
13776
|
# functions are available in the Amazon Web Services Serverless
|
13768
13777
|
# Application Repository, and can be selected through the Amazon Web
|
13769
|
-
# Services Management Console when you create your Object Lambda
|
13770
|
-
#
|
13778
|
+
# Services Management Console when you create your Object Lambda access
|
13779
|
+
# point.
|
13771
13780
|
#
|
13772
13781
|
# Example 1: PII Access Control - This Lambda function uses Amazon
|
13773
13782
|
# Comprehend, a natural language processing (NLP) service using machine
|
@@ -13959,8 +13968,8 @@ module Aws::S3
|
|
13959
13968
|
#
|
13960
13969
|
# @option params [String] :ssekms_key_id
|
13961
13970
|
# If present, specifies the ID of the Amazon Web Services Key Management
|
13962
|
-
# Service (Amazon Web Services KMS) symmetric customer managed
|
13963
|
-
#
|
13971
|
+
# Service (Amazon Web Services KMS) symmetric customer managed key that
|
13972
|
+
# was used for stored in Amazon S3 object.
|
13964
13973
|
#
|
13965
13974
|
# @option params [String] :sse_customer_key_md5
|
13966
13975
|
# 128-bit MD5 digest of customer-provided encryption key used in Amazon
|
@@ -14052,7 +14061,7 @@ module Aws::S3
|
|
14052
14061
|
params: params,
|
14053
14062
|
config: config)
|
14054
14063
|
context[:gem_name] = 'aws-sdk-s3'
|
14055
|
-
context[:gem_version] = '1.
|
14064
|
+
context[:gem_version] = '1.103.0'
|
14056
14065
|
Seahorse::Client::Request.new(handlers, context)
|
14057
14066
|
end
|
14058
14067
|
|