aws-sdk-s3 1.41.0 → 1.42.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 6069a346d4b83bd39a5155ea21e6ca1ebde5c4eb
4
- data.tar.gz: 3a87cde74ca806eff17bf28db60a91f04ccf4692
3
+ metadata.gz: c994950edf95c16fed89a953c3e71c4ad2ca7bc0
4
+ data.tar.gz: '00747688b1ffbb47bf666f6416da5d53e65ed34d'
5
5
  SHA512:
6
- metadata.gz: 5bb3ff4292cf9f84ce9af87fcb0e8c4213cafdcc4036f57e06a5e0d692b4c4e17ed0e80cf8faf75c48ab77ed2b981ae814a745c4443eb0495f8853f96f4d71c2
7
- data.tar.gz: f6df78ee45afc6f43d7f878ac78bd898cc64b889005e15db6d50daf74c1f4fe15273fcb8a0b6dc4362cd86bd258993e5fbaed588a3792c29756710f5db0d524a
6
+ metadata.gz: f482b1848801b63c26d7b62efb438d03e0121f4c4c7600c80d98870ac2ad9af80db5462f77b5636d0e6a388bd113756ae69d2bfbb8aec43c0909fafbebbdae58
7
+ data.tar.gz: e50ae06aa5627077323b040ba2d0eec96de06b21351c2dcc5cbf5e840e299027c5d5a1f9cd77efc9e893f1d583e25366352c9990b959dc31f817a01bb7baf959
@@ -63,6 +63,6 @@ require_relative 'aws-sdk-s3/event_streams'
63
63
  # @service
64
64
  module Aws::S3
65
65
 
66
- GEM_VERSION = '1.41.0'
66
+ GEM_VERSION = '1.42.0'
67
67
 
68
68
  end
@@ -86,10 +86,10 @@ module Aws::S3
86
86
  # @option options [Proc] :before_attempt
87
87
  # @option options [Proc] :before_wait
88
88
  # @return [Bucket]
89
- def wait_until_exists(options = {})
89
+ def wait_until_exists(options = {}, &block)
90
90
  options, params = separate_params_and_options(options)
91
91
  waiter = Waiters::BucketExists.new(options)
92
- yield_waiter_and_warn(waiter, &Proc.new) if block_given?
92
+ yield_waiter_and_warn(waiter, &block) if block_given?
93
93
  waiter.wait(params.merge(bucket: @name))
