aws-sdk-s3 1.119.1 → 1.120.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -284,7 +284,7 @@ module Aws::S3
284
284
  # @option options [required, String] :copy_source
285
285
  # Specifies the source object for the copy operation. You specify the
286
286
  # value in one of two formats, depending on whether you want to access
287
- # the source object through an [access point][1]\:
287
+ # the source object through an [access point][1]:
288
288
  #
289
289
  # * For objects not accessed through an access point, specify the name
290
290
  # of the source bucket and key of the source object, separated by a
@@ -239,11 +239,8 @@ module Aws::S3
239
239
  data[:website_redirect_location]
240
240
  end
241
241
 
242
- # If the object is stored using server-side encryption either with an
243
- # Amazon Web Services KMS key or an Amazon S3-managed encryption key,
244
- # the response includes this header with the value of the server-side
245
- # encryption algorithm used when storing this object in Amazon S3 (for
246
- # example, AES256, aws:kms).
242
+ # The server-side encryption algorithm used when storing this object in
243
+ # Amazon S3 (for example, AES256, `aws:kms`).
247
244
  # @return [String]
248
245
  def server_side_encryption
249
246
  data[:server_side_encryption]
@@ -273,8 +270,8 @@ module Aws::S3
273
270
  end
274
271
 
275
272
  # If present, specifies the ID of the Amazon Web Services Key Management
276
- # Service (Amazon Web Services KMS) symmetric customer managed key that
277
- # was used for the object.
273
+ # Service (Amazon Web Services KMS) symmetric encryption customer
274
+ # managed key that was used for the object.
278
275
  # @return [String]
279
276
  def ssekms_key_id
280
277
  data[:ssekms_key_id]
@@ -658,7 +655,7 @@ module Aws::S3
658
655
  # @option options [required, String] :copy_source
659
656
  # Specifies the source object for the copy operation. You specify the
660
657
  # value in one of two formats, depending on whether you want to access
661
- # the source object through an [access point][1]\:
658
+ # the source object through an [access point][1]:
662
659
  #
663
660
  # * For objects not accessed through an access point, specify the name
664
661
  # of the source bucket and the key of the source object, separated by
@@ -740,7 +737,7 @@ module Aws::S3
740
737
  # or replaced with tag-set provided in the request.
741
738
  # @option options [String] :server_side_encryption
742
739
  # The server-side encryption algorithm used when storing this object in
743
- # Amazon S3 (for example, AES256, aws:kms).
740
+ # Amazon S3 (for example, AES256, `aws:kms`).
744
741
  # @option options [String] :storage_class
745
742
  # By default, Amazon S3 uses the STANDARD Storage Class to store newly
746
743
  # created objects. The STANDARD storage class provides high durability
@@ -755,7 +752,10 @@ module Aws::S3
755
752
  # @option options [String] :website_redirect_location
756
753
  # If the bucket is configured as a website, redirects requests for this
757
754
  # object to another object in the same bucket or to an external URL.
758
- # Amazon S3 stores the value of this header in the object metadata.
755
+ # Amazon S3 stores the value of this header in the object metadata. This
756
+ # value is unique to each object and is not copied when using the
757
+ # `x-amz-metadata-directive` header. Instead, you may opt to provide
758
+ # this header in combination with the directive.
759
759
  # @option options [String] :sse_customer_algorithm
760
760
  # Specifies the algorithm to use to when encrypting the object (for
761
761
  # example, AES256).
@@ -927,7 +927,7 @@ module Aws::S3
927
927
  # @option options [String] :range
928
928
  # Downloads the specified range bytes of an object. For more information
929
929
  # about the HTTP Range header, see
930
- # [https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
930
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-range][1].
931
931
  #
932
932
  # <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
933
933
  # `GET` request.
@@ -936,7 +936,7 @@ module Aws::S3
936
936
  #
937
937
  #
938
938
  #
939
- # [1]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
939
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-range
940
940
  # @option options [String] :response_cache_control
941
941
  # Sets the `Cache-Control` header of the response.
942
942
  # @option options [String] :response_content_disposition
@@ -1069,7 +1069,7 @@ module Aws::S3
1069
1069
  # A map of metadata to store with the object in S3.
1070
1070
  # @option options [String] :server_side_encryption
1071
1071
  # The server-side encryption algorithm used when storing this object in
1072
- # Amazon S3 (for example, AES256, aws:kms).
1072
+ # Amazon S3 (for example, AES256, `aws:kms`).
1073
1073
  # @option options [String] :storage_class
