aws-sdk-s3 1.36.1 → 1.56.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (37) hide show
  1. checksums.yaml +4 -4
  2. data/lib/aws-sdk-s3/bucket.rb +158 -34
  3. data/lib/aws-sdk-s3/bucket_acl.rb +10 -1
  4. data/lib/aws-sdk-s3/bucket_cors.rb +17 -1
  5. data/lib/aws-sdk-s3/bucket_lifecycle.rb +1 -1
  6. data/lib/aws-sdk-s3/bucket_lifecycle_configuration.rb +2 -1
  7. data/lib/aws-sdk-s3/bucket_logging.rb +10 -3
  8. data/lib/aws-sdk-s3/bucket_notification.rb +6 -3
  9. data/lib/aws-sdk-s3/bucket_policy.rb +1 -0
  10. data/lib/aws-sdk-s3/bucket_request_payment.rb +9 -0
  11. data/lib/aws-sdk-s3/bucket_tagging.rb +9 -1
  12. data/lib/aws-sdk-s3/bucket_versioning.rb +25 -0
  13. data/lib/aws-sdk-s3/bucket_website.rb +14 -4
  14. data/lib/aws-sdk-s3/client.rb +4636 -301
  15. data/lib/aws-sdk-s3/client_api.rb +22 -0
  16. data/lib/aws-sdk-s3/customizations/bucket.rb +4 -0
  17. data/lib/aws-sdk-s3/customizations/object.rb +65 -43
  18. data/lib/aws-sdk-s3/encryption/client.rb +4 -0
  19. data/lib/aws-sdk-s3/event_streams.rb +7 -7
  20. data/lib/aws-sdk-s3/file_part.rb +9 -6
  21. data/lib/aws-sdk-s3/file_uploader.rb +13 -12
  22. data/lib/aws-sdk-s3/multipart_file_uploader.rb +14 -11
  23. data/lib/aws-sdk-s3/multipart_upload.rb +3 -1
  24. data/lib/aws-sdk-s3/multipart_upload_part.rb +3 -1
  25. data/lib/aws-sdk-s3/object.rb +205 -32
  26. data/lib/aws-sdk-s3/object_acl.rb +17 -2
  27. data/lib/aws-sdk-s3/object_summary.rb +125 -25
  28. data/lib/aws-sdk-s3/object_version.rb +6 -2
  29. data/lib/aws-sdk-s3/plugins/iad_regional_endpoint.rb +59 -0
  30. data/lib/aws-sdk-s3/plugins/md5s.rb +3 -4
  31. data/lib/aws-sdk-s3/plugins/s3_signer.rb +2 -0
  32. data/lib/aws-sdk-s3/presigned_post.rb +4 -0
  33. data/lib/aws-sdk-s3/presigner.rb +44 -30
  34. data/lib/aws-sdk-s3/resource.rb +2 -0
  35. data/lib/aws-sdk-s3/types.rb +2460 -430
  36. data/lib/aws-sdk-s3.rb +1 -1
  37. metadata +7 -6
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA1:
3
- metadata.gz: 72940c011079e517dc7eaefdc36789c1ff3ce769
4
- data.tar.gz: 594bb19e804afe32207bd5285b09514049f5a180
3
+ metadata.gz: 97510d745f7ed2fd04221e9213bc80749aa72800
4
+ data.tar.gz: 8f486dbd89e0b58c112b18cc877f79a19d7299da
5
5
  SHA512:
6
- metadata.gz: 2ba9edd851d10ce6fc36e82fd32c65ce34fb22a62f455f61b34fa609f3d1f5809564d08073c480244777ecee045a2b04df6d87e89ead8bb0e8e94ac0fde62698
7
- data.tar.gz: d8da5158696050869d5a2ee77b64d9268ee69be5020edcdacd6c94a8c6229440e039e4b6a7f7af04339448e7f0854d6336af05ab193c4814ffc105fa473a79e9
6
+ metadata.gz: 02dc98b651db4c246856e368a86e06f8fa2791d2ba636ef0805038206749b6603cd00e0c5ed163fc6cd20d3b5cd118fa9f26d449a964a8f4dd2298a3318b285b
7
+ data.tar.gz: fcbfaa5ee8c9c68b47f3f5b1166603b0e4a82b84c1efef8865818449b1da44c4f0f22efb96dbd60f9decbf3d3dfc91d0e3bf3fc54cfe866604de77472060fef4
@@ -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,
@@ -229,6 +229,7 @@ module Aws::S3
229
229
  # @option options [String] :acl
