aws-sdk-s3 1.126.0 → 1.127.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -513,7 +513,7 @@ module Aws::S3
513
513
  # When you use this action with S3 on Outposts through the Amazon Web
514
514
  # Services SDKs, you provide the Outposts access point ARN in place of
515
515
  # the bucket name. For more information about S3 on Outposts ARNs, see
516
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
516
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
517
517
  #
518
518
  #
519
519
  #
@@ -702,7 +702,7 @@ module Aws::S3
702
702
  # When you use this action with S3 on Outposts through the Amazon Web
703
703
  # Services SDKs, you provide the Outposts access point ARN in place of
704
704
  # the bucket name. For more information about S3 on Outposts ARNs, see
705
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
705
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
706
706
  #
707
707
  #
708
708
  #
@@ -1170,7 +1170,7 @@ module Aws::S3
1170
1170
  # When you use this action with S3 on Outposts through the Amazon Web
1171
1171
  # Services SDKs, you provide the Outposts access point ARN in place of
1172
1172
  # the bucket name. For more information about S3 on Outposts ARNs, see
1173
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
1173
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
1174
1174
  #
1175
1175
  #
1176
1176
  #
@@ -2026,7 +2026,7 @@ module Aws::S3
2026
2026
  # When you use this action with S3 on Outposts through the Amazon Web
2027
2027
  # Services SDKs, you provide the Outposts access point ARN in place of
2028
2028
  # the bucket name. For more information about S3 on Outposts ARNs, see
2029
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
2029
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
2030
2030
  #
2031
2031
  #
2032
2032
  #
@@ -3111,7 +3111,7 @@ module Aws::S3
3111
3111
  # When you use this action with S3 on Outposts through the Amazon Web
3112
3112
  # Services SDKs, you provide the Outposts access point ARN in place of
3113
3113
  # the bucket name. For more information about S3 on Outposts ARNs, see
3114
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
3114
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
3115
3115
  #
3116
3116
  #
3117
3117
  #
@@ -3247,7 +3247,7 @@ module Aws::S3
3247
3247
  # When you use this action with S3 on Outposts through the Amazon Web
3248
3248
  # Services SDKs, you provide the Outposts access point ARN in place of
3249
3249
  # the bucket name. For more information about S3 on Outposts ARNs, see
3250
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
3250
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
3251
3251
  #
3252
3252
  #
3253
3253
  #
@@ -3395,7 +3395,7 @@ module Aws::S3
3395
3395
  # When you use this action with S3 on Outposts through the Amazon Web
3396
3396
  # Services SDKs, you provide the Outposts access point ARN in place of
3397
3397
  # the bucket name. For more information about S3 on Outposts ARNs, see
3398
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
3398
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
3399
3399
  #
3400
3400
  #
3401
3401
  #
@@ -5770,7 +5770,7 @@ module Aws::S3
5770
5770
  # When you use this action with S3 on Outposts through the Amazon Web
5771
5771
  # Services SDKs, you provide the Outposts access point ARN in place of
5772
5772
  # the bucket name. For more information about S3 on Outposts ARNs, see
5773
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
5773
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
5774
5774
  #
5775
5775
  #
5776
5776
  #
@@ -6357,7 +6357,7 @@ module Aws::S3
6357
6357
  # When you use this action with S3 on Outposts through the Amazon Web
6358
6358
  # Services SDKs, you provide the Outposts access point ARN in place of
6359
6359
  # the bucket name. For more information about S3 on Outposts ARNs, see
6360
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
6360
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
6361
6361
  #
6362
6362
  #
6363
6363
  #
@@ -6410,9 +6410,8 @@ module Aws::S3
6410
6410
  # Forbidden` (access denied).
6411
6411
  #
6412
6412
  # @option params [required, Array<String>] :object_attributes
6413
- # An XML header that specifies the fields at the root level that you
6414
- # want returned in the response. Fields that you do not specify are not
6415
- # returned.
6413
+ # Specifies the fields at the root level that you want returned in the
6414
+ # response. Fields that you do not specify are not returned.
6416
6415
  #
6417
6416
  # @return [Types::GetObjectAttributesOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
6418
6417
  #
@@ -6757,7 +6756,7 @@ module Aws::S3
6757
6756
  # When you use this action with S3 on Outposts through the Amazon Web
6758
6757
  # Services SDKs, you provide the Outposts access point ARN in place of
6759
6758
  # the bucket name. For more information about S3 on Outposts ARNs, see
6760
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
6759
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
6761
6760
  #
6762
6761
  #
6763
6762
  #
@@ -6792,49 +6791,49 @@ module Aws::S3
6792
6791
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array&lt;Types::Tag&gt;
6793
6792
  #
6794
6793
  #
6795
- # @example Example: To retrieve tag set of an object
6794
+ # @example Example: To retrieve tag set of a specific object version
6796
6795
  #
6797
- # # The following example retrieves tag set of an object.
6796
+ # # The following example retrieves tag set of an object. The request specifies object version.
6798
6797
  #
6799
6798
  # resp = client.get_object_tagging({
6800
6799
  # bucket: "examplebucket",
6801
- # key: "HappyFace.jpg",
6800
+ # key: "exampleobject",
6801
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6802
6802
  # })
6803
6803
  #
6804
6804
  # resp.to_h outputs the following:
6805
6805
  # {
6806
6806
  # tag_set: [