94
94
  Bucket.new({
95
95
  name: @name,
@@ -103,10 +103,10 @@ module Aws::S3
103
103
  # @option options [Proc] :before_attempt
104
104
  # @option options [Proc] :before_wait
105
105
  # @return [Bucket]
106
- def wait_until_not_exists(options = {})
106
+ def wait_until_not_exists(options = {}, &block)
107
107
  options, params = separate_params_and_options(options)
108
108
  waiter = Waiters::BucketNotExists.new(options)
109
- yield_waiter_and_warn(waiter, &Proc.new) if block_given?
109
+ yield_waiter_and_warn(waiter, &block) if block_given?
110
110
  waiter.wait(params.merge(bucket: @name))
111
111
  Bucket.new({
112
112
  name: @name,
@@ -242,8 +242,8 @@ module Aws::S3
242
242
  # @option options [String] :grant_write_acp
243
243
  # Allows grantee to write the ACL for the applicable bucket.
244
244
  # @option options [Boolean] :object_lock_enabled_for_bucket
245
- # Specifies whether you want S3 Object Lock to be enabled for the new
246
- # bucket.
245
+ # Specifies whether you want Amazon S3 object lock to be enabled for the
246
+ # new bucket.
247
247
  # @return [Types::CreateBucketOutput]
248
248
  def create(options = {})
249
249
  options = options.merge(bucket: @name)
@@ -291,7 +291,7 @@ module Aws::S3
291
291
  # http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
292
292
  # @option options [Boolean] :bypass_governance_retention
293
293
  # Specifies whether you want to delete this object even if it has a
294
- # Governance-type Object Lock in place. You must have sufficient
294
+ # Governance-type object lock in place. You must have sufficient
295
295
  # permissions to perform this operation.
296
296
  # @return [Types::DeleteObjectsOutput]
297
297
  def delete_objects(options = {})
@@ -354,7 +354,8 @@ module Aws::S3
354
354
  # the body cannot be determined automatically.
355
355
  # @option options [String] :content_md5
356
356
  # The base64-encoded 128-bit MD5 digest of the part data. This parameter
357
- # is auto-populated when using the command from the CLI
357
+ # is auto-populated when using the command from the CLI. This parameted
358
+ # is required if object lock parameters are specified.
358
359
  # @option options [String] :content_type
359
360
  # A standard MIME type describing the format of the object data.
360
361
  # @option options [Time,DateTime,Date,Integer,String] :expires
@@ -410,9 +411,9 @@ module Aws::S3
410
411
  # The tag-set for the object. The tag-set must be encoded as URL Query
411
412
  # parameters. (For example, "Key1=Value1")
412
413
  # @option options [String] :object_lock_mode
413
- # The Object Lock mode that you want to apply to this object.
414
+ # The object lock mode that you want to apply to this object.
414
415
  # @option options [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
415
- # The date and time when you want this object's Object Lock to expire.
416
+ # The date and time when you want this object's object lock to expire.
416
417
  # @option options [String] :object_lock_legal_hold_status
417
418
  # The Legal Hold status that you want to apply to the specified object.
418
419
  # @return [Object]
@@ -207,6 +207,8 @@ module Aws::S3
207
207
  # @option options [String] :acl
208
208
  # The canned ACL to apply to the bucket.
209
209
  # @option options [Types::AccessControlPolicy] :access_control_policy
210
+ # Contains the elements that set the ACL permissions for an object per
211
+ # grantee.
210
212
  # @option options [String] :content_md5
211
213
  # @option options [String] :grant_full_control
212
214
  # Allows grantee the read, write, read ACP, and write ACP permissions on
@@ -30,9 +30,7 @@ module Aws::S3
30
30
  @bucket_name
31
31
  end
32
32
 
33
- # Container for logging information. Presence of this element indicates
34
- # that logging is enabled. Parameters TargetBucket and TargetPrefix are
35
- # required in this case.
33
+
36
34
  # @return [Types::LoggingEnabled]
37
35
  def logging_enabled
38
36
  data[:logging_enabled]
@@ -30,19 +30,22 @@ module Aws::S3
30
30
  @bucket_name
31
31
  end
32
32
 
33
-
33
+ # The topic to which notifications are sent and the events for which
34
+ # notifications are generated.
34
35
  # @return [Array<Types::TopicConfiguration>]
35
36
  def topic_configurations
36
37
  data[:topic_configurations]
37
38
  end
38
39
 
39
-
40
+ # The Amazon Simple Queue Service queues to publish messages to and the
41
+ # events for which to publish messages.
40
42
  # @return [Array<Types::QueueConfiguration>]
41
43
  def queue_configurations
42
44
  data[:queue_configurations]
43
45
  end
44
46
 
45
-
47
+ # Describes the AWS Lambda functions to invoke and the events for which
48
+ # to invoke them.
46
49
  # @return [Array<Types::LambdaFunctionConfiguration>]
47
50
  def lambda_function_configurations
48
51
  data[:lambda_function_configurations]
@@ -239,9 +242,6 @@ module Aws::S3
239
242
  # })
240
243
  # @param [Hash] options ({})
241
244
  # @option options [required, Types::NotificationConfiguration] :notification_configuration
242
- # A container for specifying the notification configuration of the
243
- # bucket. If this element is empty, notifications are turned off for the
244
- # bucket.
245
245
  # @return [EmptyStructure]
246
246
  def put(options = {})
247
247
  options = options.merge(bucket: @bucket_name)
@@ -322,10 +322,13 @@ module Aws::S3
322
322
  # ensure the parts list is empty.
323
323
  #
324
324
  # @option params [required, String] :bucket
325
+ # Name of the bucket to which the multipart upload was initiated.
325
326
  #
326
327
  # @option params [required, String] :key
328
+ # Key of the object for which the multipart upload was initiated.
327
329
  #
328
330
  # @option params [required, String] :upload_id
331
+ # Upload ID that identifies the multipart upload.
329
332
  #
330
333
  # @option params [String] :request_payer
331
334
  # Confirms that the requester knows that she or he will be charged for
@@ -606,10 +609,10 @@ module Aws::S3
606
609
  # as URL Query parameters
607
610
  #
608
611
  # @option params [String] :object_lock_mode
609
- # The Object Lock mode that you want to apply to the copied object.
612
+ # The object lock mode that you want to apply to the copied object.
610
613
  #
611
614
  # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
612
- # The date and time when you want the copied object's Object Lock to
615
+ # The date and time when you want the copied object's object lock to
613
616
  # expire.
614
617
  #
615
618
  # @option params [String] :object_lock_legal_hold_status
@@ -738,8 +741,8 @@ module Aws::S3
738
741
  # Allows grantee to write the ACL for the applicable bucket.
739
742
  #
740
743
  # @option params [Boolean] :object_lock_enabled_for_bucket
741
- # Specifies whether you want S3 Object Lock to be enabled for the new
742
- # bucket.
744
+ # Specifies whether you want Amazon S3 object lock to be enabled for the
745
+ # new bucket.
743
746
  #
744
747
  # @return [Types::CreateBucketOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
745
748
  #
@@ -902,11 +905,11 @@ module Aws::S3
902
905
  # parameters
903
906
  #
904
907
  # @option params [String] :object_lock_mode
905
- # Specifies the Object Lock mode that you want to apply to the uploaded
908
+ # Specifies the object lock mode that you want to apply to the uploaded
906
909
  # object.
907
910
  #
908
911
  # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
909
- # Specifies the date and time when you want the Object Lock to expire.
912
+ # Specifies the date and time when you want the object lock to expire.
910
913
  #
911
914
  # @option params [String] :object_lock_legal_hold_status
912
915
  # Specifies whether you want to apply a Legal Hold to the uploaded
@@ -1032,12 +1035,17 @@ module Aws::S3
1032
1035
  # Deletes an analytics configuration for the bucket (specified by the
1033
1036
  # analytics configuration ID).
1034
1037
  #
1038
+ # To use this operation, you must have permissions to perform the
1039
+ # s3:PutAnalyticsConfiguration action. The bucket owner has this
1040
+ # permission by default. The bucket owner can grant this permission to
1041
+ # others.
1042
+ #
1035
1043
  # @option params [required, String] :bucket
1036
1044
  # The name of the bucket from which an analytics configuration is
1037
1045
  # deleted.
1038
1046
  #
1039
1047
  # @option params [required, String] :id
1040
- # The identifier used to represent an analytics configuration.
1048
+ # The ID that identifies the analytics configuration.
1041
1049
  #
1042
1050
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
1043
1051
  #
@@ -1347,7 +1355,7 @@ module Aws::S3
1347
1355
  # http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
1348
1356
  #
1349
1357
  # @option params [Boolean] :bypass_governance_retention
1350
- # Indicates whether S3 Object Lock should bypass Governance-mode
1358
+ # Indicates whether Amazon S3 object lock should bypass governance-mode
1351
1359
  # restrictions to process this operation.
1352
1360
  #
1353
1361
  # @return [Types::DeleteObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1491,7 +1499,7 @@ module Aws::S3
1491
1499
  #
1492
1500
  # @option params [Boolean] :bypass_governance_retention
1493
1501
  # Specifies whether you want to delete this object even if it has a
1494
- # Governance-type Object Lock in place. You must have sufficient
1502
+ # Governance-type object lock in place. You must have sufficient
1495
1503
  # permissions to perform this operation.
1496
1504
  #
1497
1505
  # @return [Types::DeleteObjectsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1711,7 +1719,7 @@ module Aws::S3
1711
1719
  # retrieved.
1712
1720
  #
1713
1721
  # @option params [required, String] :id
1714
- # The identifier used to represent an analytics configuration.
1722
+ # The ID that identifies the analytics configuration.
1715
1723
  #
1716
1724
  # @return [Types::GetBucketAnalyticsConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
1717
1725
  #
@@ -3056,12 +3064,12 @@ module Aws::S3
3056
3064
  req.send_request(options)
3057
3065
  end
3058
3066
 
3059
- # Gets the Object Lock configuration for a bucket. The rule specified in
3060
- # the Object Lock configuration will be applied by default to every new
3067
+ # Gets the object lock configuration for a bucket. The rule specified in
3068
+ # the object lock configuration will be applied by default to every new
3061
3069
  # object placed in the specified bucket.
3062
3070
  #
3063
3071
  # @option params [required, String] :bucket
3064
- # The bucket whose Object Lock configuration you want to retrieve.
3072
+ # The bucket whose object lock configuration you want to retrieve.
3065
3073
  #
3066
3074
  # @return [Types::GetObjectLockConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
3067
3075
  #
@@ -4484,6 +4492,8 @@ module Aws::S3
4484
4492
  # The canned ACL to apply to the bucket.
4485
4493
  #
4486
4494
  # @option params [Types::AccessControlPolicy] :access_control_policy
4495
+ # Contains the elements that set the ACL permissions for an object per
4496
+ # grantee.
4487
4497
  #
4488
4498
  # @option params [required, String] :bucket
4489
4499
  #
@@ -4568,7 +4578,7 @@ module Aws::S3
4568
4578
  # The name of the bucket to which an analytics configuration is stored.
4569
4579
  #
4570
4580
  # @option params [required, String] :id
4571
- # The identifier used to represent an analytics configuration.
4581
+ # The ID that identifies the analytics configuration.
4572
4582
  #
4573
4583
  # @option params [required, Types::AnalyticsConfiguration] :analytics_configuration
4574
4584
  # The configuration and any analyses for the analytics filter.
@@ -4708,17 +4718,22 @@ module Aws::S3
4708
4718
  # existing one, if present).
4709
4719
  #
4710
4720
  # @option params [required, String] :bucket
4711
- # The name of the bucket for which the server-side encryption
4712
- # configuration is set.
4721
+ # Specifies default encryption for a bucket using server-side encryption
4722
+ # with Amazon S3-managed keys (SSE-S3) or AWS KMS-managed keys
4723
+ # (SSE-KMS). For information about the Amazon S3 default encryption
4724
+ # feature, see [Amazon S3 Default Bucket Encryption][1] in the *Amazon
4725
+ # Simple Storage Service Developer Guide*.
4726
+ #
4727
+ #
4728
+ #
4729
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
4713
4730
  #
4714
4731
  # @option params [String] :content_md5
4715
4732
  # The base64-encoded 128-bit MD5 digest of the server-side encryption
4716
4733
  # configuration. This parameter is auto-populated when using the command
4717
- # from the CLI
4734
+ # from the CLI.
4718
4735
  #
4719
4736
  # @option params [required, Types::ServerSideEncryptionConfiguration] :server_side_encryption_configuration
4720
- # Container for server-side encryption configuration rules. Currently S3
4721
- # supports one rule only.
4722
4737
  #
4723
4738
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
4724
4739
  #
@@ -5135,9 +5150,6 @@ module Aws::S3
5135
5150
  # @option params [required, String] :bucket
5136
5151
  #
5137
5152
  # @option params [required, Types::NotificationConfiguration] :notification_configuration
5138
- # A container for specifying the notification configuration of the
5139
- # bucket. If this element is empty, notifications are turned off for the
5140
- # bucket.
5141
5153
  #
5142
5154
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5143
5155
  #
@@ -5228,8 +5240,7 @@ module Aws::S3
5228
5240
  req.send_request(options)
5229
5241
  end
5230
5242
 
5231
- # Replaces a policy on a bucket. If the bucket already has a policy, the
5232
- # one in this request completely replaces it.
5243
+ # Applies an Amazon S3 bucket policy to an Amazon S3 bucket.
5233
5244
  #
5234
5245
  # @option params [required, String] :bucket
5235
5246
  #
@@ -5273,19 +5284,25 @@ module Aws::S3
5273
5284
  end
5274
5285
 
5275
5286
  # Creates a replication configuration or replaces an existing one. For
5276
- # more information, see [Cross-Region Replication (CRR)](
5277
- # https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) in the
5287
+ # more information, see [Cross-Region Replication (CRR)][1] in the
5278
5288
  # *Amazon S3 Developer Guide*.
5279
5289
  #
5290
+ #
5291
+ #
5292
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html
5293
+ #
5280
5294
  # @option params [required, String] :bucket
5281
5295
  #
5282
5296
  # @option params [String] :content_md5
5297
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
5298
+ # header as a message integrity check to verify that the request body
5299
+ # was not corrupted in transit.
5283
5300
  #
5284
5301
  # @option params [required, Types::ReplicationConfiguration] :replication_configuration
5285
- # A container for replication rules. You can add up to 1,000 rules. The
5286
- # maximum size of a replication configuration is 2 MB.
5287
5302
  #
5288
5303
  # @option params [String] :token
5304
+ # A token that allows Amazon S3 object lock to be enabled for an
5305
+ # existing bucket.
5289
5306
  #
5290
5307
  # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
5291
5308
  #
@@ -5626,7 +5643,8 @@ module Aws::S3
5626
5643
  #
5627
5644
  # @option params [String] :content_md5
5628
5645
  # The base64-encoded 128-bit MD5 digest of the part data. This parameter
5629
- # is auto-populated when using the command from the CLI
5646
+ # is auto-populated when using the command from the CLI. This parameted
5647
+ # is required if object lock parameters are specified.
5630
5648
  #
5631
5649
  # @option params [String] :content_type
5632
5650
  # A standard MIME type describing the format of the object data.
@@ -5700,10 +5718,10 @@ module Aws::S3
5700
5718
  # parameters. (For example, "Key1=Value1")
5701
5719
  #
5702
5720
  # @option params [String] :object_lock_mode
5703
- # The Object Lock mode that you want to apply to this object.
5721
+ # The object lock mode that you want to apply to this object.
5704
5722
  #
5705
5723
  # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
5706
- # The date and time when you want this object's Object Lock to expire.
5724
+ # The date and time when you want this object's object lock to expire.
5707
5725
  #
5708
5726
  # @option params [String] :object_lock_legal_hold_status
5709
5727
  # The Legal Hold status that you want to apply to the specified object.
@@ -5919,6 +5937,8 @@ module Aws::S3
5919
5937
  # The canned ACL to apply to the object.
5920
5938
  #
5921
5939
  # @option params [Types::AccessControlPolicy] :access_control_policy
5940
+ # Contains the elements that set the ACL permissions for an object per
5941
+ # grantee.
5922
5942
  #
5923
5943
  # @option params [required, String] :bucket
5924
5944
  #
@@ -6079,16 +6099,16 @@ module Aws::S3
6079
6099
  req.send_request(options)
6080
6100
  end
6081
6101
 
6082
- # Places an Object Lock configuration on the specified bucket. The rule
6083
- # specified in the Object Lock configuration will be applied by default
6102
+ # Places an object lock configuration on the specified bucket. The rule
6103
+ # specified in the object lock configuration will be applied by default
6084
6104
  # to every new object placed in the specified bucket.
6085
6105
  #
6086
6106
  # @option params [required, String] :bucket
6087
- # The bucket whose Object Lock configuration you want to create or
6107
+ # The bucket whose object lock configuration you want to create or
6088
6108
  # replace.
6089
6109
  #
6090
6110
  # @option params [Types::ObjectLockConfiguration] :object_lock_configuration
6091
- # The Object Lock configuration that you want to apply to the specified
6111
+ # The object lock configuration that you want to apply to the specified
6092
6112
  # bucket.
6093
6113
  #
6094
6114
  # @option params [String] :request_payer
@@ -6099,7 +6119,8 @@ module Aws::S3
6099
6119
  # http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
6100
6120
  #
6101
6121
  # @option params [String] :token
6102
- # A token to allow Object Lock to be enabled for an existing bucket.
6122
+ # A token to allow Amazon S3 object lock to be enabled for an existing
6123
+ # bucket.
6103
6124
  #
6104
6125
  # @option params [String] :content_md5
6105
6126
  # The MD5 hash for the request body.
@@ -6330,7 +6351,6 @@ module Aws::S3
6330
6351
  # @option params [String] :version_id
6331
6352
  #
6332
6353
  # @option params [Types::RestoreRequest] :restore_request
6333
- # Container for restore job parameters.
6334
6354
  #
6335
6355
  # @option params [String] :request_payer
6336
6356
  # Confirms that the requester knows that she or he will be charged for
@@ -6761,7 +6781,9 @@ module Aws::S3
6761
6781
  # the body cannot be determined automatically.
6762
6782
  #
6763
6783
  # @option params [String] :content_md5
6764
- # The base64-encoded 128-bit MD5 digest of the part data.
6784
+ # The base64-encoded 128-bit MD5 digest of the part data. This parameter
6785
+ # is auto-populated when using the command from the CLI. This parameted
6786
+ # is required if object lock parameters are specified.
6765
6787
  #
6766
6788
  # @option params [required, String] :key
6767
6789
  # Object key for which the multipart upload was initiated.
@@ -7046,7 +7068,7 @@ module Aws::S3
7046
7068
  params: params,
7047
7069
  config: config)
7048
7070
  context[:gem_name] = 'aws-sdk-s3'
7049
- context[:gem_version] = '1.41.0'
7071
+ context[:gem_version] = '1.42.0'
7050
7072
  Seahorse::Client::Request.new(handlers, context)
7051
7073
  end
7052
7074
 
@@ -14,31 +14,31 @@ module Aws::S3
14
14
  end
15
15
 
16
16
  def on_records_event(&block)
17
- @event_emitter.on(:records, Proc.new)
17
+ @event_emitter.on(:records, block) if block_given?
18
18
  end
19
19
 
20
20
  def on_stats_event(&block)
21
- @event_emitter.on(:stats, Proc.new)
21
+ @event_emitter.on(:stats, block) if block_given?
22
22
  end
23
23
 
24
24
  def on_progress_event(&block)
25
- @event_emitter.on(:progress, Proc.new)
25
+ @event_emitter.on(:progress, block) if block_given?
26
26
  end
27
27
 
28
28
  def on_cont_event(&block)
29
- @event_emitter.on(:cont, Proc.new)
29
+ @event_emitter.on(:cont, block) if block_given?
30
30
  end
31
31
 
32
32
  def on_end_event(&block)
33
- @event_emitter.on(:end, Proc.new)
33
+ @event_emitter.on(:end, block) if block_given?
34
34
  end
35
35
 
36
36
  def on_error_event(&block)
37
- @event_emitter.on(:error, Proc.new)
37
+ @event_emitter.on(:error, block) if block_given?
38
38
  end
39
39
 
40
40
  def on_initial_response_event(&block)
41
- @event_emitter.on(:initial_response, Proc.new)
41
+ @event_emitter.on(:initial_response, block) if block_given?
42
42
  end
43
43
 
44
44
  def on_event(&block)