aws-sdk-s3 1.55.0 → 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.
@@ -38,19 +38,20 @@ module Aws::S3
38
38
  @key
39
39
  end
40
40
 
41
-
41
+ # The date the Object was Last Modified
42
42
  # @return [Time]
43
43
  def last_modified
44
44
  data[:last_modified]
45
45
  end
46
46
 
47
-
47
+ # The entity tag is an MD5 hash of the object. ETag reflects only
48
+ # changes to the contents of an object, not its metadata.
48
49
  # @return [String]
49
50
  def etag
50
51
  data[:etag]
51
52
  end
52
53
 
53
-
54
+ # Size in bytes of the object
54
55
  # @return [Integer]
55
56
  def size
56
57
  data[:size]
@@ -62,7 +63,7 @@ module Aws::S3
62
63
  data[:storage_class]
63
64
  end
64
65
 
65
-
66
+ # The owner of the object
66
67
  # @return [Types::Owner]
67
68
  def owner
68
69
  data[:owner]
@@ -389,9 +390,9 @@ module Aws::S3
389
390
  # in conjunction with the TaggingDirective. The tag-set must be encoded
390
391
  # as URL Query parameters
391
392
  # @option options [String] :object_lock_mode
392
- # The object lock mode that you want to apply to the copied object.
393
+ # The Object Lock mode that you want to apply to the copied object.
393
394
  # @option options [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
394
- # The date and time when you want the copied object's object lock to
395
+ # The date and time when you want the copied object's Object Lock to
395
396
  # expire.
396
397
  # @option options [String] :object_lock_legal_hold_status
397
398
  # Specifies whether you want to apply a Legal Hold to the copied object.
@@ -417,6 +418,8 @@ module Aws::S3
417
418
  # @option options [String] :mfa
418
419
  # The concatenation of the authentication device's serial number, a
419
420
  # space, and the value that is displayed on your authentication device.
421
+ # Required to permanently delete a versionedobject if versioning is
422
+ # configured with MFA Deleteenabled.
420
423
  # @option options [String] :version_id
421
424
  # VersionId used to reference a specific version of the object.
422
425
  # @option options [String] :request_payer
@@ -426,7 +429,7 @@ module Aws::S3
426
429
  # buckets can be found at
427
430
  # http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
428
431
  # @option options [Boolean] :bypass_governance_retention
429
- # Indicates whether Amazon S3 object lock should bypass governance-mode
432
+ # Indicates whether S3 Object Lock should bypass Governance-mode
430
433
  # restrictions to process this operation.
431
434
  # @return [Types::DeleteObjectOutput]
432
435
  def delete(options = {})
@@ -625,10 +628,10 @@ module Aws::S3
625
628
  # The tag-set for the object. The tag-set must be encoded as URL Query
626
629
  # parameters
627
630
  # @option options [String] :object_lock_mode
628
- # Specifies the object lock mode that you want to apply to the uploaded
631
+ # Specifies the Object Lock mode that you want to apply to the uploaded
629
632
  # object.
630
633
  # @option options [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
631
- # Specifies the date and time when you want the object lock to expire.
634
+ # Specifies the date and time when you want the Object Lock to expire.
632
635
  # @option options [String] :object_lock_legal_hold_status
633
636
  # Specifies whether you want to apply a Legal Hold to the uploaded
634
637
  # object.
@@ -683,30 +686,77 @@ module Aws::S3
683
686
  # })
684
687
  # @param [Hash] options ({})
685
688
  # @option options [String] :acl
686
- # The canned ACL to apply to the object.
689
+ # The canned ACL to apply to the object. For more information, see
690
+ # [Canned ACL][1].
691
+ #
692
+ #
693
+ #
694
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
687
695
  # @option options [String, IO] :body
688
696
  # Object data.
689
697
  # @option options [String] :cache_control
690
- # Specifies caching behavior along the request/reply chain.
698
+ # Can be used to specify caching behavior along the request/reply chain.
699
+ # For more information, see
700
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9][1].
701
+ #
702
+ #
703
+ #
704
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9
691
705
  # @option options [String] :content_disposition
692
- # Specifies presentational information for the object.
706
+ # Specifies presentational information for the object. For more
707
+ # information, see
708
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1][1].
709
+ #
710
+ #
711
+ #
712
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
693
713
  # @option options [String] :content_encoding
694
714
  # Specifies what content encodings have been applied to the object and
695
715
  # thus what decoding mechanisms must be applied to obtain the media-type
696
- # referenced by the Content-Type header field.
716
+ # referenced by the Content-Type header field. For more information, see
717
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11][1].
718
+ #
719
+ #
720
+ #
721
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
697
722
  # @option options [String] :content_language
698
723
  # The language the content is in.
699
724
  # @option options [Integer] :content_length
700
725
  # Size of the body in bytes. This parameter is useful when the size of
701
- # the body cannot be determined automatically.
726
+ # the body cannot be determined automatically. For more information, see
727
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13][1].
728
+ #
729
+ #
730
+ #
731
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
702
732
  # @option options [String] :content_md5
703
- # The base64-encoded 128-bit MD5 digest of the part data. This parameter
704
- # is auto-populated when using the command from the CLI. This parameted
705
- # is required if object lock parameters are specified.
733
+ # The base64-encoded 128-bit MD5 digest of the message (without the
734
+ # headers) according to RFC 1864. This header can be used as a message
735
+ # integrity check to verify that the data is the same data that was
736
+ # originally sent. Although it is optional, we recommend using the
737
+ # Content-MD5 mechanism as an end-to-end integrity check. For more
738
+ # information about REST request authentication, see [REST
739
+ # Authentication][1].
740
+ #
741
+ #
742
+ #
743
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
706
744
  # @option options [String] :content_type
707
- # A standard MIME type describing the format of the object data.
745
+ # A standard MIME type describing the format of the contents. For more
746
+ # information, see
747
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17][1].
748
+ #
749
+ #
750
+ #
751
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
708
752
  # @option options [Time,DateTime,Date,Integer,String] :expires
709
- # The date and time at which the object is no longer cacheable.
753
+ # The date and time at which the object is no longer cacheable. For more
754
+ # information, see
755
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21][1].
756
+ #
757
+ #
758
+ #
759
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
710
760
  # @option options [String] :grant_full_control
711
761
  # Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
712
762
  # object.
@@ -722,11 +772,32 @@ module Aws::S3
722
772
  # The Server-side encryption algorithm used when storing this object in
723
773
  # S3 (e.g., AES256, aws:kms).
724
774
  # @option options [String] :storage_class
725
- # The type of storage to use for the object. Defaults to 'STANDARD'.
775
+ # If you don't specify, Standard is the default storage class. Amazon
776
+ # S3 supports other storage classes.
726
777
  # @option options [String] :website_redirect_location
727
778
  # If the bucket is configured as a website, redirects requests for this
728
779
  # object to another object in the same bucket or to an external URL.
729
- # Amazon S3 stores the value of this header in the object metadata.
780
+ # Amazon S3 stores the value of this header in the object metadata. For
781
+ # information about object metadata, see .
782
+ #
783
+ # In the following example, the request header sets the redirect to an
784
+ # object (anotherPage.html) in the same bucket:
785
+ #
786
+ # `x-amz-website-redirect-location: /anotherPage.html`
787
+ #
788
+ # In the following example, the request header sets the object redirect
789
+ # to another website:
790
+ #
791
+ # `x-amz-website-redirect-location: http://www.example.com/`
792
+ #
793
+ # For more information about website hosting in Amazon S3, see [Hosting
794
+ # Websites on Amazon S3][1] and [How to Configure Website Page
795
+ # Redirects][2].
796
+ #
797
+ #
798
+ #
799
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
800
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html
730
801
  # @option options [String] :sse_customer_algorithm
731
802
  # Specifies the algorithm to use to when encrypting the object (e.g.,
732
803
  # AES256).
@@ -741,11 +812,16 @@ module Aws::S3
741
812
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
742
813
  # ensure the encryption key was transmitted without error.
743
814
  # @option options [String] :ssekms_key_id
744
- # Specifies the AWS KMS key ID to use for object encryption. All GET and
745
- # PUT requests for an object protected by AWS KMS will fail if not made
746
- # via SSL or using SigV4. Documentation on configuring any of the
747
- # officially supported AWS SDKs and CLI can be found at
748
- # http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
815
+ # If the x-amz-server-side-encryption is present and has the value of
816
+ # aws:kms, this header specifies the ID of the AWS Key Management
817
+ # Service (AWS KMS) customer master key (CMK) that was used for the
818
+ # object.
819
+ #
820
+ # If the value of x-amz-server-side-encryption is aws:kms, this header
821
+ # specifies the ID of the AWS KMS CMK that will be used for the object.
822
+ # If you specify x-amz-server-side-encryption:aws:kms, but do not
823
+ # provide x-amz-server-side-encryption-aws-kms-key-id, Amazon S3 uses
824
+ # the AWS managed CMK in AWS to protect the data.
749
825
  # @option options [String] :ssekms_encryption_context
750
826
  # Specifies the AWS KMS Encryption Context to use for object encryption.
751
827
  # The value of this header is a base64-encoded UTF-8 string holding JSON
@@ -760,11 +836,16 @@ module Aws::S3
760
836
  # The tag-set for the object. The tag-set must be encoded as URL Query
761
837
  # parameters. (For example, "Key1=Value1")
762
838
  # @option options [String] :object_lock_mode
763
- # The object lock mode that you want to apply to this object.
839
+ # The Object Lock mode that you want to apply to this object.
764
840
  # @option options [Time,DateTime,Date,Integer,String] :object_lock_retain_until_date
765
- # The date and time when you want this object's object lock to expire.
841
+ # The date and time when you want this object's Object Lock to expire.
766
842
  # @option options [String] :object_lock_legal_hold_status
767
- # The Legal Hold status that you want to apply to the specified object.
843
+ # Specifies whether a legal hold will be applied to this object. For
844
+ # more information about S3 Object Lock, see [Object Lock][1].
845
+ #
846
+ #
847
+ #
848
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
768
849
  # @return [Types::PutObjectOutput]
769
850
  def put(options = {})