6807
6807
  # {
6808
- # key: "Key4",
6809
- # value: "Value4",
6810
- # },
6811
- # {
6812
- # key: "Key3",
6813
- # value: "Value3",
6808
+ # key: "Key1",
6809
+ # value: "Value1",
6814
6810
  # },
6815
6811
  # ],
6816
- # version_id: "null",
6812
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6817
6813
  # }
6818
6814
  #
6819
- # @example Example: To retrieve tag set of a specific object version
6815
+ # @example Example: To retrieve tag set of an object
6820
6816
  #
6821
- # # The following example retrieves tag set of an object. The request specifies object version.
6817
+ # # The following example retrieves tag set of an object.
6822
6818
  #
6823
6819
  # resp = client.get_object_tagging({
6824
6820
  # bucket: "examplebucket",
6825
- # key: "exampleobject",
6826
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6821
+ # key: "HappyFace.jpg",
6827
6822
  # })
6828
6823
  #
6829
6824
  # resp.to_h outputs the following:
6830
6825
  # {
6831
6826
  # tag_set: [
6832
6827
  # {
6833
- # key: "Key1",
6834
- # value: "Value1",
6828
+ # key: "Key4",
6829
+ # value: "Value4",
6830
+ # },
6831
+ # {
6832
+ # key: "Key3",
6833
+ # value: "Value3",
6835
6834
  # },
6836
6835
  # ],
6837
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
6836
+ # version_id: "null",
6838
6837
  # }
6839
6838
  #
6840
6839
  # @example Request syntax with placeholder values
@@ -7090,7 +7089,7 @@ module Aws::S3
7090
7089
  # When you use this action with S3 on Outposts through the Amazon Web
7091
7090
  # Services SDKs, you provide the Outposts access point ARN in place of
7092
7091
  # the bucket name. For more information about S3 on Outposts ARNs, see
7093
- # [What is S3 on Outposts][3] in the *Amazon S3 User Guide*.
7092
+ # [What is S3 on Outposts?][3] in the *Amazon S3 User Guide*.
7094
7093
  #
7095
7094
  #
7096
7095
  #
@@ -7247,7 +7246,7 @@ module Aws::S3
7247
7246
  # When you use this action with S3 on Outposts through the Amazon Web
7248
7247
  # Services SDKs, you provide the Outposts access point ARN in place of
7249
7248
  # the bucket name. For more information about S3 on Outposts ARNs, see
7250
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
7249
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
7251
7250
  #
7252
7251
  #
7253
7252
  #
@@ -7507,7 +7506,7 @@ module Aws::S3
7507
7506
  # retrieved.
7508
7507
  #
7509
7508
  # @option params [String] :continuation_token
7510
- # The ContinuationToken that represents a placeholder from where this
7509
+ # The `ContinuationToken` that represents a placeholder from where this
7511
7510
  # request should begin.
7512
7511
  #
7513
7512
  # @option params [String] :expected_bucket_owner
@@ -7693,7 +7692,7 @@ module Aws::S3
7693
7692
  #
7694
7693
  # @option params [String] :continuation_token
7695
7694
  # The marker used to continue an inventory configuration listing that
7696
- # has been truncated. Use the NextContinuationToken from a previously
7695
+ # has been truncated. Use the `NextContinuationToken` from a previously
7697
7696
  # truncated list response to continue the listing. The continuation
7698
7697
  # token is an opaque value that Amazon S3 understands.
7699
7698
  #
@@ -7793,7 +7792,7 @@ module Aws::S3
7793
7792
  #
7794
7793
  # @option params [String] :continuation_token
7795
7794
  # The marker that is used to continue a metrics configuration listing
7796
- # that has been truncated. Use the NextContinuationToken from a
7795
+ # that has been truncated. Use the `NextContinuationToken` from a
7797
7796
  # previously truncated list response to continue the listing. The
7798
7797
  # continuation token is an opaque value that Amazon S3 understands.
7799
7798
  #
@@ -7972,7 +7971,7 @@ module Aws::S3
7972
7971
  # When you use this action with S3 on Outposts through the Amazon Web
7973
7972
  # Services SDKs, you provide the Outposts access point ARN in place of
7974
7973
  # the bucket name. For more information about S3 on Outposts ARNs, see
7975
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
7974
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
7976
7975
  #
7977
7976
  #
7978
7977
  #
@@ -7991,15 +7990,15 @@ module Aws::S3
7991
7990
  #
7992
7991
  # @option params [String] :encoding_type
7993
7992
  # Requests Amazon S3 to encode the object keys in the response and
7994
- # specifies the encoding method to use. An object key may contain any
7995
- # Unicode character; however, XML 1.0 parser cannot parse some
7993
+ # specifies the encoding method to use. An object key can contain any
7994
+ # Unicode character; however, the XML 1.0 parser cannot parse some
7996
7995
  # characters, such as characters with an ASCII value from 0 to 10. For
7997
7996
  # characters that are not supported in XML 1.0, you can add this
7998
7997
  # parameter to request that Amazon S3 encode the keys in the response.
7999
7998
  #
8000
7999
  # @option params [String] :key_marker
8001
- # Together with upload-id-marker, this parameter specifies the multipart
8002
- # upload after which listing should begin.
8000
+ # Together with `upload-id-marker`, this parameter specifies the
8001
+ # multipart upload after which listing should begin.
8003
8002
  #