230
230
  # The canned ACL to apply to the bucket.
231
231
  # @option options [Types::CreateBucketConfiguration] :create_bucket_configuration
232
+ # The configuration information for the bucket.
232
233
  # @option options [String] :grant_full_control
233
234
  # Allows grantee the read, write, read ACP, and write ACP permissions on
234
235
  # the bucket.
@@ -280,9 +281,12 @@ module Aws::S3
280
281
  # })
281
282
  # @param [Hash] options ({})
282
283
  # @option options [required, Types::Delete] :delete
284
+ # Container for the request.
283
285
  # @option options [String] :mfa
284
286
  # The concatenation of the authentication device's serial number, a
285
287
  # space, and the value that is displayed on your authentication device.
288
+ # Required to permanently delete a versioned object if versioning is
289
+ # configured with MFA Delete enabled.
286
290
  # @option options [String] :request_payer
287
291
  # Confirms that the requester knows that she or he will be charged for
288
292
  # the request. Bucket owners need not specify this parameter in their
@@ -328,6 +332,7 @@ module Aws::S3
328
332
  # sse_customer_key: "SSECustomerKey",
329
333
  # sse_customer_key_md5: "SSECustomerKeyMD5",
330
334
  # ssekms_key_id: "SSEKMSKeyId",
335
+ # ssekms_encryption_context: "SSEKMSEncryptionContext",
331
336
  # request_payer: "requester", # accepts requester
332
337
  # tagging: "TaggingHeader",
333
338
  # object_lock_mode: "GOVERNANCE", # accepts GOVERNANCE, COMPLIANCE
@@ -336,29 +341,77 @@ module Aws::S3
336
341
  # })
337
342
  # @param [Hash] options ({})
338
343
  # @option options [String] :acl
339
- # The canned ACL to apply to the object.
344
+ # The canned ACL to apply to the object. For more information, see
345
+ # [Canned ACL][1].
346
+ #
347
+ #
348
+ #
349
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
340
350
  # @option options [String, IO] :body
341
351
  # Object data.
342
352
  # @option options [String] :cache_control
343
- # Specifies caching behavior along the request/reply chain.
353
+ # Can be used to specify caching behavior along the request/reply chain.
354
+ # For more information, see
355
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9][1].
356
+ #
357
+ #
358
+ #
359
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9
344
360
  # @option options [String] :content_disposition
345
- # Specifies presentational information for the object.
361
+ # Specifies presentational information for the object. For more
362
+ # information, see
363
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1][1].
364
+ #
365
+ #
366
+ #
367
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
346
368
  # @option options [String] :content_encoding
347
369
  # Specifies what content encodings have been applied to the object and
348
370
  # thus what decoding mechanisms must be applied to obtain the media-type
349
- # referenced by the Content-Type header field.
371
+ # referenced by the Content-Type header field. For more information, see
372
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11][1].
373
+ #
374
+ #
375
+ #
376
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
350
377
  # @option options [String] :content_language
351
378
  # The language the content is in.
352
379
  # @option options [Integer] :content_length
353
380
  # Size of the body in bytes. This parameter is useful when the size of
354
- # the body cannot be determined automatically.
381
+ # the body cannot be determined automatically. For more information, see
382
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13][1].
383
+ #
384
+ #
385
+ #
386
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
355
387
  # @option options [String] :content_md5
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
388
+ # The base64-encoded 128-bit MD5 digest of the message (without the
389
+ # headers) according to RFC 1864. This header can be used as a message
390
+ # integrity check to verify that the data is the same data that was
391
+ # originally sent. Although it is optional, we recommend using the
392
+ # Content-MD5 mechanism as an end-to-end integrity check. For more
393
+ # information about REST request authentication, see [REST
394
+ # Authentication][1].
395
+ #
396
+ #
397
+ #
398
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
358
399
  # @option options [String] :content_type
