aws-sdk-s3 1.0.0.rc2 → 1.0.0.rc3
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/lib/aws-sdk-s3.rb +1 -1
- data/lib/aws-sdk-s3/bucket.rb +540 -542
- data/lib/aws-sdk-s3/bucket_acl.rb +144 -146
- data/lib/aws-sdk-s3/bucket_cors.rb +122 -124
- data/lib/aws-sdk-s3/bucket_lifecycle.rb +140 -142
- data/lib/aws-sdk-s3/bucket_logging.rb +119 -121
- data/lib/aws-sdk-s3/bucket_notification.rb +162 -164
- data/lib/aws-sdk-s3/bucket_policy.rb +114 -116
- data/lib/aws-sdk-s3/bucket_request_payment.rb +105 -107
- data/lib/aws-sdk-s3/bucket_tagging.rb +119 -121
- data/lib/aws-sdk-s3/bucket_versioning.rb +162 -164
- data/lib/aws-sdk-s3/bucket_website.rb +150 -152
- data/lib/aws-sdk-s3/client.rb +4380 -3611
- data/lib/aws-sdk-s3/client_api.rb +2343 -2345
- data/lib/aws-sdk-s3/customizations/object.rb +3 -2
- data/lib/aws-sdk-s3/errors.rb +4 -13
- data/lib/aws-sdk-s3/multipart_upload.rb +240 -242
- data/lib/aws-sdk-s3/multipart_upload_part.rb +273 -275
- data/lib/aws-sdk-s3/object.rb +879 -881
- data/lib/aws-sdk-s3/object_acl.rb +186 -188
- data/lib/aws-sdk-s3/object_summary.rb +751 -753
- data/lib/aws-sdk-s3/object_version.rb +356 -358
- data/lib/aws-sdk-s3/plugins/bucket_dns.rb +1 -1
- data/lib/aws-sdk-s3/plugins/s3_signer.rb +1 -1
- data/lib/aws-sdk-s3/presigner.rb +6 -2
- data/lib/aws-sdk-s3/resource.rb +79 -78
- data/lib/aws-sdk-s3/types.rb +7678 -6939
- data/lib/aws-sdk-s3/waiters.rb +150 -151
- metadata +4 -4
@@ -1,168 +1,166 @@
|
|
1
1
|
# WARNING ABOUT GENERATED CODE
|
2
2
|
#
|
3
|
-
# This file is generated. See the contributing for
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
4
|
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
5
|
#
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
7
7
|
|
8
|
-
module Aws
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
end
|
8
|
+
module Aws::S3
|
9
|
+
class BucketAcl
|
10
|
+
|
11
|
+
extend Aws::Deprecations
|
12
|
+
|
13
|
+
# @overload def initialize(bucket_name, options = {})
|
14
|
+
# @param [String] bucket_name
|
15
|
+
# @option options [Client] :client
|
16
|
+
# @overload def initialize(options = {})
|
17
|
+
# @option options [required, String] :bucket_name
|
18
|
+
# @option options [Client] :client
|
19
|
+
def initialize(*args)
|
20
|
+
options = Hash === args.last ? args.pop.dup : {}
|
21
|
+
@bucket_name = extract_bucket_name(args, options)
|
22
|
+
@data = options.delete(:data)
|
23
|
+
@client = options.delete(:client) || Client.new(options)
|
24
|
+
end
|
26
25
|
|
27
|
-
|
26
|
+
# @!group Read-Only Attributes
|
28
27
|
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
28
|
+
# @return [String]
|
29
|
+
def bucket_name
|
30
|
+
@bucket_name
|
31
|
+
end
|
33
32
|
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
33
|
+
# @return [Types::Owner]
|
34
|
+
def owner
|
35
|
+
data.owner
|
36
|
+
end
|
38
37
|
|
39
|
-
|
40
|
-
|
41
|
-
|
42
|
-
|
43
|
-
|
38
|
+
# A list of grants.
|
39
|
+
# @return [Array<Types::Grant>]
|
40
|
+
def grants
|
41
|
+
data.grants
|
42
|
+
end
|
44
43
|
|
45
|
-
|
44
|
+
# @!endgroup
|
46
45
|
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
46
|
+
# @return [Client]
|
47
|
+
def client
|
48
|
+
@client
|
49
|
+
end
|
51
50
|
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
66
|
-
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
51
|
+
# Loads, or reloads {#data} for the current {BucketAcl}.
|
52
|
+
# Returns `self` making it possible to chain methods.
|
53
|
+
#
|
54
|
+
# bucket_acl.reload.data
|
55
|
+
#
|
56
|
+
# @return [self]
|
57
|
+
def load
|
58
|
+
resp = @client.get_bucket_acl(bucket: @bucket_name)
|
59
|
+
@data = resp.data
|
60
|
+
self
|
61
|
+
end
|
62
|
+
alias :reload :load
|
63
|
+
|
64
|
+
# @return [Types::GetBucketAclOutput]
|
65
|
+
# Returns the data for this {BucketAcl}. Calls
|
66
|
+
# {Client#get_bucket_acl} if {#data_loaded?} is `false`.
|
67
|
+
def data
|
68
|
+
load unless @data
|
69
|
+
@data
|
70
|
+
end
|
72
71
|
|
73
|
-
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
72
|
+
# @return [Boolean]
|
73
|
+
# Returns `true` if this resource is loaded. Accessing attributes or
|
74
|
+
# {#data} on an unloaded resource will trigger a call to {#load}.
|
75
|
+
def data_loaded?
|
76
|
+
!!@data
|
77
|
+
end
|
79
78
|
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
86
|
-
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
112
|
-
|
113
|
-
|
114
|
-
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
122
|
-
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
79
|
+
# @!group Actions
|
80
|
+
|
81
|
+
# @example Request syntax with placeholder values
|
82
|
+
#
|
83
|
+
# bucket_acl.put({
|
84
|
+
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
85
|
+
# access_control_policy: {
|
86
|
+
# grants: [
|
87
|
+
# {
|
88
|
+
# grantee: {
|
89
|
+
# display_name: "DisplayName",
|
90
|
+
# email_address: "EmailAddress",
|
91
|
+
# id: "ID",
|
92
|
+
# type: "CanonicalUser", # required, accepts CanonicalUser, AmazonCustomerByEmail, Group
|
93
|
+
# uri: "URI",
|
94
|
+
# },
|
95
|
+
# permission: "FULL_CONTROL", # accepts FULL_CONTROL, WRITE, WRITE_ACP, READ, READ_ACP
|
96
|
+
# },
|
97
|
+
# ],
|
98
|
+
# owner: {
|
99
|
+
# display_name: "DisplayName",
|
100
|
+
# id: "ID",
|
101
|
+
# },
|
102
|
+
# },
|
103
|
+
# content_md5: "ContentMD5",
|
104
|
+
# grant_full_control: "GrantFullControl",
|
105
|
+
# grant_read: "GrantRead",
|
106
|
+
# grant_read_acp: "GrantReadACP",
|
107
|
+
# grant_write: "GrantWrite",
|
108
|
+
# grant_write_acp: "GrantWriteACP",
|
109
|
+
# })
|
110
|
+
# @param [Hash] options ({})
|
111
|
+
# @option options [String] :acl
|
112
|
+
# The canned ACL to apply to the bucket.
|
113
|
+
# @option options [Types::AccessControlPolicy] :access_control_policy
|
114
|
+
# @option options [String] :content_md5
|
115
|
+
# @option options [String] :grant_full_control
|
116
|
+
# Allows grantee the read, write, read ACP, and write ACP permissions on
|
117
|
+
# the bucket.
|
118
|
+
# @option options [String] :grant_read
|
119
|
+
# Allows grantee to list the objects in the bucket.
|
120
|
+
# @option options [String] :grant_read_acp
|
121
|
+
# Allows grantee to read the bucket ACL.
|
122
|
+
# @option options [String] :grant_write
|
123
|
+
# Allows grantee to create, overwrite, and delete any object in the
|
124
|
+
# bucket.
|
125
|
+
# @option options [String] :grant_write_acp
|
126
|
+
# Allows grantee to write the ACL for the applicable bucket.
|
127
|
+
# @return [EmptyStructure]
|
128
|
+
def put(options = {})
|
129
|
+
options = options.merge(bucket: @bucket_name)
|
130
|
+
resp = @client.put_bucket_acl(options)
|
131
|
+
resp.data
|
132
|
+
end
|
134
133
|
|
135
|
-
|
134
|
+
# @!group Associations
|
136
135
|
|
137
|
-
|
138
|
-
|
139
|
-
|
140
|
-
|
141
|
-
|
142
|
-
|
143
|
-
|
136
|
+
# @return [Bucket]
|
137
|
+
def bucket
|
138
|
+
Bucket.new(
|
139
|
+
name: @bucket_name,
|
140
|
+
client: @client
|
141
|
+
)
|
142
|
+
end
|
144
143
|
|
145
|
-
|
146
|
-
|
147
|
-
|
148
|
-
|
149
|
-
|
150
|
-
|
151
|
-
|
152
|
-
|
153
|
-
|
154
|
-
|
155
|
-
|
156
|
-
|
157
|
-
|
158
|
-
|
159
|
-
|
160
|
-
|
161
|
-
|
162
|
-
end
|
144
|
+
# @deprecated
|
145
|
+
# @api private
|
146
|
+
def identifiers
|
147
|
+
{ bucket_name: @bucket_name }
|
148
|
+
end
|
149
|
+
deprecated(:identifiers)
|
150
|
+
|
151
|
+
private
|
152
|
+
|
153
|
+
def extract_bucket_name(args, options)
|
154
|
+
value = args[0] || options.delete(:bucket_name)
|
155
|
+
case value
|
156
|
+
when String then value
|
157
|
+
when nil then raise ArgumentError, "missing required option :bucket_name"
|
158
|
+
else
|
159
|
+
msg = "expected :bucket_name to be a String, got #{value.class}"
|
160
|
+
raise ArgumentError, msg
|
163
161
|
end
|
164
|
-
|
165
|
-
class Collection < Aws::Resources::Collection; end
|
166
162
|
end
|
163
|
+
|
164
|
+
class Collection < Aws::Resources::Collection; end
|
167
165
|
end
|
168
166
|
end
|
@@ -1,146 +1,144 @@
|
|
1
1
|
# WARNING ABOUT GENERATED CODE
|
2
2
|
#
|
3
|
-
# This file is generated. See the contributing for
|
3
|
+
# This file is generated. See the contributing guide for more information:
|
4
4
|
# https://github.com/aws/aws-sdk-ruby/blob/master/CONTRIBUTING.md
|
5
5
|
#
|
6
6
|
# WARNING ABOUT GENERATED CODE
|
7
7
|
|
8
|
-
module Aws
|
9
|
-
|
10
|
-
|
11
|
-
|
12
|
-
|
13
|
-
|
14
|
-
|
15
|
-
|
16
|
-
|
17
|
-
|
18
|
-
|
19
|
-
|
20
|
-
|
21
|
-
|
22
|
-
|
23
|
-
|
24
|
-
|
25
|
-
end
|
8
|
+
module Aws::S3
|
9
|
+
class BucketCors
|
10
|
+
|
11
|
+
extend Aws::Deprecations
|
12
|
+
|
13
|
+
# @overload def initialize(bucket_name, options = {})
|
14
|
+
# @param [String] bucket_name
|
15
|
+
# @option options [Client] :client
|
16
|
+
# @overload def initialize(options = {})
|
17
|
+
# @option options [required, String] :bucket_name
|
18
|
+
# @option options [Client] :client
|
19
|
+
def initialize(*args)
|
20
|
+
options = Hash === args.last ? args.pop.dup : {}
|
21
|
+
@bucket_name = extract_bucket_name(args, options)
|
22
|
+
@data = options.delete(:data)
|
23
|
+
@client = options.delete(:client) || Client.new(options)
|
24
|
+
end
|
26
25
|
|
27
|
-
|
26
|
+
# @!group Read-Only Attributes
|
28
27
|
|
29
|
-
|
30
|
-
|
31
|
-
|
32
|
-
|
28
|
+
# @return [String]
|
29
|
+
def bucket_name
|
30
|
+
@bucket_name
|
31
|
+
end
|
33
32
|
|
34
|
-
|
35
|
-
|
36
|
-
|
37
|
-
|
33
|
+
# @return [Array<Types::CORSRule>]
|
34
|
+
def cors_rules
|
35
|
+
data.cors_rules
|
36
|
+
end
|
38
37
|
|
39
|
-
|
38
|
+
# @!endgroup
|
40
39
|
|
41
|
-
|
42
|
-
|
43
|
-
|
44
|
-
|
40
|
+
# @return [Client]
|
41
|
+
def client
|
42
|
+
@client
|
43
|
+
end
|
45
44
|
|
46
|
-
|
47
|
-
|
48
|
-
|
49
|
-
|
50
|
-
|
51
|
-
|
52
|
-
|
53
|
-
|
54
|
-
|
55
|
-
|
56
|
-
|
57
|
-
|
58
|
-
|
59
|
-
|
60
|
-
|
61
|
-
|
62
|
-
|
63
|
-
|
64
|
-
|
65
|
-
|
45
|
+
# Loads, or reloads {#data} for the current {BucketCors}.
|
46
|
+
# Returns `self` making it possible to chain methods.
|
47
|
+
#
|
48
|
+
# bucket_cors.reload.data
|
49
|
+
#
|
50
|
+
# @return [self]
|
51
|
+
def load
|
52
|
+
resp = @client.get_bucket_cors(bucket: @bucket_name)
|
53
|
+
@data = resp.data
|
54
|
+
self
|
55
|
+
end
|
56
|
+
alias :reload :load
|
57
|
+
|
58
|
+
# @return [Types::GetBucketCorsOutput]
|
59
|
+
# Returns the data for this {BucketCors}. Calls
|
60
|
+
# {Client#get_bucket_cors} if {#data_loaded?} is `false`.
|
61
|
+
def data
|
62
|
+
load unless @data
|
63
|
+
@data
|
64
|
+
end
|
66
65
|
|
67
|
-
|
68
|
-
|
69
|
-
|
70
|
-
|
71
|
-
|
72
|
-
|
66
|
+
# @return [Boolean]
|
67
|
+
# Returns `true` if this resource is loaded. Accessing attributes or
|
68
|
+
# {#data} on an unloaded resource will trigger a call to {#load}.
|
69
|
+
def data_loaded?
|
70
|
+
!!@data
|
71
|
+
end
|
73
72
|
|
74
|
-
|
75
|
-
|
76
|
-
|
77
|
-
|
78
|
-
|
79
|
-
|
80
|
-
|
81
|
-
|
82
|
-
|
83
|
-
|
84
|
-
|
85
|
-
|
73
|
+
# @!group Actions
|
74
|
+
|
75
|
+
# @example Request syntax with placeholder values
|
76
|
+
#
|
77
|
+
# bucket_cors.delete()
|
78
|
+
# @param [Hash] options ({})
|
79
|
+
# @return [EmptyStructure]
|
80
|
+
def delete(options = {})
|
81
|
+
options = options.merge(bucket: @bucket_name)
|
82
|
+
resp = @client.delete_bucket_cors(options)
|
83
|
+
resp.data
|
84
|
+
end
|
86
85
|
|
87
|
-
|
88
|
-
|
89
|
-
|
90
|
-
|
91
|
-
|
92
|
-
|
93
|
-
|
94
|
-
|
95
|
-
|
96
|
-
|
97
|
-
|
98
|
-
|
99
|
-
|
100
|
-
|
101
|
-
|
102
|
-
|
103
|
-
|
104
|
-
|
105
|
-
|
106
|
-
|
107
|
-
|
108
|
-
|
109
|
-
|
110
|
-
|
111
|
-
|
86
|
+
# @example Request syntax with placeholder values
|
87
|
+
#
|
88
|
+
# bucket_cors.put({
|
89
|
+
# cors_configuration: { # required
|
90
|
+
# cors_rules: [ # required
|
91
|
+
# {
|
92
|
+
# allowed_headers: ["AllowedHeader"],
|
93
|
+
# allowed_methods: ["AllowedMethod"], # required
|
94
|
+
# allowed_origins: ["AllowedOrigin"], # required
|
95
|
+
# expose_headers: ["ExposeHeader"],
|
96
|
+
# max_age_seconds: 1,
|
97
|
+
# },
|
98
|
+
# ],
|
99
|
+
# },
|
100
|
+
# content_md5: "ContentMD5",
|
101
|
+
# })
|
102
|
+
# @param [Hash] options ({})
|
103
|
+
# @option options [required, Types::CORSConfiguration] :cors_configuration
|
104
|
+
# @option options [String] :content_md5
|
105
|
+
# @return [EmptyStructure]
|
106
|
+
def put(options = {})
|
107
|
+
options = options.merge(bucket: @bucket_name)
|
108
|
+
resp = @client.put_bucket_cors(options)
|
109
|
+
resp.data
|
110
|
+
end
|
112
111
|
|
113
|
-
|
112
|
+
# @!group Associations
|
114
113
|
|
115
|
-
|
116
|
-
|
117
|
-
|
118
|
-
|
119
|
-
|
120
|
-
|
121
|
-
|
114
|
+
# @return [Bucket]
|
115
|
+
def bucket
|
116
|
+
Bucket.new(
|
117
|
+
name: @bucket_name,
|
118
|
+
client: @client
|
119
|
+
)
|
120
|
+
end
|
122
121
|
|
123
|
-
|
124
|
-
|
125
|
-
|
126
|
-
|
127
|
-
|
128
|
-
|
129
|
-
|
130
|
-
|
131
|
-
|
132
|
-
|
133
|
-
|
134
|
-
|
135
|
-
|
136
|
-
|
137
|
-
|
138
|
-
|
139
|
-
|
140
|
-
end
|
122
|
+
# @deprecated
|
123
|
+
# @api private
|
124
|
+
def identifiers
|
125
|
+
{ bucket_name: @bucket_name }
|
126
|
+
end
|
127
|
+
deprecated(:identifiers)
|
128
|
+
|
129
|
+
private
|
130
|
+
|
131
|
+
def extract_bucket_name(args, options)
|
132
|
+
value = args[0] || options.delete(:bucket_name)
|
133
|
+
case value
|
134
|
+
when String then value
|
135
|
+
when nil then raise ArgumentError, "missing required option :bucket_name"
|
136
|
+
else
|
137
|
+
msg = "expected :bucket_name to be a String, got #{value.class}"
|
138
|
+
raise ArgumentError, msg
|
141
139
|
end
|
142
|
-
|
143
|
-
class Collection < Aws::Resources::Collection; end
|
144
140
|
end
|
141
|
+
|
142
|
+
class Collection < Aws::Resources::Collection; end
|
145
143
|
end
|
146
144
|
end
|