770
851
  options = options.merge(
@@ -864,7 +945,9 @@ module Aws::S3
864
945
  # })
865
946
  # @param [Hash] options ({})
866
947
  # @option options [String] :version_id
948
+ # VersionId used to reference a specific version of the object.
867
949
  # @option options [Types::RestoreRequest] :restore_request
950
+ # Container for restore job parameters.
868
951
  # @option options [String] :request_payer
869
952
  # Confirms that the requester knows that she or he will be charged for
870
953
  # the request. Bucket owners need not specify this parameter in their
@@ -1005,6 +1088,8 @@ module Aws::S3
1005
1088
  # @option options [String] :mfa
1006
1089
  # The concatenation of the authentication device's serial number, a
1007
1090
  # space, and the value that is displayed on your authentication device.
1091
+ # Required to permanently delete a versioned object if versioning is
1092
+ # configured with MFA Delete enabled.
1008
1093
  # @option options [String] :request_payer
1009
1094
  # Confirms that the requester knows that she or he will be charged for
1010
1095
  # the request. Bucket owners need not specify this parameter in their
@@ -1013,7 +1098,7 @@ module Aws::S3
1013
1098
  # http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
1014
1099
  # @option options [Boolean] :bypass_governance_retention
1015
1100
  # Specifies whether you want to delete this object even if it has a
1016
- # Governance-type object lock in place. You must have sufficient
1101
+ # Governance-type Object Lock in place. You must have sufficient
1017
1102
  # permissions to perform this operation.
1018
1103
  # @return [void]
1019
1104
  def batch_delete!(options = {})
@@ -46,7 +46,7 @@ module Aws::S3
46
46
  @id
47
47
  end
48
48
 
49
-
49
+ # The entity tag is an MD5 hash of that version of the object
50
50
  # @return [String]
51
51
  def etag
52
52
  data[:etag]
@@ -89,7 +89,7 @@ module Aws::S3
89
89
  data[:last_modified]
90
90
  end
91
91
 
92
-
92
+ # Specifies the Owner of the object.
93
93
  # @return [Types::Owner]
94
94
  def owner
95
95
  data[:owner]
@@ -233,6 +233,8 @@ module Aws::S3
233
233
  # @option options [String] :mfa
234
234
  # The concatenation of the authentication device's serial number, a
235
235
  # space, and the value that is displayed on your authentication device.
236
+ # Required to permanently delete a versionedobject if versioning is
237
+ # configured with MFA Deleteenabled.
236
238
  # @option options [String] :request_payer
237
239
  # Confirms that the requester knows that she or he will be charged for
238
240
  # the request. Bucket owners need not specify this parameter in their
@@ -240,7 +242,7 @@ module Aws::S3
240
242
  # buckets can be found at
241
243
  # http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
242
244
  # @option options [Boolean] :bypass_governance_retention
243
- # Indicates whether Amazon S3 object lock should bypass governance-mode
245
+ # Indicates whether S3 Object Lock should bypass Governance-mode
244
246
  # restrictions to process this operation.
245
247
  # @return [Types::DeleteObjectOutput]
246
248
  def delete(options = {})
@@ -475,6 +477,8 @@ module Aws::S3
475
477
  # @option options [String] :mfa
476
478
  # The concatenation of the authentication device's serial number, a
477
479
  # space, and the value that is displayed on your authentication device.
480
+ # Required to permanently delete a versioned object if versioning is
481
+ # configured with MFA Delete enabled.
478
482
  # @option options [String] :request_payer
479
483
  # Confirms that the requester knows that she or he will be charged for
480
484
  # the request. Bucket owners need not specify this parameter in their
@@ -483,7 +487,7 @@ module Aws::S3
483
487
  # http://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
484
488
  # @option options [Boolean] :bypass_governance_retention
485
489
  # Specifies whether you want to delete this object even if it has a
486
- # Governance-type object lock in place. You must have sufficient
490
+ # Governance-type Object Lock in place. You must have sufficient
487
491
  # permissions to perform this operation.
488
492
  # @return [void]
489
493
  def batch_delete!(options = {})
@@ -17,6 +17,8 @@ module Aws
17
17
  end
18
18
 
19
19
  option(:sigv4_region) do |cfg|
20
+ raise Aws::Errors::MissingRegionError if cfg.region.nil?
21
+
20
22
  Aws::Partitions::EndpointProvider.signing_region(cfg.region, 's3')
21
23
  end
22
24
 
@@ -40,7 +40,9 @@ module Aws::S3
40
40
  # @option options [String] :acl
41
41
  # The canned ACL to apply to the bucket.
42
42
  # @option options [required, String] :bucket
43
+ # The name of the bucket to create.
43
44
  # @option options [Types::CreateBucketConfiguration] :create_bucket_configuration
45
+ # The configuration information for the bucket.
44
46
  # @option options [String] :grant_full_control
45
47
  # Allows grantee the read, write, read ACP, and write ACP permissions on
46
48
  # the bucket.
@@ -54,8 +56,8 @@ module Aws::S3
54
56
  # @option options [String] :grant_write_acp
55
57
  # Allows grantee to write the ACL for the applicable bucket.
56
58
  # @option options [Boolean] :object_lock_enabled_for_bucket
57
- # Specifies whether you want Amazon S3 object lock to be enabled for the
58
- # new bucket.
59
+ # Specifies whether you want S3 Object Lock to be enabled for the new
60
+ # bucket.
59
61
  # @return [Bucket]
60
62
  def create_bucket(options = {})
61
63
  resp = @client.create_bucket(options)
@@ -60,7 +60,7 @@ module Aws::S3
60
60
  # }
61
61
  #
62
62
  # @!attribute [rw] bucket
63
- # Name of the bucket to which the multipart upload was initiated.
63
+ # The bucket to which the upload was taking place.
64
64
  # @return [String]
65
65
  #
66
66
  # @!attribute [rw] key
@@ -220,13 +220,6 @@ module Aws::S3
220
220
  # Specifies the configuration and any analyses for the analytics filter
221
221
  # of an Amazon S3 bucket.
222
222
  #
223
- # For more information, see [GET Bucket analytics][1] in the *Amazon
224
- # Simple Storage Service API Reference*.
225
- #
226
- #
227
- #
228
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketGETAnalyticsConfig.html
229
- #
230
223
  # @note When making an API call, you may pass AnalyticsConfiguration
231
224
  # data as a hash:
232
225
  #
@@ -314,6 +307,11 @@ module Aws::S3
314
307
  include Aws::Structure
315
308
  end
316
309
 
310
+ # The filter used to describe a set of objects for analyses. A filter
311
+ # must have exactly one prefix, one tag, or one conjunction
312
+ # (AnalyticsAndOperator). If no filter is provided, all objects will be
313
+ # considered in any analysis.
314
+ #
317
315
  # @note When making an API call, you may pass AnalyticsFilter
318
316
  # data as a hash:
319
317
  #
@@ -357,6 +355,8 @@ module Aws::S3
357
355
  include Aws::Structure
358
356
  end
359
357
 
358
+ # Contains information about where to publish the analytics results.
359
+ #
360
360
  # @note When making an API call, you may pass AnalyticsS3BucketDestination
361
361
  # data as a hash:
362
362
  #
@@ -396,6 +396,10 @@ module Aws::S3
396
396
  include Aws::Structure
397
397
  end
398
398
 
399
+ # In terms of implementation, a Bucket is a resource. An Amazon S3
400
+ # bucket name is globally unique, and the namespace is shared by all AWS
401
+ # accounts.
402
+ #
399
403
  # @!attribute [rw] name
400
404
  # The name of the bucket.
401
405
  # @return [String]
@@ -484,6 +488,8 @@ module Aws::S3
484
488
  include Aws::Structure
485
489
  end
486
490
 
491
+ # Container for logging status information.
492
+ #
487
493
  # @note When making an API call, you may pass BucketLoggingStatus
488
494
  # data as a hash:
489
495
  #
@@ -507,6 +513,14 @@ module Aws::S3
507
513
  # }
508
514
  #
509
515
  # @!attribute [rw] logging_enabled
516
+ # Describes where logs are stored and the prefix that Amazon S3
517
+ # assigns to all log object keys for a bucket. For more information,
518
+ # see [PUT Bucket logging][1] in the *Amazon Simple Storage Service
519
+ # API Reference*.
520
+ #
521
+ #
522
+ #
523
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlogging.html
510
524
  # @return [Types::LoggingEnabled]
511
525
  #
512
526
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/BucketLoggingStatus AWS API Documentation
@@ -541,7 +555,8 @@ module Aws::S3
541
555
  # }
542
556
  #
543
557
  # @!attribute [rw] cors_rules
544
- # A set of allowed origins and methods.
558
+ # A set of origins and methods (cross-origin access that you want to
559
+ # allow). You can add up to 100 rules to the configuration.
545
560
  # @return [Array<Types::CORSRule>]
546
561
  #
547
562
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CORSConfiguration AWS API Documentation
@@ -603,7 +618,8 @@ module Aws::S3
603
618
  include Aws::Structure
604
619
  end
605
620
 
606
- # Describes how a CSV-formatted input object is formatted.
621
+ # Describes how a uncompressed comma-separated values (CSV)-formatted
622
+ # input object is formatted.
607
623
  #
608
624
  # @note When making an API call, you may pass CSVInput
609
625
  # data as a hash:
@@ -619,30 +635,53 @@ module Aws::S3
619
635
  # }
620
636
  #
621
637
  # @!attribute [rw] file_header_info
622
- # Describes the first line of input. Valid values: None, Ignore, Use.
638
+ # Describes the first line of input. Valid values are:
639
+ #
640
+ # * `NONE`\: First line is not a header.
641
+ #
642
+ # * `IGNORE`\: First line is a header, but you can't use the header
643
+ # values to indicate the column in an expression. You can use column
644
+ # position (such as \_1, \_2, …) to indicate the column (`SELECT
645
+ # s._1 FROM OBJECT s`).
646
+ #
647
+ # * `Use`\: First line is a header, and you can use the header value
648
+ # to identify a column in an expression (`SELECT "name" FROM
649
+ # OBJECT`).
623
650
  # @return [String]
624
651
  #
625
652
  # @!attribute [rw] comments
626
- # The single character used to indicate a row should be ignored when
627
- # present at the start of a row.
653
+ # A single character used to indicate that a row should be ignored
654
+ # when the character is present at the start of that row. You can
655
+ # specify any character to indicate a comment line.
628
656
  # @return [String]
629
657
  #
630
658
  # @!attribute [rw] quote_escape_character
631
- # The single character used for escaping the quote character inside an
632
- # already escaped value.
659
+ # A single character used for escaping the quotation mark character
660
+ # inside an already escaped value. For example, the value """ a , b
661
+ # """ is parsed as " a , b ".
633
662
  # @return [String]
634
663
  #
635
664
  # @!attribute [rw] record_delimiter
636
- # The value used to separate individual records.
665
+ # A single character used to separate individual records in the input.
666
+ # Instead of the default value, you can specify an arbitrary
667
+ # delimiter.
637
668
  # @return [String]
638
669
  #
639
670
  # @!attribute [rw] field_delimiter
640
- # The value used to separate individual fields in a record.
671
+ # A single character used to separate individual fields in a record.
672
+ # You can specify an arbitrary delimiter.
641
673
  # @return [String]
642
674
  #
643
675
  # @!attribute [rw] quote_character
644
- # Value used for escaping where the field delimiter is part of the
645
- # value.
676
+ # A single character used for escaping when the field delimiter is
677
+ # part of the value. For example, if the value is `a, b`, Amazon S3
678
+ # wraps this field value in quotation marks, as follows: `" a , b "`.
679
+ #
680
+ # Type: String
681
+ #
682
+ # Default: `"`
683
+ #
684
+ # Ancestors: `CSV`
646
685
  # @return [String]
647
686
  #
648
687
  # @!attribute [rw] allow_quoted_record_delimiter
@@ -664,7 +703,8 @@ module Aws::S3
664
703
  include Aws::Structure
665
704
  end
666
705
 
667
- # Describes how CSV-formatted results are formatted.
706
+ # Describes how uncompressed comma-separated values (CSV)-formatted
707
+ # results are formatted.
668
708
  #
669
709
  # @note When making an API call, you may pass CSVOutput
670
710
  # data as a hash:
@@ -678,25 +718,33 @@ module Aws::S3
678
718
  # }
679
719
  #
680
720
  # @!attribute [rw] quote_fields
681
- # Indicates whether or not all output fields should be quoted.
721
+ # Indicates whether to use quotation marks around output fields.
722
+ #
723
+ # * `ALWAYS`\: Always use quotation marks for output fields.
724
+ #
725
+ # * `ASNEEDED`\: Use quotation marks for output fields when needed.
682
726
  # @return [String]
683
727
  #
684
728
  # @!attribute [rw] quote_escape_character
685
- # Th single character used for escaping the quote character inside an
729
+ # The single character used for escaping the quote character inside an
686
730
  # already escaped value.
687
731
  # @return [String]
688
732
  #
689
733
  # @!attribute [rw] record_delimiter
690
- # The value used to separate individual records.
734
+ # A single character used to separate individual records in the
735
+ # output. Instead of the default value, you can specify an arbitrary
736
+ # delimiter.
691
737
  # @return [String]
692
738
  #
693
739
  # @!attribute [rw] field_delimiter
694
- # The value used to separate individual fields in a record.
740
+ # The value used to separate individual fields in a record. You can
741
+ # specify an arbitrary delimiter.
695
742
  # @return [String]
696
743
  #
697
744
  # @!attribute [rw] quote_character
698
- # The value used for escaping where the field delimiter is part of the
699
- # value.
745
+ # A single character used for escaping when the field delimiter is
746
+ # part of the value. For example, if the value is `a, b`, Amazon S3
747
+ # wraps this field value in quotation marks, as follows: `" a , b "`.
700
748
  # @return [String]
701
749
  #
702
750
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CSVOutput AWS API Documentation
@@ -710,6 +758,8 @@ module Aws::S3
710
758
  include Aws::Structure
711
759
  end
712
760
 
761
+ # Container for specifying the AWS Lambda notification configuration.
762
+ #
713
763
  # @note When making an API call, you may pass CloudFunctionConfiguration
714
764
  # data as a hash:
715
765
  #
@@ -732,12 +782,16 @@ module Aws::S3
732
782
  # @return [String]
733
783
  #
734
784
  # @!attribute [rw] events
785
+ # Bucket events for which to send notifications.
735
786
  # @return [Array<String>]
736
787
  #
737
788
  # @!attribute [rw] cloud_function
789
+ # Lambda cloud function ARN that Amazon S3 can invoke when it detects
790
+ # events of the specified type.
738
791
  # @return [String]
739
792
  #
740
793
  # @!attribute [rw] invocation_role
794
+ # The role supporting the invocation of the lambda function
741
795
  # @return [String]
742
796
  #
743
797
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CloudFunctionConfiguration AWS API Documentation
@@ -751,7 +805,14 @@ module Aws::S3
751
805
  include Aws::Structure
752
806
  end
753
807
 
808
+ # Container for all (if there are any) keys between Prefix and the next
809
+ # occurrence of the string specified by a delimiter. CommonPrefixes
810
+ # lists keys that act like subdirectories in the directory specified by
811
+ # Prefix. For example, if the prefix is notes/ and the delimiter is a
812
+ # slash (/) as in notes/summer/july, the common prefix is notes/summer/.
813
+ #
754
814
  # @!attribute [rw] prefix
815
+ # Container for the specified common prefix.
755
816
  # @return [String]
756
817
  #
757
818
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CommonPrefix AWS API Documentation
@@ -762,12 +823,15 @@ module Aws::S3
762
823
  end
763
824
 
764
825
  # @!attribute [rw] location
826
+ # The URI that identifies the newly created object.
765
827
  # @return [String]
766
828
  #
767
829
  # @!attribute [rw] bucket
830
+ # The name of the bucket that contains the newly created object.
768
831
  # @return [String]
769
832
  #
770
833
  # @!attribute [rw] key
834
+ # The object key of the newly created object.
771
835
  # @return [String]
772
836
  #
773
837
  # @!attribute [rw] expiration
@@ -777,21 +841,31 @@ module Aws::S3
777
841
  # @return [String]
778
842
  #
779
843
  # @!attribute [rw] etag
780
- # Entity tag of the object.
844
+ # Entity tag that identifies the newly created object's data. Objects
845
+ # with different object data will have different entity tags. The
846
+ # entity tag is an opaque string. The entity tag may or may not be an
847
+ # MD5 digest of the object data. If the entity tag is not an MD5
848
+ # digest of the object data, it will contain one or more
849
+ # nonhexadecimal characters and/or will consist of less than 32 or
850
+ # more than 32 hexadecimal digits.
781
851
  # @return [String]
782
852
  #
783
853
  # @!attribute [rw] server_side_encryption
784
- # The Server-side encryption algorithm used when storing this object
785
- # in S3 (e.g., AES256, aws:kms).
854
+ # If you specified server-side encryption either with an Amazon
855
+ # S3-managed encryption key or an AWS KMS customer master key (CMK) in
856
+ # your initiate multipart upload request, the response includes this
857
+ # header. It confirms the encryption algorithm that Amazon S3 used to
858
+ # encrypt the object.
786
859
  # @return [String]
787
860
  #
788
861
  # @!attribute [rw] version_id
789
- # Version of the object.
862
+ # Version ID of the newly created object, in case the bucket has
863
+ # versioning turned on.
790
864
  # @return [String]
791
865
  #
792
866
  # @!attribute [rw] ssekms_key_id
793
867
  # If present, specifies the ID of the AWS Key Management Service (KMS)
794
- # master encryption key that was used for the object.
868
+ # customer master key (CMK) that was used for the object.
795
869
  # @return [String]
796
870
  #
797
871
  # @!attribute [rw] request_charged
@@ -833,15 +907,19 @@ module Aws::S3
833
907
  # }
834
908
  #
835
909
  # @!attribute [rw] bucket
910
+ # Name of the bucket to which the multipart upload was initiated.
836
911
  # @return [String]
837
912
  #
838
913
  # @!attribute [rw] key
914
+ # Object key for which the multipart upload was initiated.
839
915
  # @return [String]
840
916
  #
841
917
  # @!attribute [rw] multipart_upload
918
+ # The container for the multipart upload request information.
842
919
  # @return [Types::CompletedMultipartUpload]
843
920
  #
844
921
  # @!attribute [rw] upload_id
922
+ # ID for the initiated multipart upload.
845
923
  # @return [String]
846
924
  #
847
925
  # @!attribute [rw] request_payer
@@ -863,6 +941,8 @@ module Aws::S3
863
941
  include Aws::Structure
864
942
  end
865
943
 
944
+ # The container for the completed multipart upload details.
945
+ #
866
946
  # @note When making an API call, you may pass CompletedMultipartUpload
867
947
  # data as a hash:
868
948
  #
@@ -876,6 +956,7 @@ module Aws::S3
876
956
  # }
877
957
  #
878
958
  # @!attribute [rw] parts
959
+ # Array of CompletedPart data types.
879
960
  # @return [Array<Types::CompletedPart>]
880
961
  #
881
962
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CompletedMultipartUpload AWS API Documentation
@@ -885,6 +966,8 @@ module Aws::S3
885
966
  include Aws::Structure
886
967
  end
887
968
 
969
+ # Details of the parts that were uploaded.
970
+ #
888
971
  # @note When making an API call, you may pass CompletedPart
889
972
  # data as a hash:
890
973
  #
@@ -910,7 +993,11 @@ module Aws::S3
910
993
  include Aws::Structure
911
994
  end
912
995
 
913
- # Specifies a condition that must be met for a redirect to apply.
996
+ # A container for describing a condition that must be met for the
997
+ # specified redirect to apply. For example, 1. If request is for pages
998
+ # in the `/docs` folder, redirect to the `/documents` folder. 2. If
999
+ # request results in HTTP error 4xx, redirect request to another host
1000
+ # where you might process the error.
914
1001
  #
915
1002
  # @note When making an API call, you may pass Condition
916
1003
  # data as a hash:
@@ -956,6 +1043,7 @@ module Aws::S3
956
1043
  end
957
1044
 
958
1045
  # @!attribute [rw] copy_object_result
1046
+ # Container for all response elements.
959
1047
  # @return [Types::CopyObjectResult]
960
1048
  #
961
1049
  # @!attribute [rw] expiration
@@ -964,6 +1052,7 @@ module Aws::S3
964
1052
  # @return [String]
965
1053
  #
966
1054
  # @!attribute [rw] copy_source_version_id
1055
+ # Version of the copied object in the destination bucket.
967
1056
  # @return [String]
968
1057
  #
969
1058
  # @!attribute [rw] version_id
@@ -990,7 +1079,7 @@ module Aws::S3
990
1079
  #
991
1080
  # @!attribute [rw] ssekms_key_id
992
1081
  # If present, specifies the ID of the AWS Key Management Service (KMS)
993
- # master encryption key that was used for the object.
1082
+ # customer master key (CMK) that was used for the object.
994
1083
  # @return [String]
995
1084
  #
996
1085
  # @!attribute [rw] ssekms_encryption_context
@@ -1071,6 +1160,7 @@ module Aws::S3
1071
1160
  # @return [String]
1072
1161
  #
1073
1162
  # @!attribute [rw] bucket
1163
+ # The name of the destination bucket.
1074
1164
  # @return [String]
1075
1165
  #
1076
1166
  # @!attribute [rw] cache_control
@@ -1141,6 +1231,7 @@ module Aws::S3
1141
1231
  # @return [String]
1142
1232
  #
1143
1233
  # @!attribute [rw] key
1234
+ # The key of the destination object.
1144
1235
  # @return [String]
1145
1236
  #
1146
1237
  # @!attribute [rw] metadata
@@ -1238,11 +1329,11 @@ module Aws::S3
1238
1329
  # @return [String]
1239
1330
  #
1240
1331
  # @!attribute [rw] object_lock_mode
1241
- # The object lock mode that you want to apply to the copied object.
1332
+ # The Object Lock mode that you want to apply to the copied object.
1242
1333
  # @return [String]
1243
1334
  #
1244
1335
  # @!attribute [rw] object_lock_retain_until_date
1245
- # The date and time when you want the copied object's object lock to
1336
+ # The date and time when you want the copied object's Object Lock to
1246
1337
  # expire.
1247
1338
  # @return [Time]
1248
1339
  #
@@ -1294,10 +1385,16 @@ module Aws::S3
1294
1385
  include Aws::Structure
1295
1386
  end
1296
1387
 
1388
+ # &gt;Container for all response elements.
1389
+ #
1297
1390
  # @!attribute [rw] etag
1391
+ # Returns the ETag of the new object. The ETag reflects only changes
1392
+ # to the contents of an object, not its metadata. The source and
1393
+ # destination ETag is identical for a successfully copied object.
1298
1394
  # @return [String]
1299
1395
  #
1300
1396
  # @!attribute [rw] last_modified
1397
+ # Returns the date that the object was last modified.
1301
1398
  # @return [Time]
1302
1399
  #
1303
1400
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CopyObjectResult AWS API Documentation
@@ -1308,6 +1405,8 @@ module Aws::S3
1308
1405
  include Aws::Structure
1309
1406
  end
1310
1407
 
1408
+ # Container for all response elements.
1409
+ #
1311
1410
  # @!attribute [rw] etag
1312
1411
  # Entity tag of the object.
1313
1412
  # @return [String]
@@ -1324,6 +1423,8 @@ module Aws::S3
1324
1423
  include Aws::Structure
1325
1424
  end
1326
1425
 
1426
+ # The configuration information for the bucket.
1427
+ #
1327
1428
  # @note When making an API call, you may pass CreateBucketConfiguration
1328
1429
  # data as a hash:
1329
1430
  #
@@ -1345,6 +1446,9 @@ module Aws::S3
1345
1446
  end
1346
1447
 
1347
1448
  # @!attribute [rw] location
1449
+ # Specifies the region where the bucket will be created. If you are
1450
+ # creating a bucket on the US East (N. Virginia) region (us-east-1),
1451
+ # you do not need to specify the location.
1348
1452
  # @return [String]
1349
1453
  #
1350
1454
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketOutput AWS API Documentation
@@ -1376,9 +1480,11 @@ module Aws::S3
1376
1480
  # @return [String]
1377
1481
  #
1378
1482
  # @!attribute [rw] bucket
1483
+ # The name of the bucket to create.
1379
1484
  # @return [String]
1380
1485
  #
1381
1486
  # @!attribute [rw] create_bucket_configuration
1487
+ # The configuration information for the bucket.
1382
1488
  # @return [Types::CreateBucketConfiguration]
1383
1489
  #
1384
1490
  # @!attribute [rw] grant_full_control
@@ -1404,8 +1510,8 @@ module Aws::S3
1404
1510
  # @return [String]
1405
1511
  #
1406
1512
  # @!attribute [rw] object_lock_enabled_for_bucket
1407
- # Specifies whether you want Amazon S3 object lock to be enabled for
1408
- # the new bucket.
1513
+ # Specifies whether you want S3 Object Lock to be enabled for the new
1514
+ # bucket.
1409
1515
  # @return [Boolean]
1410
1516
  #
1411
1517
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/CreateBucketRequest AWS API Documentation
@@ -1424,13 +1530,27 @@ module Aws::S3
1424
1530
  end
1425
1531
 
1426
1532
  # @!attribute [rw] abort_date
1427
- # Date when multipart upload will become eligible for abort operation
1428
- # by lifecycle.
1533
+ # If the bucket has a lifecycle rule configured with an action to
1534
+ # abort incomplete multipart uploads and the prefix in the lifecycle
1535
+ # rule matches the object name in the request, the response includes
1536
+ # this header. The header indicates when the initiated multipart
1537
+ # upload becomes eligible for an abort operation. For more
1538
+ # information, see [ Aborting Incomplete Multipart Uploads Using a
1539
+ # Bucket Lifecycle Policy][1].
1540
+ #
1541
+ # The response also includes the x-amz-abort-rule-id header that
1542
+ # provides the ID of the lifecycle configuration rule that defines
1543
+ # this action.
1544
+ #
1545
+ #
1546
+ #
1547
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
1429
1548
  # @return [Time]
1430
1549
  #
1431
1550
  # @!attribute [rw] abort_rule_id
1432
- # Id of the lifecycle rule that makes a multipart upload eligible for
1433
- # abort operation.
1551
+ # This header is returned along with the x-amz-abort-date header. It
1552
+ # identifies the applicable lifecycle configuration rule that defines
1553
+ # the action to abort incomplete multipart uploads.
1434
1554
  # @return [String]
1435
1555
  #
1436
1556
  # @!attribute [rw] bucket
@@ -1465,7 +1585,7 @@ module Aws::S3
1465
1585
  #
1466
1586
  # @!attribute [rw] ssekms_key_id
1467
1587
  # If present, specifies the ID of the AWS Key Management Service (KMS)
1468
- # master encryption key that was used for the object.
1588
+ # customer master key (CMK) that was used for the object.
1469
1589
  # @return [String]
1470
1590
  #
1471
1591
  # @!attribute [rw] ssekms_encryption_context
@@ -1537,6 +1657,7 @@ module Aws::S3
1537
1657
  # @return [String]
1538
1658
  #
1539
1659
  # @!attribute [rw] bucket
1660
+ # The name of the bucket to which to initiate the upload
1540
1661
  # @return [String]
1541
1662
  #
1542
1663
  # @!attribute [rw] cache_control
@@ -1583,6 +1704,7 @@ module Aws::S3
1583
1704
  # @return [String]
1584
1705
  #
1585
1706
  # @!attribute [rw] key
1707
+ # Object key for which the multipart upload is to be initiated.
1586
1708
  # @return [String]
1587
1709
  #
1588
1710
  # @!attribute [rw] metadata
@@ -1652,12 +1774,12 @@ module Aws::S3
1652
1774
  # @return [String]
1653
1775
  #
1654
1776
  # @!attribute [rw] object_lock_mode
1655
- # Specifies the object lock mode that you want to apply to the
1777
+ # Specifies the Object Lock mode that you want to apply to the
1656
1778
  # uploaded object.
1657
1779
  # @return [String]
1658
1780
  #
1659
1781
  # @!attribute [rw] object_lock_retain_until_date
1660
- # Specifies the date and time when you want the object lock to expire.
1782
+ # Specifies the date and time when you want the Object Lock to expire.
1661
1783
  # @return [Time]
1662
1784
  #
1663
1785
  # @!attribute [rw] object_lock_legal_hold_status
@@ -1698,7 +1820,7 @@ module Aws::S3
1698
1820
  include Aws::Structure
1699
1821
  end
1700
1822
 
1701
- # The container element for specifying the default object lock retention
1823
+ # The container element for specifying the default Object Lock retention
1702
1824
  # settings for new objects placed in the specified bucket.
1703
1825
  #
1704
1826
  # @note When making an API call, you may pass DefaultRetention
@@ -1711,7 +1833,7 @@ module Aws::S3
1711
1833
  # }
1712
1834
  #
1713
1835
  # @!attribute [rw] mode
1714
- # The default object lock retention mode you want to apply to new
1836
+ # The default Object Lock retention mode you want to apply to new
1715
1837
  # objects placed in the specified bucket.
1716
1838
  # @return [String]
1717
1839
  #
@@ -1734,6 +1856,8 @@ module Aws::S3
1734
1856
  include Aws::Structure
1735
1857
  end
1736
1858
 
1859
+ # Container for the objects to delete.
1860
+ #
1737
1861
  # @note When making an API call, you may pass Delete
1738
1862
  # data as a hash:
1739
1863
  #
@@ -1748,6 +1872,7 @@ module Aws::S3
1748
1872
  # }
1749
1873
  #
1750
1874
  # @!attribute [rw] objects
1875
+ # The objects to delete.
1751
1876
  # @return [Array<Types::ObjectIdentifier>]
1752
1877
  #
1753
1878
  # @!attribute [rw] quiet
@@ -1796,6 +1921,7 @@ module Aws::S3
1796
1921
  # }
1797
1922
  #
1798
1923
  # @!attribute [rw] bucket
1924
+ # Specifies the bucket whose `cors` configuration is being deleted.
1799
1925
  # @return [String]
1800
1926
  #
1801
1927
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketCorsRequest AWS API Documentation
@@ -1857,6 +1983,7 @@ module Aws::S3
1857
1983
  # }
1858
1984
  #
1859
1985
  # @!attribute [rw] bucket
1986
+ # The bucket name of the lifecycle to delete.
1860
1987
  # @return [String]
1861
1988
  #
1862
1989
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketLifecycleRequest AWS API Documentation
@@ -1899,6 +2026,7 @@ module Aws::S3
1899
2026
  # }
1900
2027
  #
1901
2028
  # @!attribute [rw] bucket
2029
+ # The bucket name.
1902
2030
  # @return [String]
1903
2031
  #
1904
2032
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketPolicyRequest AWS API Documentation
@@ -1917,11 +2045,6 @@ module Aws::S3
1917
2045
  #
1918
2046
  # @!attribute [rw] bucket
1919
2047
  # The bucket name.
1920
- #
1921
- # <note markdown="1"> It can take a while to propagate the deletion of a replication
1922
- # configuration to all Amazon S3 systems.
1923
- #
1924
- # </note>
1925
2048
  # @return [String]
1926
2049
  #
1927
2050
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketReplicationRequest AWS API Documentation
@@ -1939,6 +2062,7 @@ module Aws::S3
1939
2062
  # }
1940
2063
  #
1941
2064
  # @!attribute [rw] bucket
2065
+ # Specifies the bucket being deleted.
1942
2066
  # @return [String]
1943
2067
  #
1944
2068
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketRequest AWS API Documentation
@@ -1956,6 +2080,7 @@ module Aws::S3
1956
2080
  # }
1957
2081
  #
1958
2082
  # @!attribute [rw] bucket
2083
+ # The bucket that has the tag set to be removed.
1959
2084
  # @return [String]
1960
2085
  #
1961
2086
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketTaggingRequest AWS API Documentation
@@ -1973,6 +2098,8 @@ module Aws::S3
1973
2098
  # }
1974
2099
  #
1975
2100
  # @!attribute [rw] bucket
2101
+ # The bucket name for which you want to remove the website
2102
+ # configuration.
1976
2103
  # @return [String]
1977
2104
  #
1978
2105
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteBucketWebsiteRequest AWS API Documentation
@@ -1982,7 +2109,10 @@ module Aws::S3
1982
2109
  include Aws::Structure
1983
2110
  end
1984
2111
 
2112
+ # Information about the delete marker.
2113
+ #
1985
2114
  # @!attribute [rw] owner
2115
+ # The account that created the delete marker.&gt;
1986
2116
  # @return [Types::Owner]
1987
2117
  #
1988
2118
  # @!attribute [rw] key
@@ -2013,7 +2143,25 @@ module Aws::S3
2013
2143
  include Aws::Structure
2014
2144
  end
2015
2145
 
2016
- # Specifies whether Amazon S3 should replicate delete makers.
2146
+ # Specifies whether Amazon S3 replicates the delete markers. If you
2147
+ # specify a `Filter`, you must specify this element. However, in the
2148
+ # latest version of replication configuration (when `Filter` is
2149
+ # specified), Amazon S3 doesn't replicate delete markers. Therefore,
2150
+ # the `DeleteMarkerReplication` element can contain only
2151
+ # &lt;Status&gt;Disabled&lt;/Status&gt;. For an example configuration,
2152
+ # see [Basic Rule Configuration][1].
2153
+ #
2154
+ # <note markdown="1"> If you don't specify the Filter element, Amazon S3 assumes the
2155
+ # replication configuration is the earlier version, V1. In the earlier
2156
+ # version, Amazon S3 handled replication of delete markers differently.
2157
+ # For more information, see [Backward Compatibility][2].
2158
+ #
2159
+ # </note>
2160
+ #
2161
+ #
2162
+ #
2163
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-config-min-rule-config
2164
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations
2017
2165
  #
2018
2166
  # @note When making an API call, you may pass DeleteMarkerReplication
2019
2167
  # data as a hash:
@@ -2023,7 +2171,7 @@ module Aws::S3
2023
2171
  # }
2024
2172
  #
2025
2173
  # @!attribute [rw] status
2026
- # The status of the delete marker replication.
2174
+ # Indicates whether to replicate delete markers.
2027
2175
  #
2028
2176
  # <note markdown="1"> In the current implementation, Amazon S3 doesn't replicate the
2029
2177
  # delete markers. The status must be `Disabled`.
@@ -2075,15 +2223,18 @@ module Aws::S3
2075
2223
  # }
2076
2224
  #
2077
2225
  # @!attribute [rw] bucket
2226
+ # The bucket name of the bucket containing the object.
2078
2227
  # @return [String]
2079
2228
  #
2080
2229
  # @!attribute [rw] key
2230
+ # Key name of the object to delete.
2081
2231
  # @return [String]
2082
2232
  #
2083
2233
  # @!attribute [rw] mfa
2084
2234
  # The concatenation of the authentication device's serial number, a
2085
2235
  # space, and the value that is displayed on your authentication
2086
- # device.
2236
+ # device. Required to permanently delete a versionedobject if
2237
+ # versioning is configured with MFA Deleteenabled.
2087
2238
  # @return [String]
2088
2239
  #
2089
2240
  # @!attribute [rw] version_id
@@ -2099,8 +2250,8 @@ module Aws::S3
2099
2250
  # @return [String]
2100
2251
  #
2101
2252
  # @!attribute [rw] bypass_governance_retention
2102
- # Indicates whether Amazon S3 object lock should bypass
2103
- # governance-mode restrictions to process this operation.
2253
+ # Indicates whether S3 Object Lock should bypass Governance-mode
2254
+ # restrictions to process this operation.
2104
2255
  # @return [Boolean]
2105
2256
  #
2106
2257
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjectRequest AWS API Documentation
@@ -2136,9 +2287,11 @@ module Aws::S3
2136
2287
  # }
2137
2288
  #
2138
2289
  # @!attribute [rw] bucket
2290
+ # The bucket containing the objects from which to remove the tags.
2139
2291
  # @return [String]
2140
2292
  #
2141
2293
  # @!attribute [rw] key
2294
+ # Name of the tag.
2142
2295
  # @return [String]
2143
2296
  #
2144
2297
  # @!attribute [rw] version_id
@@ -2155,6 +2308,8 @@ module Aws::S3
2155
2308
  end
2156
2309
 
2157
2310
  # @!attribute [rw] deleted
2311
+ # Container element for a successful delete. It identifies the object
2312
+ # that was successfully deleted.
2158
2313
  # @return [Array<Types::DeletedObject>]
2159
2314
  #
2160
2315
  # @!attribute [rw] request_charged
@@ -2163,6 +2318,8 @@ module Aws::S3
2163
2318
  # @return [String]
2164
2319
  #
2165
2320
  # @!attribute [rw] errors
2321
+ # Container for a failed delete operation that describes the object
2322
+ # that Amazon S3 attempted to delete and the error it encountered.
2166
2323
  # @return [Array<Types::Error>]
2167
2324
  #
2168
2325
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeleteObjectsOutput AWS API Documentation
@@ -2194,15 +2351,18 @@ module Aws::S3
2194
2351
  # }
2195
2352
  #
2196
2353
  # @!attribute [rw] bucket
2354
+ # The bucket name containing the objects to delete.
2197
2355
  # @return [String]
2198
2356
  #
2199
2357
  # @!attribute [rw] delete
2358
+ # Container for the request.
2200
2359
  # @return [Types::Delete]
2201
2360
  #
2202
2361
  # @!attribute [rw] mfa
2203
2362
  # The concatenation of the authentication device's serial number, a
2204
2363
  # space, and the value that is displayed on your authentication
2205
- # device.
2364
+ # device. Required to permanently delete a versioned object if
2365
+ # versioning is configured with MFA Delete enabled.
2206
2366
  # @return [String]
2207
2367
  #
2208
2368
  # @!attribute [rw] request_payer
@@ -2215,7 +2375,7 @@ module Aws::S3
2215
2375
  #
2216
2376
  # @!attribute [rw] bypass_governance_retention
2217
2377
  # Specifies whether you want to delete this object even if it has a
2218
- # Governance-type object lock in place. You must have sufficient
2378
+ # Governance-type Object Lock in place. You must have sufficient
2219
2379
  # permissions to perform this operation.
2220
2380
  # @return [Boolean]
2221
2381
  #
@@ -2249,16 +2409,28 @@ module Aws::S3
2249
2409
  include Aws::Structure
2250
2410
  end
2251
2411
 
2412
+ # Information about the deleted object.
2413
+ #
2252
2414
  # @!attribute [rw] key
2415
+ # The name of the deleted object.
2253
2416
  # @return [String]
2254
2417
  #
2255
2418
  # @!attribute [rw] version_id
2419
+ # The version ID of the deleted object.
2256
2420
  # @return [String]
2257
2421
  #
2258
2422
  # @!attribute [rw] delete_marker
2423
+ # Specifies whether the versioned object that was permanently deleted
2424
+ # was (true) or was not (false) a delete marker. In a simple DELETE,
2425
+ # this header indicates whether (true) or not (false) a delete marker
2426
+ # was created.
2259
2427
  # @return [Boolean]
2260
2428
  #
2261
2429
  # @!attribute [rw] delete_marker_version_id
2430
+ # The version ID of the delete marker created as a result of the
2431
+ # DELETE operation. If you delete a specific object version, the value
2432
+ # returned by this header is the version ID of the object version
2433
+ # deleted.
2262
2434
  # @return [String]
2263
2435
  #
2264
2436
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/DeletedObject AWS API Documentation
@@ -2291,11 +2463,7 @@ module Aws::S3
2291
2463
  #
2292
2464
  # @!attribute [rw] bucket
2293
2465
  # The Amazon Resource Name (ARN) of the bucket where you want Amazon
2294
- # S3 to store replicas of the object identified by the rule.
2295
- #
2296
- # A replication configuration can replicate objects to only one
2297
- # destination bucket. If there are multiple rules in your replication
2298
- # configuration, all rules must specify the same destination bucket.
2466
+ # S3 to store the results.
2299
2467
  # @return [String]
2300
2468
  #
2301
2469
  # @!attribute [rw] account
@@ -2303,13 +2471,13 @@ module Aws::S3
2303
2471
  # you direct Amazon S3 to change replica ownership to the AWS account
2304
2472
  # that owns the destination bucket by specifying the
2305
2473
  # `AccessControlTranslation` property, this is the account ID of the
2306
- # destination bucket owner. For more information, see [Cross-Region
2307
- # Replication Additional Configuration: Change Replica Owner][1] in
2308
- # the *Amazon Simple Storage Service Developer Guide*.
2474
+ # destination bucket owner. For more information, see [Replication
2475
+ # Additional Configuration: Change Replica Owner][1] in the *Amazon
2476
+ # Simple Storage Service Developer Guide*.
2309
2477
  #
2310
2478
  #
2311
2479
  #
2312
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/crr-change-owner.html
2480
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-change-owner.html
2313
2481
  # @return [String]
2314
2482
  #
2315
2483
  # @!attribute [rw] storage_class
@@ -2352,8 +2520,7 @@ module Aws::S3
2352
2520
  include Aws::Structure
2353
2521
  end
2354
2522
 
2355
- # Describes the server-side encryption that will be applied to the
2356
- # restore results.
2523
+ # Contains the type of server-side encryption used.
2357
2524
  #
2358
2525
  # @note When making an API call, you may pass Encryption
2359
2526
  # data as a hash:
@@ -2411,6 +2578,10 @@ module Aws::S3
2411
2578
  include Aws::Structure
2412
2579
  end
2413
2580
 
2581
+ # A message that indicates the request is complete and no more messages
2582
+ # will be sent. You should not assume that the request is complete until
2583
+ # the client receives an `EndEvent`.
2584
+ #
2414
2585
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/EndEvent AWS API Documentation
2415
2586
  #
2416
2587
  class EndEvent < Struct.new(
@@ -2418,16 +2589,823 @@ module Aws::S3
2418
2589
  include Aws::Structure
2419
2590
  end
2420
2591
 
2592
+ # Container for all error elements.
2593
+ #
2421
2594
  # @!attribute [rw] key
2595
+ # The error key.
2422
2596
  # @return [String]
2423
2597
  #
2424
2598
  # @!attribute [rw] version_id
2599
+ # The version ID of the error.
2425
2600
  # @return [String]
2426
2601
  #
2427
2602
  # @!attribute [rw] code
2603
+ # The error code is a string that uniquely identifies an error
2604
+ # condition. It is meant to be read and understood by programs that
2605
+ # detect and handle errors by type.
2606
+ #
2607
+ # **Amazon S3 error codes**
2608
+ #
2609
+ # * * *Code:* AccessDenied
2610
+ #
2611
+ # * *Description:* Access Denied
2612
+ #
2613
+ # * *HTTP Status Code:* 403 Forbidden
2614
+ #
2615
+ # * *SOAP Fault Code Prefix:* Client
2616
+ #
2617
+ # * * *Code:* AccountProblem
2618
+ #
2619
+ # * *Description:* There is a problem with your AWS account that
2620
+ # prevents the operation from completing successfully. Contact AWS
2621
+ # Support for further assistance.
2622
+ #
2623
+ # * *HTTP Status Code:* 403 Forbidden
2624
+ #
2625
+ # * *SOAP Fault Code Prefix:* Client
2626
+ #
2627
+ # * * *Code:* AllAccessDisabled
2628
+ #
2629
+ # * *Description:* All access to this Amazon S3 resource has been
2630
+ # disabled. Contact AWS Support for further assistance.
2631
+ #
2632
+ # * *HTTP Status Code:* 403 Forbidden
2633
+ #
2634
+ # * *SOAP Fault Code Prefix:* Client
2635
+ #
2636
+ # * * *Code:* AmbiguousGrantByEmailAddress
2637
+ #
2638
+ # * *Description:* The email address you provided is associated with
2639
+ # more than one account.
2640
+ #
2641
+ # * *HTTP Status Code:* 400 Bad Request
2642
+ #
2643
+ # * *SOAP Fault Code Prefix:* Client
2644
+ #
2645
+ # * * *Code:* AuthorizationHeaderMalformed
2646
+ #
2647
+ # * *Description:* The authorization header you provided is invalid.
2648
+ #
2649
+ # * *HTTP Status Code:* 400 Bad Request
2650
+ #
2651
+ # * *HTTP Status Code:* N/A
2652
+ #
2653
+ # * * *Code:* BadDigest
2654
+ #
2655
+ # * *Description:* The Content-MD5 you specified did not match what
2656
+ # we received.
2657
+ #
2658
+ # * *HTTP Status Code:* 400 Bad Request
2659
+ #
2660
+ # * *SOAP Fault Code Prefix:* Client
2661
+ #
2662
+ # * * *Code:* BucketAlreadyExists
2663
+ #
2664
+ # * *Description:* The requested bucket name is not available. The
2665
+ # bucket namespace is shared by all users of the system. Please
2666
+ # select a different name and try again.
2667
+ #
2668
+ # * *HTTP Status Code:* 409 Conflict
2669
+ #
2670
+ # * *SOAP Fault Code Prefix:* Client
2671
+ #
2672
+ # * * *Code:* BucketAlreadyOwnedByYou
2673
+ #
2674
+ # * *Description:* The bucket you tried to create already exists,
2675
+ # and you own it. Amazon S3 returns this error in all AWS Regions
2676
+ # except in the North Virginia region. For legacy compatibility,
2677
+ # if you re-create an existing bucket that you already own in the
2678
+ # North Virginia region, Amazon S3 returns 200 OK and resets the
2679
+ # bucket access control lists (ACLs).
2680
+ #
2681
+ # * *Code:* 409 Conflict (in all regions except the North Virginia
2682
+ # region)
2683
+ #
2684
+ # * *SOAP Fault Code Prefix:* Client
2685
+ #
2686
+ # * * *Code:* BucketNotEmpty
2687
+ #
2688
+ # * *Description:* The bucket you tried to delete is not empty.
2689
+ #
2690
+ # * *HTTP Status Code:* 409 Conflict
2691
+ #
2692
+ # * *SOAP Fault Code Prefix:* Client
2693
+ #
2694
+ # * * *Code:* CredentialsNotSupported
2695
+ #
2696
+ # * *Description:* This request does not support credentials.
2697
+ #
2698
+ # * *HTTP Status Code:* 400 Bad Request
2699
+ #
2700
+ # * *SOAP Fault Code Prefix:* Client
2701
+ #
2702
+ # * * *Code:* CrossLocationLoggingProhibited
2703
+ #
2704
+ # * *Description:* Cross-location logging not allowed. Buckets in
2705
+ # one geographic location cannot log information to a bucket in
2706
+ # another location.
2707
+ #
2708
+ # * *HTTP Status Code:* 403 Forbidden
2709
+ #
2710
+ # * *SOAP Fault Code Prefix:* Client
2711
+ #
2712
+ # * * *Code:* EntityTooSmall
2713
+ #
2714
+ # * *Description:* Your proposed upload is smaller than the minimum
2715
+ # allowed object size.
2716
+ #
2717
+ # * *HTTP Status Code:* 400 Bad Request
2718
+ #
2719
+ # * *SOAP Fault Code Prefix:* Client
2720
+ #
2721
+ # * * *Code:* EntityTooLarge
2722
+ #
2723
+ # * *Description:* Your proposed upload exceeds the maximum allowed
2724
+ # object size.
2725
+ #
2726
+ # * *HTTP Status Code:* 400 Bad Request
2727
+ #
2728
+ # * *SOAP Fault Code Prefix:* Client
2729
+ #
2730
+ # * * *Code:* ExpiredToken
2731
+ #
2732
+ # * *Description:* The provided token has expired.
2733
+ #
2734
+ # * *HTTP Status Code:* 400 Bad Request
2735
+ #
2736
+ # * *SOAP Fault Code Prefix:* Client
2737
+ #
2738
+ # * * *Code:* IllegalVersioningConfigurationException
2739
+ #
2740
+ # * *Description:* Indicates that the versioning configuration
2741
+ # specified in the request is invalid.
2742
+ #
2743
+ # * *HTTP Status Code:* 400 Bad Request
2744
+ #
2745
+ # * *SOAP Fault Code Prefix:* Client
2746
+ #
2747
+ # * * *Code:* IncompleteBody
2748
+ #
2749
+ # * *Description:* You did not provide the number of bytes specified
2750
+ # by the Content-Length HTTP header
2751
+ #
2752
+ # * *HTTP Status Code:* 400 Bad Request
2753
+ #
2754
+ # * *SOAP Fault Code Prefix:* Client
2755
+ #
2756
+ # * * *Code:* IncorrectNumberOfFilesInPostRequest
2757
+ #
2758
+ # * *Description:* POST requires exactly one file upload per
2759
+ # request.
2760
+ #
2761
+ # * *HTTP Status Code:* 400 Bad Request
2762
+ #
2763
+ # * *SOAP Fault Code Prefix:* Client
2764
+ #
2765
+ # * * *Code:* InlineDataTooLarge
2766
+ #
2767
+ # * *Description:* Inline data exceeds the maximum allowed size.
2768
+ #
2769
+ # * *HTTP Status Code:* 400 Bad Request
2770
+ #
2771
+ # * *SOAP Fault Code Prefix:* Client
2772
+ #
2773
+ # * * *Code:* InternalError
2774
+ #
2775
+ # * *Description:* We encountered an internal error. Please try
2776
+ # again.
2777
+ #
2778
+ # * *HTTP Status Code:* 500 Internal Server Error
2779
+ #
2780
+ # * *SOAP Fault Code Prefix:* Server
2781
+ #
2782
+ # * * *Code:* InvalidAccessKeyId
2783
+ #
2784
+ # * *Description:* The AWS access key ID you provided does not exist
2785
+ # in our records.
2786
+ #
2787
+ # * *HTTP Status Code:* 403 Forbidden
2788
+ #
2789
+ # * *SOAP Fault Code Prefix:* Client
2790
+ #
2791
+ # * * *Code:* InvalidAddressingHeader
2792
+ #
2793
+ # * *Description:* You must specify the Anonymous role.
2794
+ #
2795
+ # * *HTTP Status Code:* N/A
2796
+ #
2797
+ # * *SOAP Fault Code Prefix:* Client
2798
+ #
2799
+ # * * *Code:* InvalidArgument
2800
+ #
2801
+ # * *Description:* Invalid Argument
2802
+ #
2803
+ # * *HTTP Status Code:* 400 Bad Request
2804
+ #
2805
+ # * *SOAP Fault Code Prefix:* Client
2806
+ #
2807
+ # * * *Code:* InvalidBucketName
2808
+ #
2809
+ # * *Description:* The specified bucket is not valid.
2810
+ #
2811
+ # * *HTTP Status Code:* 400 Bad Request
2812
+ #
2813
+ # * *SOAP Fault Code Prefix:* Client
2814
+ #
2815
+ # * * *Code:* InvalidBucketState
2816
+ #
2817
+ # * *Description:* The request is not valid with the current state
2818
+ # of the bucket.
2819
+ #
2820
+ # * *HTTP Status Code:* 409 Conflict
2821
+ #
2822
+ # * *SOAP Fault Code Prefix:* Client
2823
+ #
2824
+ # * * *Code:* InvalidDigest
2825
+ #
2826
+ # * *Description:* The Content-MD5 you specified is not valid.
2827
+ #
2828
+ # * *HTTP Status Code:* 400 Bad Request
2829
+ #
2830
+ # * *SOAP Fault Code Prefix:* Client
2831
+ #
2832
+ # * * *Code:* InvalidEncryptionAlgorithmError
2833
+ #
2834
+ # * *Description:* The encryption request you specified is not
2835
+ # valid. The valid value is AES256.
2836
+ #
2837
+ # * *HTTP Status Code:* 400 Bad Request
2838
+ #
2839
+ # * *SOAP Fault Code Prefix:* Client
2840
+ #
2841
+ # * * *Code:* InvalidLocationConstraint
2842
+ #
2843
+ # * *Description:* The specified location constraint is not valid.
2844
+ # For more information about Regions, see [How to Select a Region
2845
+ # for Your Buckets][1].
2846
+ #
2847
+ # * *HTTP Status Code:* 400 Bad Request
2848
+ #
2849
+ # * *SOAP Fault Code Prefix:* Client
2850
+ #
2851
+ # * * *Code:* InvalidObjectState
2852
+ #
2853
+ # * *Description:* The operation is not valid for the current state
2854
+ # of the object.
2855
+ #
2856
+ # * *HTTP Status Code:* 403 Forbidden
2857
+ #
2858
+ # * *SOAP Fault Code Prefix:* Client
2859
+ #
2860
+ # * * *Code:* InvalidPart
2861
+ #
2862
+ # * *Description:* One or more of the specified parts could not be
2863
+ # found. The part might not have been uploaded, or the specified
2864
+ # entity tag might not have matched the part's entity tag.
2865
+ #
2866
+ # * *HTTP Status Code:* 400 Bad Request
2867
+ #
2868
+ # * *SOAP Fault Code Prefix:* Client
2869
+ #
2870
+ # * * *Code:* InvalidPartOrder
2871
+ #
2872
+ # * *Description:* The list of parts was not in ascending order.
2873
+ # Parts list must be specified in order by part number.
2874
+ #
2875
+ # * *HTTP Status Code:* 400 Bad Request
2876
+ #
2877
+ # * *SOAP Fault Code Prefix:* Client
2878
+ #
2879
+ # * * *Code:* InvalidPayer
2880
+ #
2881
+ # * *Description:* All access to this object has been disabled.
2882
+ # Please contact AWS Support for further assistance.
2883
+ #
2884
+ # * *HTTP Status Code:* 403 Forbidden
2885
+ #
2886
+ # * *SOAP Fault Code Prefix:* Client
2887
+ #
2888
+ # * * *Code:* InvalidPolicyDocument
2889
+ #
2890
+ # * *Description:* The content of the form does not meet the
2891
+ # conditions specified in the policy document.
2892
+ #
2893
+ # * *HTTP Status Code:* 400 Bad Request
2894
+ #
2895
+ # * *SOAP Fault Code Prefix:* Client
2896
+ #
2897
+ # * * *Code:* InvalidRange
2898
+ #
2899
+ # * *Description:* The requested range cannot be satisfied.
2900
+ #
2901
+ # * *HTTP Status Code:* 416 Requested Range Not Satisfiable
2902
+ #
2903
+ # * *SOAP Fault Code Prefix:* Client
2904
+ #
2905
+ # * * *Code:* InvalidRequest
2906
+ #
2907
+ # * *Description:* Please use AWS4-HMAC-SHA256.
2908
+ #
2909
+ # * *HTTP Status Code:* 400 Bad Request
2910
+ #
2911
+ # * *Code:* N/A
2912
+ #
2913
+ # * * *Code:* InvalidRequest
2914
+ #
2915
+ # * *Description:* SOAP requests must be made over an HTTPS
2916
+ # connection.
2917
+ #
2918
+ # * *HTTP Status Code:* 400 Bad Request
2919
+ #
2920
+ # * *SOAP Fault Code Prefix:* Client
2921
+ #
2922
+ # * * *Code:* InvalidRequest
2923
+ #
2924
+ # * *Description:* Amazon S3 Transfer Acceleration is not supported
2925
+ # for buckets with non-DNS compliant names.
2926
+ #
2927
+ # * *HTTP Status Code:* 400 Bad Request
2928
+ #
2929
+ # * *Code:* N/A
2930
+ #
2931
+ # * * *Code:* InvalidRequest
2932
+ #
2933
+ # * *Description:* Amazon S3 Transfer Acceleration is not supported
2934
+ # for buckets with periods (.) in their names.
2935
+ #
2936
+ # * *HTTP Status Code:* 400 Bad Request
2937
+ #
2938
+ # * *Code:* N/A
2939
+ #
2940
+ # * * *Code:* InvalidRequest
2941
+ #
2942
+ # * *Description:* Amazon S3 Transfer Accelerate endpoint only
2943
+ # supports virtual style requests.
2944
+ #
2945
+ # * *HTTP Status Code:* 400 Bad Request
2946
+ #
2947
+ # * *Code:* N/A
2948
+ #
2949
+ # * * *Code:* InvalidRequest
2950
+ #
2951
+ # * *Description:* Amazon S3 Transfer Accelerate is not configured
2952
+ # on this bucket.
2953
+ #
2954
+ # * *HTTP Status Code:* 400 Bad Request
2955
+ #
2956
+ # * *Code:* N/A
2957
+ #
2958
+ # * * *Code:* InvalidRequest
2959
+ #
2960
+ # * *Description:* Amazon S3 Transfer Accelerate is disabled on this
2961
+ # bucket.
2962
+ #
2963
+ # * *HTTP Status Code:* 400 Bad Request
2964
+ #
2965
+ # * *Code:* N/A
2966
+ #
2967
+ # * * *Code:* InvalidRequest
2968
+ #
2969
+ # * *Description:* Amazon S3 Transfer Acceleration is not supported
2970
+ # on this bucket. Contact AWS Support for more information.
2971
+ #
2972
+ # * *HTTP Status Code:* 400 Bad Request
2973
+ #
2974
+ # * *Code:* N/A
2975
+ #
2976
+ # * * *Code:* InvalidRequest
2977
+ #
2978
+ # * *Description:* Amazon S3 Transfer Acceleration cannot be enabled
2979
+ # on this bucket. Contact AWS Support for more information.
2980
+ #
2981
+ # * *HTTP Status Code:* 400 Bad Request
2982
+ #
2983
+ # * *Code:* N/A
2984
+ #
2985
+ # * * *Code:* InvalidSecurity
2986
+ #
2987
+ # * *Description:* The provided security credentials are not valid.
2988
+ #
2989
+ # * *HTTP Status Code:* 403 Forbidden
2990
+ #
2991
+ # * *SOAP Fault Code Prefix:* Client
2992
+ #
2993
+ # * * *Code:* InvalidSOAPRequest
2994
+ #
2995
+ # * *Description:* The SOAP request body is invalid.
2996
+ #
2997
+ # * *HTTP Status Code:* 400 Bad Request
2998
+ #
2999
+ # * *SOAP Fault Code Prefix:* Client
3000
+ #
3001
+ # * * *Code:* InvalidStorageClass
3002
+ #
3003
+ # * *Description:* The storage class you specified is not valid.
3004
+ #
3005
+ # * *HTTP Status Code:* 400 Bad Request
3006
+ #
3007
+ # * *SOAP Fault Code Prefix:* Client
3008
+ #
3009
+ # * * *Code:* InvalidTargetBucketForLogging
3010
+ #
3011
+ # * *Description:* The target bucket for logging does not exist, is
3012
+ # not owned by you, or does not have the appropriate grants for
3013
+ # the log-delivery group.
3014
+ #
3015
+ # * *HTTP Status Code:* 400 Bad Request
3016
+ #
3017
+ # * *SOAP Fault Code Prefix:* Client
3018
+ #
3019
+ # * * *Code:* InvalidToken
3020
+ #
3021
+ # * *Description:* The provided token is malformed or otherwise
3022
+ # invalid.
3023
+ #
3024
+ # * *HTTP Status Code:* 400 Bad Request
3025
+ #
3026
+ # * *SOAP Fault Code Prefix:* Client
3027
+ #
3028
+ # * * *Code:* InvalidURI
3029
+ #
3030
+ # * *Description:* Couldn't parse the specified URI.
3031
+ #
3032
+ # * *HTTP Status Code:* 400 Bad Request
3033
+ #
3034
+ # * *SOAP Fault Code Prefix:* Client
3035
+ #
3036
+ # * * *Code:* KeyTooLongError
3037
+ #
3038
+ # * *Description:* Your key is too long.
3039
+ #
3040
+ # * *HTTP Status Code:* 400 Bad Request
3041
+ #
3042
+ # * *SOAP Fault Code Prefix:* Client
3043
+ #
3044
+ # * * *Code:* MalformedACLError
3045
+ #
3046
+ # * *Description:* The XML you provided was not well-formed or did
3047
+ # not validate against our published schema.
3048
+ #
3049
+ # * *HTTP Status Code:* 400 Bad Request
3050
+ #
3051
+ # * *SOAP Fault Code Prefix:* Client
3052
+ #
3053
+ # * * *Code:* MalformedPOSTRequest
3054
+ #
3055
+ # * *Description:* The body of your POST request is not well-formed
3056
+ # multipart/form-data.
3057
+ #
3058
+ # * *HTTP Status Code:* 400 Bad Request
3059
+ #
3060
+ # * *SOAP Fault Code Prefix:* Client
3061
+ #
3062
+ # * * *Code:* MalformedXML
3063
+ #
3064
+ # * *Description:* This happens when the user sends malformed XML
3065
+ # (XML that doesn't conform to the published XSD) for the
3066
+ # configuration. The error message is, "The XML you provided was
3067
+ # not well-formed or did not validate against our published
3068
+ # schema."
3069
+ #
3070
+ # * *HTTP Status Code:* 400 Bad Request
3071
+ #
3072
+ # * *SOAP Fault Code Prefix:* Client
3073
+ #
3074
+ # * * *Code:* MaxMessageLengthExceeded
3075
+ #
3076
+ # * *Description:* Your request was too big.
3077
+ #
3078
+ # * *HTTP Status Code:* 400 Bad Request
3079
+ #
3080
+ # * *SOAP Fault Code Prefix:* Client
3081
+ #
3082
+ # * * *Code:* MaxPostPreDataLengthExceededError
3083
+ #
3084
+ # * *Description:* Your POST request fields preceding the upload
3085
+ # file were too large.
3086
+ #
3087
+ # * *HTTP Status Code:* 400 Bad Request
3088
+ #
3089
+ # * *SOAP Fault Code Prefix:* Client
3090
+ #
3091
+ # * * *Code:* MetadataTooLarge
3092
+ #
3093
+ # * *Description:* Your metadata headers exceed the maximum allowed
3094
+ # metadata size.
3095
+ #
3096
+ # * *HTTP Status Code:* 400 Bad Request
3097
+ #
3098
+ # * *SOAP Fault Code Prefix:* Client
3099
+ #
3100
+ # * * *Code:* MethodNotAllowed
3101
+ #
3102
+ # * *Description:* The specified method is not allowed against this
3103
+ # resource.
3104
+ #
3105
+ # * *HTTP Status Code:* 405 Method Not Allowed
3106
+ #
3107
+ # * *SOAP Fault Code Prefix:* Client
3108
+ #
3109
+ # * * *Code:* MissingAttachment
3110
+ #
3111
+ # * *Description:* A SOAP attachment was expected, but none were
3112
+ # found.
3113
+ #
3114
+ # * *HTTP Status Code:* N/A
3115
+ #
3116
+ # * *SOAP Fault Code Prefix:* Client
3117
+ #
3118
+ # * * *Code:* MissingContentLength
3119
+ #
3120
+ # * *Description:* You must provide the Content-Length HTTP header.
3121
+ #
3122
+ # * *HTTP Status Code:* 411 Length Required
3123
+ #
3124
+ # * *SOAP Fault Code Prefix:* Client
3125
+ #
3126
+ # * * *Code:* MissingRequestBodyError
3127
+ #
3128
+ # * *Description:* This happens when the user sends an empty XML
3129
+ # document as a request. The error message is, "Request body is
3130
+ # empty."
3131
+ #
3132
+ # * *HTTP Status Code:* 400 Bad Request
3133
+ #
3134
+ # * *SOAP Fault Code Prefix:* Client
3135
+ #
3136
+ # * * *Code:* MissingSecurityElement
3137
+ #
3138
+ # * *Description:* The SOAP 1.1 request is missing a security
3139
+ # element.
3140
+ #
3141
+ # * *HTTP Status Code:* 400 Bad Request
3142
+ #
3143
+ # * *SOAP Fault Code Prefix:* Client
3144
+ #
3145
+ # * * *Code:* MissingSecurityHeader
3146
+ #
3147
+ # * *Description:* Your request is missing a required header.
3148
+ #
3149
+ # * *HTTP Status Code:* 400 Bad Request
3150
+ #
3151
+ # * *SOAP Fault Code Prefix:* Client
3152
+ #
3153
+ # * * *Code:* NoLoggingStatusForKey
3154
+ #
3155
+ # * *Description:* There is no such thing as a logging status
3156
+ # subresource for a key.
3157
+ #
3158
+ # * *HTTP Status Code:* 400 Bad Request
3159
+ #
3160
+ # * *SOAP Fault Code Prefix:* Client
3161
+ #
3162
+ # * * *Code:* NoSuchBucket
3163
+ #
3164
+ # * *Description:* The specified bucket does not exist.
3165
+ #
3166
+ # * *HTTP Status Code:* 404 Not Found
3167
+ #
3168
+ # * *SOAP Fault Code Prefix:* Client
3169
+ #
3170
+ # * * *Code:* NoSuchBucketPolicy
3171
+ #
3172
+ # * *Description:* The specified bucket does not have a bucket
3173
+ # policy.
3174
+ #
3175
+ # * *HTTP Status Code:* 404 Not Found
3176
+ #
3177
+ # * *SOAP Fault Code Prefix:* Client
3178
+ #
3179
+ # * * *Code:* NoSuchKey
3180
+ #
3181
+ # * *Description:* The specified key does not exist.
3182
+ #
3183
+ # * *HTTP Status Code:* 404 Not Found
3184
+ #
3185
+ # * *SOAP Fault Code Prefix:* Client
3186
+ #
3187
+ # * * *Code:* NoSuchLifecycleConfiguration
3188
+ #
3189
+ # * *Description:* The lifecycle configuration does not exist.
3190
+ #
3191
+ # * *HTTP Status Code:* 404 Not Found
3192
+ #
3193
+ # * *SOAP Fault Code Prefix:* Client
3194
+ #
3195
+ # * * *Code:* NoSuchUpload
3196
+ #
3197
+ # * *Description:* The specified multipart upload does not exist.
3198
+ # The upload ID might be invalid, or the multipart upload might
3199
+ # have been aborted or completed.
3200
+ #
3201
+ # * *HTTP Status Code:* 404 Not Found
3202
+ #
3203
+ # * *SOAP Fault Code Prefix:* Client
3204
+ #
3205
+ # * * *Code:* NoSuchVersion
3206
+ #
3207
+ # * *Description:* Indicates that the version ID specified in the
3208
+ # request does not match an existing version.
3209
+ #
3210
+ # * *HTTP Status Code:* 404 Not Found
3211
+ #
3212
+ # * *SOAP Fault Code Prefix:* Client
3213
+ #
3214
+ # * * *Code:* NotImplemented
3215
+ #
3216
+ # * *Description:* A header you provided implies functionality that
3217
+ # is not implemented.
3218
+ #
3219
+ # * *HTTP Status Code:* 501 Not Implemented
3220
+ #
3221
+ # * *SOAP Fault Code Prefix:* Server
3222
+ #
3223
+ # * * *Code:* NotSignedUp
3224
+ #
3225
+ # * *Description:* Your account is not signed up for the Amazon S3
3226
+ # service. You must sign up before you can use Amazon S3. You can
3227
+ # sign up at the following URL: https://aws.amazon.com/s3
3228
+ #
3229
+ # * *HTTP Status Code:* 403 Forbidden
3230
+ #
3231
+ # * *SOAP Fault Code Prefix:* Client
3232
+ #
3233
+ # * * *Code:* OperationAborted
3234
+ #
3235
+ # * *Description:* A conflicting conditional operation is currently
3236
+ # in progress against this resource. Try again.
3237
+ #
3238
+ # * *HTTP Status Code:* 409 Conflict
3239
+ #
3240
+ # * *SOAP Fault Code Prefix:* Client
3241
+ #
3242
+ # * * *Code:* PermanentRedirect
3243
+ #
3244
+ # * *Description:* The bucket you are attempting to access must be
3245
+ # addressed using the specified endpoint. Send all future requests
3246
+ # to this endpoint.
3247
+ #
3248
+ # * *HTTP Status Code:* 301 Moved Permanently
3249
+ #
3250
+ # * *SOAP Fault Code Prefix:* Client
3251
+ #
3252
+ # * * *Code:* PreconditionFailed
3253
+ #
3254
+ # * *Description:* At least one of the preconditions you specified
3255
+ # did not hold.
3256
+ #
3257
+ # * *HTTP Status Code:* 412 Precondition Failed
3258
+ #
3259
+ # * *SOAP Fault Code Prefix:* Client
3260
+ #
3261
+ # * * *Code:* Redirect
3262
+ #
3263
+ # * *Description:* Temporary redirect.
3264
+ #
3265
+ # * *HTTP Status Code:* 307 Moved Temporarily
3266
+ #
3267
+ # * *SOAP Fault Code Prefix:* Client
3268
+ #
3269
+ # * * *Code:* RestoreAlreadyInProgress
3270
+ #
3271
+ # * *Description:* Object restore is already in progress.
3272
+ #
3273
+ # * *HTTP Status Code:* 409 Conflict
3274
+ #
3275
+ # * *SOAP Fault Code Prefix:* Client
3276
+ #
3277
+ # * * *Code:* RequestIsNotMultiPartContent
3278
+ #
3279
+ # * *Description:* Bucket POST must be of the enclosure-type
3280
+ # multipart/form-data.
3281
+ #
3282
+ # * *HTTP Status Code:* 400 Bad Request
3283
+ #
3284
+ # * *SOAP Fault Code Prefix:* Client
3285
+ #
3286
+ # * * *Code:* RequestTimeout
3287
+ #
3288
+ # * *Description:* Your socket connection to the server was not read
3289
+ # from or written to within the timeout period.
3290
+ #
3291
+ # * *HTTP Status Code:* 400 Bad Request
3292
+ #
3293
+ # * *SOAP Fault Code Prefix:* Client
3294
+ #
3295
+ # * * *Code:* RequestTimeTooSkewed
3296
+ #
3297
+ # * *Description:* The difference between the request time and the
3298
+ # server's time is too large.
3299
+ #
3300
+ # * *HTTP Status Code:* 403 Forbidden
3301
+ #
3302
+ # * *SOAP Fault Code Prefix:* Client
3303
+ #
3304
+ # * * *Code:* RequestTorrentOfBucketError
3305
+ #
3306
+ # * *Description:* Requesting the torrent file of a bucket is not
3307
+ # permitted.
3308
+ #
3309
+ # * *HTTP Status Code:* 400 Bad Request
3310
+ #
3311
+ # * *SOAP Fault Code Prefix:* Client
3312
+ #
3313
+ # * * *Code:* SignatureDoesNotMatch
3314
+ #
3315
+ # * *Description:* The request signature we calculated does not
3316
+ # match the signature you provided. Check your AWS secret access
3317
+ # key and signing method. For more information, see [REST
3318
+ # Authentication][2] and [SOAP Authentication][3] for details.
3319
+ #
3320
+ # * *HTTP Status Code:* 403 Forbidden
3321
+ #
3322
+ # * *SOAP Fault Code Prefix:* Client
3323
+ #
3324
+ # * * *Code:* ServiceUnavailable
3325
+ #
3326
+ # * *Description:* Reduce your request rate.
3327
+ #
3328
+ # * *HTTP Status Code:* 503 Service Unavailable
3329
+ #
3330
+ # * *SOAP Fault Code Prefix:* Server
3331
+ #
3332
+ # * * *Code:* SlowDown
3333
+ #
3334
+ # * *Description:* Reduce your request rate.
3335
+ #
3336
+ # * *HTTP Status Code:* 503 Slow Down
3337
+ #
3338
+ # * *SOAP Fault Code Prefix:* Server
3339
+ #
3340
+ # * * *Code:* TemporaryRedirect
3341
+ #
3342
+ # * *Description:* You are being redirected to the bucket while DNS
3343
+ # updates.
3344
+ #
3345
+ # * *HTTP Status Code:* 307 Moved Temporarily
3346
+ #
3347
+ # * *SOAP Fault Code Prefix:* Client
3348
+ #
3349
+ # * * *Code:* TokenRefreshRequired
3350
+ #
3351
+ # * *Description:* The provided token must be refreshed.
3352
+ #
3353
+ # * *HTTP Status Code:* 400 Bad Request
3354
+ #
3355
+ # * *SOAP Fault Code Prefix:* Client
3356
+ #
3357
+ # * * *Code:* TooManyBuckets
3358
+ #
3359
+ # * *Description:* You have attempted to create more buckets than
3360
+ # allowed.
3361
+ #
3362
+ # * *HTTP Status Code:* 400 Bad Request
3363
+ #
3364
+ # * *SOAP Fault Code Prefix:* Client
3365
+ #
3366
+ # * * *Code:* UnexpectedContent
3367
+ #
3368
+ # * *Description:* This request does not support content.
3369
+ #
3370
+ # * *HTTP Status Code:* 400 Bad Request
3371
+ #
3372
+ # * *SOAP Fault Code Prefix:* Client
3373
+ #
3374
+ # * * *Code:* UnresolvableGrantByEmailAddress
3375
+ #
3376
+ # * *Description:* The email address you provided does not match any
3377
+ # account on record.
3378
+ #
3379
+ # * *HTTP Status Code:* 400 Bad Request
3380
+ #
3381
+ # * *SOAP Fault Code Prefix:* Client
3382
+ #
3383
+ # * * *Code:* UserKeyMustBeSpecified
3384
+ #
3385
+ # * *Description:* The bucket POST must contain the specified field
3386
+ # name. If it is specified, check the order of the fields.
3387
+ #
3388
+ # * *HTTP Status Code:* 400 Bad Request
3389
+ #
3390
+ # * *SOAP Fault Code Prefix:* Client
3391
+ #
3392
+ #
3393
+ #
3394
+ #
3395
+ #
3396
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingBucket.html#access-bucket-intro
3397
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
3398
+ # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/SOAPAuthentication.html
2428
3399
  # @return [String]
2429
3400
  #
2430
3401
  # @!attribute [rw] message
3402
+ # The error message contains a generic description of the error
3403
+ # condition in English. It is intended for a human audience. Simple
3404
+ # programs display the message directly to the end user if they
3405
+ # encounter an error condition they don't know how or don't care to
3406
+ # handle. Sophisticated programs with more exhaustive error handling
3407
+ # and proper internationalization are more likely to ignore the error
3408
+ # message.
2431
3409
  # @return [String]
2432
3410
  #
2433
3411
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Error AWS API Documentation
@@ -2440,6 +3418,8 @@ module Aws::S3
2440
3418
  include Aws::Structure
2441
3419
  end
2442
3420
 
3421
+ # The error information.
3422
+ #
2443
3423
  # @note When making an API call, you may pass ErrorDocument
2444
3424
  # data as a hash:
2445
3425
  #
@@ -2458,6 +3438,28 @@ module Aws::S3
2458
3438
  include Aws::Structure
2459
3439
  end
2460
3440
 
3441
+ # A container that specifies information about existing object
3442
+ # replication. You can choose whether to enable or disable the
3443
+ # replication of existing objects.
3444
+ #
3445
+ # @note When making an API call, you may pass ExistingObjectReplication
3446
+ # data as a hash:
3447
+ #
3448
+ # {
3449
+ # status: "Enabled", # required, accepts Enabled, Disabled
3450
+ # }
3451
+ #
3452
+ # @!attribute [rw] status
3453
+ # Specifies whether existing object replication is enabled.
3454
+ # @return [String]
3455
+ #
3456
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ExistingObjectReplication AWS API Documentation
3457
+ #
3458
+ class ExistingObjectReplication < Struct.new(
3459
+ :status)
3460
+ include Aws::Structure
3461
+ end
3462
+
2461
3463
  # Specifies the Amazon S3 object key name to filter on and whether to
2462
3464
  # filter on the suffix or prefix of the key name.
2463
3465
  #
@@ -2524,6 +3526,7 @@ module Aws::S3
2524
3526
  end
2525
3527
 
2526
3528
  # @!attribute [rw] owner
3529
+ # Container for the bucket owner's display name and ID.
2527
3530
  # @return [Types::Owner]
2528
3531
  #
2529
3532
  # @!attribute [rw] grants
@@ -2546,6 +3549,7 @@ module Aws::S3
2546
3549
  # }
2547
3550
  #
2548
3551
  # @!attribute [rw] bucket
3552
+ # Specifies the S3 bucket whose ACL is being requested.
2549
3553
  # @return [String]
2550
3554
  #
2551
3555
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAclRequest AWS API Documentation
@@ -2592,6 +3596,8 @@ module Aws::S3
2592
3596
  end
2593
3597
 
2594
3598
  # @!attribute [rw] cors_rules
3599
+ # A set of origins and methods (cross-origin access that you want to
3600
+ # allow). You can add up to 100 rules to the configuration.
2595
3601
  # @return [Array<Types::CORSRule>]
2596
3602
  #
2597
3603
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketCorsOutput AWS API Documentation
@@ -2609,6 +3615,7 @@ module Aws::S3
2609
3615
  # }
2610
3616
  #
2611
3617
  # @!attribute [rw] bucket
3618
+ # The bucket name for which to get the cors configuration.
2612
3619
  # @return [String]
2613
3620
  #
2614
3621
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketCorsRequest AWS API Documentation
@@ -2619,6 +3626,7 @@ module Aws::S3
2619
3626
  end
2620
3627
 
2621
3628
  # @!attribute [rw] server_side_encryption_configuration
3629
+ # Specifies the default server-side-encryption configuration.
2622
3630
  # @return [Types::ServerSideEncryptionConfiguration]
2623
3631
  #
2624
3632
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketEncryptionOutput AWS API Documentation
@@ -2684,6 +3692,7 @@ module Aws::S3
2684
3692
  end
2685
3693
 
2686
3694
  # @!attribute [rw] rules
3695
+ # Container for a lifecycle rule.
2687
3696
  # @return [Array<Types::LifecycleRule>]
2688
3697
  #
2689
3698
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfigurationOutput AWS API Documentation
@@ -2701,6 +3710,7 @@ module Aws::S3
2701
3710
  # }
2702
3711
  #
2703
3712
  # @!attribute [rw] bucket
3713
+ # The name of the bucket for which to the the lifecycle information.
2704
3714
  # @return [String]
2705
3715
  #
2706
3716
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfigurationRequest AWS API Documentation
@@ -2711,6 +3721,7 @@ module Aws::S3
2711
3721
  end
2712
3722
 
2713
3723
  # @!attribute [rw] rules
3724
+ # Container for a lifecycle rule.
2714
3725
  # @return [Array<Types::Rule>]
2715
3726
  #
2716
3727
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleOutput AWS API Documentation
@@ -2728,6 +3739,7 @@ module Aws::S3
2728
3739
  # }
2729
3740
  #
2730
3741
  # @!attribute [rw] bucket
3742
+ # The name of the bucket for which to the the lifecycle information.
2731
3743
  # @return [String]
2732
3744
  #
2733
3745
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleRequest AWS API Documentation
@@ -2738,6 +3750,13 @@ module Aws::S3
2738
3750
  end
2739
3751
 
2740
3752
  # @!attribute [rw] location_constraint
3753
+ # Specifies the region where the bucket resides. For a list of all the
3754
+ # Amazon S3 supported location constraints by region, see [Regions and
3755
+ # Endpoints][1].
3756
+ #
3757
+ #
3758
+ #
3759
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
2741
3760
  # @return [String]
2742
3761
  #
2743
3762
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocationOutput AWS API Documentation
@@ -2755,6 +3774,7 @@ module Aws::S3
2755
3774
  # }
2756
3775
  #
2757
3776
  # @!attribute [rw] bucket
3777
+ # The name of the bucket for which to get the location.
2758
3778
  # @return [String]
2759
3779
  #
2760
3780
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocationRequest AWS API Documentation
@@ -2765,6 +3785,14 @@ module Aws::S3
2765
3785
  end
2766
3786
 
2767
3787
  # @!attribute [rw] logging_enabled
3788
+ # Describes where logs are stored and the prefix that Amazon S3
3789
+ # assigns to all log object keys for a bucket. For more information,
3790
+ # see [PUT Bucket logging][1] in the *Amazon Simple Storage Service
3791
+ # API Reference*.
3792
+ #
3793
+ #
3794
+ #
3795
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTlogging.html
2768
3796
  # @return [Types::LoggingEnabled]
2769
3797
  #
2770
3798
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLoggingOutput AWS API Documentation
@@ -2782,6 +3810,7 @@ module Aws::S3
2782
3810
  # }
2783
3811
  #
2784
3812
  # @!attribute [rw] bucket
3813
+ # The bucket name for which to get the logging information.
2785
3814
  # @return [String]
2786
3815
  #
2787
3816
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLoggingRequest AWS API Documentation
@@ -2835,7 +3864,7 @@ module Aws::S3
2835
3864
  # }
2836
3865
  #
2837
3866
  # @!attribute [rw] bucket
2838
- # Name of the bucket to get the notification configuration for.
3867
+ # Name of the bucket for which to get the notification configuration
2839
3868
  # @return [String]
2840
3869
  #
2841
3870
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketNotificationConfigurationRequest AWS API Documentation
@@ -2864,6 +3893,7 @@ module Aws::S3
2864
3893
  # }
2865
3894
  #
2866
3895
  # @!attribute [rw] bucket
3896
+ # The bucket name for which to get the bucket policy.
2867
3897
  # @return [String]
2868
3898
  #
2869
3899
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketPolicyRequest AWS API Documentation
@@ -2904,6 +3934,8 @@ module Aws::S3
2904
3934
  end
2905
3935
 
2906
3936
  # @!attribute [rw] replication_configuration
3937
+ # A container for replication rules. You can add up to 1,000 rules.
3938
+ # The maximum size of a replication configuration is 2 MB.
2907
3939
  # @return [Types::ReplicationConfiguration]
2908
3940
  #
2909
3941
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketReplicationOutput AWS API Documentation
@@ -2921,6 +3953,7 @@ module Aws::S3
2921
3953
  # }
2922
3954
  #
2923
3955
  # @!attribute [rw] bucket
3956
+ # The bucket name for which to get the replication information.
2924
3957
  # @return [String]
2925
3958
  #
2926
3959
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketReplicationRequest AWS API Documentation
@@ -2949,6 +3982,8 @@ module Aws::S3
2949
3982
  # }
2950
3983
  #
2951
3984
  # @!attribute [rw] bucket
3985
+ # The name of the bucket for which to get the payment request
3986
+ # configuration
2952
3987
  # @return [String]
2953
3988
  #
2954
3989
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketRequestPaymentRequest AWS API Documentation
@@ -2959,6 +3994,7 @@ module Aws::S3
2959
3994
  end
2960
3995
 
2961
3996
  # @!attribute [rw] tag_set
3997
+ # Contains the tag set.
2962
3998
  # @return [Array<Types::Tag>]
2963
3999
  #
2964
4000
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketTaggingOutput AWS API Documentation
@@ -2976,6 +4012,7 @@ module Aws::S3
2976
4012
  # }
2977
4013
  #
2978
4014
  # @!attribute [rw] bucket
4015
+ # The name of the bucket for which to get the tagging information.
2979
4016
  # @return [String]
2980
4017
  #
2981
4018
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketTaggingRequest AWS API Documentation
@@ -3012,6 +4049,7 @@ module Aws::S3
3012
4049
  # }
3013
4050
  #
3014
4051
  # @!attribute [rw] bucket
4052
+ # The name of the bucket for which to get the versioning information.
3015
4053
  # @return [String]
3016
4054
  #
3017
4055
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketVersioningRequest AWS API Documentation
@@ -3022,15 +4060,21 @@ module Aws::S3
3022
4060
  end
3023
4061
 
3024
4062
  # @!attribute [rw] redirect_all_requests_to
4063
+ # Specifies the redirect behavior of all requests to a website
4064
+ # endpoint of an Amazon S3 bucket.
3025
4065
  # @return [Types::RedirectAllRequestsTo]
3026
4066
  #
3027
4067
  # @!attribute [rw] index_document
4068
+ # The name of the index document for the website.
3028
4069
  # @return [Types::IndexDocument]
3029
4070
  #
3030
4071
  # @!attribute [rw] error_document
4072
+ # The name of the error document for the website.
3031
4073
  # @return [Types::ErrorDocument]
3032
4074
  #
3033
4075
  # @!attribute [rw] routing_rules
4076
+ # Rules that define when a redirect is applied and the redirect
4077
+ # behavior.
3034
4078
  # @return [Array<Types::RoutingRule>]
3035
4079
  #
3036
4080
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketWebsiteOutput AWS API Documentation
@@ -3051,6 +4095,7 @@ module Aws::S3
3051
4095
  # }
3052
4096
  #
3053
4097
  # @!attribute [rw] bucket
4098
+ # The bucket name for which to get the website configuration.
3054
4099
  # @return [String]
3055
4100
  #
3056
4101
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketWebsiteRequest AWS API Documentation
@@ -3061,6 +4106,7 @@ module Aws::S3
3061
4106
  end
3062
4107
 
3063
4108
  # @!attribute [rw] owner
4109
+ # Container for the bucket owner's display name and ID.
3064
4110
  # @return [Types::Owner]
3065
4111
  #
3066
4112
  # @!attribute [rw] grants
@@ -3092,9 +4138,11 @@ module Aws::S3
3092
4138
  # }
3093
4139
  #
3094
4140
  # @!attribute [rw] bucket
4141
+ # The bucket name of the object for which to get the ACL information.
3095
4142
  # @return [String]
3096
4143
  #
3097
4144
  # @!attribute [rw] key
4145
+ # The key of the object for which to get the ACL information.
3098
4146
  # @return [String]
3099
4147
  #
3100
4148
  # @!attribute [rw] version_id
@@ -3174,7 +4222,7 @@ module Aws::S3
3174
4222
  end
3175
4223
 
3176
4224
  # @!attribute [rw] object_lock_configuration
3177
- # The specified bucket's object lock configuration.
4225
+ # The specified bucket's Object Lock configuration.
3178
4226
  # @return [Types::ObjectLockConfiguration]
3179
4227
  #
3180
4228
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectLockConfigurationOutput AWS API Documentation
@@ -3192,7 +4240,7 @@ module Aws::S3
3192
4240
  # }
3193
4241
  #
3194
4242
  # @!attribute [rw] bucket
3195
- # The bucket whose object lock configuration you want to retrieve.
4243
+ # The bucket whose Object Lock configuration you want to retrieve.
3196
4244
  # @return [String]
3197
4245
  #
3198
4246
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectLockConfigurationRequest AWS API Documentation
@@ -3213,6 +4261,7 @@ module Aws::S3
3213
4261
  # @return [Boolean]
3214
4262
  #
3215
4263
  # @!attribute [rw] accept_ranges
4264
+ # Indicates that a range of bytes was specifed.
3216
4265
  # @return [String]
3217
4266
  #
3218
4267
  # @!attribute [rw] expiration
@@ -3316,10 +4365,13 @@ module Aws::S3
3316
4365
  #
3317
4366
  # @!attribute [rw] ssekms_key_id
3318
4367
  # If present, specifies the ID of the AWS Key Management Service (KMS)
3319
- # master encryption key that was used for the object.
4368
+ # customer master key (CMK) that was used for the object.
3320
4369
  # @return [String]
3321
4370
  #
3322
4371
  # @!attribute [rw] storage_class
4372
+ # Provides storage class information of the object. Amazon S3 returns
4373
+ # this header for all objects except for Standard storage class
4374
+ # objects.
3323
4375
  # @return [String]
3324
4376
  #
3325
4377
  # @!attribute [rw] request_charged
@@ -3328,6 +4380,8 @@ module Aws::S3
3328
4380
  # @return [String]
3329
4381
  #
3330
4382
  # @!attribute [rw] replication_status
4383
+ # Amazon S3 can return this if your request involves a bucket that is
4384
+ # either a source or destination in a replication rule.
3331
4385
  # @return [String]
3332
4386
  #
3333
4387
  # @!attribute [rw] parts_count
@@ -3339,11 +4393,11 @@ module Aws::S3
3339
4393
  # @return [Integer]
3340
4394
  #
3341
4395
  # @!attribute [rw] object_lock_mode
3342
- # The object lock mode currently in place for this object.
4396
+ # The Object Lock mode currently in place for this object.
3343
4397
  # @return [String]
3344
4398
  #
3345
4399
  # @!attribute [rw] object_lock_retain_until_date
3346
- # The date and time when this object's object lock will expire.
4400
+ # The date and time when this object's Object Lock will expire.
3347
4401
  # @return [Time]
3348
4402
  #
3349
4403
  # @!attribute [rw] object_lock_legal_hold_status
@@ -3416,6 +4470,7 @@ module Aws::S3
3416
4470
  # }
3417
4471
  #
3418
4472
  # @!attribute [rw] bucket
4473
+ # The bucket name containing the object.
3419
4474
  # @return [String]
3420
4475
  #
3421
4476
  # @!attribute [rw] if_match
@@ -3439,6 +4494,7 @@ module Aws::S3
3439
4494
  # @return [Time]
3440
4495
  #
3441
4496
  # @!attribute [rw] key
4497
+ # Key of the object to get.
3442
4498
  # @return [String]
3443
4499
  #
3444
4500
  # @!attribute [rw] range
@@ -3589,9 +4645,12 @@ module Aws::S3
3589
4645
  end
3590
4646
 
3591
4647
  # @!attribute [rw] version_id
4648
+ # The versionId of the object for which you got the tagging
4649
+ # information.
3592
4650
  # @return [String]
3593
4651
  #
3594
4652
  # @!attribute [rw] tag_set
4653
+ # Contains the tag set.
3595
4654
  # @return [Array<Types::Tag>]
3596
4655
  #
3597
4656
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTaggingOutput AWS API Documentation
@@ -3612,12 +4671,17 @@ module Aws::S3
3612
4671
  # }
3613
4672
  #
3614
4673
  # @!attribute [rw] bucket
4674
+ # The bucket name containing the object for which to get the tagging
4675
+ # information.
3615
4676
  # @return [String]
3616
4677
  #
3617
4678
  # @!attribute [rw] key
4679
+ # Object key for which to get the tagging information.
3618
4680
  # @return [String]
3619
4681
  #
3620
4682
  # @!attribute [rw] version_id
4683
+ # The versionId of the object for which to get the tagging
4684
+ # information.
3621
4685
  # @return [String]
3622
4686
  #
3623
4687
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetObjectTaggingRequest AWS API Documentation
@@ -3630,6 +4694,7 @@ module Aws::S3
3630
4694
  end
3631
4695
 
3632
4696
  # @!attribute [rw] body
4697
+ # A Bencoded dictionary as defined by the BitTorrent specification
3633
4698
  # @return [IO]
3634
4699
  #
3635
4700
  # @!attribute [rw] request_charged
@@ -3655,9 +4720,12 @@ module Aws::S3
3655
4720
  # }
3656
4721
  #
3657
4722
  # @!attribute [rw] bucket
4723
+ # The name of the bucket containing the object for which to get the
4724
+ # torrent files.
3658
4725
  # @return [String]
3659
4726
  #
3660
4727
  # @!attribute [rw] key
4728
+ # The object key for which to get the information.
3661
4729
  # @return [String]
3662
4730
  #
3663
4731
  # @!attribute [rw] request_payer
@@ -3708,6 +4776,8 @@ module Aws::S3
3708
4776
  include Aws::Structure
3709
4777
  end
3710
4778
 
4779
+ # Container for Glacier job parameters.
4780
+ #
3711
4781
  # @note When making an API call, you may pass GlacierJobParameters
3712
4782
  # data as a hash:
3713
4783
  #
@@ -3726,6 +4796,8 @@ module Aws::S3
3726
4796
  include Aws::Structure
3727
4797
  end
3728
4798
 
4799
+ # Container for grant information.
4800
+ #
3729
4801
  # @note When making an API call, you may pass Grant
3730
4802
  # data as a hash:
3731
4803
  #
@@ -3741,6 +4813,7 @@ module Aws::S3
3741
4813
  # }
3742
4814
  #
3743
4815
  # @!attribute [rw] grantee
4816
+ # The person being granted permissions.
3744
4817
  # @return [Types::Grantee]
3745
4818
  #
3746
4819
  # @!attribute [rw] permission
@@ -3755,6 +4828,8 @@ module Aws::S3
3755
4828
  include Aws::Structure
3756
4829
  end
3757
4830
 
4831
+ # Container for the person being granted permissions.
4832
+ #
3758
4833
  # @note When making an API call, you may pass Grantee
3759
4834
  # data as a hash:
3760
4835
  #
@@ -3805,6 +4880,7 @@ module Aws::S3
3805
4880
  # }
3806
4881
  #
3807
4882
  # @!attribute [rw] bucket
4883
+ # The bucket name.
3808
4884
  # @return [String]
3809
4885
  #
3810
4886
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadBucketRequest AWS API Documentation
@@ -3821,6 +4897,7 @@ module Aws::S3
3821
4897
  # @return [Boolean]
3822
4898
  #
3823
4899
  # @!attribute [rw] accept_ranges
4900
+ # Indicates that a range of bytes was specifed.
3824
4901
  # @return [String]
3825
4902
  #
3826
4903
  # @!attribute [rw] expiration
@@ -3831,8 +4908,26 @@ module Aws::S3
3831
4908
  # @return [String]
3832
4909
  #
3833
4910
  # @!attribute [rw] restore
3834
- # Provides information about object restoration operation and
3835
- # expiration time of the restored object copy.
4911
+ # If the object is an archived object (an object whose storage class
4912
+ # is GLACIER), the response includes this header if either the archive
4913
+ # restoration is in progress (see RestoreObject or an archive copy is
4914
+ # already restored.
4915
+ #
4916
+ # If an archive copy is already restored, the header value indicates
4917
+ # when Amazon S3 is scheduled to delete the object copy. For example:
4918
+ #
4919
+ # `x-amz-restore: ongoing-request="false", expiry-date="Fri, 23 Dec
4920
+ # 2012 00:00:00 GMT"`
4921
+ #
4922
+ # If the object restoration is in progress, the header returns the
4923
+ # value `ongoing-request="true"`.
4924
+ #
4925
+ # For more information about archiving objects, see [Transitioning
4926
+ # Objects: General Considerations][1].
4927
+ #
4928
+ #
4929
+ #
4930
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html#lifecycle-transition-general-considerations
3836
4931
  # @return [String]
3837
4932
  #
3838
4933
  # @!attribute [rw] last_modified
@@ -3897,8 +4992,11 @@ module Aws::S3
3897
4992
  # @return [String]
3898
4993
  #
3899
4994
  # @!attribute [rw] server_side_encryption
3900
- # The Server-side encryption algorithm used when storing this object
3901
- # in S3 (e.g., AES256, aws:kms).
4995
+ # If the object is stored using server-side encryption either with an
4996
+ # AWS KMS customer master key (CMK) or an Amazon S3-managed encryption
4997
+ # key, the response includes this header with the value of the
4998
+ # Server-side encryption algorithm used when storing this object in S3
4999
+ # (e.g., AES256, aws:kms).
3902
5000
  # @return [String]
3903
5001
  #
3904
5002
  # @!attribute [rw] metadata
@@ -3920,10 +5018,19 @@ module Aws::S3
3920
5018
  #
3921
5019
  # @!attribute [rw] ssekms_key_id
3922
5020
  # If present, specifies the ID of the AWS Key Management Service (KMS)
3923
- # master encryption key that was used for the object.
5021
+ # customer master key (CMK) that was used for the object.
3924
5022
  # @return [String]
3925
5023
  #
3926
5024
  # @!attribute [rw] storage_class
5025
+ # Provides storage class information of the object. Amazon S3 returns
5026
+ # this header for all objects except for Standard storage class
5027
+ # objects.
5028
+ #
5029
+ # For more information, see [Storage Classes][1].
5030
+ #
5031
+ #
5032
+ #
5033
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html
3927
5034
  # @return [String]
3928
5035
  #
3929
5036
  # @!attribute [rw] request_charged
@@ -3932,6 +5039,37 @@ module Aws::S3
3932
5039
  # @return [String]
3933
5040
  #
3934
5041
  # @!attribute [rw] replication_status
5042
+ # Amazon S3 can return this header if your request involves a bucket
5043
+ # that is either a source or destination in a replication rule.
5044
+ #
5045
+ # In replication you have a source bucket on which you configure
5046
+ # replication and destination bucket where Amazon S3 stores object
5047
+ # replicas. When you request an object (GetObject) or object metadata
5048
+ # (HeadObject) from these buckets, Amazon S3 will return the
5049
+ # x-amz-replication-status header in the response as follows:
5050
+ #
5051
+ # * If requesting object from the source bucket — Amazon S3 will
5052
+ # return the x-amz-replication-status header if object in your
5053
+ # request is eligible for replication.
5054
+ #
5055
+ # For example, suppose in your replication configuration you specify
5056
+ # object prefix "TaxDocs" requesting Amazon S3 to replicate
5057
+ # objects with key prefix "TaxDocs". Then any objects you upload
5058
+ # with this key name prefix, for example "TaxDocs/document1.pdf",
5059
+ # is eligible for replication. For any object request with this key
5060
+ # name prefix Amazon S3 will return the x-amz-replication-status
5061
+ # header with value PENDING, COMPLETED or FAILED indicating object
5062
+ # replication status.
5063
+ #
5064
+ # * If requesting object from the destination bucket — Amazon S3 will
5065
+ # return the x-amz-replication-status header with value REPLICA if
5066
+ # object in your request is a replica that Amazon S3 created.
5067
+ #
5068
+ # For more information, see [Replication][1].
5069
+ #
5070
+ #
5071
+ #
5072
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
3935
5073
  # @return [String]
3936
5074
  #
3937
5075
  # @!attribute [rw] parts_count
@@ -3939,15 +5077,33 @@ module Aws::S3
3939
5077
  # @return [Integer]
3940
5078
  #
3941
5079
  # @!attribute [rw] object_lock_mode
3942
- # The object lock mode currently in place for this object.
5080
+ # The Object Lock mode, if any, that's in effect for this object.
5081
+ # This header is only returned if the requester has the
5082
+ # `s3:GetObjectRetention` permission. For more information about S3
5083
+ # Object Lock, see [Object Lock][1].
5084
+ #
5085
+ #
5086
+ #
5087
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
3943
5088
  # @return [String]
3944
5089
  #
3945
5090
  # @!attribute [rw] object_lock_retain_until_date
3946
- # The date and time when this object's object lock expires.
5091
+ # The date and time when the Object Lock retention period expires.
5092
+ # This header is only returned if the requester has the
5093
+ # `s3:GetObjectRetention` permission.
3947
5094
  # @return [Time]
3948
5095
  #
3949
5096
  # @!attribute [rw] object_lock_legal_hold_status
3950
- # The Legal Hold status for the specified object.
5097
+ # Specifies whether a legal hold is in effect for this object. This
5098
+ # header is only returned if the requester has the
5099
+ # `s3:GetObjectLegalHold` permission. This header is not returned if
5100
+ # the specified version of this object has never had a legal hold
5101
+ # applied. For more information about S3 Object Lock, see [Object
5102
+ # Lock][1].
5103
+ #
5104
+ #
5105
+ #
5106
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
3951
5107
  # @return [String]
3952
5108
  #
3953
5109
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/HeadObjectOutput AWS API Documentation
@@ -4005,6 +5161,7 @@ module Aws::S3
4005
5161
  # }
4006
5162
  #
4007
5163
  # @!attribute [rw] bucket
5164
+ # The name of the bucket containing the object.
4008
5165
  # @return [String]
4009
5166
  #
4010
5167
  # @!attribute [rw] if_match
@@ -4028,6 +5185,7 @@ module Aws::S3
4028
5185
  # @return [Time]
4029
5186
  #
4030
5187
  # @!attribute [rw] key
5188
+ # The object key.
4031
5189
  # @return [String]
4032
5190
  #
4033
5191
  # @!attribute [rw] range
@@ -4093,6 +5251,8 @@ module Aws::S3
4093
5251
  include Aws::Structure
4094
5252
  end
4095
5253
 
5254
+ # Container for the Suffix element.
5255
+ #
4096
5256
  # @note When making an API call, you may pass IndexDocument
4097
5257
  # data as a hash:
4098
5258
  #
@@ -4115,6 +5275,8 @@ module Aws::S3
4115
5275
  include Aws::Structure
4116
5276
  end
4117
5277
 
5278
+ # Container element that identifies who initiated the ultipart upload.
5279
+ #
4118
5280
  # @!attribute [rw] id
4119
5281
  # If the principal is an AWS account, it provides the Canonical User
4120
5282
  # ID. If the principal is an IAM User, it provides a user ARN value.
@@ -4270,6 +5432,8 @@ module Aws::S3
4270
5432
  include Aws::Structure
4271
5433
  end
4272
5434
 
5435
+ # Specifies the inventory configuration for an Amazon S3 bucket.
5436
+ #
4273
5437
  # @note When making an API call, you may pass InventoryDestination
4274
5438
  # data as a hash:
4275
5439
  #
@@ -4331,6 +5495,9 @@ module Aws::S3
4331
5495
  include Aws::Structure
4332
5496
  end
4333
5497
 
5498
+ # Specifies an inventory filter. The inventory only includes objects
5499
+ # that meet the filter's criteria.
5500
+ #
4334
5501
  # @note When making an API call, you may pass InventoryFilter
4335
5502
  # data as a hash:
4336
5503
  #
@@ -4350,6 +5517,9 @@ module Aws::S3
4350
5517
  include Aws::Structure
4351
5518
  end
4352
5519
 
5520
+ # Contains the bucket name, file format, bucket owner (optional), and
5521
+ # prefix (optional) where inventory results are published.
5522
+ #
4353
5523
  # @note When making an API call, you may pass InventoryS3BucketDestination
4354
5524
  # data as a hash:
4355
5525
  #
@@ -4400,6 +5570,8 @@ module Aws::S3
4400
5570
  include Aws::Structure
4401
5571
  end
4402
5572
 
5573
+ # Specifies the schedule for generating inventory results.
5574
+ #
4403
5575
  # @note When making an API call, you may pass InventorySchedule
4404
5576
  # data as a hash:
4405
5577
  #
@@ -4418,6 +5590,8 @@ module Aws::S3
4418
5590
  include Aws::Structure
4419
5591
  end
4420
5592
 
5593
+ # Specifies JSON as object's input serialization format.
5594
+ #
4421
5595
  # @note When making an API call, you may pass JSONInput
4422
5596
  # data as a hash:
4423
5597
  #
@@ -4436,6 +5610,8 @@ module Aws::S3
4436
5610
  include Aws::Structure
4437
5611
  end
4438
5612
 
5613
+ # Specifies JSON as request's output serialization format.
5614
+ #
4439
5615
  # @note When making an API call, you may pass JSONOutput
4440
5616
  # data as a hash:
4441
5617
  #
@@ -4498,6 +5674,13 @@ module Aws::S3
4498
5674
  # @return [Array<String>]
4499
5675
  #
4500
5676
  # @!attribute [rw] filter
5677
+ # Specifies object key name filtering rules. For information about key
5678
+ # name filtering, see [Configuring Event Notifications][1] in the
5679
+ # *Amazon Simple Storage Service Developer Guide*.
5680
+ #
5681
+ #
5682
+ #
5683
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
4501
5684
  # @return [Types::NotificationConfigurationFilter]
4502
5685
  #
4503
5686
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/LambdaFunctionConfiguration AWS API Documentation
@@ -4510,6 +5693,8 @@ module Aws::S3
4510
5693
  include Aws::Structure
4511
5694
  end
4512
5695
 
5696
+ # Container for lifecycle rules. You can add as many as 1000 rules.
5697
+ #
4513
5698
  # @note When making an API call, you may pass LifecycleConfiguration
4514
5699
  # data as a hash:
4515
5700
  #
@@ -4544,6 +5729,7 @@ module Aws::S3
4544
5729
  # }
4545
5730
  #
4546
5731
  # @!attribute [rw] rules
5732
+ # Specifies lifecycle configuration rules for an Amazon S3 bucket.
4547
5733
  # @return [Array<Types::Rule>]
4548
5734
  #
4549
5735
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/LifecycleConfiguration AWS API Documentation
@@ -4553,6 +5739,8 @@ module Aws::S3
4553
5739
  include Aws::Structure
4554
5740
  end
4555
5741
 
5742
+ # Container for the expiration for the lifecycle of the object.
5743
+ #
4556
5744
  # @note When making an API call, you may pass LifecycleExpiration
4557
5745
  # data as a hash:
4558
5746
  #
@@ -4588,6 +5776,8 @@ module Aws::S3
4588
5776
  include Aws::Structure
4589
5777
  end
4590
5778
 
5779
+ # A lifecycle rule for individual objects in an Amazon S3 bucket.
5780
+ #
4591
5781
  # @note When making an API call, you may pass LifecycleRule
4592
5782
  # data as a hash:
4593
5783
  #
@@ -4638,6 +5828,8 @@ module Aws::S3
4638
5828
  # }
4639
5829
  #
4640
5830
  # @!attribute [rw] expiration
5831
+ # Specifies the expiration for the lifecycle of the object in the form
5832
+ # of date, days and, whether the object has a delete marker.
4641
5833
  # @return [Types::LifecycleExpiration]
4642
5834
  #
4643
5835
  # @!attribute [rw] id
@@ -4651,6 +5843,8 @@ module Aws::S3
4651
5843
  # @return [String]
4652
5844
  #
4653
5845
  # @!attribute [rw] filter
5846
+ # The Filter is used to identify objects that a Lifecycle Rule applies
5847
+ # to. A Filter must have exactly one of Prefix, Tag, or And specified.
4654
5848
  # @return [Types::LifecycleRuleFilter]
4655
5849
  #
4656
5850
  # @!attribute [rw] status
@@ -4659,15 +5853,38 @@ module Aws::S3
4659
5853
  # @return [String]
4660
5854
  #
4661
5855
  # @!attribute [rw] transitions
5856
+ # Specifies when an Amazon S3 object transitions to a specified
5857
+ # storage class.
4662
5858
  # @return [Array<Types::Transition>]
4663
5859
  #
4664
5860
  # @!attribute [rw] noncurrent_version_transitions
5861
+ # Specifies the transition rule for the lifecycle rule that describes
5862
+ # when noncurrent objects transition to the a specific storage class.
5863
+ # If your bucket is versioning-enabled (or versioning is suspended),
5864
+ # you can set this action to request that Amazon S3 transition
5865
+ # noncurrent object versions to the a specifc storage class at a set
5866
+ # period in the object's lifetime.
4665
5867
  # @return [Array<Types::NoncurrentVersionTransition>]
4666
5868
  #
4667
5869
  # @!attribute [rw] noncurrent_version_expiration
5870
+ # Specifies when noncurrent object versions expire. Upon expiration,
5871
+ # Amazon S3 permanently deletes the noncurrent object versions. You
5872
+ # set this lifecycle configuration action on a bucket that has
5873
+ # versioning enabled (or suspended) to request that Amazon S3 delete
5874
+ # noncurrent object versions at a specific period in the object's
5875
+ # lifetime.
4668
5876
  # @return [Types::NoncurrentVersionExpiration]
4669
5877
  #
4670
5878
  # @!attribute [rw] abort_incomplete_multipart_upload
5879
+ # Specifies the days since the initiation of an incomplete multipart
5880
+ # upload that Amazon S3 will wait before permanently removing all
5881
+ # parts of the upload. For more information, see [ Aborting Incomplete
5882
+ # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
5883
+ # Simple Storage Service Developer Guide*.
5884
+ #
5885
+ #
5886
+ #
5887
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
4671
5888
  # @return [Types::AbortIncompleteMultipartUpload]
4672
5889
  #
4673
5890
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/LifecycleRule AWS API Documentation
@@ -4703,6 +5920,7 @@ module Aws::S3
4703
5920
  # }
4704
5921
  #
4705
5922
  # @!attribute [rw] prefix
5923
+ # Prefix identifying one or more objects to which the rule applies.
4706
5924
  # @return [String]
4707
5925
  #
4708
5926
  # @!attribute [rw] tags
@@ -4751,6 +5969,9 @@ module Aws::S3
4751
5969
  # @return [Types::Tag]
4752
5970
  #
4753
5971
  # @!attribute [rw] and
5972
+ # This is used in a Lifecycle Rule Filter to apply a logical AND to
5973
+ # two or more predicates. The Lifecycle Rule will apply to any object
5974
+ # matching all of the predicates configured inside the And operator.
4754
5975
  # @return [Types::LifecycleRuleAndOperator]
4755
5976
  #
4756
5977
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/LifecycleRuleFilter AWS API Documentation
@@ -4770,7 +5991,9 @@ module Aws::S3
4770
5991
  # @return [Boolean]
4771
5992
  #
4772
5993
  # @!attribute [rw] continuation_token
4773
- # The ContinuationToken that represents where this request began.
5994
+ # The marker that is used as a starting point for this analytics
5995
+ # configuration list response. This value is present if it was sent in
5996
+ # the request.
4774
5997
  # @return [String]
4775
5998
  #
4776
5999
  # @!attribute [rw] next_continuation_token
@@ -4830,9 +6053,9 @@ module Aws::S3
4830
6053
  # @return [Array<Types::InventoryConfiguration>]
4831
6054
  #
4832
6055
  # @!attribute [rw] is_truncated
4833
- # Indicates whether the returned list of inventory configurations is
4834
- # truncated in this response. A value of true indicates that the list
4835
- # is truncated.
6056
+ # Tells whether the returned list of inventory configurations is
6057
+ # complete. A value of true indicates that the list is not complete
6058
+ # and the NextContinuationToken is provided for a subsequent request.
4836
6059
  # @return [Boolean]
4837
6060
  #
4838
6061
  # @!attribute [rw] next_continuation_token
@@ -4943,9 +6166,11 @@ module Aws::S3
4943
6166
  end
4944
6167
 
4945
6168
  # @!attribute [rw] buckets
6169
+ # The list of buckets owned by the requestor.
4946
6170
  # @return [Array<Types::Bucket>]
4947
6171
  #
4948
6172
  # @!attribute [rw] owner
6173
+ # The owner of the buckets listed.
4949
6174
  # @return [Types::Owner]
4950
6175
  #
4951
6176
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketsOutput AWS API Documentation
@@ -4981,6 +6206,9 @@ module Aws::S3
4981
6206
  # @return [String]
4982
6207
  #
4983
6208
  # @!attribute [rw] delimiter
6209
+ # Contains the delimiter you specified in the request. If you don't
6210
+ # specify a delimiter in your request, this element is absent from the
6211
+ # response.
4984
6212
  # @return [String]
4985
6213
  #
4986
6214
  # @!attribute [rw] next_upload_id_marker
@@ -5002,14 +6230,26 @@ module Aws::S3
5002
6230
  # @return [Boolean]
5003
6231
  #
5004
6232
  # @!attribute [rw] uploads
6233
+ # Container for elements related to a particular multipart upload. A
6234
+ # response can contain zero or more Upload elements.
5005
6235
  # @return [Array<Types::MultipartUpload>]
5006
6236
  #
5007
6237
  # @!attribute [rw] common_prefixes
6238
+ # If you specify a delimiter in the request, then the result returns
6239
+ # each distinct key prefix containing the delimiter in a
6240
+ # CommonPrefixes element. The distinct key prefixes are returned in
6241
+ # the Prefix child element.
5008
6242
  # @return [Array<Types::CommonPrefix>]
5009
6243
  #
5010
6244
  # @!attribute [rw] encoding_type
5011
6245
  # Encoding type used by Amazon S3 to encode object keys in the
5012
6246
  # response.
6247
+ #
6248
+ # If you specify `encoding-type` request parameter, Amazon S3 includes
6249
+ # this element in the response, and returns encoded key name values in
6250
+ # the following response elements:
6251
+ #
6252
+ # `Delimiter`, `KeyMarker`, `Prefix`, `NextKeyMarker`, `Key`.
5013
6253
  # @return [String]
5014
6254
  #
5015
6255
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploadsOutput AWS API Documentation
@@ -5044,10 +6284,19 @@ module Aws::S3
5044
6284
  # }
5045
6285
  #
5046
6286
  # @!attribute [rw] bucket
6287
+ # Name of the bucket to which the multipart upload was initiated.
5047
6288
  # @return [String]
5048
6289
  #
5049
6290
  # @!attribute [rw] delimiter
5050
6291
  # Character you use to group keys.
6292
+ #
6293
+ # All keys that contain the same string between the prefix, if
6294
+ # specified, and the first occurrence of the delimiter after the
6295
+ # prefix are grouped under a single result element, `CommonPrefixes`.
6296
+ # If you don't specify the prefix parameter, then the substring
6297
+ # starts at the beginning of the key. The keys that are grouped under
6298
+ # `CommonPrefixes` result element are not returned elsewhere in the
6299
+ # response.
5051
6300
  # @return [String]
5052
6301
  #
5053
6302
  # @!attribute [rw] encoding_type
@@ -5062,6 +6311,15 @@ module Aws::S3
5062
6311
  # @!attribute [rw] key_marker
5063
6312
  # Together with upload-id-marker, this parameter specifies the
5064
6313
  # multipart upload after which listing should begin.
6314
+ #
6315
+ # If `upload-id-marker` is not specified, only the keys
6316
+ # lexicographically greater than the specified `key-marker` will be
6317
+ # included in the list.
6318
+ #
6319
+ # If `upload-id-marker` is specified, any multipart uploads for a key
6320
+ # equal to the `key-marker` might also be included, provided those
6321
+ # multipart uploads have upload IDs lexicographically greater than the
6322
+ # specified `upload-id-marker`.
5065
6323
  # @return [String]
5066
6324
  #
5067
6325
  # @!attribute [rw] max_uploads
@@ -5072,13 +6330,18 @@ module Aws::S3
5072
6330
  #
5073
6331
  # @!attribute [rw] prefix
5074
6332
  # Lists in-progress uploads only for those keys that begin with the
5075
- # specified prefix.
6333
+ # specified prefix. You can use prefixes to separate a bucket into
6334
+ # different grouping of keys. (You can think of using prefix to make
6335
+ # groups in the same way you'd use a folder in a file system.)
5076
6336
  # @return [String]
5077
6337
  #
5078
6338
  # @!attribute [rw] upload_id_marker
5079
6339
  # Together with key-marker, specifies the multipart upload after which
5080
6340
  # listing should begin. If key-marker is not specified, the
5081
- # upload-id-marker parameter is ignored.
6341
+ # upload-id-marker parameter is ignored. Otherwise, any multipart
6342
+ # uploads for a key equal to the key-marker might be included in the
6343
+ # list only if they have an upload ID lexicographically greater than
6344
+ # the specified upload-id-marker.
5082
6345
  # @return [String]
5083
6346
  #
5084
6347
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListMultipartUploadsRequest AWS API Documentation
@@ -5107,42 +6370,67 @@ module Aws::S3
5107
6370
  # @return [String]
5108
6371
  #
5109
6372
  # @!attribute [rw] version_id_marker
6373
+ # Marks the last version of the Key returned in a truncated response.
5110
6374
  # @return [String]
5111
6375
  #
5112
6376
  # @!attribute [rw] next_key_marker
5113
- # Use this value for the key marker request parameter in a subsequent
5114
- # request.
6377
+ # When the number of responses exceeds the value of MaxKeys,
6378
+ # NextKeyMarker specifies the first key not returned that satisfies
6379
+ # the search criteria. Use this value for the key-marker request
6380
+ # parameter in a subsequent request.
5115
6381
  # @return [String]
5116
6382
  #
5117
6383
  # @!attribute [rw] next_version_id_marker
5118
- # Use this value for the next version id marker parameter in a
5119
- # subsequent request.
6384
+ # When the number of responses exceeds the value of MaxKeys,
6385
+ # NextVersionIdMarker specifies the first object version not returned
6386
+ # that satisfies the search criteria. Use this value for the
6387
+ # version-id-marker request parameter in a subsequent request.
5120
6388
  # @return [String]
5121
6389
  #
5122
6390
  # @!attribute [rw] versions
6391
+ # Container for version information.
5123
6392
  # @return [Array<Types::ObjectVersion>]
5124
6393
  #
5125
6394
  # @!attribute [rw] delete_markers
6395
+ # Container for an object that is a delete marker.
5126
6396
  # @return [Array<Types::DeleteMarkerEntry>]
5127
6397
  #
5128
6398
  # @!attribute [rw] name
6399
+ # Bucket owner's name.
5129
6400
  # @return [String]
5130
6401
  #
5131
6402
  # @!attribute [rw] prefix
6403
+ # Selects objects that start with the value supplied by this
6404
+ # parameter.
5132
6405
  # @return [String]
5133
6406
  #
5134
6407
  # @!attribute [rw] delimiter
6408
+ # The delimeter grouping the included keys. A delimiter is a character
6409
+ # that you specify to group keys. All keys that contain the same
6410
+ # string between the prefix and the first occurrence of the delimiter
6411
+ # are grouped under a single result element in CommonPrefixes. These
6412
+ # groups are counted as one result against the max-keys limitation.
6413
+ # These keys are not returned elsewhere in the response.
5135
6414
  # @return [String]
5136
6415
  #
5137
6416
  # @!attribute [rw] max_keys
6417
+ # Specifies the maximum number of objects to return.
5138
6418
  # @return [Integer]
5139
6419
  #
5140
6420
  # @!attribute [rw] common_prefixes
6421
+ # All of the keys rolled up into a common prefix count as a single
6422
+ # return when calculating the number of returns.
5141
6423
  # @return [Array<Types::CommonPrefix>]
5142
6424
  #
5143
6425
  # @!attribute [rw] encoding_type
5144
- # Encoding type used by Amazon S3 to encode object keys in the
5145
- # response.
6426
+ # Encoding type used by Amazon S3 to encode object key names in the
6427
+ # XML response.
6428
+ #
6429
+ # If you specify encoding-type request parameter, Amazon S3 includes
6430
+ # this element in the response, and returns encoded key name values in
6431
+ # the following response elements:
6432
+ #
6433
+ # `KeyMarker, NextKeyMarker, Prefix, Key`, and `Delimiter`.
5146
6434
  # @return [String]
5147
6435
  #
5148
6436
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectVersionsOutput AWS API Documentation
@@ -5178,10 +6466,16 @@ module Aws::S3
5178
6466
  # }
5179
6467
  #
5180
6468
  # @!attribute [rw] bucket
6469
+ # The name of the bucket that contains the objects.
5181
6470
  # @return [String]
5182
6471
  #
5183
6472
  # @!attribute [rw] delimiter
5184
- # A delimiter is a character you use to group keys.
6473
+ # A delimiter is a character that you specify to group keys. All keys
6474
+ # that contain the same string between the `prefix` and the first
6475
+ # occurrence of the delimiter are grouped under a single result
6476
+ # element in CommonPrefixes. These groups are counted as one result
6477
+ # against the max-keys limitation. These keys are not returned
6478
+ # elsewhere in the response.
5185
6479
  # @return [String]
5186
6480
  #
5187
6481
  # @!attribute [rw] encoding_type
@@ -5199,11 +6493,20 @@ module Aws::S3
5199
6493
  #
5200
6494
  # @!attribute [rw] max_keys
5201
6495
  # Sets the maximum number of keys returned in the response. The
5202
- # response might contain fewer keys but will never contain more.
6496
+ # response might contain fewer keys but will never contain more. If
6497
+ # additional keys satisfy the search criteria, but were not returned
6498
+ # because max-keys was exceeded, the response contains
6499
+ # &lt;isTruncated&gt;true&lt;/isTruncated&gt;. To return the
6500
+ # additional keys, see key-marker and version-id-marker.
5203
6501
  # @return [Integer]
5204
6502
  #
5205
6503
  # @!attribute [rw] prefix
5206
- # Limits the response to keys that begin with the specified prefix.
6504
+ # Use this parameter to select only those keys that begin with the
6505
+ # specified prefix. You can use prefixes to separate a bucket into
6506
+ # different groupings of keys. (You can think of using prefix to make
6507
+ # groups in the same way you'd use a folder in a file system.) You
6508
+ # can use prefix with delimiter to roll up numerous objects into a
6509
+ # single result under CommonPrefixes.
5207
6510
  # @return [String]
5208
6511
  #
5209
6512
  # @!attribute [rw] version_id_marker
@@ -5229,6 +6532,8 @@ module Aws::S3
5229
6532
  # @return [Boolean]
5230
6533
  #
5231
6534
  # @!attribute [rw] marker
6535
+ # Indicates where in the bucket listing begins. Marker is included in
6536
+ # the response if it was sent with the request.
5232
6537
  # @return [String]
5233
6538
  #
5234
6539
  # @!attribute [rw] next_marker
@@ -5243,21 +6548,46 @@ module Aws::S3
5243
6548
  # @return [String]
5244
6549
  #
5245
6550
  # @!attribute [rw] contents
6551
+ # Metadata about each object returned.
5246
6552
  # @return [Array<Types::Object>]
5247
6553
  #
5248
6554
  # @!attribute [rw] name
6555
+ # Name of the bucket.
5249
6556
  # @return [String]
5250
6557
  #
5251
6558
  # @!attribute [rw] prefix
6559
+ # Keys that begin with the indicated prefix.
5252
6560
  # @return [String]
5253
6561
  #
5254
6562
  # @!attribute [rw] delimiter
6563
+ # Causes keys that contain the same string between the prefix and the
6564
+ # first occurrence of the delimiter to be rolled up into a single
6565
+ # result element in the CommonPrefixes collection. These rolled-up
6566
+ # keys are not returned elsewhere in the response. Each rolled-up
6567
+ # result counts as only one return against the MaxKeys value.
5255
6568
  # @return [String]
5256
6569
  #
5257
6570
  # @!attribute [rw] max_keys
6571
+ # The maximum number of keys returned in the response body.
5258
6572
  # @return [Integer]
5259
6573
  #
5260
6574
  # @!attribute [rw] common_prefixes
6575
+ # All of the keys rolled up in a common prefix count as a single
6576
+ # return when calculating the number of returns.
6577
+ #
6578
+ # A response can contain CommonPrefixes only if you specify a
6579
+ # delimiter.
6580
+ #
6581
+ # CommonPrefixes contains all (if there are any) keys between Prefix
6582
+ # and the next occurrence of the string specified by the delimiter.
6583
+ #
6584
+ # CommonPrefixes lists keys that act like subdirectories in the
6585
+ # directory specified by Prefix.
6586
+ #
6587
+ # For example, if the prefix is notes/ and the delimiter is a slash
6588
+ # (/) as in notes/summer/july, the common prefix is notes/summer/. All
6589
+ # of the keys that roll up into a common prefix count as a single
6590
+ # return when calculating the number of returns.
5261
6591
  # @return [Array<Types::CommonPrefix>]
5262
6592
  #
5263
6593
  # @!attribute [rw] encoding_type
@@ -5295,6 +6625,7 @@ module Aws::S3
5295
6625
  # }
5296
6626
  #
5297
6627
  # @!attribute [rw] bucket
6628
+ # The name of the bucket containing the objects.
5298
6629
  # @return [String]
5299
6630
  #
5300
6631
  # @!attribute [rw] delimiter
@@ -5343,8 +6674,9 @@ module Aws::S3
5343
6674
  end
5344
6675
 
5345
6676
  # @!attribute [rw] is_truncated
5346
- # A flag that indicates whether or not Amazon S3 returned all of the
5347
- # results that satisfied the search criteria.
6677
+ # Set to false if all of the results were returned. Set to true if
6678
+ # more keys are available to return. If the number of results exceeds
6679
+ # that specified by MaxKeys, all of the results might not be returned.
5348
6680
  # @return [Boolean]
5349
6681
  #
5350
6682
  # @!attribute [rw] contents
@@ -5352,15 +6684,19 @@ module Aws::S3
5352
6684
  # @return [Array<Types::Object>]
5353
6685
  #
5354
6686
  # @!attribute [rw] name
5355
- # Name of the bucket to list.
6687
+ # Name of the bucket.
5356
6688
  # @return [String]
5357
6689
  #
5358
6690
  # @!attribute [rw] prefix
5359
- # Limits the response to keys that begin with the specified prefix.
6691
+ # Keys that begin with the indicated prefix.
5360
6692
  # @return [String]
5361
6693
  #
5362
6694
  # @!attribute [rw] delimiter
5363
- # A delimiter is a character you use to group keys.
6695
+ # Causes keys that contain the same string between the prefix and the
6696
+ # first occurrence of the delimiter to be rolled up into a single
6697
+ # result element in the CommonPrefixes collection. These rolled-up
6698
+ # keys are not returned elsewhere in the response. Each rolled-up
6699
+ # result counts as only one return against the MaxKeys value.
5364
6700
  # @return [String]
5365
6701
  #
5366
6702
  # @!attribute [rw] max_keys
@@ -5369,13 +6705,34 @@ module Aws::S3
5369
6705
  # @return [Integer]
5370
6706
  #
5371
6707
  # @!attribute [rw] common_prefixes
5372
- # CommonPrefixes contains all (if there are any) keys between Prefix
5373
- # and the next occurrence of the string specified by delimiter
6708
+ # All of the keys rolled up into a common prefix count as a single
6709
+ # return when calculating the number of returns.
6710
+ #
6711
+ # A response can contain `CommonPrefixes` only if you specify a
6712
+ # delimiter.
6713
+ #
6714
+ # `CommonPrefixes` contains all (if there are any) keys between
6715
+ # `Prefix` and the next occurrence of the string specified by a
6716
+ # delimiter.
6717
+ #
6718
+ # `CommonPrefixes` lists keys that act like subdirectories in the
6719
+ # directory specified by `Prefix`.
6720
+ #
6721
+ # For example, if the prefix is `notes/` and the delimiter is a slash
6722
+ # (`/`) as in `notes/summer/july`, the common prefix is
6723
+ # `notes/summer/`. All of the keys that roll up into a common prefix
6724
+ # count as a single return when calculating the number of returns.
5374
6725
  # @return [Array<Types::CommonPrefix>]
5375
6726
  #
5376
6727
  # @!attribute [rw] encoding_type
5377
- # Encoding type used by Amazon S3 to encode object keys in the
5378
- # response.
6728
+ # Encoding type used by Amazon S3 to encode object key names in the
6729
+ # XML response.
6730
+ #
6731
+ # If you specify the encoding-type request parameter, Amazon S3
6732
+ # includes this element in the response, and returns encoded key name
6733
+ # values in the following response elements:
6734
+ #
6735
+ # `Delimiter, Prefix, Key,` and `StartAfter`.
5379
6736
  # @return [String]
5380
6737
  #
5381
6738
  # @!attribute [rw] key_count
@@ -5385,9 +6742,8 @@ module Aws::S3
5385
6742
  # @return [Integer]
5386
6743
  #
5387
6744
  # @!attribute [rw] continuation_token
5388
- # ContinuationToken indicates Amazon S3 that the list is being
5389
- # continued on this bucket with a token. ContinuationToken is
5390
- # obfuscated and is not a real key
6745
+ # If ContinuationToken was sent with the request, it is included in
6746
+ # the response.
5391
6747
  # @return [String]
5392
6748
  #
5393
6749
  # @!attribute [rw] next_continuation_token
@@ -5399,9 +6755,8 @@ module Aws::S3
5399
6755
  # @return [String]
5400
6756
  #
5401
6757
  # @!attribute [rw] start_after
5402
- # StartAfter is where you want Amazon S3 to start listing from. Amazon
5403
- # S3 starts listing after this specified key. StartAfter can be any
5404
- # key in the bucket
6758
+ # If StartAfter was sent with the request, it is included in the
6759
+ # response.
5405
6760
  # @return [String]
5406
6761
  #
5407
6762
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListObjectsV2Output AWS API Documentation
@@ -5462,7 +6817,7 @@ module Aws::S3
5462
6817
  # @!attribute [rw] continuation_token
5463
6818
  # ContinuationToken indicates Amazon S3 that the list is being
5464
6819
  # continued on this bucket with a token. ContinuationToken is
5465
- # obfuscated and is not a real key
6820
+ # obfuscated and is not a real key.
5466
6821
  # @return [String]
5467
6822
  #
5468
6823
  # @!attribute [rw] fetch_owner
@@ -5474,7 +6829,7 @@ module Aws::S3
5474
6829
  # @!attribute [rw] start_after
5475
6830
  # StartAfter is where you want Amazon S3 to start listing from. Amazon
5476
6831
  # S3 starts listing after this specified key. StartAfter can be any
5477
- # key in the bucket
6832
+ # key in the bucket.
5478
6833
  # @return [String]
5479
6834
  #
5480
6835
  # @!attribute [rw] request_payer
@@ -5499,13 +6854,27 @@ module Aws::S3
5499
6854
  end
5500
6855
 
5501
6856
  # @!attribute [rw] abort_date
5502
- # Date when multipart upload will become eligible for abort operation
5503
- # by lifecycle.
6857
+ # If the bucket has a lifecycle rule configured with an action to
6858
+ # abort incomplete multipart uploads and the prefix in the lifecycle
6859
+ # rule matches the object name in the request, then the response
6860
+ # includes this header indicating when the initiated multipart upload
6861
+ # will become eligible for abort operation. For more information, see
6862
+ # [Aborting Incomplete Multipart Uploads Using a Bucket Lifecycle
6863
+ # Policy][1].
6864
+ #
6865
+ # The response will also include the x-amz-abort-rule-id header that
6866
+ # will provide the ID of the lifecycle configuration rule that defines
6867
+ # this action.
6868
+ #
6869
+ #
6870
+ #
6871
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
5504
6872
  # @return [Time]
5505
6873
  #
5506
6874
  # @!attribute [rw] abort_rule_id
5507
- # Id of the lifecycle rule that makes a multipart upload eligible for
5508
- # abort operation.
6875
+ # This header is returned along with the x-amz-abort-date header. It
6876
+ # identifies applicable lifecycle configuration rule that defines the
6877
+ # action to abort incomplete multipart uploads.
5509
6878
  # @return [String]
5510
6879
  #
5511
6880
  # @!attribute [rw] bucket
@@ -5522,7 +6891,9 @@ module Aws::S3
5522
6891
  # @return [String]
5523
6892
  #
5524
6893
  # @!attribute [rw] part_number_marker
5525
- # Part number after which listing begins.
6894
+ # When a list is truncated, this element specifies the last part in
6895
+ # the list, as well as the value to use for the part-number-marker
6896
+ # request parameter in a subsequent request.
5526
6897
  # @return [Integer]
5527
6898
  #
5528
6899
  # @!attribute [rw] next_part_number_marker
@@ -5536,21 +6907,33 @@ module Aws::S3
5536
6907
  # @return [Integer]
5537
6908
  #
5538
6909
  # @!attribute [rw] is_truncated
5539
- # Indicates whether the returned list of parts is truncated.
6910
+ # Indicates whether the returned list of parts is truncated. A true
6911
+ # value indicates that the list was truncated. A list can be truncated
6912
+ # if the number of parts exceeds the limit returned in the MaxParts
6913
+ # element.
5540
6914
  # @return [Boolean]
5541
6915
  #
5542
6916
  # @!attribute [rw] parts
6917
+ # Container for elements related to a particular part. A response can
6918
+ # contain zero or more Part elements.
5543
6919
  # @return [Array<Types::Part>]
5544
6920
  #
5545
6921
  # @!attribute [rw] initiator
5546
- # Identifies who initiated the multipart upload.
6922
+ # Container element that identifies who initiated the multipart
6923
+ # upload. If the initiator is an AWS account, this element provides
6924
+ # the same information as the Owner element. If the initiator is an
6925
+ # IAM User, then this element provides the user ARN and display name.
5547
6926
  # @return [Types::Initiator]
5548
6927
  #
5549
6928
  # @!attribute [rw] owner
6929
+ # Container element that identifies the object owner, after the object
6930
+ # is created. If multipart upload is initiated by an IAM user, this
6931
+ # element provides the parent account ID and display name.
5550
6932
  # @return [Types::Owner]
5551
6933
  #
5552
6934
  # @!attribute [rw] storage_class
5553
- # The class of storage used to store the object.
6935
+ # Class of storage (STANDARD or REDUCED\_REDUNDANCY) used to store the
6936
+ # uploaded object.
5554
6937
  # @return [String]
5555
6938
  #
5556
6939
  # @!attribute [rw] request_charged
@@ -5591,9 +6974,11 @@ module Aws::S3
5591
6974
  # }
5592
6975
  #
5593
6976
  # @!attribute [rw] bucket
6977
+ # Name of the bucket to which the parts are being uploaded.-&gt;
5594
6978
  # @return [String]
5595
6979
  #
5596
6980
  # @!attribute [rw] key
6981
+ # Object key for which the multipart upload was initiated.
5597
6982
  # @return [String]
5598
6983
  #
5599
6984
  # @!attribute [rw] max_parts
@@ -5670,6 +7055,7 @@ module Aws::S3
5670
7055
  # @return [String]
5671
7056
  #
5672
7057
  # @!attribute [rw] target_grants
7058
+ # Container for granting information.
5673
7059
  # @return [Array<Types::TargetGrant>]
5674
7060
  #
5675
7061
  # @!attribute [rw] target_prefix
@@ -5698,9 +7084,11 @@ module Aws::S3
5698
7084
  # }
5699
7085
  #
5700
7086
  # @!attribute [rw] name
7087
+ # Name of the Object.
5701
7088
  # @return [String]
5702
7089
  #
5703
7090
  # @!attribute [rw] value
7091
+ # Value of the Object.
5704
7092
  # @return [String]
5705
7093
  #
5706
7094
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/MetadataEntry AWS API Documentation
@@ -5711,6 +7099,11 @@ module Aws::S3
5711
7099
  include Aws::Structure
5712
7100
  end
5713
7101
 
7102
+ # A conjunction (logical AND) of predicates, which is used in evaluating
7103
+ # a metrics filter. The operator must have at least two predicates, and
7104
+ # an object must match all of the predicates in order for the filter to
7105
+ # apply.
7106
+ #
5714
7107
  # @note When making an API call, you may pass MetricsAndOperator
5715
7108
  # data as a hash:
5716
7109
  #
@@ -5793,6 +7186,10 @@ module Aws::S3
5793
7186
  include Aws::Structure
5794
7187
  end
5795
7188
 
7189
+ # Specifies a metrics configuration filter. The metrics configuration
7190
+ # only includes objects that meet the filter's criteria. A filter must
7191
+ # be a prefix, a tag, or a conjunction (MetricsAndOperator).
7192
+ #
5796
7193
  # @note When making an API call, you may pass MetricsFilter
5797
7194
  # data as a hash:
5798
7195
  #
@@ -5837,6 +7234,8 @@ module Aws::S3
5837
7234
  include Aws::Structure
5838
7235
  end
5839
7236
 
7237
+ # Container for the MultipartUpload for the Amazon S3 object.
7238
+ #
5840
7239
  # @!attribute [rw] upload_id
5841
7240
  # Upload ID that identifies the multipart upload.
5842
7241
  # @return [String]
@@ -5854,6 +7253,8 @@ module Aws::S3
5854
7253
  # @return [String]
5855
7254
  #
5856
7255
  # @!attribute [rw] owner
7256
+ # Specifies the owner of the object that is part of the multipart
7257
+ # upload.
5857
7258
  # @return [Types::Owner]
5858
7259
  #
5859
7260
  # @!attribute [rw] initiator
@@ -6056,12 +7457,20 @@ module Aws::S3
6056
7457
  # }
6057
7458
  #
6058
7459
  # @!attribute [rw] topic_configuration
7460
+ # This data type is deperecated. A container for specifying the
7461
+ # configuration for publication of messages to an Amazon Simple
7462
+ # Notification Service (Amazon SNS) topic when Amazon S3 detects
7463
+ # specified events.
6059
7464
  # @return [Types::TopicConfigurationDeprecated]
6060
7465
  #
6061
7466
  # @!attribute [rw] queue_configuration
7467
+ # This data type is deprecated. This data type specifies the
7468
+ # configuration for publishing messages to an Amazon Simple Queue
7469
+ # Service (Amazon SQS) queue when Amazon S3 detects specified events.
6062
7470
  # @return [Types::QueueConfigurationDeprecated]
6063
7471
  #
6064
7472
  # @!attribute [rw] cloud_function_configuration
7473
+ # Container for specifying the AWS Lambda notification configuration.
6065
7474
  # @return [Types::CloudFunctionConfiguration]
6066
7475
  #
6067
7476
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/NotificationConfigurationDeprecated AWS API Documentation
@@ -6096,6 +7505,7 @@ module Aws::S3
6096
7505
  # }
6097
7506
  #
6098
7507
  # @!attribute [rw] key
7508
+ # A container for object key name prefix and suffix filtering rules.
6099
7509
  # @return [Types::S3KeyFilter]
6100
7510
  #
6101
7511
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/NotificationConfigurationFilter AWS API Documentation
@@ -6105,16 +7515,24 @@ module Aws::S3
6105
7515
  include Aws::Structure
6106
7516
  end
6107
7517
 
7518
+ # An object consists of data and its descriptive metadata.
7519
+ #
6108
7520
  # @!attribute [rw] key
7521
+ # The name that you assign to an object. You use the object key to
7522
+ # retrieve the object.
6109
7523
  # @return [String]
6110
7524
  #
6111
7525
  # @!attribute [rw] last_modified
7526
+ # The date the Object was Last Modified
6112
7527
  # @return [Time]
6113
7528
  #
6114
7529
  # @!attribute [rw] etag
7530
+ # The entity tag is an MD5 hash of the object. ETag reflects only
7531
+ # changes to the contents of an object, not its metadata.
6115
7532
  # @return [String]
6116
7533
  #
6117
7534
  # @!attribute [rw] size
7535
+ # Size in bytes of the object
6118
7536
  # @return [Integer]
6119
7537
  #
6120
7538
  # @!attribute [rw] storage_class
@@ -6122,6 +7540,7 @@ module Aws::S3
6122
7540
  # @return [String]
6123
7541
  #
6124
7542
  # @!attribute [rw] owner
7543
+ # The owner of the object
6125
7544
  # @return [Types::Owner]
6126
7545
  #
6127
7546
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Object AWS API Documentation
@@ -6136,6 +7555,8 @@ module Aws::S3
6136
7555
  include Aws::Structure
6137
7556
  end
6138
7557
 
7558
+ # Object Identifier is unique value to identify objects.
7559
+ #
6139
7560
  # @note When making an API call, you may pass ObjectIdentifier
6140
7561
  # data as a hash:
6141
7562
  #
@@ -6160,7 +7581,7 @@ module Aws::S3
6160
7581
  include Aws::Structure
6161
7582
  end
6162
7583
 
6163
- # The container element for object lock configuration parameters.
7584
+ # The container element for Object Lock configuration parameters.
6164
7585
  #
6165
7586
  # @note When making an API call, you may pass ObjectLockConfiguration
6166
7587
  # data as a hash:
@@ -6177,12 +7598,12 @@ module Aws::S3
6177
7598
  # }
6178
7599
  #
6179
7600
  # @!attribute [rw] object_lock_enabled
6180
- # Indicates whether this bucket has an object lock configuration
7601
+ # Indicates whether this bucket has an Object Lock configuration
6181
7602
  # enabled.
6182
7603
  # @return [String]
6183
7604
  #
6184
7605
  # @!attribute [rw] rule
6185
- # The object lock rule in place for the specified object.
7606
+ # The Object Lock rule in place for the specified object.
6186
7607
  # @return [Types::ObjectLockRule]
6187
7608
  #
6188
7609
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectLockConfiguration AWS API Documentation
@@ -6228,7 +7649,7 @@ module Aws::S3
6228
7649
  # @return [String]
6229
7650
  #
6230
7651
  # @!attribute [rw] retain_until_date
6231
- # The date on which this object lock retention expires.
7652
+ # The date on which this Object Lock Retention will expire.
6232
7653
  # @return [Time]
6233
7654
  #
6234
7655
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectLockRetention AWS API Documentation
@@ -6239,7 +7660,7 @@ module Aws::S3
6239
7660
  include Aws::Structure
6240
7661
  end
6241
7662
 
6242
- # The container element for an object lock rule.
7663
+ # The container element for an Object Lock rule.
6243
7664
  #
6244
7665
  # @note When making an API call, you may pass ObjectLockRule
6245
7666
  # data as a hash:
@@ -6264,7 +7685,10 @@ module Aws::S3
6264
7685
  include Aws::Structure
6265
7686
  end
6266
7687
 
7688
+ # The version of an object.
7689
+ #
6267
7690
  # @!attribute [rw] etag
7691
+ # The entity tag is an MD5 hash of that version of the object
6268
7692
  # @return [String]
6269
7693
  #
6270
7694
  # @!attribute [rw] size
@@ -6293,6 +7717,7 @@ module Aws::S3
6293
7717
  # @return [Time]
6294
7718
  #
6295
7719
  # @!attribute [rw] owner
7720
+ # Specifies the Owner of the object.
6296
7721
  # @return [Types::Owner]
6297
7722
  #
6298
7723
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ObjectVersion AWS API Documentation
@@ -6400,6 +7825,8 @@ module Aws::S3
6400
7825
  include Aws::Structure
6401
7826
  end
6402
7827
 
7828
+ # Container for the owner's display name and ID
7829
+ #
6403
7830
  # @note When making an API call, you may pass Owner
6404
7831
  # data as a hash:
6405
7832
  #
@@ -6409,9 +7836,11 @@ module Aws::S3
6409
7836
  # }
6410
7837
  #
6411
7838
  # @!attribute [rw] display_name
7839
+ # Container for the display name of the owner
6412
7840
  # @return [String]
6413
7841
  #
6414
7842
  # @!attribute [rw] id
7843
+ # Container for the ID of the owner
6415
7844
  # @return [String]
6416
7845
  #
6417
7846
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Owner AWS API Documentation
@@ -6422,12 +7851,16 @@ module Aws::S3
6422
7851
  include Aws::Structure
6423
7852
  end
6424
7853
 
7854
+ # Container for Parquet.
7855
+ #
6425
7856
  # @api private
6426
7857
  #
6427
7858
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ParquetInput AWS API Documentation
6428
7859
  #
6429
7860
  class ParquetInput < Aws::EmptyStructure; end
6430
7861
 
7862
+ # Container for elements related to a part.
7863
+ #
6431
7864
  # @!attribute [rw] part_number
6432
7865
  # Part number identifying the part. This is a positive integer between
6433
7866
  # 1 and 10,000.
@@ -6469,6 +7902,8 @@ module Aws::S3
6469
7902
  include Aws::Structure
6470
7903
  end
6471
7904
 
7905
+ # This data type contains information about progress of an operation.
7906
+ #
6472
7907
  # @!attribute [rw] bytes_scanned
6473
7908
  # The current number of object bytes scanned.
6474
7909
  # @return [Integer]
@@ -6490,6 +7925,9 @@ module Aws::S3
6490
7925
  include Aws::Structure
6491
7926
  end
6492
7927
 
7928
+ # This data type contains information about the progress event of an
7929
+ # operation.
7930
+ #
6493
7931
  # @!attribute [rw] details
6494
7932
  # The Progress event details.
6495
7933
  # @return [Types::Progress]
@@ -6502,8 +7940,15 @@ module Aws::S3
6502
7940
  include Aws::Structure
6503
7941
  end
6504
7942
 
6505
- # Specifies the Block Public Access configuration for an Amazon S3
6506
- # bucket.
7943
+ # The PublicAccessBlock configuration that you want to apply to this
7944
+ # Amazon S3 bucket. You can enable the configuration options in any
7945
+ # combination. For more information about when Amazon S3 considers a
7946
+ # bucket or object public, see [The Meaning of "Public"][1] in the
7947
+ # Amazon Simple Storage Service Developer Guide.
7948
+ #
7949
+ #
7950
+ #
7951
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev//access-control-block-public-access.html#access-control-block-public-access-policy-status
6507
7952
  #
6508
7953
  # @note When making an API call, you may pass PublicAccessBlockConfiguration
6509
7954
  # data as a hash:
@@ -6525,6 +7970,8 @@ module Aws::S3
6525
7970
  #
6526
7971
  # * PUT Object calls fail if the request includes a public ACL.
6527
7972
  #
7973
+ # * PUT Bucket calls fail if the request includes a public ACL.
7974
+ #
6528
7975
  # Enabling this setting doesn't affect existing policies or ACLs.
6529
7976
  # @return [Boolean]
6530
7977
  #
@@ -6584,8 +8031,7 @@ module Aws::S3
6584
8031
  # @return [String]
6585
8032
  #
6586
8033
  # @!attribute [rw] accelerate_configuration
6587
- # Specifies the Accelerate Configuration you want to set for the
6588
- # bucket.
8034
+ # Container for setting the transfer acceleration state.
6589
8035
  # @return [Types::AccelerateConfiguration]
6590
8036
  #
6591
8037
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAccelerateConfigurationRequest AWS API Documentation
@@ -6638,9 +8084,18 @@ module Aws::S3
6638
8084
  # @return [Types::AccessControlPolicy]
6639
8085
  #
6640
8086
  # @!attribute [rw] bucket
8087
+ # The bucket to which to apply the ACL.
6641
8088
  # @return [String]
6642
8089
  #
6643
8090
  # @!attribute [rw] content_md5
8091
+ # The base64-encoded 128-bit MD5 digest of the data. This header must
8092
+ # be used as a message integrity check to verify that the request body
8093
+ # was not corrupted in transit. For more information, go to [RFC
8094
+ # 1864.][1]
8095
+ #
8096
+ #
8097
+ #
8098
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
6644
8099
  # @return [String]
6645
8100
  #
6646
8101
  # @!attribute [rw] grant_full_control
@@ -6762,12 +8217,29 @@ module Aws::S3
6762
8217
  # }
6763
8218
  #
6764
8219
  # @!attribute [rw] bucket
8220
+ # Specifies the bucket impacted by the `cors`configuration.
6765
8221
  # @return [String]
6766
8222
  #
6767
8223
  # @!attribute [rw] cors_configuration
8224
+ # Describes the cross-origin access configuration for objects in an
8225
+ # Amazon S3 bucket. For more information, see [Enabling Cross-Origin
8226
+ # Resource Sharing][1] in the Amazon Simple Storage Service Developer
8227
+ # Guide.
8228
+ #
8229
+ #
8230
+ #
8231
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev//cors.html
6768
8232
  # @return [Types::CORSConfiguration]
6769
8233
  #
6770
8234
  # @!attribute [rw] content_md5
8235
+ # The base64-encoded 128-bit MD5 digest of the data. This header must
8236
+ # be used as a message integrity check to verify that the request body
8237
+ # was not corrupted in transit. For more information, go to [RFC
8238
+ # 1864.][1]
8239
+ #
8240
+ #
8241
+ #
8242
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
6771
8243
  # @return [String]
6772
8244
  #
6773
8245
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketCorsRequest AWS API Documentation
@@ -6799,10 +8271,11 @@ module Aws::S3
6799
8271
  #
6800
8272
  # @!attribute [rw] bucket
6801
8273
  # Specifies default encryption for a bucket using server-side
6802
- # encryption with Amazon S3-managed keys (SSE-S3) or AWS KMS-managed
6803
- # keys (SSE-KMS). For information about the Amazon S3 default
6804
- # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
6805
- # the *Amazon Simple Storage Service Developer Guide*.
8274
+ # encryption with Amazon S3-managed keys (SSE-S3) or customer master
8275
+ # keys stored in AWS KMS (SSE-KMS). For information about the Amazon
8276
+ # S3 default encryption feature, see [Amazon S3 Default Bucket
8277
+ # Encryption][1] in the *Amazon Simple Storage Service Developer
8278
+ # Guide*.
6806
8279
  #
6807
8280
  #
6808
8281
  #
@@ -6816,6 +8289,7 @@ module Aws::S3
6816
8289
  # @return [String]
6817
8290
  #
6818
8291
  # @!attribute [rw] server_side_encryption_configuration
8292
+ # Specifies the default server-side-encryption configuration.
6819
8293
  # @return [Types::ServerSideEncryptionConfiguration]
6820
8294
  #
6821
8295
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketEncryptionRequest AWS API Documentation
@@ -6941,9 +8415,11 @@ module Aws::S3
6941
8415
  # }
6942
8416
  #
6943
8417
  # @!attribute [rw] bucket
8418
+ # The name of the bucket for which to set the configuration.
6944
8419
  # @return [String]
6945
8420
  #
6946
8421
  # @!attribute [rw] lifecycle_configuration
8422
+ # Container for lifecycle rules. You can add as many as 1,000 rules.
6947
8423
  # @return [Types::BucketLifecycleConfiguration]
6948
8424
  #
6949
8425
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycleConfigurationRequest AWS API Documentation
@@ -7036,12 +8512,15 @@ module Aws::S3
7036
8512
  # }
7037
8513
  #
7038
8514
  # @!attribute [rw] bucket
8515
+ # The name of the bucket for which to set the logging parameters.
7039
8516
  # @return [String]
7040
8517
  #
7041
8518
  # @!attribute [rw] bucket_logging_status
8519
+ # Container for logging status information.
7042
8520
  # @return [Types::BucketLoggingStatus]
7043
8521
  #
7044
8522
  # @!attribute [rw] content_md5
8523
+ # The MD5 hash of the `PutBucketLogging` request body.
7045
8524
  # @return [String]
7046
8525
  #
7047
8526
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLoggingRequest AWS API Documentation
@@ -7162,9 +8641,13 @@ module Aws::S3
7162
8641
  # }
7163
8642
  #
7164
8643
  # @!attribute [rw] bucket
8644
+ # The name of the bucket.
7165
8645
  # @return [String]
7166
8646
  #
7167
8647
  # @!attribute [rw] notification_configuration
8648
+ # A container for specifying the notification configuration of the
8649
+ # bucket. If this element is empty, notifications are turned off for
8650
+ # the bucket.
7168
8651
  # @return [Types::NotificationConfiguration]
7169
8652
  #
7170
8653
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotificationConfigurationRequest AWS API Documentation
@@ -7205,12 +8688,15 @@ module Aws::S3
7205
8688
  # }
7206
8689
  #
7207
8690
  # @!attribute [rw] bucket
8691
+ # The name of the bucket.
7208
8692
  # @return [String]
7209
8693
  #
7210
8694
  # @!attribute [rw] content_md5
8695
+ # The MD5 hash of the `PutPublicAccessBlock` request body.
7211
8696
  # @return [String]
7212
8697
  #
7213
8698
  # @!attribute [rw] notification_configuration
8699
+ # The container for the configuration.
7214
8700
  # @return [Types::NotificationConfigurationDeprecated]
7215
8701
  #
7216
8702
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketNotificationRequest AWS API Documentation
@@ -7233,9 +8719,11 @@ module Aws::S3
7233
8719
  # }
7234
8720
  #
7235
8721
  # @!attribute [rw] bucket
8722
+ # The name of the bucket.
7236
8723
  # @return [String]
7237
8724
  #
7238
8725
  # @!attribute [rw] content_md5
8726
+ # The MD5 hash of the request body.
7239
8727
  # @return [String]
7240
8728
  #
7241
8729
  # @!attribute [rw] confirm_remove_self_bucket_access
@@ -7292,6 +8780,9 @@ module Aws::S3
7292
8780
  # status: "Enabled", # required, accepts Enabled, Disabled
7293
8781
  # },
7294
8782
  # },
8783
+ # existing_object_replication: {
8784
+ # status: "Enabled", # required, accepts Enabled, Disabled
8785
+ # },
7295
8786
  # destination: { # required
7296
8787
  # bucket: "BucketName", # required
7297
8788
  # account: "AccountId",
@@ -7313,20 +8804,26 @@ module Aws::S3
7313
8804
  # }
7314
8805
  #
7315
8806
  # @!attribute [rw] bucket
8807
+ # The name of the bucket
7316
8808
  # @return [String]
7317
8809
  #
7318
8810
  # @!attribute [rw] content_md5
7319
8811
  # The base64-encoded 128-bit MD5 digest of the data. You must use this
7320
8812
  # header as a message integrity check to verify that the request body
7321
- # was not corrupted in transit.
8813
+ # was not corrupted in transit. For more information, see [RFC
8814
+ # 1864][1].
8815
+ #
8816
+ #
8817
+ #
8818
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
7322
8819
  # @return [String]
7323
8820
  #
7324
8821
  # @!attribute [rw] replication_configuration
8822
+ # A container for replication rules. You can add up to 1,000 rules.
8823
+ # The maximum size of a replication configuration is 2 MB.
7325
8824
  # @return [Types::ReplicationConfiguration]
7326
8825
  #
7327
8826
  # @!attribute [rw] token
7328
- # A token that allows Amazon S3 object lock to be enabled for an
7329
- # existing bucket.
7330
8827
  # @return [String]
7331
8828
  #
7332
8829
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketReplicationRequest AWS API Documentation
@@ -7351,12 +8848,22 @@ module Aws::S3
7351
8848
  # }
7352
8849
  #
7353
8850
  # @!attribute [rw] bucket
8851
+ # The bucket name.
7354
8852
  # @return [String]
7355
8853
  #
7356
8854
  # @!attribute [rw] content_md5
8855
+ # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
8856
+ # this header as a message integrity check to verify that the request
8857
+ # body was not corrupted in transit. For more information, see [RFC
8858
+ # 1864][1].
8859
+ #
8860
+ #
8861
+ #
8862
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
7357
8863
  # @return [String]
7358
8864
  #
7359
8865
  # @!attribute [rw] request_payment_configuration
8866
+ # Container for Payer.
7360
8867
  # @return [Types::RequestPaymentConfiguration]
7361
8868
  #
7362
8869
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketRequestPaymentRequest AWS API Documentation
@@ -7385,12 +8892,22 @@ module Aws::S3
7385
8892
  # }
7386
8893
  #
7387
8894
  # @!attribute [rw] bucket
8895
+ # The bucket name.
7388
8896
  # @return [String]
7389
8897
  #
7390
8898
  # @!attribute [rw] content_md5
8899
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
8900
+ # header as a message integrity check to verify that the request body
8901
+ # was not corrupted in transit. For more information, see [RFC
8902
+ # 1864][1].
8903
+ #
8904
+ #
8905
+ #
8906
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
7391
8907
  # @return [String]
7392
8908
  #
7393
8909
  # @!attribute [rw] tagging
8910
+ # Container for the TagSet and Tag elements.
7394
8911
  # @return [Types::Tagging]
7395
8912
  #
7396
8913
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketTaggingRequest AWS API Documentation
@@ -7416,9 +8933,18 @@ module Aws::S3
7416
8933
  # }
7417
8934
  #
7418
8935
  # @!attribute [rw] bucket
8936
+ # The bucket name.
7419
8937
  # @return [String]
7420
8938
  #
7421
8939
  # @!attribute [rw] content_md5
8940
+ # &gt;The base64-encoded 128-bit MD5 digest of the data. You must use
8941
+ # this header as a message integrity check to verify that the request
8942
+ # body was not corrupted in transit. For more information, see [RFC
8943
+ # 1864][1].
8944
+ #
8945
+ #
8946
+ #
8947
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
7422
8948
  # @return [String]
7423
8949
  #
7424
8950
  # @!attribute [rw] mfa
@@ -7428,6 +8954,7 @@ module Aws::S3
7428
8954
  # @return [String]
7429
8955
  #
7430
8956
  # @!attribute [rw] versioning_configuration
8957
+ # Container for setting the versioning state.
7431
8958
  # @return [Types::VersioningConfiguration]
7432
8959
  #
7433
8960
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketVersioningRequest AWS API Documentation
@@ -7476,12 +9003,22 @@ module Aws::S3
7476
9003
  # }
7477
9004
  #
7478
9005
  # @!attribute [rw] bucket
9006
+ # The bucket name.
7479
9007
  # @return [String]
7480
9008
  #
7481
9009
  # @!attribute [rw] content_md5
9010
+ # The base64-encoded 128-bit MD5 digest of the data. You must use this
9011
+ # header as a message integrity check to verify that the request body
9012
+ # was not corrupted in transit. For more information, see [RFC
9013
+ # 1864][1].
9014
+ #
9015
+ #
9016
+ #
9017
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
7482
9018
  # @return [String]
7483
9019
  #
7484
9020
  # @!attribute [rw] website_configuration
9021
+ # Container for the request.
7485
9022
  # @return [Types::WebsiteConfiguration]
7486
9023
  #
7487
9024
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketWebsiteRequest AWS API Documentation
@@ -7541,7 +9078,12 @@ module Aws::S3
7541
9078
  # }
7542
9079
  #
7543
9080
  # @!attribute [rw] acl
7544
- # The canned ACL to apply to the object.
9081
+ # The canned ACL to apply to the object. For more information, see
9082
+ # [Canned ACL][1]
9083
+ #
9084
+ #
9085
+ #
9086
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
7545
9087
  # @return [String]
7546
9088
  #
7547
9089
  # @!attribute [rw] access_control_policy
@@ -7550,9 +9092,18 @@ module Aws::S3
7550
9092
  # @return [Types::AccessControlPolicy]
7551
9093
  #
7552
9094
  # @!attribute [rw] bucket
9095
+ # The name of the bucket to which the ACL is being added.
7553
9096
  # @return [String]
7554
9097
  #
7555
9098
  # @!attribute [rw] content_md5
9099
+ # The base64-encoded 128-bit MD5 digest of the data. This header must
9100
+ # be used as a message integrity check to verify that the request body
9101
+ # was not corrupted in transit. For more information, go to [RFC
9102
+ # 1864.&gt;][1]
9103
+ #
9104
+ #
9105
+ #
9106
+ # [1]: http://www.ietf.org/rfc/rfc1864.txt
7556
9107
  # @return [String]
7557
9108
  #
7558
9109
  # @!attribute [rw] grant_full_control
@@ -7578,6 +9129,7 @@ module Aws::S3
7578
9129
  # @return [String]
7579
9130
  #
7580
9131
  # @!attribute [rw] key
9132
+ # Key for which the PUT operation was initiated.
7581
9133
  # @return [String]
7582
9134
  #
7583
9135
  # @!attribute [rw] request_payer
@@ -7711,12 +9263,12 @@ module Aws::S3
7711
9263
  # }
7712
9264
  #
7713
9265
  # @!attribute [rw] bucket
7714
- # The bucket whose object lock configuration you want to create or
9266
+ # The bucket whose Object Lock configuration you want to create or
7715
9267
  # replace.
7716
9268
  # @return [String]
7717
9269
  #
7718
9270
  # @!attribute [rw] object_lock_configuration
7719
- # The object lock configuration that you want to apply to the
9271
+ # The Object Lock configuration that you want to apply to the
7720
9272
  # specified bucket.
7721
9273
  # @return [Types::ObjectLockConfiguration]
7722
9274
  #
@@ -7729,8 +9281,7 @@ module Aws::S3
7729
9281
  # @return [String]
7730
9282
  #
7731
9283
  # @!attribute [rw] token
7732
- # A token to allow Amazon S3 object lock to be enabled for an existing
7733
- # bucket.
9284
+ # A token to allow Object Lock to be enabled for an existing bucket.
7734
9285
  # @return [String]
7735
9286
  #
7736
9287
  # @!attribute [rw] content_md5
@@ -7749,9 +9300,11 @@ module Aws::S3
7749
9300
  end
7750
9301
 
7751
9302
  # @!attribute [rw] expiration
7752
- # If the object expiration is configured, this will contain the
7753
- # expiration date (expiry-date) and rule ID (rule-id). The value of
7754
- # rule-id is URL encoded.
9303
+ # If the expiration is configured for the object (see
9304
+ # PutBucketLifecycleConfiguration), the response includes this header.
9305
+ # It includes the expiry-date and rule-id key-value pairs that provide
9306
+ # information about object expiration. The value of the rule-id is URL
9307
+ # encoded.
7755
9308
  # @return [String]
7756
9309
  #
7757
9310
  # @!attribute [rw] etag
@@ -7759,8 +9312,10 @@ module Aws::S3
7759
9312
  # @return [String]
7760
9313
  #
7761
9314
  # @!attribute [rw] server_side_encryption
7762
- # The Server-side encryption algorithm used when storing this object
7763
- # in S3 (e.g., AES256, aws:kms).
9315
+ # If you specified server-side encryption either with an AWS KMS
9316
+ # customer master key (CMK) or Amazon S3-managed encryption key in
9317
+ # your PUT request, the response includes this header. It confirms the
9318
+ # encryption algorithm that Amazon S3 used to encrypt the object.
7764
9319
  # @return [String]
7765
9320
  #
7766
9321
  # @!attribute [rw] version_id
@@ -7781,8 +9336,10 @@ module Aws::S3
7781
9336
  # @return [String]
7782
9337
  #
7783
9338
  # @!attribute [rw] ssekms_key_id
7784
- # If present, specifies the ID of the AWS Key Management Service (KMS)
7785
- # master encryption key that was used for the object.
9339
+ # If the x-amz-server-side-encryption is present and has the value of
9340
+ # aws:kms, this header specifies the ID of the AWS Key Management
9341
+ # Service (KMS) customer master key (CMK) that was used for the
9342
+ # object.
7786
9343
  # @return [String]
7787
9344
  #
7788
9345
  # @!attribute [rw] ssekms_encryption_context
@@ -7851,7 +9408,12 @@ module Aws::S3
7851
9408
  # }
7852
9409
  #
7853
9410
  # @!attribute [rw] acl
7854
- # The canned ACL to apply to the object.
9411
+ # The canned ACL to apply to the object. For more information, see
9412
+ # [Canned ACL][1].
9413
+ #
9414
+ #
9415
+ #
9416
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
7855
9417
  # @return [String]
7856
9418
  #
7857
9419
  # @!attribute [rw] body
@@ -7863,17 +9425,35 @@ module Aws::S3
7863
9425
  # @return [String]
7864
9426
  #
7865
9427
  # @!attribute [rw] cache_control
7866
- # Specifies caching behavior along the request/reply chain.
9428
+ # Can be used to specify caching behavior along the request/reply
9429
+ # chain. For more information, see
9430
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9][1].
9431
+ #
9432
+ #
9433
+ #
9434
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.9
7867
9435
  # @return [String]
7868
9436
  #
7869
9437
  # @!attribute [rw] content_disposition
7870
- # Specifies presentational information for the object.
9438
+ # Specifies presentational information for the object. For more
9439
+ # information, see
9440
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1][1].
9441
+ #
9442
+ #
9443
+ #
9444
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
7871
9445
  # @return [String]