8004
8003
  # If `upload-id-marker` is not specified, only the keys
8005
8004
  # lexicographically greater than the specified `key-marker` will be
@@ -8018,8 +8017,8 @@ module Aws::S3
8018
8017
  # @option params [String] :prefix
8019
8018
  # Lists in-progress uploads only for those keys that begin with the
8020
8019
  # specified prefix. You can use prefixes to separate a bucket into
8021
- # different grouping of keys. (You can think of using prefix to make
8022
- # groups in the same way you'd use a folder in a file system.)
8020
+ # different grouping of keys. (You can think of using `prefix` to make
8021
+ # groups in the same way that you'd use a folder in a file system.)
8023
8022
  #
8024
8023
  # @option params [String] :upload_id_marker
8025
8024
  # Together with key-marker, specifies the multipart upload after which
@@ -8064,97 +8063,97 @@ module Aws::S3
8064
8063
  # The returned {Seahorse::Client::Response response} is a pageable response and is Enumerable. For details on usage see {Aws::PageableResponse PageableResponse}.
8065
8064
  #
8066
8065
  #
8067
- # @example Example: List next set of multipart uploads when previous result is truncated
8066
+ # @example Example: To list in-progress multipart uploads on a bucket
8068
8067
  #
8069
- # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
8070
- # # setup of multipart uploads.
8068
+ # # The following example lists in-progress multipart uploads on a specific bucket.
8071
8069
  #
8072
8070
  # resp = client.list_multipart_uploads({
8073
8071
  # bucket: "examplebucket",
8074
- # key_marker: "nextkeyfrompreviousresponse",
8075
- # max_uploads: 2,
8076
- # upload_id_marker: "valuefrompreviousresponse",
8077
8072
  # })
8078
8073
  #
8079
8074
  # resp.to_h outputs the following:
8080
8075
  # {
8081
- # bucket: "acl1",
8082
- # is_truncated: true,
8083
- # key_marker: "",
8084
- # max_uploads: 2,
8085
- # next_key_marker: "someobjectkey",
8086
- # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
8087
- # upload_id_marker: "",
8088
8076
  # uploads: [
8089
8077
  # {
8090
8078
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
8091
8079
  # initiator: {
8092
- # display_name: "ownder-display-name",
8080
+ # display_name: "display-name",
8093
8081
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8094
8082
  # },
8095
8083
  # key: "JavaFile",
8096
8084
  # owner: {
8097
- # display_name: "mohanataws",
8098
- # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8085
+ # display_name: "display-name",
8086
+ # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8099
8087
  # },
8100
8088
  # storage_class: "STANDARD",
8101
- # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
8089
+ # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
8102
8090
  # },
8103
8091
  # {
8104
8092
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
8105
8093
  # initiator: {
8106
- # display_name: "ownder-display-name",
8094
+ # display_name: "display-name",
8107
8095
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8108
8096
  # },
8109
8097
  # key: "JavaFile",
8110
8098
  # owner: {
8111
- # display_name: "ownder-display-name",
8099
+ # display_name: "display-name",
8112
8100
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8113
8101
  # },
8114
8102
  # storage_class: "STANDARD",
8115
- # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
8103
+ # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
8116
8104
  # },
8117
8105
  # ],
8118
8106
  # }
8119
8107
  #
8120
- # @example Example: To list in-progress multipart uploads on a bucket
8108
+ # @example Example: List next set of multipart uploads when previous result is truncated
8121
8109
  #
8122
- # # The following example lists in-progress multipart uploads on a specific bucket.
8110
+ # # The following example specifies the upload-id-marker and key-marker from previous truncated response to retrieve next
8111
+ # # setup of multipart uploads.
8123
8112
  #
8124
8113
  # resp = client.list_multipart_uploads({
8125
8114
  # bucket: "examplebucket",
8115
+ # key_marker: "nextkeyfrompreviousresponse",
8116
+ # max_uploads: 2,
8117
+ # upload_id_marker: "valuefrompreviousresponse",
8126
8118
  # })
8127
8119
  #
8128
8120
  # resp.to_h outputs the following:
8129
8121
  # {
8122
+ # bucket: "acl1",
8123
+ # is_truncated: true,
8124
+ # key_marker: "",
8125
+ # max_uploads: 2,
8126
+ # next_key_marker: "someobjectkey",
8127
+ # next_upload_id_marker: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
8128
+ # upload_id_marker: "",
8130
8129
  # uploads: [
8131
8130
  # {
8132
8131
  # initiated: Time.parse("2014-05-01T05:40:58.000Z"),
8133
8132
  # initiator: {
8134
- # display_name: "display-name",
8133
+ # display_name: "ownder-display-name",
8135
8134
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8136
8135
  # },
8137
8136
  # key: "JavaFile",
8138
8137
  # owner: {
8139
- # display_name: "display-name",
8140
- # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8138
+ # display_name: "mohanataws",
8139
+ # id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8141
8140
  # },
8142
8141
  # storage_class: "STANDARD",
8143
- # upload_id: "examplelUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
8142
+ # upload_id: "gZ30jIqlUa.CInXklLQtSMJITdUnoZ1Y5GACB5UckOtspm5zbDMCkPF_qkfZzMiFZ6dksmcnqxJyIBvQMG9X9Q--",
8144
8143
  # },
8145
8144
  # {
