aws-sdk-s3 1.36.1 → 1.56.0

Sign up to get free protection for your applications and to get access to all the features.
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)