aws-sdk-s3 1.41.0 → 1.42.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA1:
-  metadata.gz: 6069a346d4b83bd39a5155ea21e6ca1ebde5c4eb
-  data.tar.gz: 3a87cde74ca806eff17bf28db60a91f04ccf4692
+  metadata.gz: c994950edf95c16fed89a953c3e71c4ad2ca7bc0
+  data.tar.gz: '00747688b1ffbb47bf666f6416da5d53e65ed34d'
 SHA512:
-  metadata.gz: 5bb3ff4292cf9f84ce9af87fcb0e8c4213cafdcc4036f57e06a5e0d692b4c4e17ed0e80cf8faf75c48ab77ed2b981ae814a745c4443eb0495f8853f96f4d71c2
-  data.tar.gz: f6df78ee45afc6f43d7f878ac78bd898cc64b889005e15db6d50daf74c1f4fe15273fcb8a0b6dc4362cd86bd258993e5fbaed588a3792c29756710f5db0d524a
+  metadata.gz: f482b1848801b63c26d7b62efb438d03e0121f4c4c7600c80d98870ac2ad9af80db5462f77b5636d0e6a388bd113756ae69d2bfbb8aec43c0909fafbebbdae58
+  data.tar.gz: e50ae06aa5627077323b040ba2d0eec96de06b21351c2dcc5cbf5e840e299027c5d5a1f9cd77efc9e893f1d583e25366352c9990b959dc31f817a01bb7baf959

data/lib/aws-sdk-s3.rb

@@ -63,6 +63,6 @@ require_relative 'aws-sdk-s3/event_streams'
 # @service
 module Aws::S3
 
-  GEM_VERSION = '1.41.0'
+  GEM_VERSION = '1.42.0'
 
 end

data/lib/aws-sdk-s3/bucket.rb

@@ -86,10 +86,10 @@ module Aws::S3
     # @option options [Proc] :before_attempt
     # @option options [Proc] :before_wait
     # @return [Bucket]
-    def wait_until_exists(options = {})
+    def wait_until_exists(options = {}, &block)
       options, params = separate_params_and_options(options)
       waiter = Waiters::BucketExists.new(options)