1074
1074
  # By default, Amazon S3 uses the STANDARD Storage Class to store newly
1075
1075
  # created objects. The STANDARD storage class provides high durability
@@ -1099,13 +1099,13 @@ module Aws::S3
1099
1099
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
1100
1100
  # ensure that the encryption key was transmitted without error.
1101
1101
  # @option options [String] :ssekms_key_id
1102
- # Specifies the ID of the symmetric customer managed key to use for
1103
- # object encryption. All GET and PUT requests for an object protected by
1104
- # Amazon Web Services KMS will fail if not made via SSL or using SigV4.
1105
- # For information about configuring using any of the officially
1106
- # supported Amazon Web Services SDKs and Amazon Web Services CLI, see
1107
- # [Specifying the Signature Version in Request Authentication][1] in the
1108
- # *Amazon S3 User Guide*.
1102
+ # Specifies the ID of the symmetric encryption customer managed key to
1103
+ # use for object encryption. All GET and PUT requests for an object
1104
+ # protected by Amazon Web Services KMS will fail if not made via SSL or
1105
+ # using SigV4. For information about configuring using any of the
1106
+ # officially supported Amazon Web Services SDKs and Amazon Web Services
1107
+ # CLI, see [Specifying the Signature Version in Request
1108
+ # Authentication][1] in the *Amazon S3 User Guide*.
1109
1109
  #
1110
1110
  #
1111
1111
  #
@@ -1234,30 +1234,30 @@ module Aws::S3
1234
1234
  # @option options [String] :content_disposition
1235
1235
  # Specifies presentational information for the object. For more
1236
1236
  # information, see
1237
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1][1].
1237
+ # [https://www.rfc-editor.org/rfc/rfc6266#section-4][1].
1238
1238
  #
1239
1239
  #
1240
1240
  #
1241
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
1241
+ # [1]: https://www.rfc-editor.org/rfc/rfc6266#section-4
1242
1242
  # @option options [String] :content_encoding
1243
1243
  # Specifies what content encodings have been applied to the object and
1244
1244
  # thus what decoding mechanisms must be applied to obtain the media-type
1245
1245
  # referenced by the Content-Type header field. For more information, see
1246
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11][1].
1246
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding][1].
1247
1247
  #
1248
1248
  #
1249
1249
  #
1250
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
1250
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding
1251
1251
  # @option options [String] :content_language
1252
1252
  # The language the content is in.
1253
1253
  # @option options [Integer] :content_length
1254
1254
  # Size of the body in bytes. This parameter is useful when the size of
1255
1255
  # the body cannot be determined automatically. For more information, see
1256
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13][1].
1256
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length][1].
1257
1257
  #
1258
1258
  #
1259
1259
  #
1260
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
1260
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
1261
1261
  # @option options [String] :content_md5
1262
1262
  # The base64-encoded 128-bit MD5 digest of the message (without the
1263
1263
  # headers) according to RFC 1864. This header can be used as a message
@@ -1273,11 +1273,11 @@ module Aws::S3
1273
1273
  # @option options [String] :content_type
1274
1274
  # A standard MIME type describing the format of the contents. For more
1275
1275
  # information, see
1276
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17][1].
1276
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type][1].
1277
1277
  #
1278
1278
  #
1279
1279
  #
1280
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
1280
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type
1281
1281
  # @option options [String] :checksum_algorithm
1282
1282
  # Indicates the algorithm used to create the checksum for the object
1283
1283
  # when using the SDK. This header will not provide any additional
@@ -1336,11 +1336,11 @@ module Aws::S3
1336
1336
  # @option options [Time,DateTime,Date,Integer,String] :expires
1337
1337
  # The date and time at which the object is no longer cacheable. For more
1338
1338
  # information, see
1339
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21][1].
1339
+ # [https://www.rfc-editor.org/rfc/rfc7234#section-5.3][1].
1340
1340
  #
1341
1341
  #
1342
1342
  #
1343
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
1343
+ # [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
1344
1344
  # @option options [String] :grant_full_control
1345
1345
  # Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
1346
1346
  # object.
@@ -1362,7 +1362,7 @@ module Aws::S3
1362
1362
  # A map of metadata to store with the object in S3.
1363
1363
  # @option options [String] :server_side_encryption
1364
1364
  # The server-side encryption algorithm used when storing this object in
1365
- # Amazon S3 (for example, AES256, aws:kms).
1365
+ # Amazon S3 (for example, AES256, `aws:kms`).
1366
1366
  # @option options [String] :storage_class
1367
1367
  # By default, Amazon S3 uses the STANDARD Storage Class to store newly
