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.
- 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
|
|