aws-sdk-s3 1.126.0 → 1.127.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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