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.
@@ -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 `CRC-32` checksum of the object.
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 `CRC-32C` checksum of the object.
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 `CRC-64NVME` checksum of the
1015
- # object. The `CRC-64NVME` checksum is always a full object checksum.
1016
- # For more information, see [Checking object integrity in the Amazon S3
1017
- # User Guide][1].
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 `SHA-1` digest of the object.
1027
- # For more information, see [Checking object integrity][1] in the
1028
- # *Amazon S3 User Guide*.
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 `SHA-256` digest of the object.
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 in a specific region
2604
+ # @example Example: To create a bucket
2605
2605
  #
2606
- # # The following example creates a bucket. The request specifies an AWS region where to create the 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: "http://examplebucket.<Region>.s3.amazonaws.com/",
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: "/examplebucket",
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 version
5472
+ # @example Example: To remove tag set from an object
5473
5473
  #
5474
- # # The following example removes tag set associated with the specified object version. The request specifies both the
5475
- # # object key and object version.
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: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
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. If the bucket is versioning enabled, the
5491
- # # operation removes tag set from the latest object version.
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: "null",
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
- # * `CRC-32`
5757
+ # * `CRC32`
5758
5758
  #
5759
- # * `CRC-32C`
5759
+ # * `CRC32C`
5760
5760
  #
5761
- # * `CRC-64NVME`
5761
+ # * `CRC64NVME`
5762
5762
  #
5763
- # * `SHA-1`
5763
+ # * `SHA1`
5764
5764
  #
5765
- # * `SHA-256`
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 a byte range of an object
8742
+ # @example Example: To retrieve an object
8743
8743
  #
8744
- # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
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: "SampleFile.txt",
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: 10,
8757
- # content_range: "bytes 0-9/43",
8758
- # content_type: "text/plain",
8759
- # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
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: "HappyFace.jpg",
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: 3191,
8779
- # content_type: "image/jpeg",
8780
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
8781
- # last_modified: Time.parse("2016-12-15T01:19:41.000Z"),
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&lt;Types::Tag&gt;
9805
9805
  #
9806
9806
  #
9807
- # @example Example: To retrieve tag set of an object
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: "HappyFace.jpg",
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: "Key4",
9821
- # value: "Value4",
9822
- # },
9823
- # {
9824
- # key: "Key3",
9825
- # value: "Value3",
9821
+ # key: "Key1",
9822
+ # value: "Value1",
9826
9823
  # },
9827
9824
  # ],
9828
- # version_id: "null",
9825
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
9829
9826
  # }
9830
9827
  #
9831
- # @example Example: To retrieve tag set of a specific object version
9828
+ # @example Example: To retrieve tag set of an object
9832
9829
  #
9833
- # # The following example retrieves tag set of an object. The request specifies object version.
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: "exampleobject",
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: "Key1",
9846
- # value: "Value1",
9841
+ # key: "Key4",
9842
+ # value: "Value4",
9843
+ # },
9844
+ # {
9845
+ # key: "Key3",
9846
+ # value: "Value3",
9847
9847
  # },
9848
9848
  # ],
9849
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
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
- # * `CRC-32`
15403
+ # * `CRC32`
15402
15404
  #
15403
- # * `CRC-32C`
15405
+ # * `CRC32C`
15404
15406
  #
15405
- # * `CRC-64NVME`
15407
+ # * `CRC64NVME`
15406
15408
  #
15407
- # * `SHA-1`
15409
+ # * `SHA1`
15408
15410
  #
15409
- # * `SHA-256`
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
- # * `CRC-32`
16611
+ # * `CRC32`
16610
16612
  #
16611
- # * `CRC-32C`
16613
+ # * `CRC32C`
16612
16614
  #
16613
- # * `CRC-64NVME`
16615
+ # * `CRC64NVME`
16614
16616
  #
16615
- # * `SHA-1`
16617
+ # * `SHA1`
16616
16618
  #