359
- # A standard MIME type describing the format of the object data.
400
+ # A standard MIME type describing the format of the contents. For more
401
+ # information, see
402
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17][1].
403
+ #
404
+ #
405
+ #
406
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
360
407
  # @option options [Time,DateTime,Date,Integer,String] :expires
361
- # The date and time at which the object is no longer cacheable.
408
+ # The date and time at which the object is no longer cacheable. For more
409
+ # information, see
410
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21][1].
411
+ #
412
+ #
413
+ #
414
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
362
415
  # @option options [String] :grant_full_control
363
416
  # Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
364
417
  # object.
@@ -376,11 +429,32 @@ module Aws::S3
376
429
  # The Server-side encryption algorithm used when storing this object in
377
430
  # S3 (e.g., AES256, aws:kms).
378
431
  # @option options [String] :storage_class
379
- # The type of storage to use for the object. Defaults to 'STANDARD'.
432
+ # If you don't specify, Standard is the default storage class. Amazon
433
+ # S3 supports other storage classes.
380
434
  # @option options [String] :website_redirect_location
381
435
  # If the bucket is configured as a website, redirects requests for this
382
436
  # object to another object in the same bucket or to an external URL.
383
- # Amazon S3 stores the value of this header in the object metadata.
437
+ # Amazon S3 stores the value of this header in the object metadata. For
438
+ # information about object metadata, see .
439
+ #
440
+ # In the following example, the request header sets the redirect to an
441
+ # object (anotherPage.html) in the same bucket:
442
+ #
443
+ # `x-amz-website-redirect-location: /anotherPage.html`
444
+ #
445
+ # In the following example, the request header sets the object redirect
446
+ # to another website:
447
+ #
448
+ # `x-amz-website-redirect-location: http://www.example.com/`
449
+ #
450
+ # For more information about website hosting in Amazon S3, see [Hosting
451
+ # Websites on Amazon S3][1] and [How to Configure Website Page
452
+ # Redirects][2].
453
+ #
454
+ #
455
+ #
456
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
457
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html
384
458
  # @option options [String] :sse_customer_algorithm
385
459
  # Specifies the algorithm to use to when encrypting the object (e.g.,
386
460
  # AES256).
@@ -395,11 +469,20 @@ module Aws::S3
395
469
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
396
470
  # ensure the encryption key was transmitted without error.
397
471
  # @option options [String] :ssekms_key_id
398
- # Specifies the AWS KMS key ID to use for object encryption. All GET and
399
- # PUT requests for an object protected by AWS KMS will fail if not made
400
- # via SSL or using SigV4. Documentation on configuring any of the
401
- # officially supported AWS SDKs and CLI can be found at
402
- # http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
472
+ # If the x-amz-server-side-encryption is present and has the value of
473
+ # aws:kms, this header specifies the ID of the AWS Key Management
474
+ # Service (AWS KMS) customer master key (CMK) that was used for the
475
+ # object.
476
+ #
477
+ # If the value of x-amz-server-side-encryption is aws:kms, this header
478
+ # specifies the ID of the AWS KMS CMK that will be used for the object.
479
+ # If you specify x-amz-server-side-encryption:aws:kms, but do not
480
+ # provide x-amz-server-side-encryption-aws-kms-key-id, Amazon S3 uses
481
+ # the AWS managed CMK in AWS to protect the data.
482
+ # @option options [String] :ssekms_encryption_context
483
+ # Specifies the AWS KMS Encryption Context to use for object encryption.
484
+ # The value of this header is a base64-encoded UTF-8 string holding JSON
485
+ # with the encryption context key-value pairs.
403
486
  # @option options [String] :request_payer
404
487
  # Confirms that the requester knows that she or he will be charged for
405
488
  # the request. Bucket owners need not specify this parameter in their
@@ -414,7 +497,12 @@ module Aws::S3
414
497
  # @option options [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
415
498
  # The date and time when you want this object's Object Lock to expire.