8146
8145
  # initiated: Time.parse("2014-05-01T05:41:27.000Z"),
8147
8146
  # initiator: {
8148
- # display_name: "display-name",
8147
+ # display_name: "ownder-display-name",
8149
8148
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8150
8149
  # },
8151
8150
  # key: "JavaFile",
8152
8151
  # owner: {
8153
- # display_name: "display-name",
8152
+ # display_name: "ownder-display-name",
8154
8153
  # id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
8155
8154
  # },
8156
8155
  # storage_class: "STANDARD",
8157
- # upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
8156
+ # upload_id: "b7tZSqIlo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
8158
8157
  # },
8159
8158
  # ],
8160
8159
  # }
@@ -8212,10 +8211,10 @@ module Aws::S3
8212
8211
  # can also use request parameters as selection criteria to return
8213
8212
  # metadata about a subset of all the object versions.
8214
8213
  #
8215
- # To use this operation, you must have permissions to perform the
8214
+ # To use this operation, you must have permission to perform the
8216
8215
  # `s3:ListBucketVersions` action. Be aware of the name difference.
8217
8216
  #
8218
- # <note markdown="1"> A 200 OK response can contain valid or invalid XML. Make sure to
8217
+ # <note markdown="1"> A `200 OK` response can contain valid or invalid XML. Make sure to
8219
8218
  # design your application to parse the contents of the response and
8220
8219
  # handle it appropriately.
8221
8220
  #
@@ -8249,14 +8248,14 @@ module Aws::S3
8249
8248
  # A delimiter is a character that you specify to group keys. All keys
8250
8249
  # that contain the same string between the `prefix` and the first
8251
8250
  # occurrence of the delimiter are grouped under a single result element
8252
- # in CommonPrefixes. These groups are counted as one result against the
8253
- # max-keys limitation. These keys are not returned elsewhere in the
8254
- # response.
8251
+ # in `CommonPrefixes`. These groups are counted as one result against
8252
+ # the `max-keys` limitation. These keys are not returned elsewhere in
8253
+ # the response.
8255
8254
  #
8256
8255
  # @option params [String] :encoding_type
8257
8256
  # Requests Amazon S3 to encode the object keys in the response and
8258
- # specifies the encoding method to use. An object key may contain any
8259
- # Unicode character; however, XML 1.0 parser cannot parse some
8257
+ # specifies the encoding method to use. An object key can contain any
8258
+ # Unicode character; however, the XML 1.0 parser cannot parse some
8260
8259
  # characters, such as characters with an ASCII value from 0 to 10. For
8261
8260
  # characters that are not supported in XML 1.0, you can add this
8262
8261
  # parameter to request that Amazon S3 encode the keys in the response.
@@ -8265,20 +8264,20 @@ module Aws::S3
8265
8264
  # Specifies the key to start with when listing objects in a bucket.
8266
8265
  #
8267
8266
  # @option params [Integer] :max_keys
8268
- # Sets the maximum number of keys returned in the response. By default
8267
+ # Sets the maximum number of keys returned in the response. By default,
8269
8268
  # the action returns up to 1,000 key names. The response might contain
8270
8269
  # fewer keys but will never contain more. If additional keys satisfy the
8271
- # search criteria, but were not returned because max-keys was exceeded,
8272
- # the response contains &lt;isTruncated&gt;true&lt;/isTruncated&gt;. To
8273
- # return the additional keys, see key-marker and version-id-marker.
8270
+ # search criteria, but were not returned because `max-keys` was
8271
+ # exceeded, the response contains `<isTruncated>true</isTruncated>`. To
8272
+ # return the additional keys, see `key-marker` and `version-id-marker`.
8274
8273
  #
8275
8274
  # @option params [String] :prefix
8276
8275
  # Use this parameter to select only those keys that begin with the
8277
8276
  # specified prefix. You can use prefixes to separate a bucket into
8278
- # different groupings of keys. (You can think of using prefix to make
8279
- # groups in the same way you'd use a folder in a file system.) You can
8280
- # use prefix with delimiter to roll up numerous objects into a single
8281
- # result under CommonPrefixes.
8277
+ # different groupings of keys. (You can think of using `prefix` to make
8278
+ # groups in the same way that you'd use a folder in a file system.) You
8279
+ # can use `prefix` with `delimiter` to roll up numerous objects into a
8280
+ # single result under `CommonPrefixes`.
8282
8281
  #
8283
8282
  # @option params [String] :version_id_marker
8284
8283
  # Specifies the object version you want to start listing from.
@@ -8299,6 +8298,10 @@ module Aws::S3
8299
8298
  #
8300
8299
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
8301
8300
  #
8301
+ # @option params [Array<String>] :optional_object_attributes
8302
+ # Specifies the optional fields that you want returned in the response.
8303
+ # Fields that you do not specify are not returned.
8304
+ #
8302
8305
  # @return [Types::ListObjectVersionsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8303
8306
  #
8304
8307
  # * {Types::ListObjectVersionsOutput#is_truncated #is_truncated} => Boolean
@@ -8374,6 +8377,7 @@ module Aws::S3
8374
8377
  # version_id_marker: "VersionIdMarker",
8375
8378
  # expected_bucket_owner: "AccountId",
8376
8379
  # request_payer: "requester", # accepts requester
8380
+ # optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
8377
8381
  # })
8378
8382
  #
8379
8383
  # @example Response structure
