aws-sdk-s3 1.119.1 → 1.120.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.
@@ -58,14 +58,14 @@ module Aws::S3
58
58
  # bucket name. For more information about access point ARNs, see
59
59
  # [Using access points][1] in the *Amazon S3 User Guide*.
60
60
  #
61
- # When using this action with Amazon S3 on Outposts, you must direct
61
+ # When you use this action with Amazon S3 on Outposts, you must direct
62
62
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
63
63
  # takes the form `
64
64
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
65
- # When using this action with S3 on Outposts through the Amazon Web
66
- # Services SDKs, you provide the Outposts bucket ARN in place of the
67
- # bucket name. For more information about S3 on Outposts ARNs, see
68
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
65
+ # When you use this action with S3 on Outposts through the Amazon Web
66
+ # Services SDKs, you provide the Outposts access point ARN in place of
67
+ # the bucket name. For more information about S3 on Outposts ARNs, see
68
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
69
69
  #
70
70
  #
71
71
  #
@@ -460,22 +460,24 @@ module Aws::S3
460
460
  # @!attribute [rw] file_header_info
461
461
  # Describes the first line of input. Valid values are:
462
462
  #
463
- # * `NONE`\: First line is not a header.
463
+ # * `NONE`: First line is not a header.
464
464
  #
465
- # * `IGNORE`\: First line is a header, but you can't use the header
465
+ # * `IGNORE`: First line is a header, but you can't use the header
466
466
  # values to indicate the column in an expression. You can use column
467
467
  # position (such as \_1, \_2, …) to indicate the column (`SELECT
468
468
  # s._1 FROM OBJECT s`).
469
469
  #
470
- # * `Use`\: First line is a header, and you can use the header value
471
- # to identify a column in an expression (`SELECT "name" FROM
472
- # OBJECT`).
470
+ # * `Use`: First line is a header, and you can use the header value to
471
+ # identify a column in an expression (`SELECT "name" FROM OBJECT`).
473
472
  # @return [String]
474
473
  #
475
474
  # @!attribute [rw] comments
476
475
  # A single character used to indicate that a row should be ignored
477
476
  # when the character is present at the start of that row. You can
478
- # specify any character to indicate a comment line.
477
+ # specify any character to indicate a comment line. The default
478
+ # character is `#`.
479
+ #
480
+ # Default: `#`
479
481
  # @return [String]
480
482
  #
481
483
  # @!attribute [rw] quote_escape_character
@@ -533,9 +535,9 @@ module Aws::S3
533
535
  # @!attribute [rw] quote_fields
534
536
  # Indicates whether to use quotation marks around output fields.
535
537
  #
536
- # * `ALWAYS`\: Always use quotation marks for output fields.
538
+ # * `ALWAYS`: Always use quotation marks for output fields.
537
539
  #
538
- # * `ASNEEDED`\: Use quotation marks for output fields when needed.
540
+ # * `ASNEEDED`: Use quotation marks for output fields when needed.
539
541
  # @return [String]
540
542
  #
541
543
  # @!attribute [rw] quote_escape_character
@@ -709,14 +711,14 @@ module Aws::S3
709
711
  # bucket name. For more information about access point ARNs, see
710
712
  # [Using access points][1] in the *Amazon S3 User Guide*.
711
713
  #
712
- # When using this action with Amazon S3 on Outposts, you must direct
714
+ # When you use this action with Amazon S3 on Outposts, you must direct
713
715
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
714
716
  # takes the form `
715
717
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
716
- # When using this action with S3 on Outposts through the Amazon Web
717
- # Services SDKs, you provide the Outposts bucket ARN in place of the
718
- # bucket name. For more information about S3 on Outposts ARNs, see
719
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
718
+ # When you use this action with S3 on Outposts through the Amazon Web
719
+ # Services SDKs, you provide the Outposts access point ARN in place of
720
+ # the bucket name. For more information about S3 on Outposts ARNs, see
721
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
720
722
  #
721
723
  #
722
724
  #
@@ -803,11 +805,8 @@ module Aws::S3
803
805
  # @return [String]
804
806
  #
805
807
  # @!attribute [rw] server_side_encryption
806
- # If you specified server-side encryption either with an Amazon
807
- # S3-managed encryption key or an Amazon Web Services KMS key in your
808
- # initiate multipart upload request, the response includes this
809
- # header. It confirms the encryption algorithm that Amazon S3 used to
810
- # encrypt the object.
808
+ # The server-side encryption algorithm used when storing this object
809
+ # in Amazon S3 (for example, AES256, `aws:kms`).
811
810
  # @return [String]
812
811
  #
813
812
  # @!attribute [rw] version_id
@@ -817,8 +816,8 @@ module Aws::S3
817
816
  #
818
817
  # @!attribute [rw] ssekms_key_id
819
818
  # If present, specifies the ID of the Amazon Web Services Key
820
- # Management Service (Amazon Web Services KMS) symmetric customer
821
- # managed key that was used for the object.
819
+ # Management Service (Amazon Web Services KMS) symmetric encryption
820
+ # customer managed key that was used for the object.
822
821
  # @return [String]
823
822
  #
824
823
  # @!attribute [rw] bucket_key_enabled
@@ -864,14 +863,14 @@ module Aws::S3
864
863
  # bucket name. For more information about access point ARNs, see
865
864
  # [Using access points][1] in the *Amazon S3 User Guide*.
866
865
  #
867
- # When using this action with Amazon S3 on Outposts, you must direct
866
+ # When you use this action with Amazon S3 on Outposts, you must direct
868
867
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
869
868
  # takes the form `
870
869
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
871
- # When using this action with S3 on Outposts through the Amazon Web
872
- # Services SDKs, you provide the Outposts bucket ARN in place of the
873
- # bucket name. For more information about S3 on Outposts ARNs, see
874
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
870
+ # When you use this action with S3 on Outposts through the Amazon Web
871
+ # Services SDKs, you provide the Outposts access point ARN in place of
872
+ # the bucket name. For more information about S3 on Outposts ARNs, see
873
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
875
874
  #
876
875
  #
877
876
  #
@@ -1173,7 +1172,7 @@ module Aws::S3
1173
1172
  #
1174
1173
  # @!attribute [rw] server_side_encryption
1175
1174
  # The server-side encryption algorithm used when storing this object
1176
- # in Amazon S3 (for example, AES256, aws:kms).
1175
+ # in Amazon S3 (for example, AES256, `aws:kms`).
1177
1176
  # @return [String]
1178
1177
  #
1179
1178
  # @!attribute [rw] sse_customer_algorithm
@@ -1191,8 +1190,8 @@ module Aws::S3
1191
1190
  #
1192
1191
  # @!attribute [rw] ssekms_key_id
1193
1192
  # If present, specifies the ID of the Amazon Web Services Key
1194
- # Management Service (Amazon Web Services KMS) symmetric customer
1195
- # managed key that was used for the object.
1193
+ # Management Service (Amazon Web Services KMS) symmetric encryption
1194
+ # customer managed key that was used for the object.
1196
1195
  # @return [String]
1197
1196
  #
1198
1197
  # @!attribute [rw] ssekms_encryption_context
@@ -1248,14 +1247,14 @@ module Aws::S3
1248
1247
  # bucket name. For more information about access point ARNs, see
1249
1248
  # [Using access points][1] in the *Amazon S3 User Guide*.
1250
1249
  #
