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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +7 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +27 -19
- data/lib/aws-sdk-s3/client.rb +193 -171
- data/lib/aws-sdk-s3/client_api.rb +16 -0
- data/lib/aws-sdk-s3/object_summary.rb +14 -0
- data/lib/aws-sdk-s3/object_version.rb +14 -0
- data/lib/aws-sdk-s3/presigner.rb +4 -2
- data/lib/aws-sdk-s3/types.rb +211 -118
- data/lib/aws-sdk-s3.rb +1 -1
- metadata +6 -6
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -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
|
-
#
|
6414
|
-
#
|
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<Types::Tag>
|
6793
6792
|
#
|
6794
6793
|
#
|
6795
|
-
# @example Example: To retrieve tag set of
|
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: "
|
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: "
|
6809
|
-
# value: "
|
6810
|
-
# },
|
6811
|
-
# {
|
6812
|
-
# key: "Key3",
|
6813
|
-
# value: "Value3",
|
6808
|
+
# key: "Key1",
|
6809
|
+
# value: "Value1",
|
6814
6810
|
# },
|
6815
6811
|
# ],
|
6816
|
-
# version_id: "
|
6812
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
6817
6813
|
# }
|
6818
6814
|
#
|
6819
|
-
# @example Example: To retrieve tag set of
|
6815
|
+
# @example Example: To retrieve tag set of an object
|
6820
6816
|
#
|
6821
|
-
# # The following example retrieves tag set of an object.
|
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: "
|
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: "
|
6834
|
-
# value: "
|
6828
|
+
# key: "Key4",
|
6829
|
+
# value: "Value4",
|
6830
|
+
# },
|
6831
|
+
# {
|
6832
|
+
# key: "Key3",
|
6833
|
+
# value: "Value3",
|
6835
6834
|
# },
|
6836
6835
|
# ],
|
6837
|
-
# version_id: "
|
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
|
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
|
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:
|
8066
|
+
# @example Example: To list in-progress multipart uploads on a bucket
|
8068
8067
|
#
|
8069
|
-
# # The following example
|
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: "
|
8080
|
+
# display_name: "display-name",
|
8093
8081
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
8094
8082
|
# },
|
8095
8083
|
# key: "JavaFile",
|
8096
8084
|
# owner: {
|
8097
|
-
# display_name: "
|
8098
|
-
# id: "
|
8085
|
+
# display_name: "display-name",
|
8086
|
+
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
8099
8087
|
# },
|
8100
8088
|
# storage_class: "STANDARD",
|
8101
|
-
# upload_id: "
|
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: "
|
8094
|
+
# display_name: "display-name",
|
8107
8095
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
8108
8096
|
# },
|
8109
8097
|
# key: "JavaFile",
|
8110
8098
|
# owner: {
|
8111
|
-
# display_name: "
|
8099
|
+
# display_name: "display-name",
|
8112
8100
|
# id: "examplee7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
8113
8101
|
# },
|
8114
8102
|
# storage_class: "STANDARD",
|
8115
|
-
# upload_id: "
|
8103
|
+
# upload_id: "examplelo91lv1iwvWpvCiJWugw2xXLPAD7Z8cJyX9.WiIRgNrdG6Ldsn.9FtS63TCl1Uf5faTB.1U5Ckcbmdw--",
|
8116
8104
|
# },
|
8117
8105
|
# ],
|
8118
8106
|
# }
|
8119
8107
|
#
|
8120
|
-
# @example Example:
|
8108
|
+
# @example Example: List next set of multipart uploads when previous result is truncated
|
8121
8109
|
#
|
8122
|
-
# # The following example
|
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: "
|
8140
|
-
# id: "
|
8138
|
+
# display_name: "mohanataws",
|
8139
|
+
# id: "852b113e7a2f25102679df27bb0ae12b3f85be6f290b936c4393484be31bebcc",
|
8141
8140
|
# },
|
8142
8141
|
# storage_class: "STANDARD",
|
8143
|
-
# upload_id: "
|
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: "
|
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
|
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
|
8253
|
-
# max-keys limitation. These keys are not returned elsewhere in
|
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
|
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
|
8272
|
-
# the response contains
|
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
|
8280
|
-
# use prefix with delimiter to roll up numerous objects into a
|
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
|
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
|
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
|
8633
|
-
# For backward compatibility, Amazon S3 continues to
|
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
|
8698
|
-
# on this bucket with a token. ContinuationToken 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
|
8703
|
-
# return owner field with each key in the result then set
|
8704
|
-
#
|
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
|
12481
|
+
# @example Example: To upload object and specify user-defined metadata
|
12460
12482
|
#
|
12461
|
-
# # The following example
|
12462
|
-
# # S3 returns version ID
|
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: "
|
12487
|
+
# body: "filetoupload",
|
12466
12488
|
# bucket: "examplebucket",
|
12467
|
-
# key: "
|
12468
|
-
#
|
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: "
|
12499
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
12475
12500
|
# }
|
12476
12501
|
#
|
12477
|
-
# @example Example: To upload an object
|
12502
|
+
# @example Example: To upload an object (specify optional headers)
|
12478
12503
|
#
|
12479
|
-
# # The following example uploads
|
12480
|
-
# #
|
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
|
-
#
|
12484
|
-
# body: "filetoupload",
|
12508
|
+
# body: "HappyFace.jpg",
|
12485
12509
|
# bucket: "examplebucket",
|
12486
|
-
# key: "
|
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
|
-
#
|
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
|
12538
|
+
# @example Example: To upload an object and specify canned ACL.
|
12512
12539
|
#
|
12513
|
-
# # The following example uploads
|
12514
|
-
# #
|
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
|
-
#
|
12528
|
-
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
12553
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
12529
12554
|
# }
|
12530
12555
|
#
|
12531
|
-
# @example Example: To upload object
|
12556
|
+
# @example Example: To upload an object
|
12532
12557
|
#
|
12533
|
-
# # The following example
|
12534
|
-
# #
|
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: "
|
12562
|
+
# body: "HappyFace.jpg",
|
12538
12563
|
# bucket: "examplebucket",
|
12539
|
-
# key: "
|
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: "
|
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
|
12555
|
-
# #
|
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: "
|
12579
|
+
# body: "filetoupload",
|
12559
12580
|
# bucket: "examplebucket",
|
12560
|
-
# key: "
|
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
|
-
#
|
12589
|
+
# server_side_encryption: "AES256",
|
12590
|
+
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
12567
12591
|
# }
|
12568
12592
|
#
|
12569
|
-
# @example Example: To upload an object
|
12593
|
+
# @example Example: To upload an object and specify optional tags
|
12570
12594
|
#
|
12571
|
-
# # The following example uploads an object. The request specifies optional
|
12572
|
-
# #
|
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
|
-
#
|
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
|
-
#
|
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
|
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
|
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:
|
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: "\"
|
15149
|
-
# last_modified: Time.parse("2016-12-29T21:
|
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
|
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
|
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:
|
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: "\"
|
15169
|
-
# last_modified: Time.parse("2016-12-29T21:
|
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.
|
15639
|
+
context[:gem_version] = '1.127.0'
|
15618
15640
|
Seahorse::Client::Request.new(handlers, context)
|
15619
15641
|
end
|
15620
15642
|
|