7872
9446
  #
7873
9447
  # @!attribute [rw] content_encoding
7874
9448
  # Specifies what content encodings have been applied to the object and
7875
9449
  # thus what decoding mechanisms must be applied to obtain the
7876
- # media-type referenced by the Content-Type header field.
9450
+ # media-type referenced by the Content-Type header field. For more
9451
+ # information, see
9452
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11][1].
9453
+ #
9454
+ #
9455
+ #
9456
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
7877
9457
  # @return [String]
7878
9458
  #
7879
9459
  # @!attribute [rw] content_language
@@ -7882,21 +9462,47 @@ module Aws::S3
7882
9462
  #
7883
9463
  # @!attribute [rw] content_length
7884
9464
  # Size of the body in bytes. This parameter is useful when the size of
7885
- # the body cannot be determined automatically.
9465
+ # the body cannot be determined automatically. For more information,
9466
+ # see
9467
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13][1].
9468
+ #
9469
+ #
9470
+ #
9471
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
7886
9472
  # @return [Integer]
7887
9473
  #
7888
9474
  # @!attribute [rw] content_md5
7889
- # The base64-encoded 128-bit MD5 digest of the part data. This
7890
- # parameter is auto-populated when using the command from the CLI.
7891
- # This parameted is required if object lock parameters are specified.
9475
+ # The base64-encoded 128-bit MD5 digest of the message (without the
9476
+ # headers) according to RFC 1864. This header can be used as a message
9477
+ # integrity check to verify that the data is the same data that was
9478
+ # originally sent. Although it is optional, we recommend using the
9479
+ # Content-MD5 mechanism as an end-to-end integrity check. For more
9480
+ # information about REST request authentication, see [REST
9481
+ # Authentication][1].
9482
+ #
9483
+ #
9484
+ #
9485
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
7892
9486
  # @return [String]