@@ -8395,6 +8399,8 @@ module Aws::S3
8395
8399
  # resp.versions[0].last_modified #=> Time
8396
8400
  # resp.versions[0].owner.display_name #=> String
8397
8401
  # resp.versions[0].owner.id #=> String
8402
+ # resp.versions[0].restore_status.is_restore_in_progress #=> Boolean
8403
+ # resp.versions[0].restore_status.restore_expiry_date #=> Time
8398
8404
  # resp.delete_markers #=> Array
8399
8405
  # resp.delete_markers[0].owner.display_name #=> String
8400
8406
  # resp.delete_markers[0].owner.id #=> String
@@ -8468,7 +8474,7 @@ module Aws::S3
8468
8474
  # When you use this action with S3 on Outposts through the Amazon Web
8469
8475
  # Services SDKs, you provide the Outposts access point ARN in place of
8470
8476
  # the bucket name. For more information about S3 on Outposts ARNs, see
8471
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
8477
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
8472
8478
  #
8473
8479
  #
8474
8480
  #
@@ -8476,12 +8482,12 @@ module Aws::S3
8476
8482
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
8477
8483
  #
8478
8484
  # @option params [String] :delimiter
8479
- # A delimiter is a character you use to group keys.
8485
+ # A delimiter is a character that you use to group keys.
8480
8486
  #
8481
8487
  # @option params [String] :encoding_type
8482
8488
  # Requests Amazon S3 to encode the object keys in the response and
8483
- # specifies the encoding method to use. An object key may contain any
8484
- # Unicode character; however, XML 1.0 parser cannot parse some
8489
+ # specifies the encoding method to use. An object key can contain any
8490
+ # Unicode character; however, the XML 1.0 parser cannot parse some
8485
8491
  # characters, such as characters with an ASCII value from 0 to 10. For
8486
8492
  # characters that are not supported in XML 1.0, you can add this
8487
8493
  # parameter to request that Amazon S3 encode the keys in the response.
@@ -8492,7 +8498,7 @@ module Aws::S3
8492
8498
  # bucket.
8493
8499
  #
8494
8500
  # @option params [Integer] :max_keys
8495
- # Sets the maximum number of keys returned in the response. By default
8501
+ # Sets the maximum number of keys returned in the response. By default,
8496
8502
  # the action returns up to 1,000 key names. The response might contain
8497
8503
  # fewer keys but will never contain more.
8498
8504
  #
@@ -8509,6 +8515,10 @@ module Aws::S3
8509
8515
  # a different account, the request fails with the HTTP status code `403
8510
8516
  # Forbidden` (access denied).
8511
8517
  #
8518
+ # @option params [Array<String>] :optional_object_attributes
8519
+ # Specifies the optional fields that you want returned in the response.
8520
+ # Fields that you do not specify are not returned.
8521
+ #
8512
8522
  # @return [Types::ListObjectsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8513
8523
  #
8514
8524
  # * {Types::ListObjectsOutput#is_truncated #is_truncated} => Boolean
@@ -8575,6 +8585,7 @@ module Aws::S3
8575
8585
  # prefix: "Prefix",
8576
8586
  # request_payer: "requester", # accepts requester
8577
8587
  # expected_bucket_owner: "AccountId",
8588
+ # optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
8578
8589
  # })
8579
8590
  #
8580
8591
  # @example Response structure
@@ -8592,6 +8603,8 @@ module Aws::S3
8592
8603
  # resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW"
8593
8604
  # resp.contents[0].owner.display_name #=> String
8594
8605
  # resp.contents[0].owner.id #=> String
8606
+ # resp.contents[0].restore_status.is_restore_in_progress #=> Boolean
8607
+ # resp.contents[0].restore_status.restore_expiry_date #=> Time
8595
8608
  # resp.name #=> String
8596
8609
  # resp.prefix #=> String
8597
8610
  # resp.delimiter #=> String
@@ -8617,21 +8630,23 @@ module Aws::S3
8617
8630
  # parse the contents of the response and handle it appropriately.
8618
8631
  # Objects are returned sorted in an ascending order of the respective
8619
8632
  # key names in the list. For more information about listing objects, see
8620
- # [Listing object keys programmatically][1]
8633
+ # [Listing object keys programmatically][1] in the *Amazon S3 User
8634
+ # Guide*.
8621
8635
  #
8622
8636
  # To use this operation, you must have READ access to the bucket.
8623
8637
  #
8624
8638
  # To use this action in an Identity and Access Management (IAM) policy,
8625
- # you must have permissions to perform the `s3:ListBucket` action. The
8639
+ # you must have permission to perform the `s3:ListBucket` action. The
8626
8640
  # bucket owner has this permission by default and can grant this
8627
8641
  # permission to others. For more information about permissions, see
8628
8642
  # [Permissions Related to Bucket Subresource Operations][2] and
8629
- # [Managing Access Permissions to Your Amazon S3 Resources][3].
8643
+ # [Managing Access Permissions to Your Amazon S3 Resources][3] in the
8644
+ # *Amazon S3 User Guide*.
8630
8645
  #
8631
8646
  # This section describes the latest revision of this action. We
8632
- # recommend that you use this revised API for application development.
8633
- # For backward compatibility, Amazon S3 continues to support the prior
8634
- # version of this API, [ListObjects][4].
8647
+ # recommend that you use this revised API operation for application
8648
+ # development. For backward compatibility, Amazon S3 continues to
8649
+ # support the prior version of this API operation, [ListObjects][4].
8635
8650
  #