1251
- # When using this action with Amazon S3 on Outposts, you must direct
1250
+ # When you use this action with Amazon S3 on Outposts, you must direct
1252
1251
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
1253
1252
  # takes the form `
1254
1253
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1255
- # When using this action with S3 on Outposts through the Amazon Web
1256
- # Services SDKs, you provide the Outposts bucket ARN in place of the
1257
- # bucket name. For more information about S3 on Outposts ARNs, see
1258
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
1254
+ # When you use this action with S3 on Outposts through the Amazon Web
1255
+ # Services SDKs, you provide the Outposts access point ARN in place of
1256
+ # the bucket name. For more information about S3 on Outposts ARNs, see
1257
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
1259
1258
  #
1260
1259
  #
1261
1260
  #
@@ -1298,7 +1297,7 @@ module Aws::S3
1298
1297
  # @!attribute [rw] copy_source
1299
1298
  # Specifies the source object for the copy operation. You specify the
1300
1299
  # value in one of two formats, depending on whether you want to access
1301
- # the source object through an [access point][1]\:
1300
+ # the source object through an [access point][1]:
1302
1301
  #
1303
1302
  # * For objects not accessed through an access point, specify the name
1304
1303
  # of the source bucket and the key of the source object, separated
@@ -1411,7 +1410,7 @@ module Aws::S3
1411
1410
  #
1412
1411
  # @!attribute [rw] server_side_encryption
1413
1412
  # The server-side encryption algorithm used when storing this object
1414
- # in Amazon S3 (for example, AES256, aws:kms).
1413
+ # in Amazon S3 (for example, AES256, `aws:kms`).
1415
1414
  # @return [String]
1416
1415
  #
1417
1416
  # @!attribute [rw] storage_class
@@ -1431,7 +1430,9 @@ module Aws::S3
1431
1430
  # If the bucket is configured as a website, redirects requests for
1432
1431
  # this object to another object in the same bucket or to an external
1433
1432
  # URL. Amazon S3 stores the value of this header in the object
1434
- # metadata.
1433
+ # metadata. This value is unique to each object and is not copied when
1434
+ # using the `x-amz-metadata-directive` header. Instead, you may opt to
1435
+ # provide this header in combination with the directive.
1435
1436
  # @return [String]
1436
1437
  #
1437
1438
  # @!attribute [rw] sse_customer_algorithm
@@ -1886,14 +1887,14 @@ module Aws::S3
1886
1887
  # bucket name. For more information about access point ARNs, see
1887
1888
  # [Using access points][1] in the *Amazon S3 User Guide*.
1888
1889
  #
1889
- # When using this action with Amazon S3 on Outposts, you must direct
1890
+ # When you use this action with Amazon S3 on Outposts, you must direct
1890
1891
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
1891
1892
  # takes the form `
1892
1893
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1893
- # When using this action with S3 on Outposts through the Amazon Web
1894
- # Services SDKs, you provide the Outposts bucket ARN in place of the
1895
- # bucket name. For more information about S3 on Outposts ARNs, see
1896
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
1894
+ # When you use this action with S3 on Outposts through the Amazon Web
1895
+ # Services SDKs, you provide the Outposts access point ARN in place of
1896
+ # the bucket name. For more information about S3 on Outposts ARNs, see
1897
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
1897
1898
  #
1898
1899
  #
1899
1900
  #
@@ -1911,7 +1912,7 @@ module Aws::S3
1911
1912
  #
1912
1913
  # @!attribute [rw] server_side_encryption
1913
1914
  # The server-side encryption algorithm used when storing this object
1914
- # in Amazon S3 (for example, AES256, aws:kms).
1915
+ # in Amazon S3 (for example, AES256, `aws:kms`).
1915
1916
  # @return [String]
1916
1917
  #
1917
1918
  # @!attribute [rw] sse_customer_algorithm
@@ -1929,8 +1930,8 @@ module Aws::S3
1929
1930
  #
1930
1931
  # @!attribute [rw] ssekms_key_id
1931
1932
  # If present, specifies the ID of the Amazon Web Services Key
1932
- # Management Service (Amazon Web Services KMS) symmetric customer
1933
- # managed key that was used for the object.
1933
+ # Management Service (Amazon Web Services KMS) symmetric encryption
1934
+ # customer managed key that was used for the object.
1934
1935
  # @return [String]
1935
1936
  #
1936
1937
  # @!attribute [rw] ssekms_encryption_context
@@ -1992,14 +1993,14 @@ module Aws::S3
1992
1993
  # bucket name. For more information about access point ARNs, see
1993
1994
  # [Using access points][1] in the *Amazon S3 User Guide*.
1994
1995
  #
1995
- # When using this action with Amazon S3 on Outposts, you must direct
1996
+ # When you use this action with Amazon S3 on Outposts, you must direct
1996
1997
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
1997
1998
  # takes the form `
1998
1999
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
1999
- # When using this action with S3 on Outposts through the Amazon Web
2000
- # Services SDKs, you provide the Outposts bucket ARN in place of the
2001
- # bucket name. For more information about S3 on Outposts ARNs, see
2002
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
2000
+ # When you use this action with S3 on Outposts through the Amazon Web
2001
+ # Services SDKs, you provide the Outposts access point ARN in place of
2002
+ # the bucket name. For more information about S3 on Outposts ARNs, see
2003
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
2003
2004
  #
2004
2005
  #
2005
2006
  #
@@ -2068,7 +2069,7 @@ module Aws::S3
2068
2069
  #
2069
2070
  # @!attribute [rw] server_side_encryption
2070
2071
  # The server-side encryption algorithm used when storing this object
2071
- # in Amazon S3 (for example, AES256, aws:kms).
2072
+ # in Amazon S3 (for example, AES256, `aws:kms`).
2072
2073
  # @return [String]
2073
2074
  #
2074
2075
  # @!attribute [rw] storage_class
@@ -2111,13 +2112,13 @@ module Aws::S3
2111
2112
  # @return [String]
2112
2113
  #
2113
2114
  # @!attribute [rw] ssekms_key_id
2114
- # Specifies the ID of the symmetric customer managed key to use for
2115
- # object encryption. All GET and PUT requests for an object protected
2116
- # by Amazon Web Services KMS will fail if not made via SSL or using
2117
- # SigV4. For information about configuring using any of the officially
2118
- # supported Amazon Web Services SDKs and Amazon Web Services CLI, see
2119
- # [Specifying the Signature Version in Request Authentication][1] in
2120
- # the *Amazon S3 User Guide*.
2115
+ # Specifies the ID of the symmetric encryption customer managed key to
2116
+ # use for object encryption. All GET and PUT requests for an object
2117
+ # protected by Amazon Web Services KMS will fail if not made via SSL
2118
+ # or using SigV4. For information about configuring using any of the
2119
+ # officially supported Amazon Web Services SDKs and Amazon Web
2120
+ # Services CLI, see [Specifying the Signature Version in Request
2121
+ # Authentication][1] in the *Amazon S3 User Guide*.
2121
2122
  #
2122
2123
  #
2123
2124
  #
@@ -2414,7 +2415,9 @@ module Aws::S3
2414
2415
  # @return [String]
2415
2416
  #
2416
2417
  # @!attribute [rw] id
2417
- # The ID used to identify the metrics configuration.
2418
+ # The ID used to identify the metrics configuration. The ID has a 64
2419
+ # character limit and can only contain letters, numbers, periods,
2420
+ # dashes, and underscores.
2418
2421
  # @return [String]
