aws-sdk-s3 1.180.0 → 1.181.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +5 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +20 -20
- data/lib/aws-sdk-s3/bucket_policy.rb +5 -5
- data/lib/aws-sdk-s3/client.rb +156 -154
- data/lib/aws-sdk-s3/client_api.rb +1 -0
- data/lib/aws-sdk-s3/multipart_upload.rb +10 -10
- data/lib/aws-sdk-s3/multipart_upload_part.rb +23 -23
- data/lib/aws-sdk-s3/object.rb +32 -25
- data/lib/aws-sdk-s3/object_summary.rb +20 -20
- data/lib/aws-sdk-s3/object_version.rb +5 -5
- data/lib/aws-sdk-s3/types.rb +192 -186
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/client.rbs +1 -0
- data/sig/object.rbs +3 -0
- data/sig/types.rbs +1 -0
- metadata +2 -2
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -989,7 +989,7 @@ module Aws::S3
|
|
989
989
|
# @option params [String] :checksum_crc32
|
990
990
|
# This header can be used as a data integrity check to verify that the
|
991
991
|
# data received is the same data that was originally sent. This header
|
992
|
-
# specifies the Base64 encoded, 32-bit `
|
992
|
+
# specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
|
993
993
|
# For more information, see [Checking object integrity][1] in the
|
994
994
|
# *Amazon S3 User Guide*.
|
995
995
|
#
|
@@ -1000,7 +1000,7 @@ module Aws::S3
|
|
1000
1000
|
# @option params [String] :checksum_crc32c
|
1001
1001
|
# This header can be used as a data integrity check to verify that the
|
1002
1002
|
# data received is the same data that was originally sent. This header
|
1003
|
-
# specifies the Base64 encoded, 32-bit `
|
1003
|
+
# specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
|
1004
1004
|
# For more information, see [Checking object integrity][1] in the
|
1005
1005
|
# *Amazon S3 User Guide*.
|
1006
1006
|
#
|
@@ -1011,10 +1011,10 @@ module Aws::S3
|
|
1011
1011
|
# @option params [String] :checksum_crc64nvme
|
1012
1012
|
# This header can be used as a data integrity check to verify that the
|
1013
1013
|
# data received is the same data that was originally sent. This header
|
1014
|
-
# specifies the Base64 encoded, 64-bit `
|
1015
|
-
# object. The `
|
1016
|
-
#
|
1017
|
-
#
|
1014
|
+
# specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
|
1015
|
+
# object. The `CRC64NVME` checksum is always a full object checksum. For
|
1016
|
+
# more information, see [Checking object integrity in the Amazon S3 User
|
1017
|
+
# Guide][1].
|
1018
1018
|
#
|
1019
1019
|
#
|
1020
1020
|
#
|
@@ -1023,9 +1023,9 @@ module Aws::S3
|
|
1023
1023
|
# @option params [String] :checksum_sha1
|
1024
1024
|
# This header can be used as a data integrity check to verify that the
|
1025
1025
|
# data received is the same data that was originally sent. This header
|
1026
|
-
# specifies the Base64 encoded, 160-bit `
|
1027
|
-
#
|
1028
|
-
#
|
1026
|
+
# specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
|
1027
|
+
# more information, see [Checking object integrity][1] in the *Amazon S3
|
1028
|
+
# User Guide*.
|
1029
1029
|
#
|
1030
1030
|
#
|
1031
1031
|
#
|
@@ -1034,7 +1034,7 @@ module Aws::S3
|
|
1034
1034
|
# @option params [String] :checksum_sha256
|
1035
1035
|
# This header can be used as a data integrity check to verify that the
|
1036
1036
|
# data received is the same data that was originally sent. This header
|
1037
|
-
# specifies the Base64 encoded, 256-bit `
|
1037
|
+
# specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
|
1038
1038
|
# For more information, see [Checking object integrity][1] in the
|
1039
1039
|
# *Amazon S3 User Guide*.
|
1040
1040
|
#
|
@@ -2601,33 +2601,33 @@ module Aws::S3
|
|
2601
2601
|
# * {Types::CreateBucketOutput#location #location} => String
|
2602
2602
|
#
|
2603
2603
|
#
|
2604
|
-
# @example Example: To create a bucket
|
2604
|
+
# @example Example: To create a bucket
|
2605
2605
|
#
|
2606
|
-
# # The following example creates a bucket.
|
2606
|
+
# # The following example creates a bucket.
|
2607
2607
|
#
|
2608
2608
|
# resp = client.create_bucket({
|
2609
2609
|
# bucket: "examplebucket",
|
2610
|
-
# create_bucket_configuration: {
|
2611
|
-
# location_constraint: "eu-west-1",
|
2612
|
-
# },
|
2613
2610
|
# })
|
2614
2611
|
#
|
2615
2612
|
# resp.to_h outputs the following:
|
2616
2613
|
# {
|
2617
|
-
# location: "
|
2614
|
+
# location: "/examplebucket",
|
2618
2615
|
# }
|
2619
2616
|
#
|
2620
|
-
# @example Example: To create a bucket
|
2617
|
+
# @example Example: To create a bucket in a specific region
|
2621
2618
|
#
|
2622
|
-
# # The following example creates a bucket.
|
2619
|
+
# # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
|
2623
2620
|
#
|
2624
2621
|
# resp = client.create_bucket({
|
2625
2622
|
# bucket: "examplebucket",
|
2623
|
+
# create_bucket_configuration: {
|
2624
|
+
# location_constraint: "eu-west-1",
|
2625
|
+
# },
|
2626
2626
|
# })
|
2627
2627
|
#
|
2628
2628
|
# resp.to_h outputs the following:
|
2629
2629
|
# {
|
2630
|
-
# location: "/
|
2630
|
+
# location: "http://examplebucket.<Region>.s3.amazonaws.com/",
|
2631
2631
|
# }
|
2632
2632
|
#
|
2633
2633
|
# @example Request syntax with placeholder values
|
@@ -5469,35 +5469,35 @@ module Aws::S3
|
|
5469
5469
|
# * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
|
5470
5470
|
#
|
5471
5471
|
#
|
5472
|
-
# @example Example: To remove tag set from an object
|
5472
|
+
# @example Example: To remove tag set from an object
|
5473
5473
|
#
|
5474
|
-
# # The following example removes tag set associated with the specified object
|
5475
|
-
# #
|
5474
|
+
# # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
|
5475
|
+
# # operation removes tag set from the latest object version.
|
5476
5476
|
#
|
5477
5477
|
# resp = client.delete_object_tagging({
|
5478
5478
|
# bucket: "examplebucket",
|
5479
5479
|
# key: "HappyFace.jpg",
|
5480
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5481
5480
|
# })
|
5482
5481
|
#
|
5483
5482
|
# resp.to_h outputs the following:
|
5484
5483
|
# {
|
5485
|
-
# version_id: "
|
5484
|
+
# version_id: "null",
|
5486
5485
|
# }
|
5487
5486
|
#
|
5488
|
-
# @example Example: To remove tag set from an object
|
5487
|
+
# @example Example: To remove tag set from an object version
|
5489
5488
|
#
|
5490
|
-
# # The following example removes tag set associated with the specified object.
|
5491
|
-
# #
|
5489
|
+
# # The following example removes tag set associated with the specified object version. The request specifies both the
|
5490
|
+
# # object key and object version.
|
5492
5491
|
#
|
5493
5492
|
# resp = client.delete_object_tagging({
|
5494
5493
|
# bucket: "examplebucket",
|
5495
5494
|
# key: "HappyFace.jpg",
|
5495
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5496
5496
|
# })
|
5497
5497
|
#
|
5498
5498
|
# resp.to_h outputs the following:
|
5499
5499
|
# {
|
5500
|
-
# version_id: "
|
5500
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5501
5501
|
# }
|
5502
5502
|
#
|
5503
5503
|
# @example Request syntax with placeholder values
|
@@ -5754,15 +5754,15 @@ module Aws::S3
|
|
5754
5754
|
# For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
|
5755
5755
|
# the supported algorithm from the following list:
|
5756
5756
|
#
|
5757
|
-
# * `
|
5757
|
+
# * `CRC32`
|
5758
5758
|
#
|
5759
|
-
# * `
|
5759
|
+
# * `CRC32C`
|
5760
5760
|
#
|
5761
|
-
# * `
|
5761
|
+
# * `CRC64NVME`
|
5762
5762
|
#
|
5763
|
-
# * `
|
5763
|
+
# * `SHA1`
|
5764
5764
|
#
|
5765
|
-
# * `
|
5765
|
+
# * `SHA256`
|
5766
5766
|
#
|
5767
5767
|
# For more information, see [Checking object integrity][1] in the
|
5768
5768
|
# *Amazon S3 User Guide*.
|
@@ -8739,49 +8739,49 @@ module Aws::S3
|
|
8739
8739
|
# * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
|
8740
8740
|
#
|
8741
8741
|
#
|
8742
|
-
# @example Example: To retrieve
|
8742
|
+
# @example Example: To retrieve an object
|
8743
8743
|
#
|
8744
|
-
# # The following example retrieves an object for an S3 bucket.
|
8745
|
-
# # specific byte range.
|
8744
|
+
# # The following example retrieves an object for an S3 bucket.
|
8746
8745
|
#
|
8747
8746
|
# resp = client.get_object({
|
8748
8747
|
# bucket: "examplebucket",
|
8749
|
-
# key: "
|
8750
|
-
# range: "bytes=0-9",
|
8748
|
+
# key: "HappyFace.jpg",
|
8751
8749
|
# })
|
8752
8750
|
#
|
8753
8751
|
# resp.to_h outputs the following:
|
8754
8752
|
# {
|
8755
8753
|
# accept_ranges: "bytes",
|
8756
|
-
# content_length:
|
8757
|
-
#
|
8758
|
-
#
|
8759
|
-
#
|
8760
|
-
# last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
|
8754
|
+
# content_length: 3191,
|
8755
|
+
# content_type: "image/jpeg",
|
8756
|
+
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
8757
|
+
# last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
|
8761
8758
|
# metadata: {
|
8762
8759
|
# },
|
8760
|
+
# tag_count: 2,
|
8763
8761
|
# version_id: "null",
|
8764
8762
|
# }
|
8765
8763
|
#
|
8766
|
-
# @example Example: To retrieve an object
|
8764
|
+
# @example Example: To retrieve a byte range of an object
|
8767
8765
|
#
|
8768
|
-
# # The following example retrieves an object for an S3 bucket.
|
8766
|
+
# # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
|
8767
|
+
# # specific byte range.
|
8769
8768
|
#
|
8770
8769
|
# resp = client.get_object({
|
8771
8770
|
# bucket: "examplebucket",
|
8772
|
-
# key: "
|
8771
|
+
# key: "SampleFile.txt",
|
8772
|
+
# range: "bytes=0-9",
|
8773
8773
|
# })
|
8774
8774
|
#
|
8775
8775
|
# resp.to_h outputs the following:
|
8776
8776
|
# {
|
8777
8777
|
# accept_ranges: "bytes",
|
8778
|
-
# content_length:
|
8779
|
-
#
|
8780
|
-
#
|
8781
|
-
#
|
8778
|
+
# content_length: 10,
|
8779
|
+
# content_range: "bytes 0-9/43",
|
8780
|
+
# content_type: "text/plain",
|
8781
|
+
# etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
|
8782
|
+
# last_modified: Time.parse("2014-10-09T22:57:28.000Z"),
|
8782
8783
|
# metadata: {
|
8783
8784
|
# },
|
8784
|
-
# tag_count: 2,
|
8785
8785
|
# version_id: "null",
|
8786
8786
|
# }
|
8787
8787
|
#
|
@@ -9804,49 +9804,49 @@ module Aws::S3
|
|
9804
9804
|
# * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
|
9805
9805
|
#
|
9806
9806
|
#
|
9807
|
-
# @example Example: To retrieve tag set of
|
9807
|
+
# @example Example: To retrieve tag set of a specific object version
|
9808
9808
|
#
|
9809
|
-
# # The following example retrieves tag set of an object.
|
9809
|
+
# # The following example retrieves tag set of an object. The request specifies object version.
|
9810
9810
|
#
|
9811
9811
|
# resp = client.get_object_tagging({
|
9812
9812
|
# bucket: "examplebucket",
|
9813
|
-
# key: "
|
9813
|
+
# key: "exampleobject",
|
9814
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9814
9815
|
# })
|
9815
9816
|
#
|
9816
9817
|
# resp.to_h outputs the following:
|
9817
9818
|
# {
|
9818
9819
|
# tag_set: [
|
9819
9820
|
# {
|
9820
|
-
# key: "
|
9821
|
-
# value: "
|
9822
|
-
# },
|
9823
|
-
# {
|
9824
|
-
# key: "Key3",
|
9825
|
-
# value: "Value3",
|
9821
|
+
# key: "Key1",
|
9822
|
+
# value: "Value1",
|
9826
9823
|
# },
|
9827
9824
|
# ],
|
9828
|
-
# version_id: "
|
9825
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9829
9826
|
# }
|
9830
9827
|
#
|
9831
|
-
# @example Example: To retrieve tag set of
|
9828
|
+
# @example Example: To retrieve tag set of an object
|
9832
9829
|
#
|
9833
|
-
# # The following example retrieves tag set of an object.
|
9830
|
+
# # The following example retrieves tag set of an object.
|
9834
9831
|
#
|
9835
9832
|
# resp = client.get_object_tagging({
|
9836
9833
|
# bucket: "examplebucket",
|
9837
|
-
# key: "
|
9838
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
9834
|
+
# key: "HappyFace.jpg",
|
9839
9835
|
# })
|
9840
9836
|
#
|
9841
9837
|
# resp.to_h outputs the following:
|
9842
9838
|
# {
|
9843
9839
|
# tag_set: [
|
9844
9840
|
# {
|
9845
|
-
# key: "
|
9846
|
-
# value: "
|
9841
|
+
# key: "Key4",
|
9842
|
+
# value: "Value4",
|
9843
|
+
# },
|
9844
|
+
# {
|
9845
|
+
# key: "Key3",
|
9846
|
+
# value: "Value3",
|
9847
9847
|
# },
|
9848
9848
|
# ],
|
9849
|
-
# version_id: "
|
9849
|
+
# version_id: "null",
|
9850
9850
|
# }
|
9851
9851
|
#
|
9852
9852
|
# @example Request syntax with placeholder values
|
@@ -10642,6 +10642,7 @@ module Aws::S3
|
|
10642
10642
|
# * {Types::HeadObjectOutput#content_encoding #content_encoding} => String
|
10643
10643
|
# * {Types::HeadObjectOutput#content_language #content_language} => String
|
10644
10644
|
# * {Types::HeadObjectOutput#content_type #content_type} => String
|
10645
|
+
# * {Types::HeadObjectOutput#content_range #content_range} => String
|
10645
10646
|
# * {Types::HeadObjectOutput#expires #expires} => Time
|
10646
10647
|
# * {Types::HeadObjectOutput#expires_string #expires_string} => String
|
10647
10648
|
# * {Types::HeadObjectOutput#website_redirect_location #website_redirect_location} => String
|
@@ -10730,6 +10731,7 @@ module Aws::S3
|
|
10730
10731
|
# resp.content_encoding #=> String
|
10731
10732
|
# resp.content_language #=> String
|
10732
10733
|
# resp.content_type #=> String
|
10734
|
+
# resp.content_range #=> String
|
10733
10735
|
# resp.expires #=> Time
|
10734
10736
|
# resp.expires_string #=> String
|
10735
10737
|
# resp.website_redirect_location #=> String
|
@@ -15398,15 +15400,15 @@ module Aws::S3
|
|
15398
15400
|
# For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
|
15399
15401
|
# the supported algorithm from the following list:
|
15400
15402
|
#
|
15401
|
-
# * `
|
15403
|
+
# * `CRC32`
|
15402
15404
|
#
|
15403
|
-
# * `
|
15405
|
+
# * `CRC32C`
|
15404
15406
|
#
|
15405
|
-
# * `
|
15407
|
+
# * `CRC64NVME`
|
15406
15408
|
#
|
15407
|
-
# * `
|
15409
|
+
# * `SHA1`
|
15408
15410
|
#
|
15409
|
-
# * `
|
15411
|
+
# * `SHA256`
|
15410
15412
|
#
|
15411
15413
|
# For more information, see [Checking object integrity][1] in the
|
15412
15414
|
# *Amazon S3 User Guide*.
|
@@ -16606,15 +16608,15 @@ module Aws::S3
|
|
16606
16608
|
# For the `x-amz-checksum-algorithm ` header, replace ` algorithm ` with
|
16607
16609
|
# the supported algorithm from the following list:
|
16608
16610
|
#
|
16609
|
-
# * `
|
16611
|
+
# * `CRC32`
|
16610
16612
|
#
|
16611
|
-
# * `
|
16613
|
+
# * `CRC32C`
|
16612
16614
|
#
|
16613
|
-
# * `
|
16615
|
+
# * `CRC64NVME`
|
16614
16616
|
#
|
16615
|
-
# * `
|
16617
|
+
# * `SHA1`
|
16616
16618
|
#
|
16617
|
-
# * `
|
16619
|
+
# * `SHA256`
|
16618
16620
|
#
|
16619
16621
|
# For more information, see [Checking object integrity][1] in the
|
16620
16622
|
# *Amazon S3 User Guide*.
|
@@ -16643,7 +16645,7 @@ module Aws::S3
|
|
16643
16645
|
# @option params [String] :checksum_crc32
|
16644
16646
|
# This header can be used as a data integrity check to verify that the
|
16645
16647
|
# data received is the same data that was originally sent. This header
|
16646
|
-
# specifies the Base64 encoded, 32-bit `
|
16648
|
+
# specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
|
16647
16649
|
# For more information, see [Checking object integrity][1] in the
|
16648
16650
|
# *Amazon S3 User Guide*.
|
16649
16651
|
#
|
@@ -16654,7 +16656,7 @@ module Aws::S3
|
|
16654
16656
|
# @option params [String] :checksum_crc32c
|
16655
16657
|
# This header can be used as a data integrity check to verify that the
|
16656
16658
|
# data received is the same data that was originally sent. This header
|
16657
|
-
# specifies the Base64 encoded, 32-bit `
|
16659
|
+
# specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
|
16658
16660
|
# For more information, see [Checking object integrity][1] in the
|
16659
16661
|
# *Amazon S3 User Guide*.
|
16660
16662
|
#
|
@@ -16665,10 +16667,10 @@ module Aws::S3
|
|
16665
16667
|
# @option params [String] :checksum_crc64nvme
|
16666
16668
|
# This header can be used as a data integrity check to verify that the
|
16667
16669
|
# data received is the same data that was originally sent. This header
|
16668
|
-
# specifies the Base64 encoded, 64-bit `
|
16669
|
-
# object. The `
|
16670
|
-
#
|
16671
|
-
#
|
16670
|
+
# specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the
|
16671
|
+
# object. The `CRC64NVME` checksum is always a full object checksum. For
|
16672
|
+
# more information, see [Checking object integrity in the Amazon S3 User
|
16673
|
+
# Guide][1].
|
16672
16674
|
#
|
16673
16675
|
#
|
16674
16676
|
#
|
@@ -16677,9 +16679,9 @@ module Aws::S3
|
|
16677
16679
|
# @option params [String] :checksum_sha1
|
16678
16680
|
# This header can be used as a data integrity check to verify that the
|
16679
16681
|
# data received is the same data that was originally sent. This header
|
16680
|
-
# specifies the Base64 encoded, 160-bit `
|
16681
|
-
#
|
16682
|
-
#
|
16682
|
+
# specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
|
16683
|
+
# more information, see [Checking object integrity][1] in the *Amazon S3
|
16684
|
+
# User Guide*.
|
16683
16685
|
#
|
16684
16686
|
#
|
16685
16687
|
#
|
@@ -16688,7 +16690,7 @@ module Aws::S3
|
|
16688
16690
|
# @option params [String] :checksum_sha256
|
16689
16691
|
# This header can be used as a data integrity check to verify that the
|
16690
16692
|
# data received is the same data that was originally sent. This header
|
16691
|
-
# specifies the Base64 encoded, 256-bit `
|
16693
|
+
# specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
|
16692
16694
|
# For more information, see [Checking object integrity][1] in the
|
16693
16695
|
# *Amazon S3 User Guide*.
|
16694
16696
|
#
|
@@ -17100,45 +17102,41 @@ module Aws::S3
|
|
17100
17102
|
# * {Types::PutObjectOutput#request_charged #request_charged} => String
|
17101
17103
|
#
|
17102
17104
|
#
|
17103
|
-
# @example Example: To upload an object
|
17105
|
+
# @example Example: To upload an object
|
17104
17106
|
#
|
17105
|
-
# # The following example uploads an object. The
|
17106
|
-
# #
|
17107
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
17108
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
17107
17109
|
#
|
17108
17110
|
# resp = client.put_object({
|
17109
|
-
# body: "
|
17111
|
+
# body: "HappyFace.jpg",
|
17110
17112
|
# bucket: "examplebucket",
|
17111
|
-
# key: "
|
17112
|
-
# server_side_encryption: "AES256",
|
17113
|
-
# tagging: "key1=value1&key2=value2",
|
17113
|
+
# key: "HappyFace.jpg",
|
17114
17114
|
# })
|
17115
17115
|
#
|
17116
17116
|
# resp.to_h outputs the following:
|
17117
17117
|
# {
|
17118
17118
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17119
|
-
#
|
17120
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
17119
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
17121
17120
|
# }
|
17122
17121
|
#
|
17123
|
-
# @example Example: To upload object
|
17122
|
+
# @example Example: To upload an object (specify optional headers)
|
17124
17123
|
#
|
17125
|
-
# # The following example
|
17126
|
-
# #
|
17124
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
17125
|
+
# # storage class and use server-side encryption.
|
17127
17126
|
#
|
17128
17127
|
# resp = client.put_object({
|
17129
|
-
# body: "
|
17128
|
+
# body: "HappyFace.jpg",
|
17130
17129
|
# bucket: "examplebucket",
|
17131
|
-
# key: "
|
17132
|
-
#
|
17133
|
-
#
|
17134
|
-
# "metadata2" => "value2",
|
17135
|
-
# },
|
17130
|
+
# key: "HappyFace.jpg",
|
17131
|
+
# server_side_encryption: "AES256",
|
17132
|
+
# storage_class: "STANDARD_IA",
|
17136
17133
|
# })
|
17137
17134
|
#
|
17138
17135
|
# resp.to_h outputs the following:
|
17139
17136
|
# {
|
17140
17137
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17141
|
-
#
|
17138
|
+
# server_side_encryption: "AES256",
|
17139
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
17142
17140
|
# }
|
17143
17141
|
#
|
17144
17142
|
# @example Example: To create an object.
|
@@ -17175,59 +17173,63 @@ module Aws::S3
|
|
17175
17173
|
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
17176
17174
|
# }
|
17177
17175
|
#
|
17178
|
-
# @example Example: To upload an object and specify
|
17176
|
+
# @example Example: To upload an object and specify server-side encryption and object tags
|
17179
17177
|
#
|
17180
|
-
# # The following example uploads
|
17181
|
-
# #
|
17178
|
+
# # The following example uploads an object. The request specifies the optional server-side encryption option. The request
|
17179
|
+
# # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
|
17182
17180
|
#
|
17183
17181
|
# resp = client.put_object({
|
17184
|
-
# acl: "authenticated-read",
|
17185
17182
|
# body: "filetoupload",
|
17186
17183
|
# bucket: "examplebucket",
|
17187
17184
|
# key: "exampleobject",
|
17185
|
+
# server_side_encryption: "AES256",
|
17186
|
+
# tagging: "key1=value1&key2=value2",
|
17188
17187
|
# })
|
17189
17188
|
#
|
17190
17189
|
# resp.to_h outputs the following:
|
17191
17190
|
# {
|
17192
17191
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17193
|
-
#
|
17192
|
+
# server_side_encryption: "AES256",
|
17193
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
17194
17194
|
# }
|
17195
17195
|
#
|
17196
|
-
# @example Example: To upload
|
17196
|
+
# @example Example: To upload object and specify user-defined metadata
|
17197
17197
|
#
|
17198
|
-
# # The following example
|
17199
|
-
# #
|
17198
|
+
# # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
|
17199
|
+
# # enabled, S3 returns version ID in response.
|
17200
17200
|
#
|
17201
17201
|
# resp = client.put_object({
|
17202
|
-
# body: "
|
17202
|
+
# body: "filetoupload",
|
17203
17203
|
# bucket: "examplebucket",
|
17204
|
-
# key: "
|
17205
|
-
#
|
17206
|
-
#
|
17204
|
+
# key: "exampleobject",
|
17205
|
+
# metadata: {
|
17206
|
+
# "metadata1" => "value1",
|
17207
|
+
# "metadata2" => "value2",
|
17208
|
+
# },
|
17207
17209
|
# })
|
17208
17210
|
#
|
17209
17211
|
# resp.to_h outputs the following:
|
17210
17212
|
# {
|
17211
17213
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17212
|
-
#
|
17213
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
17214
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
17214
17215
|
# }
|
17215
17216
|
#
|
17216
|
-
# @example Example: To upload an object
|
17217
|
+
# @example Example: To upload an object and specify canned ACL.
|
17217
17218
|
#
|
17218
|
-
# # The following example uploads
|
17219
|
-
# #
|
17219
|
+
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
17220
|
+
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
17220
17221
|
#
|
17221
17222
|
# resp = client.put_object({
|
17222
|
-
#
|
17223
|
+
# acl: "authenticated-read",
|
17224
|
+
# body: "filetoupload",
|
17223
17225
|
# bucket: "examplebucket",
|
17224
|
-
# key: "
|
17226
|
+
# key: "exampleobject",
|
17225
17227
|
# })
|
17226
17228
|
#
|
17227
17229
|
# resp.to_h outputs the following:
|
17228
17230
|
# {
|
17229
17231
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
17230
|
-
# version_id: "
|
17232
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
17231
17233
|
# }
|
17232
17234
|
#
|
17233
17235
|
# @example Streaming a file from disk
|
@@ -19429,7 +19431,7 @@ module Aws::S3
|
|
19429
19431
|
# @option params [String] :checksum_crc32
|
19430
19432
|
# This header can be used as a data integrity check to verify that the
|
19431
19433
|
# data received is the same data that was originally sent. This header
|
19432
|
-
# specifies the Base64 encoded, 32-bit `
|
19434
|
+
# specifies the Base64 encoded, 32-bit `CRC32` checksum of the object.
|
19433
19435
|
# For more information, see [Checking object integrity][1] in the
|
19434
19436
|
# *Amazon S3 User Guide*.
|
19435
19437
|
#
|
@@ -19440,7 +19442,7 @@ module Aws::S3
|
|
19440
19442
|
# @option params [String] :checksum_crc32c
|
19441
19443
|
# This header can be used as a data integrity check to verify that the
|
19442
19444
|
# data received is the same data that was originally sent. This header
|
19443
|
-
# specifies the Base64 encoded, 32-bit `
|
19445
|
+
# specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object.
|
19444
19446
|
# For more information, see [Checking object integrity][1] in the
|
19445
19447
|
# *Amazon S3 User Guide*.
|
19446
19448
|
#
|
@@ -19451,8 +19453,8 @@ module Aws::S3
|
|
19451
19453
|
# @option params [String] :checksum_crc64nvme
|
19452
19454
|
# This header can be used as a data integrity check to verify that the
|
19453
19455
|
# data received is the same data that was originally sent. This header
|
19454
|
-
# specifies the Base64 encoded, 64-bit `
|
19455
|
-
#
|
19456
|
+
# specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the part.
|
19457
|
+
# For more information, see [Checking object integrity][1] in the
|
19456
19458
|
# *Amazon S3 User Guide*.
|
19457
19459
|
#
|
19458
19460
|
#
|
@@ -19462,9 +19464,9 @@ module Aws::S3
|
|
19462
19464
|
# @option params [String] :checksum_sha1
|
19463
19465
|
# This header can be used as a data integrity check to verify that the
|
19464
19466
|
# data received is the same data that was originally sent. This header
|
19465
|
-
# specifies the Base64 encoded, 160-bit `
|
19466
|
-
#
|
19467
|
-
#
|
19467
|
+
# specifies the Base64 encoded, 160-bit `SHA1` digest of the object. For
|
19468
|
+
# more information, see [Checking object integrity][1] in the *Amazon S3
|
19469
|
+
# User Guide*.
|
19468
19470
|
#
|
19469
19471
|
#
|
19470
19472
|
#
|
@@ -19473,7 +19475,7 @@ module Aws::S3
|
|
19473
19475
|
# @option params [String] :checksum_sha256
|
19474
19476
|
# This header can be used as a data integrity check to verify that the
|
19475
19477
|
# data received is the same data that was originally sent. This header
|
19476
|
-
# specifies the Base64 encoded, 256-bit `
|
19478
|
+
# specifies the Base64 encoded, 256-bit `SHA256` digest of the object.
|
19477
19479
|
# For more information, see [Checking object integrity][1] in the
|
19478
19480
|
# *Amazon S3 User Guide*.
|
19479
19481
|
#
|
@@ -20113,45 +20115,45 @@ module Aws::S3
|
|
20113
20115
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
20114
20116
|
#
|
20115
20117
|
#
|
20116
|
-
# @example Example: To upload a part by copying
|
20118
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
20117
20119
|
#
|
20118
|
-
# # The following example uploads a part of a multipart upload by copying
|
20120
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
20121
|
+
# # data source.
|
20119
20122
|
#
|
20120
20123
|
# resp = client.upload_part_copy({
|
20121
20124
|
# bucket: "examplebucket",
|
20122
20125
|
# copy_source: "/bucketname/sourceobjectkey",
|
20126
|
+
# copy_source_range: "bytes=1-100000",
|
20123
20127
|
# key: "examplelargeobject",
|
20124
|
-
# part_number:
|
20128
|
+
# part_number: 2,
|
20125
20129
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
20126
20130
|
# })
|
20127
20131
|
#
|
20128
20132
|
# resp.to_h outputs the following:
|
20129
20133
|
# {
|
20130
20134
|
# copy_part_result: {
|
20131
|
-
# etag: "\"
|
20132
|
-
# last_modified: Time.parse("2016-12-29T21:
|
20135
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
20136
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
20133
20137
|
# },
|
20134
20138
|
# }
|
20135
20139
|
#
|
20136
|
-
# @example Example: To upload a part by copying
|
20140
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
20137
20141
|
#
|
20138
|
-
# # The following example uploads a part of a multipart upload by copying
|
20139
|
-
# # data source.
|
20142
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
20140
20143
|
#
|
20141
20144
|
# resp = client.upload_part_copy({
|
20142
20145
|
# bucket: "examplebucket",
|
20143
20146
|
# copy_source: "/bucketname/sourceobjectkey",
|
20144
|
-
# copy_source_range: "bytes=1-100000",
|
20145
20147
|
# key: "examplelargeobject",
|
20146
|
-
# part_number:
|
20148
|
+
# part_number: 1,
|
20147
20149
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
20148
20150
|
# })
|
20149
20151
|
#
|
20150
20152
|
# resp.to_h outputs the following:
|
20151
20153
|
# {
|
20152
20154
|
# copy_part_result: {
|
20153
|
-
# etag: "\"
|
20154
|
-
# last_modified: Time.parse("2016-12-29T21:
|
20155
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
20156
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
20155
20157
|
# },
|
20156
20158
|
# }
|
20157
20159
|
#
|
@@ -20351,7 +20353,7 @@ module Aws::S3
|
|
20351
20353
|
# @option params [String] :checksum_crc32
|
20352
20354
|
# This header can be used as a data integrity check to verify that the
|
20353
20355
|
# data received is the same data that was originally sent. This
|
20354
|
-
# specifies the Base64 encoded, 32-bit `
|
20356
|
+
# specifies the Base64 encoded, 32-bit `CRC32` checksum of the object
|
20355
20357
|
# returned by the Object Lambda function. This may not match the
|
20356
20358
|
# checksum for the object stored in Amazon S3. Amazon S3 will perform
|
20357
20359
|
# validation of the checksum values only when the original `GetObject`
|
@@ -20371,7 +20373,7 @@ module Aws::S3
|
|
20371
20373
|
# @option params [String] :checksum_crc32c
|
20372
20374
|
# This header can be used as a data integrity check to verify that the
|
20373
20375
|
# data received is the same data that was originally sent. This
|
20374
|
-
# specifies the Base64 encoded, 32-bit `
|
20376
|
+
# specifies the Base64 encoded, 32-bit `CRC32C` checksum of the object
|
20375
20377
|
# returned by the Object Lambda function. This may not match the
|
20376
20378
|
# checksum for the object stored in Amazon S3. Amazon S3 will perform
|
20377
20379
|
# validation of the checksum values only when the original `GetObject`
|
@@ -20389,8 +20391,8 @@ module Aws::S3
|
|
20389
20391
|
# @option params [String] :checksum_crc64nvme
|
20390
20392
|
# This header can be used as a data integrity check to verify that the
|
20391
20393
|
# data received is the same data that was originally sent. This header
|
20392
|
-
# specifies the Base64 encoded, 64-bit `
|
20393
|
-
#
|
20394
|
+
# specifies the Base64 encoded, 64-bit `CRC64NVME` checksum of the part.
|
20395
|
+
# For more information, see [Checking object integrity][1] in the
|
20394
20396
|
# *Amazon S3 User Guide*.
|
20395
20397
|
#
|
20396
20398
|
#
|
@@ -20400,7 +20402,7 @@ module Aws::S3
|
|
20400
20402
|
# @option params [String] :checksum_sha1
|
20401
20403
|
# This header can be used as a data integrity check to verify that the
|
20402
20404
|
# data received is the same data that was originally sent. This
|
20403
|
-
# specifies the Base64 encoded, 160-bit `
|
20405
|
+
# specifies the Base64 encoded, 160-bit `SHA1` digest of the object
|
20404
20406
|
# returned by the Object Lambda function. This may not match the
|
20405
20407
|
# checksum for the object stored in Amazon S3. Amazon S3 will perform
|
20406
20408
|
# validation of the checksum values only when the original `GetObject`
|
@@ -20418,7 +20420,7 @@ module Aws::S3
|
|
20418
20420
|
# @option params [String] :checksum_sha256
|
20419
20421
|
# This header can be used as a data integrity check to verify that the
|
20420
20422
|
# data received is the same data that was originally sent. This
|
20421
|
-
# specifies the Base64 encoded, 256-bit `
|
20423
|
+
# specifies the Base64 encoded, 256-bit `SHA256` digest of the object
|
20422
20424
|
# returned by the Object Lambda function. This may not match the
|
20423
20425
|
# checksum for the object stored in Amazon S3. Amazon S3 will perform
|
20424
20426
|
# validation of the checksum values only when the original `GetObject`
|
@@ -20631,7 +20633,7 @@ module Aws::S3
|
|
20631
20633
|
tracer: tracer
|
20632
20634
|
)
|
20633
20635
|
context[:gem_name] = 'aws-sdk-s3'
|
20634
|
-
context[:gem_version] = '1.
|
20636
|
+
context[:gem_version] = '1.181.0'
|
20635
20637
|
Seahorse::Client::Request.new(handlers, context)
|
20636
20638
|
end
|
20637
20639
|
|