8636
8651
  # To get a list of your buckets, see [ListBuckets][5].
8637
8652
  #
@@ -8672,7 +8687,7 @@ module Aws::S3
8672
8687
  # When you use this action with S3 on Outposts through the Amazon Web
8673
8688
  # Services SDKs, you provide the Outposts access point ARN in place of
8674
8689
  # the bucket name. For more information about S3 on Outposts ARNs, see
8675
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
8690
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
8676
8691
  #
8677
8692
  #
8678
8693
  #
@@ -8680,13 +8695,13 @@ module Aws::S3
8680
8695
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html
8681
8696
  #
8682
8697
  # @option params [String] :delimiter
8683
- # A delimiter is a character you use to group keys.
8698
+ # A delimiter is a character that you use to group keys.
8684
8699
  #
8685
8700
  # @option params [String] :encoding_type
8686
8701
  # Encoding type used by Amazon S3 to encode object keys in the response.
8687
8702
  #
8688
8703
  # @option params [Integer] :max_keys
8689
- # Sets the maximum number of keys returned in the response. By default
8704
+ # Sets the maximum number of keys returned in the response. By default,
8690
8705
  # the action returns up to 1,000 key names. The response might contain
8691
8706
  # fewer keys but will never contain more.
8692
8707
  #
@@ -8694,14 +8709,14 @@ module Aws::S3
8694
8709
  # Limits the response to keys that begin with the specified prefix.
8695
8710
  #
8696
8711
  # @option params [String] :continuation_token
8697
- # ContinuationToken indicates Amazon S3 that the list is being continued
8698
- # on this bucket with a token. ContinuationToken is obfuscated and is
8699
- # not a real key.
8712
+ # `ContinuationToken` indicates to Amazon S3 that the list is being
8713
+ # continued on this bucket with a token. `ContinuationToken` is
8714
+ # obfuscated and is not a real key.
8700
8715
  #
8701
8716
  # @option params [Boolean] :fetch_owner
8702
- # The owner field is not present in listV2 by default, if you want to
8703
- # return owner field with each key in the result then set the fetch
8704
- # owner field to true.
8717
+ # The owner field is not present in `ListObjectsV2` by default. If you
8718
+ # want to return the owner field with each key in the result, then set
8719
+ # the `FetchOwner` field to `true`.
8705
8720
  #
8706
8721
  # @option params [String] :start_after
8707
8722
  # StartAfter is where you want Amazon S3 to start listing from. Amazon
@@ -8718,6 +8733,10 @@ module Aws::S3
8718
8733
  # a different account, the request fails with the HTTP status code `403
8719
8734
  # Forbidden` (access denied).
8720
8735
  #
8736
+ # @option params [Array<String>] :optional_object_attributes
8737
+ # Specifies the optional fields that you want returned in the response.
8738
+ # Fields that you do not specify are not returned.
8739
+ #
8721
8740
  # @return [Types::ListObjectsV2Output] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
8722
8741
  #
8723
8742
  # * {Types::ListObjectsV2Output#is_truncated #is_truncated} => Boolean
@@ -8786,6 +8805,7 @@ module Aws::S3
8786
8805
  # start_after: "StartAfter",
8787
8806
  # request_payer: "requester", # accepts requester
8788
8807
  # expected_bucket_owner: "AccountId",
8808
+ # optional_object_attributes: ["RestoreStatus"], # accepts RestoreStatus
8789
8809
  # })
8790
8810
  #
8791
8811
  # @example Response structure
@@ -8801,6 +8821,8 @@ module Aws::S3
8801
8821
  # resp.contents[0].storage_class #=> String, one of "STANDARD", "REDUCED_REDUNDANCY", "GLACIER", "STANDARD_IA", "ONEZONE_IA", "INTELLIGENT_TIERING", "DEEP_ARCHIVE", "OUTPOSTS", "GLACIER_IR", "SNOW"
8802
8822
  # resp.contents[0].owner.display_name #=> String
8803
8823
  # resp.contents[0].owner.id #=> String
8824
+ # resp.contents[0].restore_status.is_restore_in_progress #=> Boolean
8825
+ # resp.contents[0].restore_status.restore_expiry_date #=> Time
8804
8826
  # resp.name #=> String
8805
8827
  # resp.prefix #=> String
8806
8828
  # resp.delimiter #=> String
@@ -8889,7 +8911,7 @@ module Aws::S3
8889
8911
  # When you use this action with S3 on Outposts through the Amazon Web
8890
8912
  # Services SDKs, you provide the Outposts access point ARN in place of
8891
8913
  # the bucket name. For more information about S3 on Outposts ARNs, see
8892
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
8914
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
8893
8915
  #
8894
8916
  #
8895
8917
  #
@@ -12152,7 +12174,7 @@ module Aws::S3
12152
12174
  # When you use this action with S3 on Outposts through the Amazon Web
12153
12175
  # Services SDKs, you provide the Outposts access point ARN in place of
12154
12176
  # the bucket name. For more information about S3 on Outposts ARNs, see
12155
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
12177
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
12156
12178
  #
12157
12179
  #
12158
12180
  #
@@ -12456,40 +12478,45 @@ module Aws::S3
12456
12478
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
12457
12479
  #