2419
2422
  #
2420
2423
  # @!attribute [rw] expected_bucket_owner
@@ -2659,14 +2662,14 @@ module Aws::S3
2659
2662
  # bucket name. For more information about access point ARNs, see
2660
2663
  # [Using access points][1] in the *Amazon S3 User Guide*.
2661
2664
  #
2662
- # When using this action with Amazon S3 on Outposts, you must direct
2665
+ # When you use this action with Amazon S3 on Outposts, you must direct
2663
2666
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2664
2667
  # takes the form `
2665
2668
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
2666
- # When using this action with S3 on Outposts through the Amazon Web
2667
- # Services SDKs, you provide the Outposts bucket ARN in place of the
2668
- # bucket name. For more information about S3 on Outposts ARNs, see
2669
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
2669
+ # When you use this action with S3 on Outposts through the Amazon Web
2670
+ # Services SDKs, you provide the Outposts access point ARN in place of
2671
+ # the bucket name. For more information about S3 on Outposts ARNs, see
2672
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
2670
2673
  #
2671
2674
  #
2672
2675
  #
@@ -2752,14 +2755,14 @@ module Aws::S3
2752
2755
  # bucket name. For more information about access point ARNs, see
2753
2756
  # [Using access points][1] in the *Amazon S3 User Guide*.
2754
2757
  #
2755
- # When using this action with Amazon S3 on Outposts, you must direct
2758
+ # When you use this action with Amazon S3 on Outposts, you must direct
2756
2759
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2757
2760
  # takes the form `
2758
2761
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
2759
- # When using this action with S3 on Outposts through the Amazon Web
2760
- # Services SDKs, you provide the Outposts bucket ARN in place of the
2761
- # bucket name. For more information about S3 on Outposts ARNs, see
2762
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
2762
+ # When you use this action with S3 on Outposts through the Amazon Web
2763
+ # Services SDKs, you provide the Outposts access point ARN in place of
2764
+ # the bucket name. For more information about S3 on Outposts ARNs, see
2765
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
2763
2766
  #
2764
2767
  #
2765
2768
  #
@@ -2830,14 +2833,14 @@ module Aws::S3
2830
2833
  # bucket name. For more information about access point ARNs, see
2831
2834
  # [Using access points][1] in the *Amazon S3 User Guide*.
2832
2835
  #
2833
- # When using this action with Amazon S3 on Outposts, you must direct
2836
+ # When you use this action with Amazon S3 on Outposts, you must direct
2834
2837
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
2835
2838
  # takes the form `
2836
2839
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
2837
- # When using this action with S3 on Outposts through the Amazon Web
2838
- # Services SDKs, you provide the Outposts bucket ARN in place of the
2839
- # bucket name. For more information about S3 on Outposts ARNs, see
2840
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
2840
+ # When you use this action with S3 on Outposts through the Amazon Web
2841
+ # Services SDKs, you provide the Outposts access point ARN in place of
2842
+ # the bucket name. For more information about S3 on Outposts ARNs, see
2843
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
2841
2844
  #
2842
2845
  #
2843
2846
  #
@@ -3050,15 +3053,16 @@ module Aws::S3
3050
3053
  #
3051
3054
  # @!attribute [rw] encryption_type
3052
3055
  # The server-side encryption algorithm used when storing job results
3053
- # in Amazon S3 (for example, AES256, aws:kms).
3056
+ # in Amazon S3 (for example, AES256, `aws:kms`).
3054
3057
  # @return [String]
3055
3058
  #
3056
3059
  # @!attribute [rw] kms_key_id
3057
3060
  # If the encryption type is `aws:kms`, this optional value specifies
3058
- # the ID of the symmetric customer managed key to use for encryption
3059
- # of job results. Amazon S3 only supports symmetric keys. For more
3060
- # information, see [Using symmetric and asymmetric keys][1] in the
3061
- # *Amazon Web Services Key Management Service Developer Guide*.
3061
+ # the ID of the symmetric encryption customer managed key to use for
3062
+ # encryption of job results. Amazon S3 only supports symmetric
3063
+ # encryption KMS keys. For more information, see [Asymmetric keys in
3064
+ # Amazon Web Services KMS][1] in the *Amazon Web Services Key
3065
+ # Management Service Developer Guide*.
3062
3066
  #
3063
3067
  #
3064
3068
  #
@@ -3088,9 +3092,9 @@ module Aws::S3
3088
3092
  # Amazon Web Services KMS key stored in Amazon Web Services Key
3089
3093
  # Management Service (KMS) for the destination bucket. Amazon S3 uses
3090
3094
  # this key to encrypt replica objects. Amazon S3 only supports
3091
- # symmetric, customer managed KMS keys. For more information, see
3092
- # [Using symmetric and asymmetric keys][1] in the *Amazon Web Services
3093
- # Key Management Service Developer Guide*.
3095
+ # symmetric encryption KMS keys. For more information, see [Asymmetric
3096
+ # keys in Amazon Web Services KMS][1] in the *Amazon Web Services Key
3097
+ # Management Service Developer Guide*.
3094
3098
  #
3095
3099
  #
3096
3100
  #
@@ -3856,7 +3860,7 @@ module Aws::S3
3856
3860
  #
3857
3861
  # * * *Code:* ServiceUnavailable
3858
3862
  #
3859
- # * *Description:* Reduce your request rate.
3863
+ # * *Description:* Service is unable to handle request.
3860
3864
  #
3861
3865
  # * *HTTP Status Code:* 503 Service Unavailable
3862
3866
  #
@@ -3992,6 +3996,8 @@ module Aws::S3
3992
3996
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-what-is-isnot-replicated.html#existing-object-replication
3993
3997
  #
3994
3998
  # @!attribute [rw] status
3999
+ # Specifies whether Amazon S3 replicates existing source bucket
4000
+ # objects.
3995
4001
  # @return [String]
3996
4002
  #
3997
4003
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ExistingObjectReplication AWS API Documentation
@@ -4421,7 +4427,9 @@ module Aws::S3
4421
4427
  # @return [String]
4422
4428
  #
4423
4429
  # @!attribute [rw] id
4424
- # The ID used to identify the metrics configuration.
4430
+ # The ID used to identify the metrics configuration. The ID has a 64
4431
+ # character limit and can only contain letters, numbers, periods,
4432
+ # dashes, and underscores.
4425
4433
  # @return [String]
4426
4434
  #
4427
4435
  # @!attribute [rw] expected_bucket_owner
@@ -4940,14 +4948,14 @@ module Aws::S3
4940
4948
  # bucket name. For more information about access point ARNs, see
4941
4949
  # [Using access points][1] in the *Amazon S3 User Guide*.
4942
4950
  #
4943
- # When using this action with Amazon S3 on Outposts, you must direct
4951
+ # When you use this action with Amazon S3 on Outposts, you must direct
4944
4952
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
4945
4953
  # takes the form `
4946
4954
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
4947
- # When using this action with S3 on Outposts through the Amazon Web
4948
- # Services SDKs, you provide the Outposts bucket ARN in place of the
4949
- # bucket name. For more information about S3 on Outposts ARNs, see
4950
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
4955
+ # When you use this action with S3 on Outposts through the Amazon Web
4956
+ # Services SDKs, you provide the Outposts access point ARN in place of
4957
+ # the bucket name. For more information about S3 on Outposts ARNs, see
4958
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
4951
4959
  #