416
499
  # @option options [String] :object_lock_legal_hold_status
417
- # The Legal Hold status that you want to apply to the specified object.
500
+ # Specifies whether a legal hold will be applied to this object. For
501
+ # more information about S3 Object Lock, see [Object Lock][1].
502
+ #
503
+ #
504
+ #
505
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
418
506
  # @return [Object]
419
507
  def put_object(options = {})
420
508
  options = options.merge(bucket: @name)
@@ -480,6 +568,13 @@ module Aws::S3
480
568
  # @param [Hash] options ({})
481
569
  # @option options [String] :delimiter
482
570
  # Character you use to group keys.
571
+ #
572
+ # All keys that contain the same string between the prefix, if
573
+ # specified, and the first occurrence of the delimiter after the prefix
574
+ # are grouped under a single result element, `CommonPrefixes`. If you
575
+ # don't specify the prefix parameter, then the substring starts at the
576
+ # beginning of the key. The keys that are grouped under `CommonPrefixes`
577
+ # result element are not returned elsewhere in the response.
483
578
  # @option options [String] :encoding_type
484
579
  # Requests Amazon S3 to encode the object keys in the response and
485
580
  # specifies the encoding method to use. An object key may contain any
@@ -490,13 +585,27 @@ module Aws::S3
490
585
  # @option options [String] :key_marker
491
586
  # Together with upload-id-marker, this parameter specifies the multipart
492
587
  # upload after which listing should begin.
588
+ #
589
+ # If `upload-id-marker` is not specified, only the keys
590
+ # lexicographically greater than the specified `key-marker` will be
591
+ # included in the list.
592
+ #
593
+ # If `upload-id-marker` is specified, any multipart uploads for a key
594
+ # equal to the `key-marker` might also be included, provided those
595
+ # multipart uploads have upload IDs lexicographically greater than the
596
+ # specified `upload-id-marker`.
493
597
  # @option options [String] :prefix
494
598
  # Lists in-progress uploads only for those keys that begin with the
495
- # specified prefix.
599
+ # specified prefix. You can use prefixes to separate a bucket into
600
+ # different grouping of keys. (You can think of using prefix to make
601
+ # groups in the same way you'd use a folder in a file system.)
496
602
  # @option options [String] :upload_id_marker
497
603
  # Together with key-marker, specifies the multipart upload after which
498
604
  # listing should begin. If key-marker is not specified, the
499
- # upload-id-marker parameter is ignored.
605
+ # upload-id-marker parameter is ignored. Otherwise, any multipart
606
+ # uploads for a key equal to the key-marker might be included in the
607
+ # list only if they have an upload ID lexicographically greater than the
608
+ # specified upload-id-marker.
500
609
  # @return [MultipartUpload::Collection]
501
610
  def multipart_uploads(options = {})
502
611
  batches = Enumerator.new do |y|
@@ -548,7 +657,12 @@ module Aws::S3
548
657
  # })
549
658
  # @param [Hash] options ({})
550
659
  # @option options [String] :delimiter
551
- # A delimiter is a character you use to group keys.
660
+ # A delimiter is a character that you specify to group keys. All keys
661
+ # that contain the same string between the `prefix` and the first
662
+ # occurrence of the delimiter are grouped under a single result element
663
+ # in CommonPrefixes. These groups are counted as one result against the
664
+ # max-keys limitation. These keys are not returned elsewhere in the
665
+ # response.
552
666
  # @option options [String] :encoding_type
553
667
  # Requests Amazon S3 to encode the object keys in the response and
554
668
  # specifies the encoding method to use. An object key may contain any
@@ -559,7 +673,12 @@ module Aws::S3
559
673
  # @option options [String] :key_marker
560
674
  # Specifies the key to start with when listing objects in a bucket.
561
675
  # @option options [String] :prefix
562
- # Limits the response to keys that begin with the specified prefix.
676
+ # Use this parameter to select only those keys that begin with the
677
+ # specified prefix. You can use prefixes to separate a bucket into
678
+ # different groupings of keys. (You can think of using prefix to make
679
+ # groups in the same way you'd use a folder in a file system.) You can
680
+ # use prefix with delimiter to roll up numerous objects into a single
681
+ # result under CommonPrefixes.
563
682
  # @option options [String] :version_id_marker