1368
1368
  # created objects. The STANDARD storage class provides high durability
@@ -1413,9 +1413,9 @@ module Aws::S3
1413
1413
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
1414
1414
  # ensure that the encryption key was transmitted without error.
1415
1415
  # @option options [String] :ssekms_key_id
1416
- # If `x-amz-server-side-encryption` is present and has the value of
1417
- # `aws:kms`, this header specifies the ID of the Amazon Web Services Key
1418
- # Management Service (Amazon Web Services KMS) symmetrical customer
1416
+ # If `x-amz-server-side-encryption` has a valid value of `aws:kms`, this
1417
+ # header specifies the ID of the Amazon Web Services Key Management
1418
+ # Service (Amazon Web Services KMS) symmetric encryption customer
1419
1419
  # managed key that was used for the object. If you specify
1420
1420
  # `x-amz-server-side-encryption:aws:kms`, but do not provide`
1421
1421
  # x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
@@ -1425,7 +1425,10 @@ module Aws::S3
1425
1425
  # @option options [String] :ssekms_encryption_context
1426
1426
  # Specifies the Amazon Web Services KMS Encryption Context to use for
1427
1427
  # object encryption. The value of this header is a base64-encoded UTF-8
1428
- # string holding JSON with the encryption context key-value pairs.
1428
+ # string holding JSON with the encryption context key-value pairs. This
1429
+ # value is stored as object metadata and automatically gets passed on to
1430
+ # Amazon Web Services KMS for future `GetObject` or `CopyObject`
1431
+ # operations on this object.
1429
1432
  # @option options [Boolean] :bucket_key_enabled
1430
1433
  # Specifies whether Amazon S3 should use an S3 Bucket Key for object
1431
1434
  # encryption with server-side encryption using AWS KMS (SSE-KMS).
@@ -1637,8 +1640,10 @@ module Aws::S3
1637
1640
  # Return the object only if it has not been modified since the specified
1638
1641
  # time; otherwise, return a 412 (precondition failed) error.
1639
1642
  # @option options [String] :range
1640
- # Because `HeadObject` returns only the metadata for an object, this
1641
- # parameter has no effect.
1643
+ # HeadObject returns only the metadata for an object. If the Range is
1644
+ # satisfiable, only the `ContentLength` is affected in the response. If
1645
+ # the Range is not satisfiable, S3 returns a `416 - Requested Range Not
1646
+ # Satisfiable` error.
1642
1647
  # @option options [String] :version_id
1643
1648
  # VersionId used to reference a specific version of the object.
1644
1649
  # @option options [String] :sse_customer_algorithm
@@ -352,7 +352,7 @@ module Aws::S3
352
352
  # @option options [required, String] :copy_source
353
353
  # Specifies the source object for the copy operation. You specify the
354
354
  # value in one of two formats, depending on whether you want to access
355
- # the source object through an [access point][1]\:
355
+ # the source object through an [access point][1]:
356
356
  #
357
357
  # * For objects not accessed through an access point, specify the name
358
358
  # of the source bucket and the key of the source object, separated by
@@ -434,7 +434,7 @@ module Aws::S3
434
434
  # or replaced with tag-set provided in the request.
435
435
  # @option options [String] :server_side_encryption
436
436
  # The server-side encryption algorithm used when storing this object in
437
- # Amazon S3 (for example, AES256, aws:kms).
437
+ # Amazon S3 (for example, AES256, `aws:kms`).
438
438
  # @option options [String] :storage_class
439
439
  # By default, Amazon S3 uses the STANDARD Storage Class to store newly
440
440
  # created objects. The STANDARD storage class provides high durability
@@ -449,7 +449,10 @@ module Aws::S3
449
449
  # @option options [String] :website_redirect_location
450
450
  # If the bucket is configured as a website, redirects requests for this
451
451
  # object to another object in the same bucket or to an external URL.
452
- # Amazon S3 stores the value of this header in the object metadata.
452
+ # Amazon S3 stores the value of this header in the object metadata. This
453
+ # value is unique to each object and is not copied when using the
454
+ # `x-amz-metadata-directive` header. Instead, you may opt to provide
455
+ # this header in combination with the directive.
453
456
  # @option options [String] :sse_customer_algorithm
454
457
  # Specifies the algorithm to use to when encrypting the object (for
455
458
  # example, AES256).
@@ -621,7 +624,7 @@ module Aws::S3
621
624
  # @option options [String] :range
622
625
  # Downloads the specified range bytes of an object. For more information
623
626
  # about the HTTP Range header, see