4952
4960
  #
4953
4961
  #
@@ -5292,7 +5300,7 @@ module Aws::S3
5292
5300
  #
5293
5301
  # @!attribute [rw] server_side_encryption
5294
5302
  # The server-side encryption algorithm used when storing this object
5295
- # in Amazon S3 (for example, AES256, aws:kms).
5303
+ # in Amazon S3 (for example, AES256, `aws:kms`).
5296
5304
  # @return [String]
5297
5305
  #
5298
5306
  # @!attribute [rw] metadata
@@ -5314,8 +5322,8 @@ module Aws::S3
5314
5322
  #
5315
5323
  # @!attribute [rw] ssekms_key_id
5316
5324
  # If present, specifies the ID of the Amazon Web Services Key
5317
- # Management Service (Amazon Web Services KMS) symmetric customer
5318
- # managed key that was used for the object.
5325
+ # Management Service (Amazon Web Services KMS) symmetric encryption
5326
+ # customer managed key that was used for the object.
5319
5327
  # @return [String]
5320
5328
  #
5321
5329
  # @!attribute [rw] bucket_key_enabled
@@ -5422,14 +5430,14 @@ module Aws::S3
5422
5430
  # When using an Object Lambda access point the hostname takes the form
5423
5431
  # *AccessPointName*-*AccountId*.s3-object-lambda.*Region*.amazonaws.com.
5424
5432
  #
5425
- # When using this action with Amazon S3 on Outposts, you must direct
5433
+ # When you use this action with Amazon S3 on Outposts, you must direct
5426
5434
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5427
5435
  # takes the form `
5428
5436
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5429
- # When using this action with S3 on Outposts through the Amazon Web
5430
- # Services SDKs, you provide the Outposts bucket ARN in place of the
5431
- # bucket name. For more information about S3 on Outposts ARNs, see
5432
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
5437
+ # When you use this action with S3 on Outposts through the Amazon Web
5438
+ # Services SDKs, you provide the Outposts access point ARN in place of
5439
+ # the bucket name. For more information about S3 on Outposts ARNs, see
5440
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
5433
5441
  #
5434
5442
  #
5435
5443
  #
@@ -5464,7 +5472,7 @@ module Aws::S3
5464
5472
  # @!attribute [rw] range
5465
5473
  # Downloads the specified range bytes of an object. For more
5466
5474
  # information about the HTTP Range header, see
5467
- # [https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
5475
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-range][1].
5468
5476
  #
5469
5477
  # <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
5470
5478
  # `GET` request.
@@ -5473,7 +5481,7 @@ module Aws::S3
5473
5481
  #
5474
5482
  #
5475
5483
  #
5476
- # [1]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
5484
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-range
5477
5485
  # @return [String]
5478
5486
  #
5479
5487
  # @!attribute [rw] response_cache_control
@@ -5681,14 +5689,14 @@ module Aws::S3
5681
5689
  # bucket name. For more information about access point ARNs, see
5682
5690
  # [Using access points][1] in the *Amazon S3 User Guide*.
5683
5691
  #
5684
- # When using this action with Amazon S3 on Outposts, you must direct
5692
+ # When you use this action with Amazon S3 on Outposts, you must direct
5685
5693
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5686
5694
  # takes the form `
5687
5695
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5688
- # When using this action with S3 on Outposts through the Amazon Web
5689
- # Services SDKs, you provide the Outposts bucket ARN in place of the
5690
- # bucket name. For more information about S3 on Outposts ARNs, see
5691
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
5696
+ # When you use this action with S3 on Outposts through the Amazon Web
5697
+ # Services SDKs, you provide the Outposts access point ARN in place of
5698
+ # the bucket name. For more information about S3 on Outposts ARNs, see
5699
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
5692
5700
  #
5693
5701
  #
5694
5702
  #
@@ -5932,14 +5940,14 @@ module Aws::S3
5932
5940
  # bucket name. For more information about access point ARNs, see
5933
5941
  # [Using access points][1] in the *Amazon S3 User Guide*.
5934
5942
  #
5935
- # When using this action with Amazon S3 on Outposts, you must direct
5943
+ # When you use this action with Amazon S3 on Outposts, you must direct
5936
5944
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
5937
5945
  # takes the form `
5938
5946
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
5939
- # When using this action with S3 on Outposts through the Amazon Web
5940
- # Services SDKs, you provide the Outposts bucket ARN in place of the
5941
- # bucket name. For more information about S3 on Outposts ARNs, see
5942
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
5947
+ # When you use this action with S3 on Outposts through the Amazon Web
5948
+ # Services SDKs, you provide the Outposts access point ARN in place of
5949
+ # the bucket name. For more information about S3 on Outposts ARNs, see
5950
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
5943
5951
  #
5944
5952
  #
5945
5953
  #
@@ -6121,11 +6129,8 @@ module Aws::S3
6121
6129
  # @return [String]
6122
6130
  #
6123
6131
  # @!attribute [rw] server_side_encryption
6124
- # If the object is stored using server-side encryption either with an
6125
- # Amazon Web Services KMS key or an Amazon S3-managed encryption key,
6126
- # the response includes this header with the value of the server-side
6127
- # encryption algorithm used when storing this object in Amazon S3 (for
6128
- # example, AES256, aws:kms).
6132
+ # The server-side encryption algorithm used when storing this object
6133
+ # in Amazon S3 (for example, AES256, `aws:kms`).
6129
6134
  # @return [String]
6130
6135
  #
6131
6136
  # @!attribute [rw] metadata
@@ -6147,8 +6152,8 @@ module Aws::S3
6147
6152
  #
6148
6153
  # @!attribute [rw] ssekms_key_id
6149
6154
  # If present, specifies the ID of the Amazon Web Services Key
6150
- # Management Service (Amazon Web Services KMS) symmetric customer
6151
- # managed key that was used for the object.
6155
+ # Management Service (Amazon Web Services KMS) symmetric encryption
6156
+ # customer managed key that was used for the object.
6152
6157
  # @return [String]
6153
6158
  #
6154
6159
  # @!attribute [rw] bucket_key_enabled
@@ -6307,14 +6312,14 @@ module Aws::S3
6307
6312
  # bucket name. For more information about access point ARNs, see
6308
6313
  # [Using access points][1] in the *Amazon S3 User Guide*.
6309
6314
  #
6310
- # When using this action with Amazon S3 on Outposts, you must direct
6315
+ # When you use this action with Amazon S3 on Outposts, you must direct
6311
6316
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
6312
6317
  # takes the form `
6313
6318
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
6314
- # When using this action with S3 on Outposts through the Amazon Web
6315
- # Services SDKs, you provide the Outposts bucket ARN in place of the
6316
- # bucket name. For more information about S3 on Outposts ARNs, see
6317
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
6319
+ # When you use this action with S3 on Outposts through the Amazon Web
6320
+ # Services SDKs, you provide the Outposts access point ARN in place of
6321
+ # the bucket name. For more information about S3 on Outposts ARNs, see
6322
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
6318
6323
  #
6319
6324
  #
6320
6325
  #
@@ -6347,8 +6352,10 @@ module Aws::S3
6347
6352
  # @return [String]
6348
6353
  #
6349
6354
  # @!attribute [rw] range