7893
9487
  #
7894
9488
  # @!attribute [rw] content_type
7895
- # A standard MIME type describing the format of the object data.
9489
+ # A standard MIME type describing the format of the contents. For more
9490
+ # information, see
9491
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17][1].
9492
+ #
9493
+ #
9494
+ #
9495
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
7896
9496
  # @return [String]
7897
9497
  #
7898
9498
  # @!attribute [rw] expires
7899
- # The date and time at which the object is no longer cacheable.
9499
+ # The date and time at which the object is no longer cacheable. For
9500
+ # more information, see
9501
+ # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21][1].
9502
+ #
9503
+ #
9504
+ #
9505
+ # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
7900
9506
  # @return [Time]
7901
9507
  #
7902
9508
  # @!attribute [rw] grant_full_control
@@ -7930,14 +9536,34 @@ module Aws::S3
7930
9536
  # @return [String]
7931
9537
  #
7932
9538
  # @!attribute [rw] storage_class
7933
- # The type of storage to use for the object. Defaults to 'STANDARD'.
9539
+ # If you don't specify, Standard is the default storage class. Amazon
9540
+ # S3 supports other storage classes.
7934
9541
  # @return [String]
7935
9542
  #
7936
9543
  # @!attribute [rw] website_redirect_location
7937
9544
  # If the bucket is configured as a website, redirects requests for
