aws-sdk-s3 1.102.0 → 1.105.1
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/access_point_arn.rb +6 -6
- data/lib/aws-sdk-s3/arn/multi_region_access_point_arn.rb +2 -3
- data/lib/aws-sdk-s3/arn/object_lambda_arn.rb +6 -6
- data/lib/aws-sdk-s3/arn/outpost_access_point_arn.rb +7 -6
- data/lib/aws-sdk-s3/bucket.rb +5 -5
- data/lib/aws-sdk-s3/client.rb +284 -270
- 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/plugins/accelerate.rb +7 -1
- data/lib/aws-sdk-s3/plugins/arn.rb +11 -24
- data/lib/aws-sdk-s3/plugins/bucket_dns.rb +1 -1
- data/lib/aws-sdk-s3/plugins/dualstack.rb +25 -31
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +19 -4
- data/lib/aws-sdk-s3/types.rb +78 -57
- data/lib/aws-sdk-s3.rb +1 -1
- metadata +4 -4
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -359,9 +359,14 @@ module Aws::S3
|
|
359
359
|
# for all object operations. You must first enable accelerate for
|
360
360
|
# each bucket. [Go here for more information](http://docs.aws.amazon.com/AmazonS3/latest/dev/transfer-acceleration.html).
|
361
361
|
#
|
362
|
-
# @option options [Boolean] :use_dualstack_endpoint
|
363
|
-
# When set to `true`,
|
364
|
-
#
|
362
|
+
# @option options [Boolean] :use_dualstack_endpoint
|
363
|
+
# When set to `true`, dualstack enabled endpoints (with `.aws` TLD)
|
364
|
+
# will be used if available.
|
365
|
+
#
|
366
|
+
# @option options [Boolean] :use_fips_endpoint
|
367
|
+
# When set to `true`, fips compatible endpoints will be used if available.
|
368
|
+
# When a `fips` region is used, the region is normalized and this config
|
369
|
+
# is set to `true`.
|
365
370
|
#
|
366
371
|
# @option options [Boolean] :validate_params (true)
|
367
372
|
# When `true`, request parameters are validated before
|
@@ -1465,33 +1470,33 @@ module Aws::S3
|
|
1465
1470
|
# * {Types::CreateBucketOutput#location #location} => String
|
1466
1471
|
#
|
1467
1472
|
#
|
1468
|
-
# @example Example: To create a bucket
|
1473
|
+
# @example Example: To create a bucket
|
1469
1474
|
#
|
1470
|
-
# # The following example creates a bucket.
|
1475
|
+
# # The following example creates a bucket.
|
1471
1476
|
#
|
1472
1477
|
# resp = client.create_bucket({
|
1473
1478
|
# bucket: "examplebucket",
|
1474
|
-
# create_bucket_configuration: {
|
1475
|
-
# location_constraint: "eu-west-1",
|
1476
|
-
# },
|
1477
1479
|
# })
|
1478
1480
|
#
|
1479
1481
|
# resp.to_h outputs the following:
|
1480
1482
|
# {
|
1481
|
-
# location: "
|
1483
|
+
# location: "/examplebucket",
|
1482
1484
|
# }
|
1483
1485
|
#
|
1484
|
-
# @example Example: To create a bucket
|
1486
|
+
# @example Example: To create a bucket in a specific region
|
1485
1487
|
#
|
1486
|
-
# # The following example creates a bucket.
|
1488
|
+
# # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
|
1487
1489
|
#
|
1488
1490
|
# resp = client.create_bucket({
|
1489
1491
|
# bucket: "examplebucket",
|
1492
|
+
# create_bucket_configuration: {
|
1493
|
+
# location_constraint: "eu-west-1",
|
1494
|
+
# },
|
1490
1495
|
# })
|
1491
1496
|
#
|
1492
1497
|
# resp.to_h outputs the following:
|
1493
1498
|
# {
|
1494
|
-
# location: "/
|
1499
|
+
# location: "http://examplebucket.<Region>.s3.amazonaws.com/",
|
1495
1500
|
# }
|
1496
1501
|
#
|
1497
1502
|
# @example Request syntax with placeholder values
|
@@ -1562,15 +1567,14 @@ module Aws::S3
|
|
1562
1567
|
# You can optionally request server-side encryption. For server-side
|
1563
1568
|
# encryption, Amazon S3 encrypts your data as it writes it to disks in
|
1564
1569
|
# 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
|
1570
|
+
# your own encryption key, or use Amazon Web Services KMS keys or Amazon
|
1571
|
+
# S3-managed encryption keys. If you choose to provide your own
|
1568
1572
|
# encryption key, the request headers you provide in [UploadPart][1] and
|
1569
1573
|
# [UploadPartCopy][6] requests must match the headers you used in the
|
1570
1574
|
# request to initiate the upload by using `CreateMultipartUpload`.
|
1571
1575
|
#
|
1572
1576
|
# To perform a multipart upload with encryption using an Amazon Web
|
1573
|
-
# Services KMS
|
1577
|
+
# Services KMS key, the requester must have permission to the
|
1574
1578
|
# `kms:Decrypt` and `kms:GenerateDataKey*` actions on the key. These
|
1575
1579
|
# permissions are required because Amazon S3 must decrypt and read data
|
1576
1580
|
# from the encrypted file parts before it completes the multipart
|
@@ -1578,11 +1582,10 @@ module Aws::S3
|
|
1578
1582
|
# permissions][7] in the *Amazon S3 User Guide*.
|
1579
1583
|
#
|
1580
1584
|
# 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.
|
1585
|
+
# same Amazon Web Services account as the KMS key, then you must have
|
1586
|
+
# these permissions on the key policy. If your IAM user or role belongs
|
1587
|
+
# to a different account than the key, then you must have the
|
1588
|
+
# permissions on both the key policy and your IAM user or role.
|
1586
1589
|
#
|
1587
1590
|
# For more information, see [Protecting Data Using Server-Side
|
1588
1591
|
# Encryption][8].
|
@@ -1615,11 +1618,11 @@ module Aws::S3
|
|
1615
1618
|
# option you use depends on whether you want to use Amazon Web
|
1616
1619
|
# Services managed encryption keys or provide your own encryption key.
|
1617
1620
|
#
|
1618
|
-
# * Use encryption keys managed by Amazon S3 or customer
|
1619
|
-
#
|
1620
|
-
#
|
1621
|
-
#
|
1622
|
-
#
|
1621
|
+
# * Use encryption keys managed by Amazon S3 or customer managed key
|
1622
|
+
# stored in Amazon Web Services Key Management Service (Amazon Web
|
1623
|
+
# Services KMS) – If you want Amazon Web Services to manage the keys
|
1624
|
+
# used to encrypt data, specify the following headers in the
|
1625
|
+
# request.
|
1623
1626
|
#
|
1624
1627
|
# * x-amz-server-side-encryption
|
1625
1628
|
#
|
@@ -1629,7 +1632,7 @@ module Aws::S3
|
|
1629
1632
|
#
|
1630
1633
|
# <note markdown="1"> If you specify `x-amz-server-side-encryption:aws:kms`, but don't
|
1631
1634
|
# provide `x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3
|
1632
|
-
# uses the Amazon Web Services managed
|
1635
|
+
# uses the Amazon Web Services managed key in Amazon Web Services
|
1633
1636
|
# KMS to protect the data.
|
1634
1637
|
#
|
1635
1638
|
# </note>
|
@@ -1638,10 +1641,9 @@ module Aws::S3
|
|
1638
1641
|
# Services KMS fail if you don't make them with SSL or by using
|
1639
1642
|
# SigV4.
|
1640
1643
|
#
|
1641
|
-
# For more information about server-side encryption with
|
1642
|
-
#
|
1643
|
-
#
|
1644
|
-
# KMS][11].
|
1644
|
+
# For more information about server-side encryption with KMS key
|
1645
|
+
# (SSE-KMS), see [Protecting Data Using Server-Side Encryption with
|
1646
|
+
# KMS keys][11].
|
1645
1647
|
#
|
1646
1648
|
# * Use customer-provided encryption keys – If you want to manage your
|
1647
1649
|
# own encryption keys, provide all the following headers in the
|
@@ -1653,10 +1655,9 @@ module Aws::S3
|
|
1653
1655
|
#
|
1654
1656
|
# * x-amz-server-side-encryption-customer-key-MD5
|
1655
1657
|
#
|
1656
|
-
# For more information about server-side encryption with
|
1657
|
-
#
|
1658
|
-
#
|
1659
|
-
# KMS][11].
|
1658
|
+
# For more information about server-side encryption with KMS keys
|
1659
|
+
# (SSE-KMS), see [Protecting Data Using Server-Side Encryption with
|
1660
|
+
# KMS keys][11].
|
1660
1661
|
#
|
1661
1662
|
# Access-Control-List (ACL)-Specific Request Headers
|
1662
1663
|
#
|
@@ -1881,13 +1882,13 @@ module Aws::S3
|
|
1881
1882
|
# ensure that the encryption key was transmitted without error.
|
1882
1883
|
#
|
1883
1884
|
# @option params [String] :ssekms_key_id
|
1884
|
-
# Specifies the ID of the symmetric customer managed
|
1885
|
-
#
|
1886
|
-
#
|
1887
|
-
#
|
1888
|
-
#
|
1889
|
-
#
|
1890
|
-
#
|
1885
|
+
# Specifies the ID of the symmetric customer managed key to use for
|
1886
|
+
# object encryption. All GET and PUT requests for an object protected by
|
1887
|
+
# Amazon Web Services KMS will fail if not made via SSL or using SigV4.
|
1888
|
+
# For information about configuring using any of the officially
|
1889
|
+
# supported Amazon Web Services SDKs and Amazon Web Services CLI, see
|
1890
|
+
# [Specifying the Signature Version in Request Authentication][1] in the
|
1891
|
+
# *Amazon S3 User Guide*.
|
1891
1892
|
#
|
1892
1893
|
#
|
1893
1894
|
#
|
@@ -2257,21 +2258,23 @@ module Aws::S3
|
|
2257
2258
|
#
|
2258
2259
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
2259
2260
|
# 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
|
-
#
|
2261
|
+
# storage access tier, without performance impact or operational
|
2262
|
+
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
2263
|
+
# two low latency and high throughput access tiers. For data that can be
|
2264
|
+
# accessed asynchronously, you can choose to activate automatic
|
2265
|
+
# archiving capabilities within the S3 Intelligent-Tiering storage
|
2266
|
+
# class.
|
2267
|
+
#
|
2268
|
+
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
2269
|
+
# for data with unknown, changing, or unpredictable access patterns,
|
2270
|
+
# independent of object size or retention period. If the size of an
|
2271
|
+
# object is less than 128 KB, it is not eligible for auto-tiering.
|
2272
|
+
# Smaller objects can be stored, but they are always charged at the
|
2273
|
+
# Frequent Access tier rates in the S3 Intelligent-Tiering storage
|
2274
|
+
# class.
|
2275
|
+
#
|
2276
|
+
# For more information, see [Storage class for automatically optimizing
|
2277
|
+
# frequently and infrequently accessed objects][1].
|
2275
2278
|
#
|
2276
2279
|
# Operations related to `DeleteBucketIntelligentTieringConfiguration`
|
2277
2280
|
# include:
|
@@ -3721,21 +3724,23 @@ module Aws::S3
|
|
3721
3724
|
#
|
3722
3725
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
3723
3726
|
# 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
|
-
#
|
3727
|
+
# storage access tier, without performance impact or operational
|
3728
|
+
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
3729
|
+
# two low latency and high throughput access tiers. For data that can be
|
3730
|
+
# accessed asynchronously, you can choose to activate automatic
|
3731
|
+
# archiving capabilities within the S3 Intelligent-Tiering storage
|
3732
|
+
# class.
|
3733
|
+
#
|
3734
|
+
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
3735
|
+
# for data with unknown, changing, or unpredictable access patterns,
|
3736
|
+
# independent of object size or retention period. If the size of an
|
3737
|
+
# object is less than 128 KB, it is not eligible for auto-tiering.
|
3738
|
+
# Smaller objects can be stored, but they are always charged at the
|
3739
|
+
# Frequent Access tier rates in the S3 Intelligent-Tiering storage
|
3740
|
+
# class.
|
3741
|
+
#
|
3742
|
+
# For more information, see [Storage class for automatically optimizing
|
3743
|
+
# frequently and infrequently accessed objects][1].
|
3739
3744
|
#
|
3740
3745
|
# Operations related to `GetBucketIntelligentTieringConfiguration`
|
3741
3746
|
# include:
|
@@ -4302,10 +4307,12 @@ module Aws::S3
|
|
4302
4307
|
# resp.metrics_configuration.filter.prefix #=> String
|
4303
4308
|
# resp.metrics_configuration.filter.tag.key #=> String
|
4304
4309
|
# resp.metrics_configuration.filter.tag.value #=> String
|
4310
|
+
# resp.metrics_configuration.filter.access_point_arn #=> String
|
4305
4311
|
# resp.metrics_configuration.filter.and.prefix #=> String
|
4306
4312
|
# resp.metrics_configuration.filter.and.tags #=> Array
|
4307
4313
|
# resp.metrics_configuration.filter.and.tags[0].key #=> String
|
4308
4314
|
# resp.metrics_configuration.filter.and.tags[0].value #=> String
|
4315
|
+
# resp.metrics_configuration.filter.and.access_point_arn #=> String
|
4309
4316
|
#
|
4310
4317
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketMetricsConfiguration AWS API Documentation
|
4311
4318
|
#
|
@@ -5163,10 +5170,9 @@ module Aws::S3
|
|
5163
5170
|
#
|
5164
5171
|
# Encryption request headers, like `x-amz-server-side-encryption`,
|
5165
5172
|
# should not be sent for GET requests if your object uses server-side
|
5166
|
-
# encryption with
|
5167
|
-
#
|
5168
|
-
#
|
5169
|
-
# HTTP 400 BadRequest error.
|
5173
|
+
# encryption with KMS keys (SSE-KMS) or server-side encryption with
|
5174
|
+
# Amazon S3–managed encryption keys (SSE-S3). If your object does use
|
5175
|
+
# these types of keys, you’ll get an HTTP 400 BadRequest error.
|
5170
5176
|
#
|
5171
5177
|
# If you encrypt an object by using server-side encryption with
|
5172
5178
|
# customer-provided encryption keys (SSE-C) when you store the object in
|
@@ -5301,6 +5307,9 @@ module Aws::S3
|
|
5301
5307
|
# name. For more information about access point ARNs, see [Using access
|
5302
5308
|
# points][1] in the *Amazon S3 User Guide*.
|
5303
5309
|
#
|
5310
|
+
# When using an Object Lambda access point the hostname takes the form
|
5311
|
+
# *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com.
|
5312
|
+
#
|
5304
5313
|
# When using this action with Amazon S3 on Outposts, you must direct
|
5305
5314
|
# requests to the S3 on Outposts hostname. The S3 on Outposts hostname
|
5306
5315
|
# takes the form
|
@@ -5444,49 +5453,49 @@ module Aws::S3
|
|
5444
5453
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
5445
5454
|
#
|
5446
5455
|
#
|
5447
|
-
# @example Example: To retrieve
|
5456
|
+
# @example Example: To retrieve an object
|
5448
5457
|
#
|
5449
|
-
# # The following example retrieves an object for an S3 bucket.
|
5450
|
-
# # specific byte range.
|
5458
|
+
# # The following example retrieves an object for an S3 bucket.
|
5451
5459
|
#
|
5452
5460
|
# resp = client.get_object({
|
5453
5461
|
# bucket: "examplebucket",
|
5454
|
-
# key: "
|
5455
|
-
# range: "bytes=0-9",
|
5462
|
+
# key: "HappyFace.jpg",
|
5456
5463
|
# })
|
5457
5464
|
#
|
5458
5465
|
# resp.to_h outputs the following:
|
5459
5466
|
# {
|
5460
5467
|
# accept_ranges: "bytes",
|
5461
|
-
# content_length:
|
5462
|
-
#
|
5463
|
-
#
|
5464
|
-
#
|
5465
|
-
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
5468
|
+
# content_length: 3191,
|
5469
|
+
# content_type: "image/jpeg",
|
5470
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
5471
|
+
# last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
|
5466
5472
|
# metadata: {
|
5467
5473
|
# },
|
5474
|
+
# tag_count: 2,
|
5468
5475
|
# version_id: "null",
|
5469
5476
|
# }
|
5470
5477
|
#
|
5471
|
-
# @example Example: To retrieve an object
|
5478
|
+
# @example Example: To retrieve a byte range of an object
|
5472
5479
|
#
|
5473
|
-
# # The following example retrieves an object for an S3 bucket.
|
5480
|
+
# # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
|
5481
|
+
# # specific byte range.
|
5474
5482
|
#
|
5475
5483
|
# resp = client.get_object({
|
5476
5484
|
# bucket: "examplebucket",
|
5477
|
-
# key: "
|
5485
|
+
# key: "SampleFile.txt",
|
5486
|
+
# range: "bytes=0-9",
|
5478
5487
|
# })
|
5479
5488
|
#
|
5480
5489
|
# resp.to_h outputs the following:
|
5481
5490
|
# {
|
5482
5491
|
# accept_ranges: "bytes",
|
5483
|
-
# content_length:
|
5484
|
-
#
|
5485
|
-
#
|
5486
|
-
#
|
5492
|
+
# content_length: 10,
|
5493
|
+
# content_range: "bytes 0-9/43",
|
5494
|
+
# content_type: "text/plain",
|
5495
|
+
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
5496
|
+
# last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
|
5487
5497
|
# metadata: {
|
5488
5498
|
# },
|
5489
|
-
# tag_count: 2,
|
5490
5499
|
# version_id: "null",
|
5491
5500
|
# }
|
5492
5501
|
#
|
@@ -6034,49 +6043,49 @@ module Aws::S3
|
|
6034
6043
|
# * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
|
6035
6044
|
#
|
6036
6045
|
#
|
6037
|
-
# @example Example: To retrieve tag set of
|
6046
|
+
# @example Example: To retrieve tag set of a specific object version
|
6038
6047
|
#
|
6039
|
-
# # The following example retrieves tag set of an object.
|
6048
|
+
# # The following example retrieves tag set of an object. The request specifies object version.
|
6040
6049
|
#
|
6041
6050
|
# resp = client.get_object_tagging({
|
6042
6051
|
# bucket: "examplebucket",
|
6043
|
-
# key: "
|
6052
|
+
# key: "exampleobject",
|
6053
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6044
6054
|
# })
|
6045
6055
|
#
|
6046
6056
|
# resp.to_h outputs the following:
|
6047
6057
|
# {
|
6048
6058
|
# tag_set: [
|
6049
6059
|
# {
|
6050
|
-
# key: "
|
6051
|
-
# value: "
|
6052
|
-
# },
|
6053
|
-
# {
|
6054
|
-
# key: "Key3",
|
6055
|
-
# value: "Value3",
|
6060
|
+
# key: "Key1",
|
6061
|
+
# value: "Value1",
|
6056
6062
|
# },
|
6057
6063
|
# ],
|
6058
|
-
# version_id: "
|
6064
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6059
6065
|
# }
|
6060
6066
|
#
|
6061
|
-
# @example Example: To retrieve tag set of
|
6067
|
+
# @example Example: To retrieve tag set of an object
|
6062
6068
|
#
|
6063
|
-
# # The following example retrieves tag set of an object.
|
6069
|
+
# # The following example retrieves tag set of an object.
|
6064
6070
|
#
|
6065
6071
|
# resp = client.get_object_tagging({
|
6066
6072
|
# bucket: "examplebucket",
|
6067
|
-
# key: "
|
6068
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6073
|
+
# key: "HappyFace.jpg",
|
6069
6074
|
# })
|
6070
6075
|
#
|
6071
6076
|
# resp.to_h outputs the following:
|
6072
6077
|
# {
|
6073
6078
|
# tag_set: [
|
6074
6079
|
# {
|
6075
|
-
# key: "
|
6076
|
-
# value: "
|
6080
|
+
# key: "Key4",
|
6081
|
+
# value: "Value4",
|
6082
|
+
# },
|
6083
|
+
# {
|
6084
|
+
# key: "Key3",
|
6085
|
+
# value: "Value3",
|
6077
6086
|
# },
|
6078
6087
|
# ],
|
6079
|
-
# version_id: "
|
6088
|
+
# version_id: "null",
|
6080
6089
|
# }
|
6081
6090
|
#
|
6082
6091
|
# @example Request syntax with placeholder values
|
@@ -6390,10 +6399,9 @@ module Aws::S3
|
|
6390
6399
|
#
|
6391
6400
|
# <note markdown="1"> * Encryption request headers, like `x-amz-server-side-encryption`,
|
6392
6401
|
# should not be sent for GET requests if your object uses server-side
|
6393
|
-
# encryption with
|
6394
|
-
#
|
6395
|
-
#
|
6396
|
-
# HTTP 400 BadRequest error.
|
6402
|
+
# encryption with KMS keys (SSE-KMS) or server-side encryption with
|
6403
|
+
# Amazon S3–managed encryption keys (SSE-S3). If your object does use
|
6404
|
+
# these types of keys, you’ll get an HTTP 400 BadRequest error.
|
6397
6405
|
#
|
6398
6406
|
# * The last modified property in this case is the creation date of the
|
6399
6407
|
# object.
|
@@ -6779,21 +6787,23 @@ module Aws::S3
|
|
6779
6787
|
#
|
6780
6788
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
6781
6789
|
# 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
|
-
#
|
6790
|
+
# storage access tier, without performance impact or operational
|
6791
|
+
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
6792
|
+
# two low latency and high throughput access tiers. For data that can be
|
6793
|
+
# accessed asynchronously, you can choose to activate automatic
|
6794
|
+
# archiving capabilities within the S3 Intelligent-Tiering storage
|
6795
|
+
# class.
|
6796
|
+
#
|
6797
|
+
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
6798
|
+
# for data with unknown, changing, or unpredictable access patterns,
|
6799
|
+
# independent of object size or retention period. If the size of an
|
6800
|
+
# object is less than 128 KB, it is not eligible for auto-tiering.
|
6801
|
+
# Smaller objects can be stored, but they are always charged at the
|
6802
|
+
# Frequent Access tier rates in the S3 Intelligent-Tiering storage
|
6803
|
+
# class.
|
6804
|
+
#
|
6805
|
+
# For more information, see [Storage class for automatically optimizing
|
6806
|
+
# frequently and infrequently accessed objects][1].
|
6797
6807
|
#
|
6798
6808
|
# Operations related to `ListBucketIntelligentTieringConfigurations`
|
6799
6809
|
# include:
|
@@ -7041,10 +7051,12 @@ module Aws::S3
|
|
7041
7051
|
# resp.metrics_configuration_list[0].filter.prefix #=> String
|
7042
7052
|
# resp.metrics_configuration_list[0].filter.tag.key #=> String
|
7043
7053
|
# resp.metrics_configuration_list[0].filter.tag.value #=> String
|
7054
|
+
# resp.metrics_configuration_list[0].filter.access_point_arn #=> String
|
7044
7055
|
# resp.metrics_configuration_list[0].filter.and.prefix #=> String
|
7045
7056
|
# resp.metrics_configuration_list[0].filter.and.tags #=> Array
|
7046
7057
|
# resp.metrics_configuration_list[0].filter.and.tags[0].key #=> String
|
7047
7058
|
# resp.metrics_configuration_list[0].filter.and.tags[0].value #=> String
|
7059
|
+
# resp.metrics_configuration_list[0].filter.and.access_point_arn #=> String
|
7048
7060
|
#
|
7049
7061
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketMetricsConfigurations AWS API Documentation
|
7050
7062
|
#
|
@@ -7258,97 +7270,97 @@ module Aws::S3
|
|
7258
7270
|
# The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
|
7259
7271
|
#
|
7260
7272
|
#
|
7261
|
-
# @example Example:
|
7273
|
+
# @example Example: To list in-progress multipart uploads on a bucket
|
7262
7274
|
#
|
7263
|
-
# # The following example
|
7264
|
-
# # setup of multipart uploads.
|
7275
|
+
# # The following example lists in-progress multipart uploads on a specific bucket.
|
7265
7276
|
#
|
7266
7277
|
# resp = client.list_multipart_uploads({
|
7267
7278
|
# bucket: "examplebucket",
|
7268
|
-
# key_marker: "nextkeyfrompreviousresponse",
|
7269
|
-
# max_uploads: 2,
|
7270
|
-
# upload_id_marker: "valuefrompreviousresponse",
|
7271
7279
|
# })
|
7272
7280
|
#
|
7273
7281
|
# resp.to_h outputs the following:
|
7274
7282
|
# {
|
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
7283
|
# uploads: [
|
7283
7284
|
# {
|
7284
7285
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
7285
7286
|
# initiator: {
|
7286
|
-
# display_name: "
|
7287
|
+
# display_name: "display-name",
|
7287
7288
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7288
7289
|
# },
|
7289
7290
|
# key: "JavaFile",
|
7290
7291
|
# owner: {
|
7291
|
-
# display_name: "
|
7292
|
-
# id: "
|
7292
|
+
# display_name: "display-name",
|
7293
|
+
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7293
7294
|
# },
|
7294
7295
|
# storage_class: "STANDARD",
|
7295
|
-
# upload_id: "
|
7296
|
+
# upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
7296
7297
|
# },
|
7297
7298
|
# {
|
7298
7299
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
7299
7300
|
# initiator: {
|
7300
|
-
# display_name: "
|
7301
|
+
# display_name: "display-name",
|
7301
7302
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7302
7303
|
# },
|
7303
7304
|
# key: "JavaFile",
|
7304
7305
|
# owner: {
|
7305
|
-
# display_name: "
|
7306
|
+
# display_name: "display-name",
|
7306
7307
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7307
7308
|
# },
|
7308
7309
|
# storage_class: "STANDARD",
|
7309
|
-
# upload_id: "
|
7310
|
+
# upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7310
7311
|
# },
|
7311
7312
|
# ],
|
7312
7313
|
# }
|
7313
7314
|
#
|
7314
|
-
# @example Example:
|
7315
|
+
# @example Example: List next set of multipart uploads when previous result is truncated
|
7315
7316
|
#
|
7316
|
-
# # The following example
|
7317
|
+
# # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
|
7318
|
+
# # setup of multipart uploads.
|
7317
7319
|
#
|
7318
7320
|
# resp = client.list_multipart_uploads({
|
7319
7321
|
# bucket: "examplebucket",
|
7322
|
+
# key_marker: "nextkeyfrompreviousresponse",
|
7323
|
+
# max_uploads: 2,
|
7324
|
+
# upload_id_marker: "valuefrompreviousresponse",
|
7320
7325
|
# })
|
7321
7326
|
#
|
7322
7327
|
# resp.to_h outputs the following:
|
7323
7328
|
# {
|
7329
|
+
# bucket: "acl1",
|
7330
|
+
# is_truncated: true,
|
7331
|
+
# key_marker: "",
|
7332
|
+
# max_uploads: 2,
|
7333
|
+
# next_key_marker: "someobjectkey",
|
7334
|
+
# next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7335
|
+
# upload_id_marker: "",
|
7324
7336
|
# uploads: [
|
7325
7337
|
# {
|
7326
7338
|
# initiated: Time.parse("2014-05-01T05:40:58.000Z"),
|
7327
7339
|
# initiator: {
|
7328
|
-
# display_name: "display-name",
|
7340
|
+
# display_name: "ownder-display-name",
|
7329
7341
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7330
7342
|
# },
|
7331
7343
|
# key: "JavaFile",
|
7332
7344
|
# owner: {
|
7333
|
-
# display_name: "
|
7334
|
-
# id: "
|
7345
|
+
# display_name: "mohanataws",
|
7346
|
+
# id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7335
7347
|
# },
|
7336
7348
|
# storage_class: "STANDARD",
|
7337
|
-
# upload_id: "
|
7349
|
+
# upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
|
7338
7350
|
# },
|
7339
7351
|
# {
|
7340
7352
|
# initiated: Time.parse("2014-05-01T05:41:27.000Z"),
|
7341
7353
|
# initiator: {
|
7342
|
-
# display_name: "display-name",
|
7354
|
+
# display_name: "ownder-display-name",
|
7343
7355
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7344
7356
|
# },
|
7345
7357
|
# key: "JavaFile",
|
7346
7358
|
# owner: {
|
7347
|
-
# display_name: "display-name",
|
7359
|
+
# display_name: "ownder-display-name",
|
7348
7360
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
7349
7361
|
# },
|
7350
7362
|
# storage_class: "STANDARD",
|
7351
|
-
# upload_id: "
|
7363
|
+
# upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
7352
7364
|
# },
|
7353
7365
|
# ],
|
7354
7366
|
# }
|
@@ -8822,12 +8834,12 @@ module Aws::S3
|
|
8822
8834
|
# encryption and Amazon S3 Bucket Key for an existing bucket.
|
8823
8835
|
#
|
8824
8836
|
# Default encryption for a bucket can use server-side encryption with
|
8825
|
-
# Amazon S3-managed keys (SSE-S3) or
|
8826
|
-
#
|
8827
|
-
#
|
8828
|
-
#
|
8829
|
-
#
|
8830
|
-
#
|
8837
|
+
# Amazon S3-managed keys (SSE-S3) or customer managed keys (SSE-KMS). If
|
8838
|
+
# you specify default encryption using SSE-KMS, you can also configure
|
8839
|
+
# Amazon S3 Bucket Key. For information about default encryption, see
|
8840
|
+
# [Amazon S3 default bucket encryption][1] in the *Amazon S3 User
|
8841
|
+
# Guide*. For more information about S3 Bucket Keys, see [Amazon S3
|
8842
|
+
# Bucket Keys][2] in the *Amazon S3 User Guide*.
|
8831
8843
|
#
|
8832
8844
|
# This action requires Amazon Web Services Signature Version 4. For more
|
8833
8845
|
# information, see [ Authenticating Requests (Amazon Web Services
|
@@ -8859,10 +8871,10 @@ module Aws::S3
|
|
8859
8871
|
#
|
8860
8872
|
# @option params [required, String] :bucket
|
8861
8873
|
# Specifies default encryption for a bucket using server-side encryption
|
8862
|
-
# with Amazon S3-managed keys (SSE-S3) or customer
|
8863
|
-
#
|
8864
|
-
#
|
8865
|
-
#
|
8874
|
+
# with Amazon S3-managed keys (SSE-S3) or customer managed keys
|
8875
|
+
# (SSE-KMS). For information about the Amazon S3 default encryption
|
8876
|
+
# feature, see [Amazon S3 Default Bucket Encryption][1] in the *Amazon
|
8877
|
+
# S3 User Guide*.
|
8866
8878
|
#
|
8867
8879
|
#
|
8868
8880
|
#
|
@@ -8920,21 +8932,23 @@ module Aws::S3
|
|
8920
8932
|
#
|
8921
8933
|
# The S3 Intelligent-Tiering storage class is designed to optimize
|
8922
8934
|
# 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
|
-
#
|
8935
|
+
# storage access tier, without performance impact or operational
|
8936
|
+
# overhead. S3 Intelligent-Tiering delivers automatic cost savings in
|
8937
|
+
# two low latency and high throughput access tiers. For data that can be
|
8938
|
+
# accessed asynchronously, you can choose to activate automatic
|
8939
|
+
# archiving capabilities within the S3 Intelligent-Tiering storage
|
8940
|
+
# class.
|
8941
|
+
#
|
8942
|
+
# The S3 Intelligent-Tiering storage class is the ideal storage class
|
8943
|
+
# for data with unknown, changing, or unpredictable access patterns,
|
8944
|
+
# independent of object size or retention period. If the size of an
|
8945
|
+
# object is less than 128 KB, it is not eligible for auto-tiering.
|
8946
|
+
# Smaller objects can be stored, but they are always charged at the
|
8947
|
+
# Frequent Access tier rates in the S3 Intelligent-Tiering storage
|
8948
|
+
# class.
|
8949
|
+
#
|
8950
|
+
# For more information, see [Storage class for automatically optimizing
|
8951
|
+
# frequently and infrequently accessed objects][1].
|
8938
8952
|
#
|
8939
8953
|
# Operations related to `PutBucketIntelligentTieringConfiguration`
|
8940
8954
|
# include:
|
@@ -9652,7 +9666,7 @@ module Aws::S3
|
|
9652
9666
|
#
|
9653
9667
|
# * [DeleteBucketMetricsConfiguration][4]
|
9654
9668
|
#
|
9655
|
-
# * [
|
9669
|
+
# * [GetBucketMetricsConfiguration][5]
|
9656
9670
|
#
|
9657
9671
|
# * [ListBucketMetricsConfigurations][6]
|
9658
9672
|
#
|
@@ -9671,7 +9685,7 @@ module Aws::S3
|
|
9671
9685
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html
|
9672
9686
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html
|
9673
9687
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketMetricsConfiguration.html
|
9674
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
9688
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketMetricsConfiguration.html
|
9675
9689
|
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListBucketMetricsConfigurations.html
|
9676
9690
|
#
|
9677
9691
|
# @option params [required, String] :bucket
|
@@ -9703,6 +9717,7 @@ module Aws::S3
|
|
9703
9717
|
# key: "ObjectKey", # required
|
9704
9718
|
# value: "Value", # required
|
9705
9719
|
# },
|
9720
|
+
# access_point_arn: "AccessPointArn",
|
9706
9721
|
# and: {
|
9707
9722
|
# prefix: "Prefix",
|
9708
9723
|
# tags: [
|
@@ -9711,6 +9726,7 @@ module Aws::S3
|
|
9711
9726
|
# value: "Value", # required
|
9712
9727
|
# },
|
9713
9728
|
# ],
|
9729
|
+
# access_point_arn: "AccessPointArn",
|
9714
9730
|
# },
|
9715
9731
|
# },
|
9716
9732
|
# },
|
@@ -10143,13 +10159,12 @@ module Aws::S3
|
|
10143
10159
|
# **Handling Replication of Encrypted Objects**
|
10144
10160
|
#
|
10145
10161
|
# 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].
|
10162
|
+
# rest using server-side encryption with KMS keys. To replicate Amazon
|
10163
|
+
# Web Services KMS-encrypted objects, add the following:
|
10164
|
+
# `SourceSelectionCriteria`, `SseKmsEncryptedObjects`, `Status`,
|
10165
|
+
# `EncryptionConfiguration`, and `ReplicaKmsKeyID`. For information
|
10166
|
+
# about replication configuration, see [Replicating Objects Created with
|
10167
|
+
# SSE Using KMS keys][4].
|
10153
10168
|
#
|
10154
10169
|
# For information on `PutBucketReplication` errors, see [List of
|
10155
10170
|
# replication-related error codes][5]
|
@@ -11112,12 +11127,12 @@ module Aws::S3
|
|
11112
11127
|
# If `x-amz-server-side-encryption` is present and has the value of
|
11113
11128
|
# `aws:kms`, this header specifies the ID of the Amazon Web Services Key
|
11114
11129
|
# Management Service (Amazon Web Services KMS) symmetrical customer
|
11115
|
-
# managed
|
11116
|
-
#
|
11130
|
+
# managed key that was used for the object. If you specify
|
11131
|
+
# `x-amz-server-side-encryption:aws:kms`, but do not provide`
|
11117
11132
|
# x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
|
11118
|
-
# Amazon Web Services managed
|
11119
|
-
#
|
11120
|
-
#
|
11133
|
+
# Amazon Web Services managed key to protect the data. If the KMS key
|
11134
|
+
# does not exist in the same account issuing the command, you must use
|
11135
|
+
# the full ARN and not just the ID.
|
11121
11136
|
#
|
11122
11137
|
# @option params [String] :ssekms_encryption_context
|
11123
11138
|
# Specifies the Amazon Web Services KMS Encryption Context to use for
|
@@ -11182,134 +11197,134 @@ module Aws::S3
|
|
11182
11197
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
11183
11198
|
#
|
11184
11199
|
#
|
11185
|
-
# @example Example: To upload an object
|
11200
|
+
# @example Example: To upload an object and specify optional tags
|
11186
11201
|
#
|
11187
|
-
# # The following example uploads an object. The request specifies optional
|
11188
|
-
# #
|
11202
|
+
# # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
|
11203
|
+
# # S3 returns version ID of the newly created object.
|
11189
11204
|
#
|
11190
11205
|
# resp = client.put_object({
|
11191
|
-
# body: "HappyFace.jpg",
|
11206
|
+
# body: "c:\\HappyFace.jpg",
|
11192
11207
|
# bucket: "examplebucket",
|
11193
11208
|
# key: "HappyFace.jpg",
|
11194
|
-
#
|
11195
|
-
# storage_class: "STANDARD_IA",
|
11209
|
+
# tagging: "key1=value1&key2=value2",
|
11196
11210
|
# })
|
11197
11211
|
#
|
11198
11212
|
# resp.to_h outputs the following:
|
11199
11213
|
# {
|
11200
11214
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11201
|
-
#
|
11202
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
11215
|
+
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
11203
11216
|
# }
|
11204
11217
|
#
|
11205
|
-
# @example Example: To upload an object and specify
|
11218
|
+
# @example Example: To upload an object and specify canned ACL.
|
11206
11219
|
#
|
11207
|
-
# # The following example uploads and object. The request specifies
|
11208
|
-
# #
|
11220
|
+
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
11221
|
+
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
11209
11222
|
#
|
11210
11223
|
# resp = client.put_object({
|
11224
|
+
# acl: "authenticated-read",
|
11211
11225
|
# body: "filetoupload",
|
11212
11226
|
# bucket: "examplebucket",
|
11213
11227
|
# key: "exampleobject",
|
11214
|
-
# server_side_encryption: "AES256",
|
11215
|
-
# tagging: "key1=value1&key2=value2",
|
11216
11228
|
# })
|
11217
11229
|
#
|
11218
11230
|
# resp.to_h outputs the following:
|
11219
11231
|
# {
|
11220
11232
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11221
|
-
#
|
11222
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
11233
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
11223
11234
|
# }
|
11224
11235
|
#
|
11225
|
-
# @example Example: To
|
11236
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
11226
11237
|
#
|
11227
|
-
# # The following example
|
11238
|
+
# # The following example uploads and object. The request specifies the optional server-side encryption option. The request
|
11239
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
11228
11240
|
#
|
11229
11241
|
# resp = client.put_object({
|
11230
11242
|
# body: "filetoupload",
|
11231
11243
|
# bucket: "examplebucket",
|
11232
|
-
# key: "
|
11244
|
+
# key: "exampleobject",
|
11245
|
+
# server_side_encryption: "AES256",
|
11246
|
+
# tagging: "key1=value1&key2=value2",
|
11233
11247
|
# })
|
11234
11248
|
#
|
11235
11249
|
# resp.to_h outputs the following:
|
11236
11250
|
# {
|
11237
11251
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11238
|
-
#
|
11252
|
+
# server_side_encryption: "AES256",
|
11253
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
11239
11254
|
# }
|
11240
11255
|
#
|
11241
|
-
# @example Example: To
|
11256
|
+
# @example Example: To create an object.
|
11242
11257
|
#
|
11243
|
-
# # The following example creates an object.
|
11244
|
-
# # enabled, S3 returns version ID in response.
|
11258
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
11245
11259
|
#
|
11246
11260
|
# resp = client.put_object({
|
11247
11261
|
# body: "filetoupload",
|
11248
11262
|
# bucket: "examplebucket",
|
11249
|
-
# key: "
|
11250
|
-
# metadata: {
|
11251
|
-
# "metadata1" => "value1",
|
11252
|
-
# "metadata2" => "value2",
|
11253
|
-
# },
|
11263
|
+
# key: "objectkey",
|
11254
11264
|
# })
|
11255
11265
|
#
|
11256
11266
|
# resp.to_h outputs the following:
|
11257
11267
|
# {
|
11258
11268
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11259
|
-
# version_id: "
|
11269
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
11260
11270
|
# }
|
11261
11271
|
#
|
11262
|
-
# @example Example: To upload an object
|
11272
|
+
# @example Example: To upload an object
|
11263
11273
|
#
|
11264
|
-
# # The following example uploads
|
11265
|
-
# #
|
11274
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
11275
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
11266
11276
|
#
|
11267
11277
|
# resp = client.put_object({
|
11268
|
-
#
|
11269
|
-
# body: "filetoupload",
|
11278
|
+
# body: "HappyFace.jpg",
|
11270
11279
|
# bucket: "examplebucket",
|
11271
|
-
# key: "
|
11280
|
+
# key: "HappyFace.jpg",
|
11272
11281
|
# })
|
11273
11282
|
#
|
11274
11283
|
# resp.to_h outputs the following:
|
11275
11284
|
# {
|
11276
11285
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11277
|
-
# version_id: "
|
11286
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
11278
11287
|
# }
|
11279
11288
|
#
|
11280
|
-
# @example Example: To upload an object
|
11289
|
+
# @example Example: To upload an object (specify optional headers)
|
11281
11290
|
#
|
11282
|
-
# # The following example uploads an object
|
11283
|
-
# #
|
11291
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
11292
|
+
# # storage class and use server-side encryption.
|
11284
11293
|
#
|
11285
11294
|
# resp = client.put_object({
|
11286
11295
|
# body: "HappyFace.jpg",
|
11287
11296
|
# bucket: "examplebucket",
|
11288
11297
|
# key: "HappyFace.jpg",
|
11298
|
+
# server_side_encryption: "AES256",
|
11299
|
+
# storage_class: "STANDARD_IA",
|
11289
11300
|
# })
|
11290
11301
|
#
|
11291
11302
|
# resp.to_h outputs the following:
|
11292
11303
|
# {
|
11293
11304
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11294
|
-
#
|
11305
|
+
# server_side_encryption: "AES256",
|
11306
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
11295
11307
|
# }
|
11296
11308
|
#
|
11297
|
-
# @example Example: To upload
|
11309
|
+
# @example Example: To upload object and specify user-defined metadata
|
11298
11310
|
#
|
11299
|
-
# # The following example
|
11300
|
-
# # S3 returns version ID
|
11311
|
+
# # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
|
11312
|
+
# # enabled, S3 returns version ID in response.
|
11301
11313
|
#
|
11302
11314
|
# resp = client.put_object({
|
11303
|
-
# body: "
|
11315
|
+
# body: "filetoupload",
|
11304
11316
|
# bucket: "examplebucket",
|
11305
|
-
# key: "
|
11306
|
-
#
|
11317
|
+
# key: "exampleobject",
|
11318
|
+
# metadata: {
|
11319
|
+
# "metadata1" => "value1",
|
11320
|
+
# "metadata2" => "value2",
|
11321
|
+
# },
|
11307
11322
|
# })
|
11308
11323
|
#
|
11309
11324
|
# resp.to_h outputs the following:
|
11310
11325
|
# {
|
11311
11326
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
11312
|
-
# version_id: "
|
11327
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
11313
11328
|
# }
|
11314
11329
|
#
|
11315
11330
|
# @example Streaming a file from disk
|
@@ -12742,12 +12757,11 @@ module Aws::S3
|
|
12742
12757
|
# Encryption Keys)][5] in the *Amazon S3 User Guide*.
|
12743
12758
|
#
|
12744
12759
|
# 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*.
|
12760
|
+
# keys (SSE-S3) and Amazon Web Services KMS keys (SSE-KMS),
|
12761
|
+
# server-side encryption is handled transparently, so you don't need
|
12762
|
+
# to specify anything. For more information about server-side
|
12763
|
+
# encryption, including SSE-S3 and SSE-KMS, see [Protecting Data Using
|
12764
|
+
# Server-Side Encryption][6] in the *Amazon S3 User Guide*.
|
12751
12765
|
#
|
12752
12766
|
# **Working with the Response Body**
|
12753
12767
|
#
|
@@ -13654,45 +13668,45 @@ module Aws::S3
|
|
13654
13668
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
13655
13669
|
#
|
13656
13670
|
#
|
13657
|
-
# @example Example: To upload a part by copying
|
13671
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
13658
13672
|
#
|
13659
|
-
# # The following example uploads a part of a multipart upload by copying
|
13660
|
-
# # data source.
|
13673
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
13661
13674
|
#
|
13662
13675
|
# resp = client.upload_part_copy({
|
13663
13676
|
# bucket: "examplebucket",
|
13664
13677
|
# copy_source: "/bucketname/sourceobjectkey",
|
13665
|
-
# copy_source_range: "bytes=1-100000",
|
13666
13678
|
# key: "examplelargeobject",
|
13667
|
-
# part_number:
|
13679
|
+
# part_number: 1,
|
13668
13680
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
13669
13681
|
# })
|
13670
13682
|
#
|
13671
13683
|
# resp.to_h outputs the following:
|
13672
13684
|
# {
|
13673
13685
|
# copy_part_result: {
|
13674
|
-
# etag: "\"
|
13675
|
-
# last_modified: Time.parse("2016-12-29T21:
|
13686
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
13687
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
13676
13688
|
# },
|
13677
13689
|
# }
|
13678
13690
|
#
|
13679
|
-
# @example Example: To upload a part by copying
|
13691
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
13680
13692
|
#
|
13681
|
-
# # The following example uploads a part of a multipart upload by copying
|
13693
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
13694
|
+
# # data source.
|
13682
13695
|
#
|
13683
13696
|
# resp = client.upload_part_copy({
|
13684
13697
|
# bucket: "examplebucket",
|
13685
13698
|
# copy_source: "/bucketname/sourceobjectkey",
|
13699
|
+
# copy_source_range: "bytes=1-100000",
|
13686
13700
|
# key: "examplelargeobject",
|
13687
|
-
# part_number:
|
13701
|
+
# part_number: 2,
|
13688
13702
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
13689
13703
|
# })
|
13690
13704
|
#
|
13691
13705
|
# resp.to_h outputs the following:
|
13692
13706
|
# {
|
13693
13707
|
# copy_part_result: {
|
13694
|
-
# etag: "\"
|
13695
|
-
# last_modified: Time.parse("2016-12-29T21:
|
13708
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
13709
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
13696
13710
|
# },
|
13697
13711
|
# }
|
13698
13712
|
#
|
@@ -13742,9 +13756,9 @@ module Aws::S3
|
|
13742
13756
|
end
|
13743
13757
|
|
13744
13758
|
# Passes transformed objects to a `GetObject` operation when using
|
13745
|
-
# Object Lambda
|
13746
|
-
#
|
13747
|
-
#
|
13759
|
+
# Object Lambda access points. For information about Object Lambda
|
13760
|
+
# access points, see [Transforming objects with Object Lambda access
|
13761
|
+
# points][1] in the *Amazon S3 User Guide*.
|
13748
13762
|
#
|
13749
13763
|
# This operation supports metadata that can be returned by
|
13750
13764
|
# [GetObject][2], in addition to `RequestRoute`, `RequestToken`,
|
@@ -13766,8 +13780,8 @@ module Aws::S3
|
|
13766
13780
|
# identifiable information (PII) and decompress S3 objects. These Lambda
|
13767
13781
|
# functions are available in the Amazon Web Services Serverless
|
13768
13782
|
# Application Repository, and can be selected through the Amazon Web
|
13769
|
-
# Services Management Console when you create your Object Lambda
|
13770
|
-
#
|
13783
|
+
# Services Management Console when you create your Object Lambda access
|
13784
|
+
# point.
|
13771
13785
|
#
|
13772
13786
|
# Example 1: PII Access Control - This Lambda function uses Amazon
|
13773
13787
|
# Comprehend, a natural language processing (NLP) service using machine
|
@@ -13959,8 +13973,8 @@ module Aws::S3
|
|
13959
13973
|
#
|
13960
13974
|
# @option params [String] :ssekms_key_id
|
13961
13975
|
# If present, specifies the ID of the Amazon Web Services Key Management
|
13962
|
-
# Service (Amazon Web Services KMS) symmetric customer managed
|
13963
|
-
#
|
13976
|
+
# Service (Amazon Web Services KMS) symmetric customer managed key that
|
13977
|
+
# was used for stored in Amazon S3 object.
|
13964
13978
|
#
|
13965
13979
|
# @option params [String] :sse_customer_key_md5
|
13966
13980
|
# 128-bit MD5 digest of customer-provided encryption key used in Amazon
|
@@ -14052,7 +14066,7 @@ module Aws::S3
|
|
14052
14066
|
params: params,
|
14053
14067
|
config: config)
|
14054
14068
|
context[:gem_name] = 'aws-sdk-s3'
|
14055
|
-
context[:gem_version] = '1.
|
14069
|
+
context[:gem_version] = '1.105.1'
|
14056
14070
|
Seahorse::Client::Request.new(handlers, context)
|
14057
14071
|
end
|
14058
14072
|
|