564
683
  # Specifies the object version you want to start listing from.
565
684
  # @return [ObjectVersion::Collection]
@@ -590,29 +709,34 @@ module Aws::S3
590
709
  # delimiter: "Delimiter",
591
710
  # encoding_type: "url", # accepts url
592
711
  # prefix: "Prefix",
712
+ # fetch_owner: false,
713
+ # start_after: "StartAfter",
593
714
  # request_payer: "requester", # accepts requester
594
715
  # })
595
716
  # @param [Hash] options ({})
596
717
  # @option options [String] :delimiter
597
718
  # A delimiter is a character you use to group keys.
598
719
  # @option options [String] :encoding_type
599
- # Requests Amazon S3 to encode the object keys in the response and
600
- # specifies the encoding method to use. An object key may contain any
601
- # Unicode character; however, XML 1.0 parser cannot parse some
602
- # characters, such as characters with an ASCII value from 0 to 10. For
603
- # characters that are not supported in XML 1.0, you can add this
604
- # parameter to request that Amazon S3 encode the keys in the response.
720
+ # Encoding type used by Amazon S3 to encode object keys in the response.
605
721
  # @option options [String] :prefix
606
722
  # Limits the response to keys that begin with the specified prefix.
723
+ # @option options [Boolean] :fetch_owner
724
+ # The owner field is not present in listV2 by default, if you want to
725
+ # return owner field with each key in the result then set the fetch
726
+ # owner field to true
727
+ # @option options [String] :start_after
728
+ # StartAfter is where you want Amazon S3 to start listing from. Amazon
729
+ # S3 starts listing after this specified key. StartAfter can be any key
730
+ # in the bucket.
607
731
  # @option options [String] :request_payer
608
732
  # Confirms that the requester knows that she or he will be charged for
609
- # the list objects request. Bucket owners need not specify this
610
- # parameter in their requests.
733
+ # the list objects request in V2 style. Bucket owners need not specify
734
+ # this parameter in their requests.
611
735
  # @return [ObjectSummary::Collection]
612
736
  def objects(options = {})
613
737
  batches = Enumerator.new do |y|
614
738
  options = options.merge(bucket: @name)
615
- resp = @client.list_objects(options)
739
+ resp = @client.list_objects_v2(options)
616
740
  resp.each_page do |page|
617
741
  batch = []
618
742
  page.data.contents.each do |c|
@@ -30,7 +30,7 @@ module Aws::S3
30
30
  @bucket_name
31
31
  end
32
32
 
33
-
33
+ # Container for the bucket owner's display name and ID.
34
34
  # @return [Types::Owner]
35
35
  def owner
36
36
  data[:owner]
@@ -207,7 +207,16 @@ 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
213
+ # The base64-encoded 128-bit MD5 digest of the data. This header must be
214
+ # used as a message integrity check to verify that the request body was
215
+ # not corrupted in transit. For more information, go to [RFC 1864.][1]
216
+ #
217
+ #
218
+ #
219
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
211
220
  # @option options [String] :grant_full_control
212
221
  # Allows grantee the read, write, read ACP, and write ACP permissions on
213
222
  # the bucket.
@@ -30,7 +30,8 @@ module Aws::S3
30
30
  @bucket_name
31
31
  end
32
32
 
33
-
33
+ # A set of origins and methods (cross-origin access that you want to
34
+ # allow). You can add up to 100 rules to the configuration.
34
35
  # @return [Array<Types::CORSRule>]
35
36
  def cors_rules
36
37
  data[:cors_rules]
@@ -197,7 +198,22 @@ module Aws::S3
197
198
  # })
198
199
  # @param [Hash] options ({})
199
200
  # @option options [required, Types::CORSConfiguration] :cors_configuration