7938
9545
  # this object to another object in the same bucket or to an external
7939
9546
  # URL. Amazon S3 stores the value of this header in the object
7940
- # metadata.
9547
+ # metadata. For information about object metadata, see .
9548
+ #
9549
+ # In the following example, the request header sets the redirect to an
9550
+ # object (anotherPage.html) in the same bucket:
9551
+ #
9552
+ # `x-amz-website-redirect-location: /anotherPage.html`
9553
+ #
9554
+ # In the following example, the request header sets the object
9555
+ # redirect to another website:
9556
+ #
9557
+ # `x-amz-website-redirect-location: http://www.example.com/`
9558
+ #
9559
+ # For more information about website hosting in Amazon S3, see
9560
+ # [Hosting Websites on Amazon S3][1] and [How to Configure Website
9561
+ # Page Redirects][2].
9562
+ #
9563
+ #
9564
+ #
9565
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html
9566
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html
7941
9567
  # @return [String]
7942
9568
  #
7943
9569
  # @!attribute [rw] sse_customer_algorithm
@@ -7960,11 +9586,16 @@ module Aws::S3
7960
9586
  # @return [String]
7961
9587
  #
7962
9588
  # @!attribute [rw] ssekms_key_id
7963
- # Specifies the AWS KMS key ID to use for object encryption. All GET
7964
- # and PUT requests for an object protected by AWS KMS will fail if not
7965
- # made via SSL or using SigV4. Documentation on configuring any of the
7966
- # officially supported AWS SDKs and CLI can be found at
7967
- # http://docs.aws.amazon.com/AmazonS3/latest/dev/UsingAWSSDK.html#specify-signature-version
9589
+ # If the x-amz-server-side-encryption is present and has the value of
9590
+ # aws:kms, this header specifies the ID of the AWS Key Management
9591
+ # Service (AWS KMS) customer master key (CMK) that was used for the
9592
+ # object.
9593
+ #
9594
+ # If the value of x-amz-server-side-encryption is aws:kms, this header
9595
+ # specifies the ID of the AWS KMS CMK that will be used for the
9596
+ # object. If you specify x-amz-server-side-encryption:aws:kms, but do
9597
+ # not provide x-amz-server-side-encryption-aws-kms-key-id, Amazon S3
9598
+ # uses the AWS managed CMK in AWS to protect the data.
7968
9599
  # @return [String]