16617
- # * `SHA-256`
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 `CRC-32` checksum of the object.
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 `CRC-32C` checksum of the object.
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 `CRC-64NVME` checksum of the
16669
- # object. The `CRC-64NVME` checksum is always a full object checksum.
16670
- # For more information, see [Checking object integrity in the Amazon S3
16671
- # User Guide][1].
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 `SHA-1` digest of the object.
16681
- # For more information, see [Checking object integrity][1] in the
16682
- # *Amazon S3 User Guide*.
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 `SHA-256` digest of the object.
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 and specify server-side encryption and object tags
17105
+ # @example Example: To upload an object
17104
17106
  #
17105
- # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
17106
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
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: "filetoupload",
17111
+ # body: "HappyFace.jpg",
17110
17112
  # bucket: "examplebucket",
17111
- # key: "exampleobject",
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
- # server_side_encryption: "AES256",
17120
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
17119
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
17121
17120
  # }
17122
17121
  #
17123
- # @example Example: To upload object and specify user-defined metadata
17122
+ # @example Example: To upload an object (specify optional headers)
17124
17123
  #
17125
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
17126
- # # enabled, S3 returns version ID in response.
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: "filetoupload",
17128
+ # body: "HappyFace.jpg",
17130
17129
  # bucket: "examplebucket",
17131
- # key: "exampleobject",
17132
- # metadata: {
17133
- # "metadata1" => "value1",
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
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
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 canned ACL.
17176
+ # @example Example: To upload an object and specify server-side encryption and object tags
17179
17177
  #
17180
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
17181
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
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
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
17192
+ # server_side_encryption: "AES256",
17193
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
17194
17194
  # }
17195
17195
  #
17196
- # @example Example: To upload an object (specify optional headers)
17196
+ # @example Example: To upload object and specify user-defined metadata
17197
17197
  #
17198
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
17199
- # # storage class and use server-side encryption.
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: "HappyFace.jpg",
17202
+ # body: "filetoupload",
17203
17203
  # bucket: "examplebucket",
17204
- # key: "HappyFace.jpg",
17205
- # server_side_encryption: "AES256",
17206
- # storage_class: "STANDARD_IA",
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
- # server_side_encryption: "AES256",
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 an object to a versioning-enabled bucket. The source file is specified using Windows file
17219
- # # syntax. S3 returns VersionId of the newly created object.
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
- # body: "HappyFace.jpg",
17223
+ # acl: "authenticated-read",
17224
+ # body: "filetoupload",
17223
17225
  # bucket: "examplebucket",
17224
- # key: "HappyFace.jpg",
17226
+ # key: "exampleobject",
17225
17227
  # })
17226
17228
  #
17227
17229
  # resp.to_h outputs the following:
17228
17230
  # {
17229
17231
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
17230
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
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 `CRC-32` checksum of the object.
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 `CRC-32C` checksum of the object.
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 `CRC-64NVME` checksum of the
19455
- # part. For more information, see [Checking object integrity][1] in the
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 `SHA-1` digest of the object.
19466
- # For more information, see [Checking object integrity][1] in the
19467
- # *Amazon S3 User Guide*.
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 `SHA-256` digest of the object.
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 data from an existing object as data source
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 data from an existing object as data source.
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: 1,
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: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
20132
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
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 byte range from an existing object as data source
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 a specified byte range from an existing object as
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: 2,
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: "\"65d16d19e65a7508a51f043180edcc36\"",
20154
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
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 `CRC-32` checksum of the object
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 `CRC-32C` checksum of the object
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 `CRC-64NVME` checksum of the
20393
- # part. For more information, see [Checking object integrity][1] in the
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 `SHA-1` digest of the object
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 `SHA-256` digest of the object
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.180.0'
20636
+ context[:gem_version] = '1.181.0'
20635
20637
  Seahorse::Client::Request.new(handlers, context)
20636
20638
  end
20637
20639