12458
12480
  #
12459
- # @example Example: To upload an object and specify optional tags
12481
+ # @example Example: To upload object and specify user-defined metadata
12460
12482
  #
12461
- # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
12462
- # # S3 returns version ID of the newly created object.
12483
+ # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
12484
+ # # enabled, S3 returns version ID in response.
12463
12485
  #
12464
12486
  # resp = client.put_object({
12465
- # body: "c:\\HappyFace.jpg",
12487
+ # body: "filetoupload",
12466
12488
  # bucket: "examplebucket",
12467
- # key: "HappyFace.jpg",
12468
- # tagging: "key1=value1&key2=value2",
12489
+ # key: "exampleobject",
12490
+ # metadata: {
12491
+ # "metadata1" => "value1",
12492
+ # "metadata2" => "value2",
12493
+ # },
12469
12494
  # })
12470
12495
  #
12471
12496
  # resp.to_h outputs the following:
12472
12497
  # {
12473
12498
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12474
- # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
12499
+ # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
12475
12500
  # }
12476
12501
  #
12477
- # @example Example: To upload an object and specify canned ACL.
12502
+ # @example Example: To upload an object (specify optional headers)
12478
12503
  #
12479
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
12480
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
12504
+ # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
12505
+ # # storage class and use server-side encryption.
12481
12506
  #
12482
12507
  # resp = client.put_object({
12483
- # acl: "authenticated-read",
12484
- # body: "filetoupload",
12508
+ # body: "HappyFace.jpg",
12485
12509
  # bucket: "examplebucket",
12486
- # key: "exampleobject",
12510
+ # key: "HappyFace.jpg",
12511
+ # server_side_encryption: "AES256",
12512
+ # storage_class: "STANDARD_IA",
12487
12513
  # })
12488
12514
  #
12489
12515
  # resp.to_h outputs the following:
12490
12516
  # {
12491
12517
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12492
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
12518
+ # server_side_encryption: "AES256",
12519
+ # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
12493
12520
  # }
12494
12521
  #
12495
12522
  # @example Example: To create an object.
@@ -12508,82 +12535,77 @@ module Aws::S3
12508
12535
  # version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
12509
12536
  # }
12510
12537
  #
12511
- # @example Example: To upload an object and specify server-side encryption and object tags
12538
+ # @example Example: To upload an object and specify canned ACL.
12512
12539
  #
12513
- # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
12514
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
12540
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
12541
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
12515
12542
  #
12516
12543
  # resp = client.put_object({
12544
+ # acl: "authenticated-read",
12517
12545
  # body: "filetoupload",
12518
12546
  # bucket: "examplebucket",
12519
12547
  # key: "exampleobject",
12520
- # server_side_encryption: "AES256",
12521
- # tagging: "key1=value1&key2=value2",
12522
12548
  # })
12523
12549
  #
12524
12550
  # resp.to_h outputs the following:
12525
12551
  # {
12526
12552
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12527
- # server_side_encryption: "AES256",
12528
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
12553
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
12529
12554
  # }
12530
12555
  #
12531
- # @example Example: To upload object and specify user-defined metadata
12556
+ # @example Example: To upload an object
12532
12557
  #
12533
- # # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
12534
- # # enabled, S3 returns version ID in response.
12558
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
12559
+ # # syntax. S3 returns VersionId of the newly created object.
12535
12560
  #
12536
12561
  # resp = client.put_object({
12537
- # body: "filetoupload",
12562
+ # body: "HappyFace.jpg",
12538
12563
  # bucket: "examplebucket",
12539
- # key: "exampleobject",
12540
- # metadata: {
12541
- # "metadata1" => "value1",
12542
- # "metadata2" => "value2",
12543
- # },
12564
+ # key: "HappyFace.jpg",
12544
12565
  # })
12545
12566
  #
12546
12567
  # resp.to_h outputs the following:
12547
12568
  # {
12548
12569
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12549
- # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
12570
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
12550
12571
  # }
12551
12572
  #
12552
- # @example Example: To upload an object
12573
+ # @example Example: To upload an object and specify server-side encryption and object tags
12553
12574
  #
12554
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
12555
- # # syntax. S3 returns VersionId of the newly created object.
12575
+ # # The following example uploads an object. The request specifies the optional server-side encryption option. The request
12576
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
12556
12577
  #
12557
12578
  # resp = client.put_object({
12558
- # body: "HappyFace.jpg",
12579
+ # body: "filetoupload",
12559
12580
  # bucket: "examplebucket",
12560
- # key: "HappyFace.jpg",
12581
+ # key: "exampleobject",
12582
+ # server_side_encryption: "AES256",
12583
+ # tagging: "key1=value1&key2=value2",
12561
12584
  # })
12562
12585
  #
12563
12586
  # resp.to_h outputs the following:
12564
12587
  # {
12565
12588
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12566
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
12589
+ # server_side_encryption: "AES256",
12590
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
12567
12591
  # }
12568
12592
  #
12569
- # @example Example: To upload an object (specify optional headers)
12593
+ # @example Example: To upload an object and specify optional tags
12570
12594
  #
12571
- # # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
12572
- # # storage class and use server-side encryption.
12595
+ # # The following example uploads an object. The request specifies optional object tags. The bucket is versioned, therefore
12596
+ # # S3 returns version ID of the newly created object.
12573
12597
  #