7969
9600
  #
7970
9601
  # @!attribute [rw] ssekms_encryption_context
@@ -7987,17 +9618,21 @@ module Aws::S3
7987
9618
  # @return [String]
7988
9619
  #
7989
9620
  # @!attribute [rw] object_lock_mode
7990
- # The object lock mode that you want to apply to this object.
9621
+ # The Object Lock mode that you want to apply to this object.
7991
9622
  # @return [String]
7992
9623
  #
7993
9624
  # @!attribute [rw] object_lock_retain_until_date
7994
- # The date and time when you want this object's object lock to
9625
+ # The date and time when you want this object's Object Lock to
7995
9626
  # expire.
7996
9627
  # @return [Time]
7997
9628
  #
7998
9629
  # @!attribute [rw] object_lock_legal_hold_status
7999
- # The Legal Hold status that you want to apply to the specified
8000
- # object.
9630
+ # Specifies whether a legal hold will be applied to this object. For
9631
+ # more information about S3 Object Lock, see [Object Lock][1].
9632
+ #
9633
+ #
9634
+ #
9635
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock.html
8001
9636
  # @return [String]
8002
9637
  #
8003
9638
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectRequest AWS API Documentation
@@ -8093,7 +9728,7 @@ module Aws::S3
8093
9728
  #