624
- # [https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
627
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-range][1].
625
628
  #
626
629
  # <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
627
630
  # `GET` request.
@@ -630,7 +633,7 @@ module Aws::S3
630
633
  #
631
634
  #
632
635
  #
633
- # [1]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
636
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-range
634
637
  # @option options [String] :response_cache_control
635
638
  # Sets the `Cache-Control` header of the response.
636
639
  # @option options [String] :response_content_disposition
@@ -763,7 +766,7 @@ module Aws::S3
763
766
  # A map of metadata to store with the object in S3.
764
767
  # @option options [String] :server_side_encryption
765
768
  # The server-side encryption algorithm used when storing this object in
766
- # Amazon S3 (for example, AES256, aws:kms).
769
+ # Amazon S3 (for example, AES256, `aws:kms`).
767
770
  # @option options [String] :storage_class
768
771
  # By default, Amazon S3 uses the STANDARD Storage Class to store newly
769
772
  # created objects. The STANDARD storage class provides high durability
@@ -793,13 +796,13 @@ module Aws::S3
793
796
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
794
797
  # ensure that the encryption key was transmitted without error.
795
798
  # @option options [String] :ssekms_key_id
796
- # Specifies the ID of the symmetric customer managed key to use for
797
- # object encryption. All GET and PUT requests for an object protected by
798
- # Amazon Web Services KMS will fail if not made via SSL or using SigV4.
799
- # For information about configuring using any of the officially
800
- # supported Amazon Web Services SDKs and Amazon Web Services CLI, see
801
- # [Specifying the Signature Version in Request Authentication][1] in the
802
- # *Amazon S3 User Guide*.
799
+ # Specifies the ID of the symmetric encryption customer managed key to
800
+ # use for object encryption. All GET and PUT requests for an object
801
+ # protected by Amazon Web Services KMS will fail if not made via SSL or
802
+ # using SigV4. For information about configuring using any of the
803
+ # officially supported Amazon Web Services SDKs and Amazon Web Services
804
+ # CLI, see [Specifying the Signature Version in Request
805
+ # Authentication][1] in the *Amazon S3 User Guide*.
803
806
  #
804
807
  #
805
808
  #
@@ -928,30 +931,30 @@ module Aws::S3
928
931
  # @option options [String] :content_disposition
929
932
  # Specifies presentational information for the object. For more
930
933
  # information, see
931
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1][1].
934
+ # [https://www.rfc-editor.org/rfc/rfc6266#section-4][1].
932
935
  #
933
936
  #
934
937
  #
935
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec19.html#sec19.5.1
938
+ # [1]: https://www.rfc-editor.org/rfc/rfc6266#section-4
936
939
  # @option options [String] :content_encoding
937
940
  # Specifies what content encodings have been applied to the object and
938
941
  # thus what decoding mechanisms must be applied to obtain the media-type
939
942
  # referenced by the Content-Type header field. For more information, see
940
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11][1].
943
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding][1].
941
944
  #
942
945
  #
943
946
  #
944
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.11
947
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#field.content-encoding
945
948
  # @option options [String] :content_language
946
949
  # The language the content is in.
947
950
  # @option options [Integer] :content_length
948
951
  # Size of the body in bytes. This parameter is useful when the size of
949
952
  # the body cannot be determined automatically. For more information, see
950
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13][1].
953
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length][1].
951
954
  #
952
955
  #
953
956
  #
954
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.13
957
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-length
955
958
  # @option options [String] :content_md5
956
959
  # The base64-encoded 128-bit MD5 digest of the message (without the
957
960
  # headers) according to RFC 1864. This header can be used as a message
@@ -967,11 +970,11 @@ module Aws::S3
967
970
  # @option options [String] :content_type
968
971
  # A standard MIME type describing the format of the contents. For more
969
972
  # information, see
970
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17][1].
973
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type][1].
971
974
  #
972
975
  #
973
976
  #
974
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.17
977
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-content-type
975
978
  # @option options [String] :checksum_algorithm
976
979
  # Indicates the algorithm used to create the checksum for the object
977
980
  # when using the SDK. This header will not provide any additional
@@ -1030,11 +1033,11 @@ module Aws::S3
1030
1033
  # @option options [Time,DateTime,Date,Integer,String] :expires
1031
1034
  # The date and time at which the object is no longer cacheable. For more
1032
1035
  # information, see
1033
- # [http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21][1].
1036
+ # [https://www.rfc-editor.org/rfc/rfc7234#section-5.3][1].
1034
1037
  #
1035
1038
  #