201
+ # Describes the cross-origin access configuration for objects in an
202
+ # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
203
+ # Resource Sharing][1] in the Amazon Simple Storage Service Developer
204
+ # Guide.
205
+ #
206
+ #
207
+ #
208
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev//cors.html
200
209
  # @option options [String] :content_md5
210
+ # The base64-encoded 128-bit MD5 digest of the data. This header must be
211
+ # used as a message integrity check to verify that the request body was
212
+ # not corrupted in transit. For more information, go to [RFC 1864.][1]
213
+ #
214
+ #
215
+ #
216
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
201
217
  # @return [EmptyStructure]
202
218
  def put(options = {})
203
219
  options = options.merge(bucket: @bucket_name)
@@ -30,7 +30,7 @@ module Aws::S3
30
30
  @bucket_name
31
31
  end
32
32
 
33
-
33
+ # Container for a lifecycle rule.
34
34
  # @return [Array<Types::Rule>]
35
35
  def rules
36
36
  data[:rules]
@@ -30,7 +30,7 @@ module Aws::S3
30
30
  @bucket_name
31
31
  end
32
32
 
33
-
33
+ # Container for a lifecycle rule.
34
34
  # @return [Array<Types::LifecycleRule>]
35
35
  def rules
36
36
  data[:rules]
@@ -234,6 +234,7 @@ module Aws::S3
234
234
  # })
235
235
  # @param [Hash] options ({})
236
236
  # @option options [Types::BucketLifecycleConfiguration] :lifecycle_configuration
237
+ # Container for lifecycle rules. You can add as many as 1,000 rules.
237
238
  # @return [EmptyStructure]
238
239
  def put(options = {})
239
240
  options = options.merge(bucket: @bucket_name)
@@ -30,9 +30,14 @@ 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
+ # Describes where logs are stored and the prefix that Amazon S3 assigns
34
+ # to all log object keys for a bucket. For more information, see [PUT
35
+ # Bucket logging][1] in the *Amazon Simple Storage Service API
36
+ # Reference*.
37
+ #
38
+ #
39
+ #
40
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlogging.html
36
41
  # @return [Types::LoggingEnabled]
37
42
  def logging_enabled
38
43
  data[:logging_enabled]
@@ -195,7 +200,9 @@ module Aws::S3
195
200
  # })
196
201
  # @param [Hash] options ({})
197
202
  # @option options [required, Types::BucketLoggingStatus] :bucket_logging_status
203
+ # Container for logging status information.
198
204
  # @option options [String] :content_md5
205
+ # The MD5 hash of the `PutBucketLogging` request body.
199
206
  # @return [EmptyStructure]
200
207
  def put(options = {})
201
208
  options = options.merge(bucket: @bucket_name)
@@ -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]
@@ -188,6 +188,7 @@ module Aws::S3
188
188
  # })
189
189
  # @param [Hash] options ({})
190
190
  # @option options [String] :content_md5
191
+ # The MD5 hash of the request body.
191
192
  # @option options [Boolean] :confirm_remove_self_bucket_access
192
193
  # Set this parameter to true to confirm that you want to remove your
193
194
  # permissions to change this bucket policy in the future.
@@ -178,7 +178,16 @@ module Aws::S3
178
178
  # })
179
179
  # @param [Hash] options ({})
180
180
  # @option options [String] :content_md5
181
+ # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
182
+ # this header as a message integrity check to verify that the request
183
+ # body was not corrupted in transit. For more information, see [RFC
184
+ # 1864][1].
185
+ #
186
+ #
187
+ #
188
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
181
189
  # @option options [required, Types::RequestPaymentConfiguration] :request_payment_configuration
190
+ # Container for Payer.
182
191
  # @return [EmptyStructure]
183
192
  def put(options = {})
184
193
  options = options.merge(bucket: @bucket_name)
@@ -30,7 +30,7 @@ module Aws::S3
30
30
  @bucket_name
31
31
  end
32
32
 
33
-
33
+ # Contains the tag set.
34
34
  # @return [Array<Types::Tag>]
35
35
  def tag_set
36
36
  data[:tag_set]
@@ -194,7 +194,15 @@ module Aws::S3
194
194
  # })
195
195
  # @param [Hash] options ({})