-      yield_waiter_and_warn(waiter, &Proc.new) if block_given?
+      yield_waiter_and_warn(waiter, &block) if block_given?
       waiter.wait(params.merge(bucket: @name))
       Bucket.new({
         name: @name,
@@ -103,10 +103,10 @@ module Aws::S3
     # @option options [Proc] :before_attempt
     # @option options [Proc] :before_wait
     # @return [Bucket]
-    def wait_until_not_exists(options = {})
+    def wait_until_not_exists(options = {}, &block)
       options, params = separate_params_and_options(options)
       waiter = Waiters::BucketNotExists.new(options)
-      yield_waiter_and_warn(waiter, &Proc.new) if block_given?
+      yield_waiter_and_warn(waiter, &block) if block_given?
       waiter.wait(params.merge(bucket: @name))
       Bucket.new({
         name: @name,
@@ -242,8 +242,8 @@ module Aws::S3
     # @option options [String] :grant_write_acp
     #   Allows grantee to write the ACL for the applicable bucket.
     # @option options [Boolean] :object_lock_enabled_for_bucket
-    #   Specifies whether you want S3 Object Lock to be enabled for the new
-    #   bucket.
+    #   Specifies whether you want Amazon S3 object lock to be enabled for the
+    #   new bucket.
     # @return [Types::CreateBucketOutput]
     def create(options = {})
       options = options.merge(bucket: @name)
@@ -291,7 +291,7 @@ module Aws::S3
     #   http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
     # @option options [Boolean] :bypass_governance_retention
     #   Specifies whether you want to delete this object even if it has a
-    #   Governance-type Object Lock in place. You must have sufficient
+    #   Governance-type object lock in place. You must have sufficient
     #   permissions to perform this operation.
     # @return [Types::DeleteObjectsOutput]
     def delete_objects(options = {})
@@ -354,7 +354,8 @@ module Aws::S3
     #   the body cannot be determined automatically.
     # @option options [String] :content_md5
     #   The base64-encoded 128-bit MD5 digest of the part data. This parameter
-    #   is auto-populated when using the command from the CLI
+    #   is auto-populated when using the command from the CLI. This parameted
+    #   is required if object lock parameters are specified.
     # @option options [String] :content_type
     #   A standard MIME type describing the format of the object data.
     # @option options [Time,DateTime,Date,Integer,String] :expires
@@ -410,9 +411,9 @@ module Aws::S3
     #   The tag-set for the object. The tag-set must be encoded as URL Query
     #   parameters. (For example, "Key1=Value1")
     # @option options [String] :object_lock_mode
-    #   The Object Lock mode that you want to apply to this object.
+    #   The object lock mode that you want to apply to this object.
     # @option options [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
-    #   The date and time when you want this object's Object Lock to expire.
+    #   The date and time when you want this object's object lock to expire.
     # @option options [String] :object_lock_legal_hold_status
     #   The Legal Hold status that you want to apply to the specified object.
     # @return [Object]

data/lib/aws-sdk-s3/bucket_acl.rb

@@ -207,6 +207,8 @@ module Aws::S3
     # @option options [String] :acl
     #   The canned ACL to apply to the bucket.
     # @option options [Types::AccessControlPolicy] :access_control_policy
+    #   Contains the elements that set the ACL permissions for an object per
+    #   grantee.
     # @option options [String] :content_md5
     # @option options [String] :grant_full_control
     #   Allows grantee the read, write, read ACP, and write ACP permissions on

data/lib/aws-sdk-s3/bucket_logging.rb

@@ -30,9 +30,7 @@ module Aws::S3
       @bucket_name
     end
 
-    # Container for logging information. Presence of this element indicates
-    # that logging is enabled. Parameters TargetBucket and TargetPrefix are
-    # required in this case.
+    
     # @return [Types::LoggingEnabled]
     def logging_enabled
       data[:logging_enabled]

data/lib/aws-sdk-s3/bucket_notification.rb

@@ -30,19 +30,22 @@ module Aws::S3
       @bucket_name
     end
 
-    
+    # The topic to which notifications are sent and the events for which
+    # notifications are generated.
     # @return [Array<Types::TopicConfiguration>]
     def topic_configurations
       data[:topic_configurations]
     end
 
-    
+    # The Amazon Simple Queue Service queues to publish messages to and the
+    # events for which to publish messages.
     # @return [Array<Types::QueueConfiguration>]
     def queue_configurations
       data[:queue_configurations]
     end
 
-    
+    # Describes the AWS Lambda functions to invoke and the events for which
+    # to invoke them.
     # @return [Array<Types::LambdaFunctionConfiguration>]
     def lambda_function_configurations
       data[:lambda_function_configurations]
@@ -239,9 +242,6 @@ module Aws::S3
     #   })
     # @param [Hash] options ({})
     # @option options [required, Types::NotificationConfiguration] :notification_configuration
-    #   A container for specifying the notification configuration of the
-    #   bucket. If this element is empty, notifications are turned off for the
-    #   bucket.
     # @return [EmptyStructure]
     def put(options = {})
       options = options.merge(bucket: @bucket_name)

data/lib/aws-sdk-s3/client.rb

@@ -322,10 +322,13 @@ module Aws::S3
     # ensure the parts list is empty.
     #
     # @option params [required, String] :bucket
+    #   Name of the bucket to which the multipart upload was initiated.
     #
     # @option params [required, String] :key
+    #   Key of the object for which the multipart upload was initiated.
     #
     # @option params [required, String] :upload_id
+    #   Upload ID that identifies the multipart upload.
     #
     # @option params [String] :request_payer
     #   Confirms that the requester knows that she or he will be charged for
@@ -606,10 +609,10 @@ module Aws::S3
     #   as URL Query parameters
     #
     # @option params [String] :object_lock_mode
-    #   The Object Lock mode that you want to apply to the copied object.
+    #   The object lock mode that you want to apply to the copied object.
     #
     # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
-    #   The date and time when you want the copied object's Object Lock to
+    #   The date and time when you want the copied object's object lock to
     #   expire.
     #
     # @option params [String] :object_lock_legal_hold_status
@@ -738,8 +741,8 @@ module Aws::S3
     #   Allows grantee to write the ACL for the applicable bucket.
     #
     # @option params [Boolean] :object_lock_enabled_for_bucket
-    #   Specifies whether you want S3 Object Lock to be enabled for the new
-    #   bucket.
+    #   Specifies whether you want Amazon S3 object lock to be enabled for the
+    #   new bucket.
     #
     # @return [Types::CreateBucketOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -902,11 +905,11 @@ module Aws::S3
     #   parameters
     #
     # @option params [String] :object_lock_mode
-    #   Specifies the Object Lock mode that you want to apply to the uploaded
+    #   Specifies the object lock mode that you want to apply to the uploaded
     #   object.
     #
     # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
-    #   Specifies the date and time when you want the Object Lock to expire.
+    #   Specifies the date and time when you want the object lock to expire.
     #
     # @option params [String] :object_lock_legal_hold_status
     #   Specifies whether you want to apply a Legal Hold to the uploaded
@@ -1032,12 +1035,17 @@ module Aws::S3
     # Deletes an analytics configuration for the bucket (specified by the
     # analytics configuration ID).
     #
+    # To use this operation, you must have permissions to perform the
+    # s3:PutAnalyticsConfiguration action. The bucket owner has this
+    # permission by default. The bucket owner can grant this permission to
+    # others.
+    #
     # @option params [required, String] :bucket
     #   The name of the bucket from which an analytics configuration is
     #   deleted.
     #
     # @option params [required, String] :id
-    #   The identifier used to represent an analytics configuration.
+    #   The ID that identifies the analytics configuration.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -1347,7 +1355,7 @@ module Aws::S3
     #   http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
     #
     # @option params [Boolean] :bypass_governance_retention
-    #   Indicates whether S3 Object Lock should bypass Governance-mode
+    #   Indicates whether Amazon S3 object lock should bypass governance-mode
     #   restrictions to process this operation.
     #
     # @return [Types::DeleteObjectOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1491,7 +1499,7 @@ module Aws::S3
     #
     # @option params [Boolean] :bypass_governance_retention
     #   Specifies whether you want to delete this object even if it has a
-    #   Governance-type Object Lock in place. You must have sufficient
+    #   Governance-type object lock in place. You must have sufficient
     #   permissions to perform this operation.
     #
     # @return [Types::DeleteObjectsOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
@@ -1711,7 +1719,7 @@ module Aws::S3
     #   retrieved.
     #
     # @option params [required, String] :id
-    #   The identifier used to represent an analytics configuration.
+    #   The ID that identifies the analytics configuration.
     #
     # @return [Types::GetBucketAnalyticsConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -3056,12 +3064,12 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # Gets the Object Lock configuration for a bucket. The rule specified in
-    # the Object Lock configuration will be applied by default to every new
+    # Gets the object lock configuration for a bucket. The rule specified in
+    # the object lock configuration will be applied by default to every new
     # object placed in the specified bucket.
     #
     # @option params [required, String] :bucket
-    #   The bucket whose Object Lock configuration you want to retrieve.
+    #   The bucket whose object lock configuration you want to retrieve.
     #
     # @return [Types::GetObjectLockConfigurationOutput] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -4484,6 +4492,8 @@ module Aws::S3
     #   The canned ACL to apply to the bucket.
     #
     # @option params [Types::AccessControlPolicy] :access_control_policy
+    #   Contains the elements that set the ACL permissions for an object per
+    #   grantee.
     #
     # @option params [required, String] :bucket
     #
@@ -4568,7 +4578,7 @@ module Aws::S3
     #   The name of the bucket to which an analytics configuration is stored.
     #
     # @option params [required, String] :id
-    #   The identifier used to represent an analytics configuration.
+    #   The ID that identifies the analytics configuration.
     #
     # @option params [required, Types::AnalyticsConfiguration] :analytics_configuration
     #   The configuration and any analyses for the analytics filter.
@@ -4708,17 +4718,22 @@ module Aws::S3
     # existing one, if present).
     #
     # @option params [required, String] :bucket
-    #   The name of the bucket for which the server-side encryption
-    #   configuration is set.
+    #   Specifies default encryption for a bucket using server-side encryption
+    #   with Amazon S3-managed keys (SSE-S3) or AWS KMS-managed keys
+    #   (SSE-KMS). For information about the Amazon S3 default encryption
+    #   feature, see [Amazon S3 Default Bucket Encryption][1] in the *Amazon
+    #   Simple Storage Service Developer Guide*.
+    #
+    #
+    #
+    #   [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html
     #
     # @option params [String] :content_md5
     #   The base64-encoded 128-bit MD5 digest of the server-side encryption
     #   configuration. This parameter is auto-populated when using the command
-    #   from the CLI
+    #   from the CLI.
     #
     # @option params [required, Types::ServerSideEncryptionConfiguration] :server_side_encryption_configuration
-    #   Container for server-side encryption configuration rules. Currently S3
-    #   supports one rule only.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5135,9 +5150,6 @@ module Aws::S3
     # @option params [required, String] :bucket
     #
     # @option params [required, Types::NotificationConfiguration] :notification_configuration
-    #   A container for specifying the notification configuration of the
-    #   bucket. If this element is empty, notifications are turned off for the
-    #   bucket.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5228,8 +5240,7 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # Replaces a policy on a bucket. If the bucket already has a policy, the
-    # one in this request completely replaces it.
+    # Applies an Amazon S3 bucket policy to an Amazon S3 bucket.
     #
     # @option params [required, String] :bucket
     #
@@ -5273,19 +5284,25 @@ module Aws::S3
     end
 
     # Creates a replication configuration or replaces an existing one. For
-    # more information, see [Cross-Region Replication (CRR)](
-    # https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html) in the
+    # more information, see [Cross-Region Replication (CRR)][1] in the
     # *Amazon S3 Developer Guide*.
     #
+    #
+    #
+    # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html
+    #
     # @option params [required, String] :bucket
     #
     # @option params [String] :content_md5
+    #   The base64-encoded 128-bit MD5 digest of the data. You must use this
+    #   header as a message integrity check to verify that the request body
+    #   was not corrupted in transit.
     #
     # @option params [required, Types::ReplicationConfiguration] :replication_configuration
-    #   A container for replication rules. You can add up to 1,000 rules. The
-    #   maximum size of a replication configuration is 2 MB.
     #
     # @option params [String] :token
+    #   A token that allows Amazon S3 object lock to be enabled for an
+    #   existing bucket.
     #
     # @return [Struct] Returns an empty {Seahorse::Client::Response response}.
     #
@@ -5626,7 +5643,8 @@ module Aws::S3
     #
     # @option params [String] :content_md5
     #   The base64-encoded 128-bit MD5 digest of the part data. This parameter
-    #   is auto-populated when using the command from the CLI
+    #   is auto-populated when using the command from the CLI. This parameted
+    #   is required if object lock parameters are specified.
     #
     # @option params [String] :content_type
     #   A standard MIME type describing the format of the object data.
@@ -5700,10 +5718,10 @@ module Aws::S3
     #   parameters. (For example, "Key1=Value1")
     #
     # @option params [String] :object_lock_mode
-    #   The Object Lock mode that you want to apply to this object.
+    #   The object lock mode that you want to apply to this object.
     #
     # @option params [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
-    #   The date and time when you want this object's Object Lock to expire.
+    #   The date and time when you want this object's object lock to expire.
     #
     # @option params [String] :object_lock_legal_hold_status
     #   The Legal Hold status that you want to apply to the specified object.
@@ -5919,6 +5937,8 @@ module Aws::S3
     #   The canned ACL to apply to the object.
     #
     # @option params [Types::AccessControlPolicy] :access_control_policy
+    #   Contains the elements that set the ACL permissions for an object per
+    #   grantee.
     #
     # @option params [required, String] :bucket
     #
@@ -6079,16 +6099,16 @@ module Aws::S3
       req.send_request(options)
     end
 
-    # Places an Object Lock configuration on the specified bucket. The rule
-    # specified in the Object Lock configuration will be applied by default
+    # Places an object lock configuration on the specified bucket. The rule
+    # specified in the object lock configuration will be applied by default
     # to every new object placed in the specified bucket.
     #
     # @option params [required, String] :bucket
-    #   The bucket whose Object Lock configuration you want to create or
+    #   The bucket whose object lock configuration you want to create or
     #   replace.
     #
     # @option params [Types::ObjectLockConfiguration] :object_lock_configuration
-    #   The Object Lock configuration that you want to apply to the specified
+    #   The object lock configuration that you want to apply to the specified
     #   bucket.
     #
     # @option params [String] :request_payer
@@ -6099,7 +6119,8 @@ module Aws::S3
     #   http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
     #
     # @option params [String] :token
-    #   A token to allow Object Lock to be enabled for an existing bucket.
+    #   A token to allow Amazon S3 object lock to be enabled for an existing
+    #   bucket.
     #
     # @option params [String] :content_md5
     #   The MD5 hash for the request body.
@@ -6330,7 +6351,6 @@ module Aws::S3
     # @option params [String] :version_id
     #
     # @option params [Types::RestoreRequest] :restore_request
-    #   Container for restore job parameters.
     #
     # @option params [String] :request_payer
     #   Confirms that the requester knows that she or he will be charged for
@@ -6761,7 +6781,9 @@ module Aws::S3
     #   the body cannot be determined automatically.
     #
     # @option params [String] :content_md5
-    #   The base64-encoded 128-bit MD5 digest of the part data.
+    #   The base64-encoded 128-bit MD5 digest of the part data. This parameter
+    #   is auto-populated when using the command from the CLI. This parameted
+    #   is required if object lock parameters are specified.
     #
     # @option params [required, String] :key
     #   Object key for which the multipart upload was initiated.
@@ -7046,7 +7068,7 @@ module Aws::S3
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-s3'
-      context[:gem_version] = '1.41.0'
+      context[:gem_version] = '1.42.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

data/lib/aws-sdk-s3/event_streams.rb

@@ -14,31 +14,31 @@ module Aws::S3
       end
 
       def on_records_event(&block)
-        @event_emitter.on(:records, Proc.new)
+        @event_emitter.on(:records, block) if block_given?
       end
 
       def on_stats_event(&block)
-        @event_emitter.on(:stats, Proc.new)
+        @event_emitter.on(:stats, block) if block_given?
       end
 
       def on_progress_event(&block)
-        @event_emitter.on(:progress, Proc.new)
+        @event_emitter.on(:progress, block) if block_given?
       end
 
       def on_cont_event(&block)
-        @event_emitter.on(:cont, Proc.new)
+        @event_emitter.on(:cont, block) if block_given?
       end
 
       def on_end_event(&block)
-        @event_emitter.on(:end, Proc.new)
+        @event_emitter.on(:end, block) if block_given?
       end
 
       def on_error_event(&block)
-        @event_emitter.on(:error, Proc.new)
+        @event_emitter.on(:error, block) if block_given?
       end
 
       def on_initial_response_event(&block)
-        @event_emitter.on(:initial_response, Proc.new)
+        @event_emitter.on(:initial_response, block) if block_given?
       end
 
       def on_event(&block)