6350
- # Because `HeadObject` returns only the metadata for an object, this
6351
- # parameter has no effect.
6355
+ # HeadObject returns only the metadata for an object. If the Range is
6356
+ # satisfiable, only the `ContentLength` is affected in the response.
6357
+ # If the Range is not satisfiable, S3 returns a `416 - Requested Range
6358
+ # Not Satisfiable` error.
6352
6359
  # @return [String]
6353
6360
  #
6354
6361
  # @!attribute [rw] version_id
@@ -6865,6 +6872,13 @@ module Aws::S3
6865
6872
 
6866
6873
  # Container for lifecycle rules. You can add as many as 1000 rules.
6867
6874
  #
6875
+ # For more information see, [Managing your storage lifecycle][1] in the
6876
+ # *Amazon S3 User Guide*.
6877
+ #
6878
+ #
6879
+ #
6880
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
6881
+ #
6868
6882
  # @!attribute [rw] rules
6869
6883
  # Specifies lifecycle configuration rules for an Amazon S3 bucket.
6870
6884
  # @return [Array<Types::Rule>]
@@ -6879,6 +6893,13 @@ module Aws::S3
6879
6893
 
6880
6894
  # Container for the expiration for the lifecycle of the object.
6881
6895
  #
6896
+ # For more information see, [Managing your storage lifecycle][1] in the
6897
+ # *Amazon S3 User Guide*.
6898
+ #
6899
+ #
6900
+ #
6901
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
6902
+ #
6882
6903
  # @!attribute [rw] date
6883
6904
  # Indicates at what date the object is to be moved or deleted. Should
6884
6905
  # be in GMT ISO 8601 Format.
@@ -6908,6 +6929,13 @@ module Aws::S3
6908
6929
 
6909
6930
  # A lifecycle rule for individual objects in an Amazon S3 bucket.
6910
6931
  #
6932
+ # For more information see, [Managing your storage lifecycle][1] in the
6933
+ # *Amazon S3 User Guide*.
6934
+ #
6935
+ #
6936
+ #
6937
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html
6938
+ #
6911
6939
  # @!attribute [rw] expiration
6912
6940
  # Specifies the expiration for the lifecycle of the object in the form
6913
6941
  # of date, days and, whether the object has a delete marker.
@@ -7431,14 +7459,14 @@ module Aws::S3
7431
7459
  # bucket name. For more information about access point ARNs, see
7432
7460
  # [Using access points][1] in the *Amazon S3 User Guide*.
7433
7461
  #
7434
- # When using this action with Amazon S3 on Outposts, you must direct
7462
+ # When you use this action with Amazon S3 on Outposts, you must direct
7435
7463
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7436
7464
  # takes the form `
7437
7465
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7438
- # When using this action with S3 on Outposts through the Amazon Web
7439
- # Services SDKs, you provide the Outposts bucket ARN in place of the
7440
- # bucket name. For more information about S3 on Outposts ARNs, see
7441
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
7466
+ # When you use this action with S3 on Outposts through the Amazon Web
7467
+ # Services SDKs, you provide the Outposts access point ARN in place of
7468
+ # the bucket name. For more information about S3 on Outposts ARNs, see
7469
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
7442
7470
  #
7443
7471
  #
7444
7472
  #
@@ -7788,14 +7816,14 @@ module Aws::S3
7788
7816
  # bucket name. For more information about access point ARNs, see
7789
7817
  # [Using access points][1] in the *Amazon S3 User Guide*.
7790
7818
  #
7791
- # When using this action with Amazon S3 on Outposts, you must direct
7819
+ # When you use this action with Amazon S3 on Outposts, you must direct
7792
7820
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7793
7821
  # takes the form `
7794
7822
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7795
- # When using this action with S3 on Outposts through the Amazon Web
7796
- # Services SDKs, you provide the Outposts bucket ARN in place of the
7797
- # bucket name. For more information about S3 on Outposts ARNs, see
7798
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
7823
+ # When you use this action with S3 on Outposts through the Amazon Web
7824
+ # Services SDKs, you provide the Outposts access point ARN in place of
7825
+ # the bucket name. For more information about S3 on Outposts ARNs, see
7826
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
7799
7827
  #
7800
7828
  #
7801
7829
  #
@@ -7881,14 +7909,14 @@ module Aws::S3
7881
7909
  # bucket name. For more information about access point ARNs, see
7882
7910
  # [Using access points][1] in the *Amazon S3 User Guide*.
7883
7911
  #
7884
- # When using this action with Amazon S3 on Outposts, you must direct
7912
+ # When you use this action with Amazon S3 on Outposts, you must direct
7885
7913
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
7886
7914
  # takes the form `
7887
7915
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
7888
- # When using this action with S3 on Outposts through the Amazon Web
7889
- # Services SDKs, you provide the Outposts bucket ARN in place of the
7890
- # bucket name. For more information about S3 on Outposts ARNs, see
7891
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
7916
+ # When you use this action with S3 on Outposts through the Amazon Web
7917
+ # Services SDKs, you provide the Outposts access point ARN in place of
7918
+ # the bucket name. For more information about S3 on Outposts ARNs, see
7919
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
7892
7920
  #
7893
7921
  #
7894
7922
  #
@@ -7947,8 +7975,8 @@ module Aws::S3
7947
7975
  #
7948
7976
  # @!attribute [rw] key_count
7949
7977
  # KeyCount is the number of keys returned with this request. KeyCount
7950
- # will always be less than or equals to MaxKeys field. Say you ask for
7951
- # 50 keys, your result will include less than equals 50 keys
7978
+ # will always be less than or equal to the `MaxKeys` field. Say you
7979
+ # ask for 50 keys, your result will include 50 keys or fewer.
7952
7980
  # @return [Integer]
7953
7981
  #
7954
7982
  # @!attribute [rw] continuation_token
@@ -8000,14 +8028,14 @@ module Aws::S3
8000
8028
  # bucket name. For more information about access point ARNs, see
8001
8029
  # [Using access points][1] in the *Amazon S3 User Guide*.
8002
8030
  #
8003
- # When using this action with Amazon S3 on Outposts, you must direct
8031
+ # When you use this action with Amazon S3 on Outposts, you must direct
8004
8032
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
8005
8033
  # takes the form `
8006
8034
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8007
- # When using this action with S3 on Outposts through the Amazon Web
8008
- # Services SDKs, you provide the Outposts bucket ARN in place of the
8009
- # bucket name. For more information about S3 on Outposts ARNs, see
8010
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
8035
+ # When you use this action with S3 on Outposts through the Amazon Web
8036
+ # Services SDKs, you provide the Outposts access point ARN in place of
8037
+ # the bucket name. For more information about S3 on Outposts ARNs, see
8038
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
8011
8039
  #
8012
8040
  #
8013
8041
  #
@@ -8209,14 +8237,14 @@ module Aws::S3
8209
8237
  # bucket name. For more information about access point ARNs, see
8210
8238
  # [Using access points][1] in the *Amazon S3 User Guide*.
8211
8239
  #
8212
- # When using this action with Amazon S3 on Outposts, you must direct
8240
+ # When you use this action with Amazon S3 on Outposts, you must direct
8213
8241
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
8214
8242
  # takes the form `