1036
1039
  #
1037
- # [1]: http://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.21
1040
+ # [1]: https://www.rfc-editor.org/rfc/rfc7234#section-5.3
1038
1041
  # @option options [String] :grant_full_control
1039
1042
  # Gives the grantee READ, READ\_ACP, and WRITE\_ACP permissions on the
1040
1043
  # object.
@@ -1056,7 +1059,7 @@ module Aws::S3
1056
1059
  # A map of metadata to store with the object in S3.
1057
1060
  # @option options [String] :server_side_encryption
1058
1061
  # The server-side encryption algorithm used when storing this object in
1059
- # Amazon S3 (for example, AES256, aws:kms).
1062
+ # Amazon S3 (for example, AES256, `aws:kms`).
1060
1063
  # @option options [String] :storage_class
1061
1064
  # By default, Amazon S3 uses the STANDARD Storage Class to store newly
1062
1065
  # created objects. The STANDARD storage class provides high durability
@@ -1107,9 +1110,9 @@ module Aws::S3
1107
1110
  # RFC 1321. Amazon S3 uses this header for a message integrity check to
1108
1111
  # ensure that the encryption key was transmitted without error.
1109
1112
  # @option options [String] :ssekms_key_id
1110
- # If `x-amz-server-side-encryption` is present and has the value of
1111
- # `aws:kms`, this header specifies the ID of the Amazon Web Services Key
1112
- # Management Service (Amazon Web Services KMS) symmetrical customer
1113
+ # If `x-amz-server-side-encryption` has a valid value of `aws:kms`, this
1114
+ # header specifies the ID of the Amazon Web Services Key Management
1115
+ # Service (Amazon Web Services KMS) symmetric encryption customer
1113
1116
  # managed key that was used for the object. If you specify
1114
1117
  # `x-amz-server-side-encryption:aws:kms`, but do not provide`
1115
1118
  # x-amz-server-side-encryption-aws-kms-key-id`, Amazon S3 uses the
@@ -1119,7 +1122,10 @@ module Aws::S3
1119
1122
  # @option options [String] :ssekms_encryption_context
1120
1123
  # Specifies the Amazon Web Services KMS Encryption Context to use for
1121
1124
  # object encryption. The value of this header is a base64-encoded UTF-8
1122
- # string holding JSON with the encryption context key-value pairs.
1125
+ # string holding JSON with the encryption context key-value pairs. This
1126
+ # value is stored as object metadata and automatically gets passed on to
1127
+ # Amazon Web Services KMS for future `GetObject` or `CopyObject`
1128
+ # operations on this object.
1123
1129
  # @option options [Boolean] :bucket_key_enabled
1124
1130
  # Specifies whether Amazon S3 should use an S3 Bucket Key for object
1125
1131
  # encryption with server-side encryption using AWS KMS (SSE-KMS).
@@ -315,7 +315,7 @@ module Aws::S3
315
315
  # @option options [String] :range
316
316
  # Downloads the specified range bytes of an object. For more information
317
317
  # about the HTTP Range header, see
318
- # [https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35][1].
318
+ # [https://www.rfc-editor.org/rfc/rfc9110.html#name-range][1].
319
319
  #
320
320
  # <note markdown="1"> Amazon S3 doesn't support retrieving multiple ranges of data per
321
321
  # `GET` request.
@@ -324,7 +324,7 @@ module Aws::S3
324
324
  #
325
325
  #
326
326
  #
327
- # [1]: https://www.w3.org/Protocols/rfc2616/rfc2616-sec14.html#sec14.35
327
+ # [1]: https://www.rfc-editor.org/rfc/rfc9110.html#name-range
328
328
  # @option options [String] :response_cache_control
329
329
  # Sets the `Cache-Control` header of the response.
330
330
  # @option options [String] :response_content_disposition
@@ -412,8 +412,10 @@ module Aws::S3
412
412
  # Return the object only if it has not been modified since the specified
413
413
  # time; otherwise, return a 412 (precondition failed) error.
414
414
  # @option options [String] :range
415
- # Because `HeadObject` returns only the metadata for an object, this
416
- # parameter has no effect.
415
+ # HeadObject returns only the metadata for an object. If the Range is
416
+ # satisfiable, only the `ContentLength` is affected in the response. If
417
+ # the Range is not satisfiable, S3 returns a `416 - Requested Range Not
418
+ # Satisfiable` error.
417
419
  # @option options [String] :sse_customer_algorithm
418
420
  # Specifies the algorithm to use to when encrypting the object (for
419
421
  # example, AES256).