196
196
  # @option options [String] :content_md5
197
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
198
+ # header as a message integrity check to verify that the request body
199
+ # was not corrupted in transit. For more information, see [RFC 1864][1].
200
+ #
201
+ #
202
+ #
203
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
197
204
  # @option options [required, Types::Tagging] :tagging
205
+ # Container for the TagSet and Tag elements.
198
206
  # @return [EmptyStructure]
199
207
  def put(options = {})
200
208
  options = options.merge(bucket: @bucket_name)
@@ -185,6 +185,14 @@ module Aws::S3
185
185
  # })
186
186
  # @param [Hash] options ({})
187
187
  # @option options [String] :content_md5
188
+ # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
189
+ # this header as a message integrity check to verify that the request
190
+ # body was not corrupted in transit. For more information, see [RFC
191
+ # 1864][1].
192
+ #
193
+ #
194
+ #
195
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
188
196
  # @option options [String] :mfa
189
197
  # The concatenation of the authentication device's serial number, a
190
198
  # space, and the value that is displayed on your authentication device.
@@ -212,10 +220,19 @@ module Aws::S3
212
220
  # })
213
221
  # @param [Hash] options ({})
214
222
  # @option options [String] :content_md5
223
+ # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
224
+ # this header as a message integrity check to verify that the request
225
+ # body was not corrupted in transit. For more information, see [RFC
226
+ # 1864][1].
227
+ #
228
+ #
229
+ #
230
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
215
231
  # @option options [String] :mfa
216
232
  # The concatenation of the authentication device's serial number, a
217
233
  # space, and the value that is displayed on your authentication device.
218
234
  # @option options [required, Types::VersioningConfiguration] :versioning_configuration
235
+ # Container for setting the versioning state.
219
236
  # @return [EmptyStructure]
220
237
  def put(options = {})
221
238
  options = options.merge(bucket: @bucket_name)
@@ -231,6 +248,14 @@ module Aws::S3
231
248
  # })
232
249
  # @param [Hash] options ({})
233
250
  # @option options [String] :content_md5
251
+ # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
252
+ # this header as a message integrity check to verify that the request
253
+ # body was not corrupted in transit. For more information, see [RFC
254
+ # 1864][1].
255
+ #
256
+ #
257
+ #
258
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
234
259
  # @option options [String] :mfa
235
260
  # The concatenation of the authentication device's serial number, a
236
261
  # space, and the value that is displayed on your authentication device.
@@ -30,25 +30,27 @@ module Aws::S3
30
30
  @bucket_name
31
31
  end
32
32
 
33
-
33
+ # Specifies the redirect behavior of all requests to a website endpoint
34
+ # of an Amazon S3 bucket.
34
35
  # @return [Types::RedirectAllRequestsTo]
35
36
  def redirect_all_requests_to
36
37
  data[:redirect_all_requests_to]
37
38
  end
38
39
 
39
-
40
+ # The name of the index document for the website.
40
41
  # @return [Types::IndexDocument]
41
42
  def index_document
42
43
  data[:index_document]
43
44
  end
44
45
 
45
-
46
+ # The name of the error document for the website.
46
47
  # @return [Types::ErrorDocument]
47
48
  def error_document
48
49
  data[:error_document]
49
50
  end
50
51
 
51
-
52
+ # Rules that define when a redirect is applied and the redirect
53
+ # behavior.
52
54
  # @return [Array<Types::RoutingRule>]
53
55
  def routing_rules
54
56
  data[:routing_rules]
@@ -231,7 +233,15 @@ module Aws::S3
231
233
  # })
232
234
  # @param [Hash] options ({})
233
235
  # @option options [String] :content_md5
236
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
237
+ # header as a message integrity check to verify that the request body
238
+ # was not corrupted in transit. For more information, see [RFC 1864][1].
239
+ #
240
+ #
241
+ #
242
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
234
243
  # @option options [required, Types::WebsiteConfiguration] :website_configuration
244
+ # Container for the request.
235
245
  # @return [EmptyStructure]
236
246
  def put(options = {})
237
247
  options = options.merge(bucket: @bucket_name)