12574
12598
  # resp = client.put_object({
12575
- # body: "HappyFace.jpg",
12599
+ # body: "c:\\HappyFace.jpg",
12576
12600
  # bucket: "examplebucket",
12577
12601
  # key: "HappyFace.jpg",
12578
- # server_side_encryption: "AES256",
12579
- # storage_class: "STANDARD_IA",
12602
+ # tagging: "key1=value1&key2=value2",
12580
12603
  # })
12581
12604
  #
12582
12605
  # resp.to_h outputs the following:
12583
12606
  # {
12584
12607
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
12585
- # server_side_encryption: "AES256",
12586
- # version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
12608
+ # version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
12587
12609
  # }
12588
12610
  #
12589
12611
  # @example Streaming a file from disk
@@ -12929,7 +12951,7 @@ module Aws::S3
12929
12951
  # When you use this action with S3 on Outposts through the Amazon Web
12930
12952
  # Services SDKs, you provide the Outposts access point ARN in place of
12931
12953
  # the bucket name. For more information about S3 on Outposts ARNs, see
12932
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
12954
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
12933
12955
  #
12934
12956
  #
12935
12957
  #
@@ -13433,7 +13455,7 @@ module Aws::S3
13433
13455
  # When you use this action with S3 on Outposts through the Amazon Web
13434
13456
  # Services SDKs, you provide the Outposts access point ARN in place of
13435
13457
  # the bucket name. For more information about S3 on Outposts ARNs, see
13436
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
13458
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
13437
13459
  #
13438
13460
  #
13439
13461
  #
@@ -13895,7 +13917,7 @@ module Aws::S3
13895
13917
  # When you use this action with S3 on Outposts through the Amazon Web
13896
13918
  # Services SDKs, you provide the Outposts access point ARN in place of
13897
13919
  # the bucket name. For more information about S3 on Outposts ARNs, see
13898
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
13920
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
13899
13921
  #
13900
13922
  #
13901
13923
  #
@@ -14629,7 +14651,7 @@ module Aws::S3
14629
14651
  # When you use this action with S3 on Outposts through the Amazon Web
14630
14652
  # Services SDKs, you provide the Outposts access point ARN in place of
14631
14653
  # the bucket name. For more information about S3 on Outposts ARNs, see
14632
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
14654
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
14633
14655
  #
14634
14656
  #
14635
14657
  #
@@ -14978,7 +15000,7 @@ module Aws::S3
14978
15000
  # When you use this action with S3 on Outposts through the Amazon Web
14979
15001
  # Services SDKs, you provide the Outposts access point ARN in place of
14980
15002
  # the bucket name. For more information about S3 on Outposts ARNs, see
14981
- # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
15003
+ # [What is S3 on Outposts?][2] in the *Amazon S3 User Guide*.
14982
15004
  #
14983
15005
  #
14984
15006
  #
@@ -15128,45 +15150,45 @@ module Aws::S3
15128
15150
  # * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
15129
15151
  #
15130
15152
  #
15131
- # @example Example: To upload a part by copying byte range from an existing object as data source
15153
+ # @example Example: To upload a part by copying data from an existing object as data source
15132
15154
  #
15133
- # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
15134
- # # data source.
15155
+ # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
15135
15156
  #
15136
15157
  # resp = client.upload_part_copy({
15137
15158
  # bucket: "examplebucket",
15138
15159
  # copy_source: "/bucketname/sourceobjectkey",
15139
- # copy_source_range: "bytes=1-100000",
15140
15160
  # key: "examplelargeobject",
15141
- # part_number: 2,
15161
+ # part_number: 1,
15142
15162
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
15143
15163
  # })
15144
15164
  #
15145
15165
  # resp.to_h outputs the following:
15146
15166
  # {
15147
15167
  # copy_part_result: {
15148
- # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
15149
- # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
15168
+ # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
15169
+ # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
15150
15170
  # },
15151
15171
  # }
15152
15172
  #
15153
- # @example Example: To upload a part by copying data from an existing object as data source
15173
+ # @example Example: To upload a part by copying byte range from an existing object as data source
15154
15174
  #
15155
- # # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
15175
+ # # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
15176
+ # # data source.
15156
15177
  #
15157
15178
  # resp = client.upload_part_copy({
15158
15179
  # bucket: "examplebucket",
15159
15180
  # copy_source: "/bucketname/sourceobjectkey",
15181
+ # copy_source_range: "bytes=1-100000",
15160
15182
  # key: "examplelargeobject",
15161
- # part_number: 1,
15183
+ # part_number: 2,
15162
15184
  # upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
15163
15185
  # })
15164
15186
  #
15165
15187
  # resp.to_h outputs the following:
15166
15188
  # {
15167
15189
  # copy_part_result: {
15168
- # etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
15169
- # last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
15190
+ # etag: "\"65d16d19e65a7508a51f043180edcc36\"",
15191
+ # last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
15170
15192
  # },
15171
15193
  # }
15172
15194
  #
@@ -15614,7 +15636,7 @@ module Aws::S3
15614
15636
  params: params,
15615
15637
  config: config)
15616
15638
  context[:gem_name] = 'aws-sdk-s3'
15617
- context[:gem_version] = '1.126.0'
15639
+ context[:gem_version] = '1.127.0'
15618
15640
  Seahorse::Client::Request.new(handlers, context)
15619
15641
  end
15620
15642