8094
9729
  # @!attribute [rw] bypass_governance_retention
8095
9730
  # Indicates whether this operation should bypass Governance-mode
8096
- # restrictions.j
9731
+ # restrictions.
8097
9732
  # @return [Boolean]
8098
9733
  #
8099
9734
  # @!attribute [rw] content_md5
@@ -8114,6 +9749,7 @@ module Aws::S3
8114
9749
  end
8115
9750
 
8116
9751
  # @!attribute [rw] version_id
9752
+ # The versionId of the object the tag-set was added to.
8117
9753
  # @return [String]
8118
9754
  #
8119
9755
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectTaggingOutput AWS API Documentation
@@ -8142,18 +9778,23 @@ module Aws::S3
8142
9778
  # }
8143
9779
  #
8144
9780
  # @!attribute [rw] bucket
9781
+ # The bucket containing the object.
8145
9782
  # @return [String]
8146
9783
  #
8147
9784
  # @!attribute [rw] key
9785
+ # Name of the tag.
8148
9786
  # @return [String]
8149
9787
  #
8150
9788
  # @!attribute [rw] version_id
9789
+ # The versionId of the object that the tag-set will be added to.
8151
9790
  # @return [String]
8152
9791
  #
8153
9792
  # @!attribute [rw] content_md5