8215
8243
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
8216
- # When using this action with S3 on Outposts through the Amazon Web
8217
- # Services SDKs, you provide the Outposts bucket ARN in place of the
8218
- # bucket name. For more information about S3 on Outposts ARNs, see
8219
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
8244
+ # When you use this action with S3 on Outposts through the Amazon Web
8245
+ # Services SDKs, you provide the Outposts access point ARN in place of
8246
+ # the bucket name. For more information about S3 on Outposts ARNs, see
8247
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
8220
8248
  #
8221
8249
  #
8222
8250
  #
@@ -8436,7 +8464,9 @@ module Aws::S3
8436
8464
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTBucketPUTMetricConfiguration.html
8437
8465
  #
8438
8466
  # @!attribute [rw] id
8439
- # The ID used to identify the metrics configuration.
8467
+ # The ID used to identify the metrics configuration. The ID has a 64
8468
+ # character limit and can only contain letters, numbers, periods,
8469
+ # dashes, and underscores.
8440
8470
  # @return [String]
8441
8471
  #
8442
8472
  # @!attribute [rw] filter
@@ -9074,7 +9104,24 @@ module Aws::S3
9074
9104
  # Container for the owner's display name and ID.
9075
9105
  #
9076
9106
  # @!attribute [rw] display_name
9077
- # Container for the display name of the owner.
9107
+ # Container for the display name of the owner. This value is only
9108
+ # supported in the following Amazon Web Services Regions:
9109
+ #
9110
+ # * US East (N. Virginia)
9111
+ #
9112
+ # * US West (N. California)
9113
+ #
9114
+ # * US West (Oregon)
9115
+ #
9116
+ # * Asia Pacific (Singapore)
9117
+ #
9118
+ # * Asia Pacific (Sydney)
9119
+ #
9120
+ # * Asia Pacific (Tokyo)
9121
+ #
9122
+ # * Europe (Ireland)
9123
+ #
9124
+ # * South America (São Paulo)
9078
9125
  # @return [String]
9079
9126
  #
9080
9127
  # @!attribute [rw] id
@@ -9579,10 +9626,14 @@ module Aws::S3
9579
9626
 
9580
9627
  # @!attribute [rw] bucket
9581
9628
  # Specifies default encryption for a bucket using server-side
9582
- # encryption with Amazon S3-managed keys (SSE-S3) or customer managed
9583
- # keys (SSE-KMS). For information about the Amazon S3 default
9584
- # encryption feature, see [Amazon S3 Default Bucket Encryption][1] in
9585
- # the *Amazon S3 User Guide*.
9629
+ # encryption with different key options. By default, all buckets have
9630
+ # a default encryption configuration that uses server-side encryption
9631
+ # with Amazon S3 managed keys (SSE-S3). You can optionally configure
9632
+ # default encryption for a bucket by using server-side encryption with
9633
+ # an Amazon Web Services KMS key (SSE-KMS) or a customer-provided key
9634
+ # (SSE-C). For information about the bucket default encryption
9635
+ # feature, see [Amazon S3 Bucket Default Encryption][1] in the *Amazon
9636
+ # S3 User Guide*.
9586
9637
  #
9587
9638
  #
9588
9639
  #
@@ -9835,7 +9886,9 @@ module Aws::S3
9835
9886
  # @return [String]
9836
9887
  #
9837
9888
  # @!attribute [rw] id
9838
- # The ID used to identify the metrics configuration.
9889
+ # The ID used to identify the metrics configuration. The ID has a 64
9890
+ # character limit and can only contain letters, numbers, periods,
9891
+ # dashes, and underscores.
9839
9892
  # @return [String]
9840
9893
  #
9841
9894
  # @!attribute [rw] metrics_configuration
@@ -10458,14 +10511,14 @@ module Aws::S3
10458
10511
  # bucket name. For more information about access point ARNs, see
10459
10512
  # [Using access points][1] in the *Amazon S3 User Guide*.
10460
10513
  #
10461
- # When using this action with Amazon S3 on Outposts, you must direct
10514
+ # When you use this action with Amazon S3 on Outposts, you must direct
10462
10515
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
10463
10516
  # takes the form `
10464
10517
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10465
- # When using this action with S3 on Outposts through the Amazon Web
10466
- # Services SDKs, you provide the Outposts bucket ARN in place of the
10467
- # bucket name. For more information about S3 on Outposts ARNs, see
10468
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
10518
+ # When you use this action with S3 on Outposts through the Amazon Web
10519
+ # Services SDKs, you provide the Outposts access point ARN in place of
10520
+ # the bucket name. For more information about S3 on Outposts ARNs, see
10521
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
10469
10522
  #
10470
10523
  #
10471
10524
  #
@@ -10771,10 +10824,8 @@ module Aws::S3
10771
10824
  # @return [String]
10772
10825
  #
10773
10826
  # @!attribute [rw] server_side_encryption
10774
- # If you specified server-side encryption either with an Amazon Web
10775
- # Services KMS key or Amazon S3-managed encryption key in your PUT
10776
- # request, the response includes this header. It confirms the
10777
- # encryption algorithm that Amazon S3 used to encrypt the object.
10827
+ # The server-side encryption algorithm used when storing this object
10828
+ # in Amazon S3 (for example, AES256, `aws:kms`).
10778
10829
  # @return [String]
10779
10830
  #
10780
10831
  # @!attribute [rw] version_id
@@ -10795,17 +10846,19 @@ module Aws::S3
10795
10846
  # @return [String]
10796
10847
  #
10797
10848
  # @!attribute [rw] ssekms_key_id
10798
- # If `x-amz-server-side-encryption` is present and has the value of
10799
- # `aws:kms`, this header specifies the ID of the Amazon Web Services
10800
- # Key Management Service (Amazon Web Services KMS) symmetric customer
10801
- # managed key that was used for the object.
10849
+ # If `x-amz-server-side-encryption` is has a valid value of `aws:kms`,
10850
+ # this header specifies the ID of the Amazon Web Services Key
10851
+ # Management Service (Amazon Web Services KMS) symmetric encryption
10852
+ # customer managed key that was used for the object.
10802
10853
  # @return [String]
10803
10854
  #
10804
10855
  # @!attribute [rw] ssekms_encryption_context
10805
10856
  # If present, specifies the Amazon Web Services KMS Encryption Context
10806
10857
  # to use for object encryption. The value of this header is a
10807
10858
  # base64-encoded UTF-8 string holding JSON with the encryption context
10808
- # key-value pairs.
10859
+ # key-value pairs. This value is stored as object metadata and
10860
+ # automatically gets passed on to Amazon Web Services KMS for future
10861
+ # `GetObject` or `CopyObject` operations on this object.
10809
10862
  # @return [String]
10810
10863
  #
10811
10864
  # @!attribute [rw] bucket_key_enabled
@@ -10866,14 +10919,14 @@ module Aws::S3
10866
10919
  # bucket name. For more information about access point ARNs, see
10867
10920
  # [Using access points][1] in the *Amazon S3 User Guide*.
10868
10921
  #
10869
- # When using this action with Amazon S3 on Outposts, you must direct
10922
+ # When you use this action with Amazon S3 on Outposts, you must direct
10870
10923
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
10871
10924
  # takes the form `
10872
10925
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
10873
- # When using this action with S3 on Outposts through the Amazon Web
10874
- # Services SDKs, you provide the Outposts bucket ARN in place of the
10875
- # bucket name. For more information about S3 on Outposts ARNs, see
10876
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
10926
+ # When you use this action with S3 on Outposts through the Amazon Web
10927
+ # Services SDKs, you provide the Outposts access point ARN in place of
10928
+ # the bucket name. For more information about S3 on Outposts ARNs, see
10929
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
10877
10930
  #