9793
+ # The MD5 hash for the request body.
8154
9794
  # @return [String]
8155
9795
  #
8156
9796
  # @!attribute [rw] tagging
9797
+ # Container for the TagSet and Tag elements
8157
9798
  # @return [Types::Tagging]
8158
9799
  #
8159
9800
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectTaggingRequest AWS API Documentation
@@ -8247,9 +9888,17 @@ module Aws::S3
8247
9888
  # @return [String]
8248
9889
  #
8249
9890
  # @!attribute [rw] events
9891
+ # A collection of bucket events for which to send notiications
8250
9892
  # @return [Array<String>]
8251
9893
  #
8252
9894
  # @!attribute [rw] filter
9895
+ # Specifies object key name filtering rules. For information about key
9896
+ # name filtering, see [Configuring Event Notifications][1] in the
9897
+ # *Amazon Simple Storage Service Developer Guide*.
9898
+ #
9899
+ #
9900
+ #
9901
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
8253
9902
  # @return [Types::NotificationConfigurationFilter]
8254
9903
  #
8255
9904
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/QueueConfiguration AWS API Documentation
@@ -8262,6 +9911,11 @@ module Aws::S3
8262
9911
  include Aws::Structure
8263
9912
  end
8264
9913
 
9914
+ # This data type is deprecated. Please use QueueConfiguration for the
9915
+ # same purposes. This dat type specifies the configuration for
9916
+ # publishing messages to an Amazon Simple Queue Service (Amazon SQS)
9917
+ # queue when Amazon S3 detects specified events.
9918
+ #
8265
9919
  # @note When making an API call, you may pass QueueConfigurationDeprecated
8266
9920
  # data as a hash:
8267
9921
  #
@@ -8283,9 +9937,13 @@ module Aws::S3
8283
9937
  # @return [String]
8284
9938
  #
8285
9939
  # @!attribute [rw] events
9940
+ # A collection of bucket events for which to send notiications
8286
9941
  # @return [Array<String>]
8287
9942
  #
8288
9943
  # @!attribute [rw] queue
9944
+ # The Amazon Resource Name (ARN) of the Amazon SQS queue to which
9945
+ # Amazon S3 publishes a message when it detects events of the
9946
+ # specified type.
8289
9947
  # @return [String]
8290
9948
  #
8291
9949
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/QueueConfigurationDeprecated AWS API Documentation
@@ -8298,6 +9956,8 @@ module Aws::S3
8298
9956
  include Aws::Structure
8299
9957
  end
8300
9958
 
9959
+ # The container for the records event.
9960
+ #
8301
9961
  # @!attribute [rw] payload
8302
9962
  # The byte array of partial, one or more result records.
8303
9963
  # @return [String]
@@ -8429,6 +10089,9 @@ module Aws::S3
8429
10089
  # status: "Enabled", # required, accepts Enabled, Disabled
8430
10090
  # },
8431
10091
  # },
10092
+ # existing_object_replication: {
10093
+ # status: "Enabled", # required, accepts Enabled, Disabled
10094
+ # },
8432
10095
  # destination: { # required
8433
10096
  # bucket: "BucketName", # required
8434
10097
  # account: "AccountId",
@@ -8450,13 +10113,12 @@ module Aws::S3
8450
10113
  # @!attribute [rw] role
8451
10114
  # The Amazon Resource Name (ARN) of the AWS Identity and Access
8452
10115
  # Management (IAM) role that Amazon S3 assumes when replicating
8453
- # objects. For more information, see [How to Set Up Cross-Region
8454
- # Replication][1] in the *Amazon Simple Storage Service Developer
8455
- # Guide*.
10116
+ # objects. For more information, see [How to Set Up Replication][1] in
10117
+ # the *Amazon Simple Storage Service Developer Guide*.
8456
10118
  #
8457
10119
  #
8458
10120
  #
8459
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/crr-how-setup.html
10121
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-how-setup.html
8460
10122
  # @return [String]
8461
10123
  #
8462
10124
  # @!attribute [rw] rules
@@ -8505,6 +10167,9 @@ module Aws::S3
8505
10167
  # status: "Enabled", # required, accepts Enabled, Disabled
8506
10168
  # },
8507
10169
  # },
10170
+ # existing_object_replication: {
10171
+ # status: "Enabled", # required, accepts Enabled, Disabled
10172
+ # },
8508
10173
  # destination: { # required
8509
10174
  # bucket: "BucketName", # required
8510
10175
  # account: "AccountId",
@@ -8539,12 +10204,9 @@ module Aws::S3
8539
10204
  # * Same object qualify tag based filter criteria specified in
8540
10205
  # multiple rules
8541
10206
  #
8542
- # For more information, see [Cross-Region Replication (CRR)][1] in the
8543
- # *Amazon S3 Developer Guide*.
8544
- #
8545
- #
8546
- #
8547
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/crr.html
10207
+ # For more information, see [Replication](
10208
+ # https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html) in
10209
+ # the *Amazon S3 Developer Guide*.
8548
10210
  # @return [Integer]
8549
10211
  #
8550
10212
  # @!attribute [rw] prefix
@@ -8555,6 +10217,9 @@ module Aws::S3
8555
10217
  # @return [String]
8556
10218
  #
8557
10219
  # @!attribute [rw] filter
10220
+ # A filter that identifies the subset of objects to which the
10221
+ # replication rule applies. A `Filter` must specify exactly one
10222
+ # `Prefix`, `Tag`, or an `And` child element.
8558
10223
  # @return [Types::ReplicationRuleFilter]
8559
10224
  #
8560
10225
  # @!attribute [rw] status
@@ -8566,14 +10231,40 @@ module Aws::S3
8566
10231
  # source objects that you want to replicate. You can choose to enable
8567
10232
  # or disable the replication of these objects. Currently, Amazon S3
8568
10233
  # supports only the filter that you can specify for objects created
8569
- # with server-side encryption using an AWS KMS-Managed Key (SSE-KMS).
10234
+ # with server-side encryption using a customer master key (CMK) stored
10235
+ # in AWS Key Management Service (SSE-KMS).
8570
10236
  # @return [Types::SourceSelectionCriteria]
8571
10237
  #
10238
+ # @!attribute [rw] existing_object_replication
10239
+ # A container that specifies information about existing object
10240
+ # replication. You can choose whether to enable or disable the
10241
+ # replication of existing objects.
10242
+ # @return [Types::ExistingObjectReplication]
10243
+ #
8572
10244
  # @!attribute [rw] destination
8573
10245
  # A container for information about the replication destination.
8574
10246
  # @return [Types::Destination]
8575
10247
  #
8576
10248
  # @!attribute [rw] delete_marker_replication
10249
+ # Specifies whether Amazon S3 replicates the delete markers. If you
10250
+ # specify a `Filter`, you must specify this element. However, in the
10251
+ # latest version of replication configuration (when `Filter` is
10252
+ # specified), Amazon S3 doesn't replicate delete markers. Therefore,
10253
+ # the `DeleteMarkerReplication` element can contain only
10254
+ # &lt;Status&gt;Disabled&lt;/Status&gt;. For an example configuration,
10255
+ # see [Basic Rule Configuration][1].
10256
+ #
10257
+ # <note markdown="1"> If you don't specify the Filter element, Amazon S3 assumes the
10258
+ # replication configuration is the earlier version, V1. In the earlier
10259
+ # version, Amazon S3 handled replication of delete markers
10260
+ # differently. For more information, see [Backward Compatibility][2].
10261
+ #
10262
+ # </note>
10263
+ #
10264
+ #
10265
+ #
10266
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-config-min-rule-config
10267
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations
8577
10268
  # @return [Types::DeleteMarkerReplication]
8578
10269
  #
8579
10270
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ReplicationRule AWS API Documentation
@@ -8585,11 +10276,24 @@ module Aws::S3
8585
10276
  :filter,
8586
10277
  :status,
8587
10278
  :source_selection_criteria,
10279
+ :existing_object_replication,
8588
10280
  :destination,
8589
10281
  :delete_marker_replication)
8590
10282
  include Aws::Structure
8591
10283
  end
8592
10284
 
10285
+ # A container for specifying rule filters. The filters determine the
10286
+ # subset of objects to which the rule applies. This element is required
10287
+ # only if you specify more than one filter.
10288
+ #
10289
+ # For example:
10290
+ #
10291
+ # * If you specify both a Prefix and a Tag filter, wrap these filters in
10292
+ # an And tag.
10293
+ #
10294
+ # * If you specify a filter based on multiple tags, wrap the Tag
10295
+ # elements in an And tag
10296
+ #
8593
10297
  # @note When making an API call, you may pass ReplicationRuleAndOperator
8594
10298
  # data as a hash:
8595
10299
  #
@@ -8604,9 +10308,12 @@ module Aws::S3
8604
10308
  # }
8605
10309
  #
8606
10310
  # @!attribute [rw] prefix
10311
+ # An object keyname prefix that identifies the subset of objects to
10312
+ # which the rule applies.
8607
10313
  # @return [String]
8608
10314
  #
8609
10315
  # @!attribute [rw] tags
10316
+ # An array of tags containing key and value pairs.
8610
10317
  # @return [Array<Types::Tag>]
8611
10318
  #
8612
10319
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ReplicationRuleAndOperator AWS API Documentation
@@ -8673,6 +10380,8 @@ module Aws::S3
8673
10380
  include Aws::Structure
8674
10381
  end
8675
10382
 
10383
+ # Container for Payer.
10384
+ #
8676
10385
  # @note When making an API call, you may pass RequestPaymentConfiguration
8677
10386
  # data as a hash:
8678
10387
  #
@@ -8691,6 +10400,9 @@ module Aws::S3
8691
10400
  include Aws::Structure
8692
10401
  end
8693
10402
 
10403
+ # Container for specifiying if periodic QueryProgress messages should be
10404
+ # sent.
10405
+ #
8694
10406
  # @note When making an API call, you may pass RequestProgress
8695
10407
  # data as a hash:
8696
10408
  #
@@ -8820,15 +10532,19 @@ module Aws::S3
8820
10532
  # }
8821
10533
  #
8822
10534
  # @!attribute [rw] bucket
10535
+ # The bucket name.
8823
10536
  # @return [String]
8824
10537
  #
8825
10538
  # @!attribute [rw] key
10539
+ # Object key for which the operation was initiated.
8826
10540
  # @return [String]
8827
10541
  #
8828
10542
  # @!attribute [rw] version_id
10543
+ # VersionId used to reference a specific version of the object.
8829
10544
  # @return [String]
8830
10545
  #
8831
10546
  # @!attribute [rw] restore_request
10547
+ # Container for restore job parameters.
8832
10548
  # @return [Types::RestoreRequest]
8833
10549
  #
8834
10550
  # @!attribute [rw] request_payer
@@ -9059,6 +10775,7 @@ module Aws::S3
9059
10775
  # }
9060
10776
  #
9061
10777
  # @!attribute [rw] expiration
10778
+ # Specifies the expiration for the lifecycle of the object.
9062
10779
  # @return [Types::LifecycleExpiration]
9063
10780
  #
9064
10781
  # @!attribute [rw] id
@@ -9077,15 +10794,39 @@ module Aws::S3
9077
10794
  # @return [String]
9078
10795
  #
9079
10796
  # @!attribute [rw] transition
10797
+ # Specifies when an object transitions to a specified storage class.
9080
10798
  # @return [Types::Transition]
9081
10799
  #
9082
10800
  # @!attribute [rw] noncurrent_version_transition
10801
+ # Container for the transition rule that describes when noncurrent
10802
+ # objects transition to the `STANDARD_IA`, `ONEZONE_IA`,
10803
+ # `INTELLIGENT_TIERING`, `GLACIER`, or `DEEP_ARCHIVE` storage class.
10804
+ # If your bucket is versioning-enabled (or versioning is suspended),
10805
+ # you can set this action to request that Amazon S3 transition
10806
+ # noncurrent object versions to the `STANDARD_IA`, `ONEZONE_IA`,
10807
+ # `INTELLIGENT_TIERING`, `GLACIER`, or `DEEP_ARCHIVE` storage class at
10808
+ # a specific period in the object's lifetime.
9083
10809
  # @return [Types::NoncurrentVersionTransition]
9084
10810
  #
9085
10811
  # @!attribute [rw] noncurrent_version_expiration
10812
+ # Specifies when noncurrent object versions expire. Upon expiration,
10813
+ # Amazon S3 permanently deletes the noncurrent object versions. You
10814
+ # set this lifecycle configuration action on a bucket that has
10815
+ # versioning enabled (or suspended) to request that Amazon S3 delete
10816
+ # noncurrent object versions at a specific period in the object's
10817
+ # lifetime.
9086
10818
  # @return [Types::NoncurrentVersionExpiration]
9087
10819
  #
9088
10820
  # @!attribute [rw] abort_incomplete_multipart_upload
10821
+ # Specifies the days since the initiation of an incomplete multipart
10822
+ # upload that Amazon S3 will wait before permanently removing all
10823
+ # parts of the upload. For more information, see [ Aborting Incomplete
10824
+ # Multipart Uploads Using a Bucket Lifecycle Policy][1] in the *Amazon
10825
+ # Simple Storage Service Developer Guide*.
10826
+ #
10827
+ #
10828
+ #
10829
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html#mpu-abort-incomplete-mpu-lifecycle-config
9089
10830
  # @return [Types::AbortIncompleteMultipartUpload]
9090
10831
  #
9091
10832
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Rule AWS API Documentation
@@ -9117,6 +10858,8 @@ module Aws::S3
9117
10858
  # }
9118
10859
  #
9119
10860
  # @!attribute [rw] filter_rules
10861
+ # A list of containers for the key value pair that defines the
10862
+ # criteria for the filter rule.
9120
10863
  # @return [Array<Types::FilterRule>]
9121
10864
  #
9122
10865
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/S3KeyFilter AWS API Documentation
@@ -9180,6 +10923,7 @@ module Aws::S3
9180
10923
  # @return [String]
9181
10924
  #
9182
10925
  # @!attribute [rw] encryption
10926
+ # Contains the type of server-side encryption used.
9183
10927
  # @return [Types::Encryption]
9184
10928
  #
9185
10929
  # @!attribute [rw] canned_acl
@@ -9226,8 +10970,8 @@ module Aws::S3
9226
10970
  # }
9227
10971
  #
9228
10972
  # @!attribute [rw] key_id
9229
- # Specifies the ID of the AWS Key Management Service (KMS) master
9230
- # encryption key to use for encrypting Inventory reports.
10973
+ # Specifies the ID of the AWS Key Management Service (KMS) customer
10974
+ # master key (CMK) to use for encrypting Inventory reports.
9231
10975
  # @return [String]
9232
10976
  #
9233
10977
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SSEKMS AWS API Documentation
@@ -9255,13 +10999,19 @@ module Aws::S3
9255
10999
  #
9256
11000
  # @!attribute [rw] start
9257
11001
  # Specifies the start of the byte range. This parameter is optional.
9258
- # Valid values: non-negative integers. The default value is 0.
11002
+ # Valid values: non-negative integers. The default value is 0. If only
11003
+ # start is supplied, it means scan from that point to the end of the
11004
+ # file.For example; `<scanrange><start>50</start></scanrange>` means
11005
+ # scan from byte 50 until the end of the file.
9259
11006
  # @return [Integer]
9260
11007
  #
9261
11008
  # @!attribute [rw] end
9262
11009
  # Specifies the end of the byte range. This parameter is optional.
9263
11010
  # Valid values: non-negative integers. The default value is one less
9264
- # than the size of the object being queried.
11011
+ # than the size of the object being queried. If only the End parameter
11012
+ # is supplied, it is interpreted to mean scan the last N bytes of the
11013
+ # file. For example; `<scanrange><end>50</end></scanrange>` means scan
11014
+ # the last 50 bytes.
9265
11015
  # @return [Integer]
9266
11016
  #
9267
11017
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ScanRange AWS API Documentation
@@ -9273,6 +11023,7 @@ module Aws::S3
9273
11023
  end
9274
11024
 
9275
11025
  # @!attribute [rw] payload
11026
+ # The array of results.
9276
11027
  # @return [Types::SelectObjectContentEventStream]
9277
11028
  #
9278
11029
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SelectObjectContentOutput AWS API Documentation
@@ -9409,6 +11160,18 @@ module Aws::S3
9409
11160
  # This parameter is optional, but when specified, it must not be
9410
11161
  # empty. See RFC 2616, Section 14.35.1 about how to specify the start
9411
11162
  # and end of the range.
11163
+ #
11164
+ # `ScanRange`may be used in the following ways:
11165
+ #
11166
+ # * `<scanrange><start>50</start><end>100</end></scanrange>` - process
11167
+ # only the records starting between the bytes 50 and 100 (inclusive,
11168
+ # counting from zero)
11169
+ #
11170
+ # * `<scanrange><start>50</start></scanrange>` - process only the
11171
+ # records starting after the byte 50
11172
+ #
11173
+ # * `<scanrange><end>50</end></scanrange>` - process only the records
11174
+ # within the last 50 bytes of the file.
9412
11175
  # @return [Types::ScanRange]
9413
11176
  #
9414
11177
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SelectObjectContentRequest AWS API Documentation
@@ -9585,7 +11348,8 @@ module Aws::S3
9585
11348
  # source objects that you want to replicate. You can choose to enable or
9586
11349
  # disable the replication of these objects. Currently, Amazon S3
9587
11350
  # supports only the filter that you can specify for objects created with
9588
- # server-side encryption using an AWS KMS-Managed Key (SSE-KMS).
11351
+ # server-side encryption using a customer master key (CMK) stored in AWS
11352
+ # Key Management Service (SSE-KMS).
9589
11353
  #
9590
11354
  # @note When making an API call, you may pass SourceSelectionCriteria
9591
11355
  # data as a hash:
@@ -9622,7 +11386,8 @@ module Aws::S3
9622
11386
  #
9623
11387
  # @!attribute [rw] status
9624
11388
  # Specifies whether Amazon S3 replicates objects created with
9625
- # server-side encryption using an AWS KMS-managed key.
11389
+ # server-side encryption using a customer master key (CMK) stored in
11390
+ # AWS Key Management Service.
9626
11391
  # @return [String]
9627
11392
  #
9628
11393
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SseKmsEncryptedObjects AWS API Documentation
@@ -9632,6 +11397,8 @@ module Aws::S3
9632
11397
  include Aws::Structure
9633
11398
  end
9634
11399
 
11400
+ # Container for the stats details.
11401
+ #
9635
11402
  # @!attribute [rw] bytes_scanned
9636
11403
  # The total number of object bytes scanned.
9637
11404
  # @return [Integer]
@@ -9653,6 +11420,8 @@ module Aws::S3
9653
11420
  include Aws::Structure
9654
11421
  end
9655
11422
 
11423
+ # Container for the Stats Event.
11424
+ #
9656
11425
  # @!attribute [rw] details
9657
11426
  # The Stats event details.
9658
11427
  # @return [Types::Stats]
@@ -9698,6 +11467,9 @@ module Aws::S3
9698
11467
  include Aws::Structure
9699
11468
  end
9700
11469
 
11470
+ # Container for data related to the storage class analysis for an Amazon
11471
+ # S3 bucket for export.
11472
+ #
9701
11473
  # @note When making an API call, you may pass StorageClassAnalysisDataExport
9702
11474
  # data as a hash:
9703
11475
  #
@@ -9730,6 +11502,8 @@ module Aws::S3
9730
11502
  include Aws::Structure
9731
11503
  end
9732
11504
 
11505
+ # A container of a key value name pair.
11506
+ #
9733
11507
  # @note When making an API call, you may pass Tag
9734
11508
  # data as a hash:
9735
11509
  #
@@ -9754,6 +11528,8 @@ module Aws::S3
9754
11528
  include Aws::Structure
9755
11529
  end
9756
11530
 
11531
+ # Container for TagSet elements.
11532
+ #
9757
11533
  # @note When making an API call, you may pass Tagging
9758
11534
  # data as a hash:
9759
11535
  #
@@ -9767,6 +11543,7 @@ module Aws::S3
9767
11543
  # }
9768
11544
  #
9769
11545
  # @!attribute [rw] tag_set
11546
+ # A collection for a a set of tags
9770
11547
  # @return [Array<Types::Tag>]
9771
11548
  #
9772
11549
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Tagging AWS API Documentation
@@ -9776,6 +11553,8 @@ module Aws::S3
9776
11553
  include Aws::Structure
9777
11554
  end
9778
11555
 
11556
+ # Container for granting information.
11557
+ #
9779
11558
  # @note When making an API call, you may pass TargetGrant
9780
11559
  # data as a hash:
9781
11560
  #
@@ -9791,6 +11570,7 @@ module Aws::S3
9791
11570
  # }
9792
11571
  #
9793
11572
  # @!attribute [rw] grantee
11573
+ # Container for the person being granted permissions.
9794
11574
  # @return [Types::Grantee]
9795
11575
  #
9796
11576
  # @!attribute [rw] permission
@@ -9851,6 +11631,13 @@ module Aws::S3
9851
11631
  # @return [Array<String>]
9852
11632
  #
9853
11633
  # @!attribute [rw] filter
11634
+ # Specifies object key name filtering rules. For information about key
11635
+ # name filtering, see [Configuring Event Notifications][1] in the
11636
+ # *Amazon Simple Storage Service Developer Guide*.
11637
+ #
11638
+ #
11639
+ #
11640
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html
9854
11641
  # @return [Types::NotificationConfigurationFilter]
9855
11642
  #
9856
11643
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/TopicConfiguration AWS API Documentation
@@ -9863,6 +11650,11 @@ module Aws::S3
9863
11650
  include Aws::Structure
9864
11651
  end
9865
11652
 
11653
+ # A container for specifying the configuration for publication of
11654
+ # messages to an Amazon Simple Notification Service (Amazon SNS) topic
11655
+ # when Amazon S3 detects specified events. This data type is
11656
+ # deperecated. Please use TopicConfiguration instead.
11657
+ #
9866
11658
  # @note When making an API call, you may pass TopicConfigurationDeprecated
9867
11659
  # data as a hash:
9868
11660
  #
@@ -9880,6 +11672,7 @@ module Aws::S3
9880
11672
  # @return [String]
9881
11673
  #
9882
11674
  # @!attribute [rw] events
11675
+ # A collection of events related to objects
9883
11676
  # @return [Array<String>]
9884
11677
  #
9885
11678
  # @!attribute [rw] event
@@ -9943,6 +11736,7 @@ module Aws::S3
9943
11736
  # @return [String]
9944
11737
  #
9945
11738
  # @!attribute [rw] copy_part_result
11739
+ # Container for all response elements.
9946
11740
  # @return [Types::CopyPartResult]
9947
11741
  #
9948
11742
  # @!attribute [rw] server_side_encryption
@@ -9965,7 +11759,7 @@ module Aws::S3
9965
11759
  #
9966
11760
  # @!attribute [rw] ssekms_key_id
9967
11761
  # If present, specifies the ID of the AWS Key Management Service (KMS)
9968
- # master encryption key that was used for the object.
11762
+ # customer master key (CMK) that was used for the object.
9969
11763
  # @return [String]
9970
11764
  #
9971
11765
  # @!attribute [rw] request_charged
@@ -10010,6 +11804,7 @@ module Aws::S3
10010
11804
  # }
10011
11805
  #
10012
11806
  # @!attribute [rw] bucket
11807
+ # The bucket name.
10013
11808
  # @return [String]
10014
11809
  #
10015
11810
  # @!attribute [rw] copy_source
@@ -10045,6 +11840,7 @@ module Aws::S3
10045
11840
  # @return [String]
10046
11841
  #
10047
11842
  # @!attribute [rw] key
11843
+ # Object key for which the multipart upload was initiated.
10048
11844
  # @return [String]
10049
11845
  #
10050
11846
  # @!attribute [rw] part_number
@@ -10150,7 +11946,7 @@ module Aws::S3
10150
11946
  #
10151
11947
  # @!attribute [rw] ssekms_key_id
10152
11948
  # If present, specifies the ID of the AWS Key Management Service (KMS)
10153
- # master encryption key that was used for the object.
11949
+ # customer master key (CMK) was used for the object.
10154
11950
  # @return [String]
10155
11951
  #
10156
11952
  # @!attribute [rw] request_charged
@@ -10364,6 +12160,8 @@ module Aws::S3
10364
12160
  include Aws::Structure
10365
12161
  end
10366
12162
 
12163
+ # The continer for selecting objects from a content event stream.
12164
+ #
10367
12165
  # EventStream is an Enumerator of Events.
10368
12166
  # #event_types #=> Array, returns all modeled event types in the stream
10369
12167
  #