10878
10931
  #
10879
10932
  #
@@ -10894,11 +10947,11 @@ module Aws::S3
10894
10947
  # @!attribute [rw] content_disposition
10895
10948
  # Specifies presentational information for the object. For more
10896
10949
  # information, see
10897
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1][1].
10950
+ # [https://www.rfc-editor.org/rfc/rfc6266#section-4][1].
10898
10951
  #
10899
10952
  #
10900
10953
  #
10901
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
10954
+ # [1]: https://www.rfc-editor.org/rfc/rfc6266#section-4
10902
10955
  # @return [String]
10903
10956
  #
10904
10957
  # @!attribute [rw] content_encoding
@@ -10906,11 +10959,11 @@ module Aws::S3
10906
10959
  # thus what decoding mechanisms must be applied to obtain the
10907
10960
  # media-type referenced by the Content-Type header field. For more
10908
10961
  # information, see
10909
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11][1].
10962
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding][1].
10910
10963
  #
10911
10964
  #
10912
10965
  #
10913
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
10966
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding
10914
10967
  # @return [String]
10915
10968
  #
10916
10969
  # @!attribute [rw] content_language
@@ -10921,11 +10974,11 @@ module Aws::S3
10921
10974
  # Size of the body in bytes. This parameter is useful when the size of
10922
10975
  # the body cannot be determined automatically. For more information,
10923
10976
  # see
10924
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13][1].
10977
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length][1].
10925
10978
  #
10926
10979
  #
10927
10980
  #
10928
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
10981
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
10929
10982
  # @return [Integer]
10930
10983
  #
10931
10984
  # @!attribute [rw] content_md5
@@ -10945,11 +10998,11 @@ module Aws::S3
10945
10998
  # @!attribute [rw] content_type
10946
10999
  # A standard MIME type describing the format of the contents. For more
10947
11000
  # information, see
10948
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17][1].
11001
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type][1].
10949
11002
  #
10950
11003
  #
10951
11004
  #
10952
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
11005
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type
10953
11006
  # @return [String]
10954
11007
  #
10955
11008
  # @!attribute [rw] checksum_algorithm
@@ -11020,11 +11073,11 @@ module Aws::S3
11020
11073
  # @!attribute [rw] expires
11021
11074
  # The date and time at which the object is no longer cacheable. For
11022
11075
  # more information, see
11023
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21][1].
11076
+ # [https://www.rfc-editor.org/rfc/rfc7234#section-5.3][1].
11024
11077
  #
11025
11078
  #
11026
11079
  #
11027
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
11080
+ # [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
11028
11081
  # @return [Time]
11029
11082
  #
11030
11083
  # @!attribute [rw] grant_full_control
@@ -11062,7 +11115,7 @@ module Aws::S3
11062
11115
  #
11063
11116
  # @!attribute [rw] server_side_encryption
11064
11117
  # The server-side encryption algorithm used when storing this object
11065
- # in Amazon S3 (for example, AES256, aws:kms).
11118
+ # in Amazon S3 (for example, AES256, `aws:kms`).
11066
11119
  # @return [String]
11067
11120
  #
11068
11121
  # @!attribute [rw] storage_class
@@ -11126,9 +11179,9 @@ module Aws::S3
11126
11179
  # @return [String]
11127
11180
  #
11128
11181
  # @!attribute [rw] ssekms_key_id
11129
- # If `x-amz-server-side-encryption` is present and has the value of
11130
- # `aws:kms`, this header specifies the ID of the Amazon Web Services
11131
- # Key Management Service (Amazon Web Services KMS) symmetrical
11182
+ # If `x-amz-server-side-encryption` has a valid value of `aws:kms`,
11183
+ # this header specifies the ID of the Amazon Web Services Key
11184
+ # Management Service (Amazon Web Services KMS) symmetric encryption
11132
11185
  # customer managed key that was used for the object. If you specify
11133
11186
  # `x-amz-server-side-encryption:aws:kms`, but do not provide`
11134
11187
  # x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
@@ -11141,7 +11194,9 @@ module Aws::S3
11141
11194
  # Specifies the Amazon Web Services KMS Encryption Context to use for
11142
11195
  # object encryption. The value of this header is a base64-encoded
11143
11196
  # UTF-8 string holding JSON with the encryption context key-value
11144
- # pairs.
11197
+ # pairs. This value is stored as object metadata and automatically
11198
+ # gets passed on to Amazon Web Services KMS for future `GetObject` or
11199
+ # `CopyObject` operations on this object.
11145
11200
  # @return [String]
11146
11201
  #
11147
11202
  # @!attribute [rw] bucket_key_enabled
@@ -11372,14 +11427,14 @@ module Aws::S3
11372
11427
  # bucket name. For more information about access point ARNs, see
11373
11428
  # [Using access points][1] in the *Amazon S3 User Guide*.
11374
11429
  #
11375
- # When using this action with Amazon S3 on Outposts, you must direct
11430
+ # When you use this action with Amazon S3 on Outposts, you must direct
11376
11431
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
11377
11432
  # takes the form `
11378
11433
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
11379
- # When using this action with S3 on Outposts through the Amazon Web
11380
- # Services SDKs, you provide the Outposts bucket ARN in place of the
11381
- # bucket name. For more information about S3 on Outposts ARNs, see
11382
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
11434
+ # When you use this action with S3 on Outposts through the Amazon Web
11435
+ # Services SDKs, you provide the Outposts access point ARN in place of
11436
+ # the bucket name. For more information about S3 on Outposts ARNs, see
11437
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
11383
11438
  #
11384
11439
  #
11385
11440
  #
@@ -11808,6 +11863,13 @@ module Aws::S3
11808
11863
  # @return [Types::SourceSelectionCriteria]
11809
11864
  #
11810
11865
  # @!attribute [rw] existing_object_replication
11866
+ # Optional configuration to replicate existing source bucket objects.
11867
+ # For more information, see [Replicating Existing Objects][1] in the
11868
+ # *Amazon S3 User Guide*.
11869
+ #
11870
+ #
11871
+ #
11872
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-what-is-isnot-replicated.html#existing-object-replication
11811
11873
  # @return [Types::ExistingObjectReplication]
11812
11874
  #
11813
11875
  # @!attribute [rw] destination
@@ -12033,14 +12095,14 @@ module Aws::S3
12033
12095
  # bucket name. For more information about access point ARNs, see
12034
12096
  # [Using access points][1] in the *Amazon S3 User Guide*.
12035
12097
  #
12036
- # When using this action with Amazon S3 on Outposts, you must direct
12098
+ # When you use this action with Amazon S3 on Outposts, you must direct
12037
12099
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
12038
12100
  # takes the form `
12039
12101
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
12040
- # When using this action with S3 on Outposts through the Amazon Web
12041
- # Services SDKs, you provide the Outposts bucket ARN in place of the
12042
- # bucket name. For more information about S3 on Outposts ARNs, see
12043
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
12102
+ # When you use this action with S3 on Outposts through the Amazon Web
12103
+ # Services SDKs, you provide the Outposts access point ARN in place of
12104
+ # the bucket name. For more information about S3 on Outposts ARNs, see
12105
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
12044
12106
  #
12045
12107
  #
12046
12108
  #
@@ -12355,8 +12417,8 @@ module Aws::S3
12355
12417
  #
12356
12418
  # @!attribute [rw] key_id
12357
12419
  # Specifies the ID of the Amazon Web Services Key Management Service
12358
- # (Amazon Web Services KMS) symmetric customer managed key to use for
12359
- # encrypting inventory reports.
12420
+ # (Amazon Web Services KMS) symmetric encryption customer managed key
12421
+ # to use for encrypting inventory reports.
12360
12422
  # @return [String]
12361
12423
  #
12362
12424
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/SSEKMS AWS API Documentation
@@ -12607,10 +12669,9 @@ module Aws::S3
12607
12669
  # * Key ARN:
12608
12670
  # `arn:aws:kms:us-east-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab`
12609
12671
  #
12610
- # Amazon S3 only supports symmetric KMS keys and not asymmetric KMS
12611
- # keys. For more information, see [Using symmetric and asymmetric
12612
- # keys][2] in the *Amazon Web Services Key Management Service
12613
- # Developer Guide*.
12672
+ # Amazon S3 only supports symmetric encryption KMS keys. For more
12673
+ # information, see [Asymmetric keys in Amazon Web Services KMS][2] in
12674
+ # the *Amazon Web Services Key Management Service Developer Guide*.
12614
12675
  #
12615
12676
  #
12616
12677
  #
@@ -13030,7 +13091,7 @@ module Aws::S3
13030
13091
  #
13031
13092
  # @!attribute [rw] server_side_encryption
13032
13093
  # The server-side encryption algorithm used when storing this object
13033
- # in Amazon S3 (for example, AES256, aws:kms).
13094
+ # in Amazon S3 (for example, AES256, `aws:kms`).
13034
13095
  # @return [String]
13035
13096
  #
13036
13097
  # @!attribute [rw] sse_customer_algorithm
@@ -13048,8 +13109,8 @@ module Aws::S3
13048
13109
  #
13049
13110
  # @!attribute [rw] ssekms_key_id
13050
13111
  # If present, specifies the ID of the Amazon Web Services Key
13051
- # Management Service (Amazon Web Services KMS) symmetric customer
13052
- # managed key that was used for the object.
13112
+ # Management Service (Amazon Web Services KMS) symmetric encryption
13113
+ # customer managed key that was used for the object.
13053
13114
  # @return [String]
13054
13115
  #
13055
13116
  # @!attribute [rw] bucket_key_enabled
@@ -13089,14 +13150,14 @@ module Aws::S3
13089
13150
  # bucket name. For more information about access point ARNs, see
13090
13151
  # [Using access points][1] in the *Amazon S3 User Guide*.
13091
13152
  #
13092
- # When using this action with Amazon S3 on Outposts, you must direct
13153
+ # When you use this action with Amazon S3 on Outposts, you must direct
13093
13154
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
13094
13155
  # takes the form `
13095
13156
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
13096
- # When using this action with S3 on Outposts through the Amazon Web
13097
- # Services SDKs, you provide the Outposts bucket ARN in place of the
13098
- # bucket name. For more information about S3 on Outposts ARNs, see
13099
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
13157
+ # When you use this action with S3 on Outposts through the Amazon Web
13158
+ # Services SDKs, you provide the Outposts access point ARN in place of
13159
+ # the bucket name. For more information about S3 on Outposts ARNs, see
13160
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
13100
13161
  #
13101
13162
  #
13102
13163
  #
@@ -13107,7 +13168,7 @@ module Aws::S3
13107
13168
  # @!attribute [rw] copy_source
13108
13169
  # Specifies the source object for the copy operation. You specify the
13109
13170
  # value in one of two formats, depending on whether you want to access
13110
- # the source object through an [access point][1]\:
13171
+ # the source object through an [access point][1]:
13111
13172
  #
13112
13173
  # * For objects not accessed through an access point, specify the name
13113
13174
  # of the source bucket and key of the source object, separated by a
@@ -13283,7 +13344,7 @@ module Aws::S3
13283
13344
 
13284
13345
  # @!attribute [rw] server_side_encryption
13285
13346
  # The server-side encryption algorithm used when storing this object
13286
- # in Amazon S3 (for example, AES256, aws:kms).
13347
+ # in Amazon S3 (for example, AES256, `aws:kms`).
13287
13348
  # @return [String]
13288
13349
  #
13289
13350
  # @!attribute [rw] etag
@@ -13357,8 +13418,8 @@ module Aws::S3
13357
13418
  #
13358
13419
  # @!attribute [rw] ssekms_key_id
13359
13420
  # If present, specifies the ID of the Amazon Web Services Key
13360
- # Management Service (Amazon Web Services KMS) symmetric customer
13361
- # managed key was used for the object.
13421
+ # Management Service (Amazon Web Services KMS) symmetric encryption
13422
+ # customer managed key was used for the object.
13362
13423
  # @return [String]
13363
13424
  #
13364
13425
  # @!attribute [rw] bucket_key_enabled
@@ -13405,14 +13466,14 @@ module Aws::S3
13405
13466
  # bucket name. For more information about access point ARNs, see
13406
13467
  # [Using access points][1] in the *Amazon S3 User Guide*.
13407
13468
  #
13408
- # When using this action with Amazon S3 on Outposts, you must direct
13469
+ # When you use this action with Amazon S3 on Outposts, you must direct
13409
13470
  # requests to the S3 on Outposts hostname. The S3 on Outposts hostname
13410
13471
  # takes the form `
13411
13472
  # AccessPointName-AccountId.outpostID.s3-outposts.Region.amazonaws.com`.
13412
- # When using this action with S3 on Outposts through the Amazon Web
13413
- # Services SDKs, you provide the Outposts bucket ARN in place of the
13414
- # bucket name. For more information about S3 on Outposts ARNs, see
13415
- # [Using Amazon S3 on Outposts][2] in the *Amazon S3 User Guide*.
13473
+ # When you use this action with S3 on Outposts through the Amazon Web
13474
+ # Services SDKs, you provide the Outposts access point ARN in place of
13475
+ # the bucket name. For more information about S3 on Outposts ARNs, see
13476
+ # [What is S3 on Outposts][2] in the *Amazon S3 User Guide*.
13416
13477
  #
13417
13478
  #
13418
13479
  #
@@ -13896,7 +13957,7 @@ module Aws::S3
13896
13957
  #
13897
13958
  # @!attribute [rw] server_side_encryption
13898
13959
  # The server-side encryption algorithm used when storing requested
13899
- # object in Amazon S3 (for example, AES256, aws:kms).
13960
+ # object in Amazon S3 (for example, AES256, `aws:kms`).
13900
13961
  # @return [String]
13901
13962
  #
13902
13963
  # @!attribute [rw] sse_customer_algorithm
@@ -13907,8 +13968,8 @@ module Aws::S3
13907
13968
  #
13908
13969
  # @!attribute [rw] ssekms_key_id
13909
13970
  # If present, specifies the ID of the Amazon Web Services Key
13910
- # Management Service (Amazon Web Services KMS) symmetric customer
13911
- # managed key that was used for stored in Amazon S3 object.
13971
+ # Management Service (Amazon Web Services KMS) symmetric encryption
13972
+ # customer managed key that was used for stored in Amazon S3 object.
13912
13973
  # @return [String]
13913
13974
  #
13914
13975
  # @!attribute [rw] sse_customer_key_md5