aws-sdk-s3 1.199.0 → 1.205.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.
- checksums.yaml +4 -4
- data/CHANGELOG.md +44 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket_versioning.rb +33 -0
- data/lib/aws-sdk-s3/client.rb +935 -257
- data/lib/aws-sdk-s3/client_api.rb +61 -0
- data/lib/aws-sdk-s3/customizations/object.rb +33 -24
- data/lib/aws-sdk-s3/customizations.rb +1 -0
- data/lib/aws-sdk-s3/default_executor.rb +103 -0
- data/lib/aws-sdk-s3/endpoint_parameters.rb +17 -17
- data/lib/aws-sdk-s3/endpoint_provider.rb +220 -50
- data/lib/aws-sdk-s3/endpoints.rb +26 -0
- data/lib/aws-sdk-s3/file_downloader.rb +192 -112
- data/lib/aws-sdk-s3/file_uploader.rb +6 -8
- data/lib/aws-sdk-s3/multipart_file_uploader.rb +79 -63
- data/lib/aws-sdk-s3/multipart_stream_uploader.rb +41 -44
- data/lib/aws-sdk-s3/object.rb +52 -23
- data/lib/aws-sdk-s3/object_summary.rb +38 -9
- data/lib/aws-sdk-s3/object_version.rb +7 -9
- data/lib/aws-sdk-s3/plugins/endpoints.rb +1 -1
- data/lib/aws-sdk-s3/transfer_manager.rb +87 -30
- data/lib/aws-sdk-s3/types.rb +383 -140
- data/lib/aws-sdk-s3.rb +1 -1
- data/sig/client.rbs +29 -1
- data/sig/object.rbs +2 -0
- data/sig/object_summary.rbs +2 -0
- data/sig/types.rbs +33 -0
- metadata +4 -3
data/lib/aws-sdk-s3/types.rb
CHANGED
|
@@ -10,6 +10,29 @@
|
|
|
10
10
|
module Aws::S3
|
|
11
11
|
module Types
|
|
12
12
|
|
|
13
|
+
# The ABAC status of the general purpose bucket. When ABAC is enabled
|
|
14
|
+
# for the general purpose bucket, you can use tags to manage access to
|
|
15
|
+
# the general purpose buckets as well as for cost tracking purposes.
|
|
16
|
+
# When ABAC is disabled for the general purpose buckets, you can only
|
|
17
|
+
# use tags for cost tracking purposes. For more information, see [Using
|
|
18
|
+
# tags with S3 general purpose buckets][1].
|
|
19
|
+
#
|
|
20
|
+
#
|
|
21
|
+
#
|
|
22
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html
|
|
23
|
+
#
|
|
24
|
+
# @!attribute [rw] status
|
|
25
|
+
# The ABAC status of the general purpose bucket.
|
|
26
|
+
# @return [String]
|
|
27
|
+
#
|
|
28
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/AbacStatus AWS API Documentation
|
|
29
|
+
#
|
|
30
|
+
class AbacStatus < Struct.new(
|
|
31
|
+
:status)
|
|
32
|
+
SENSITIVE = []
|
|
33
|
+
include Aws::Structure
|
|
34
|
+
end
|
|
35
|
+
|
|
13
36
|
# Specifies the days since the initiation of an incomplete multipart
|
|
14
37
|
# upload that Amazon S3 will wait before permanently removing all parts
|
|
15
38
|
# of the upload. For more information, see [ Aborting Incomplete
|
|
@@ -355,6 +378,63 @@ module Aws::S3
|
|
|
355
378
|
include Aws::Structure
|
|
356
379
|
end
|
|
357
380
|
|
|
381
|
+
# A bucket-level setting for Amazon S3 general purpose buckets used to
|
|
382
|
+
# prevent the upload of new objects encrypted with the specified
|
|
383
|
+
# server-side encryption type. For example, blocking an encryption type
|
|
384
|
+
# will block `PutObject`, `CopyObject`, `PostObject`, multipart upload,
|
|
385
|
+
# and replication requests to the bucket for objects with the specified
|
|
386
|
+
# encryption type. However, you can continue to read and list any
|
|
387
|
+
# pre-existing objects already encrypted with the specified encryption
|
|
388
|
+
# type. For more information, see [Blocking an encryption type for a
|
|
389
|
+
# general purpose bucket][1].
|
|
390
|
+
#
|
|
391
|
+
# This data type is used with the following actions:
|
|
392
|
+
#
|
|
393
|
+
# * [PutBucketEncryption][2]
|
|
394
|
+
#
|
|
395
|
+
# * [GetBucketEncryption][3]
|
|
396
|
+
#
|
|
397
|
+
# * [DeleteBucketEncryption][4]
|
|
398
|
+
#
|
|
399
|
+
# Permissions
|
|
400
|
+
#
|
|
401
|
+
# : You must have the `s3:PutEncryptionConfiguration` permission to
|
|
402
|
+
# block or unblock an encryption type for a bucket.
|
|
403
|
+
#
|
|
404
|
+
# You must have the `s3:GetEncryptionConfiguration` permission to view
|
|
405
|
+
# a bucket's encryption type.
|
|
406
|
+
#
|
|
407
|
+
#
|
|
408
|
+
#
|
|
409
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/userguide/block-encryption-type.html
|
|
410
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketEncryption.html
|
|
411
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketEncryption.html
|
|
412
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketEncryption.html
|
|
413
|
+
#
|
|
414
|
+
# @!attribute [rw] encryption_type
|
|
415
|
+
# The object encryption type that you want to block or unblock for an
|
|
416
|
+
# Amazon S3 general purpose bucket.
|
|
417
|
+
#
|
|
418
|
+
# <note markdown="1"> Currently, this parameter only supports blocking or unblocking
|
|
419
|
+
# server side encryption with customer-provided keys (SSE-C). For more
|
|
420
|
+
# information about SSE-C, see [Using server-side encryption with
|
|
421
|
+
# customer-provided keys (SSE-C)][1].
|
|
422
|
+
#
|
|
423
|
+
# </note>
|
|
424
|
+
#
|
|
425
|
+
#
|
|
426
|
+
#
|
|
427
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
|
|
428
|
+
# @return [Array<String>]
|
|
429
|
+
#
|
|
430
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/BlockedEncryptionTypes AWS API Documentation
|
|
431
|
+
#
|
|
432
|
+
class BlockedEncryptionTypes < Struct.new(
|
|
433
|
+
:encryption_type)
|
|
434
|
+
SENSITIVE = []
|
|
435
|
+
include Aws::Structure
|
|
436
|
+
end
|
|
437
|
+
|
|
358
438
|
# In terms of implementation, a Bucket is a resource.
|
|
359
439
|
#
|
|
360
440
|
# @!attribute [rw] name
|
|
@@ -680,7 +760,7 @@ module Aws::S3
|
|
|
680
760
|
#
|
|
681
761
|
# @!attribute [rw] checksum_crc32
|
|
682
762
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
683
|
-
# checksum is only
|
|
763
|
+
# checksum is only present if the checksum was uploaded with the
|
|
684
764
|
# object. When you use an API operation on an object that was uploaded
|
|
685
765
|
# using multipart uploads, this value may not be a direct checksum
|
|
686
766
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -722,14 +802,15 @@ module Aws::S3
|
|
|
722
802
|
# @return [String]
|
|
723
803
|
#
|
|
724
804
|
# @!attribute [rw] checksum_sha1
|
|
725
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
726
|
-
# only
|
|
727
|
-
# use the API operation on an object that was
|
|
728
|
-
# uploads, this value may not be a direct
|
|
729
|
-
# object. Instead, it's a calculation
|
|
730
|
-
# each individual part. For more
|
|
731
|
-
#
|
|
732
|
-
# integrity][1] in the *Amazon S3 User
|
|
805
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
806
|
+
# checksum is only present if the checksum was uploaded with the
|
|
807
|
+
# object. When you use the API operation on an object that was
|
|
808
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
809
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
810
|
+
# based on the checksum values of each individual part. For more
|
|
811
|
+
# information about how checksums are calculated with multipart
|
|
812
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
813
|
+
# Guide*.
|
|
733
814
|
#
|
|
734
815
|
#
|
|
735
816
|
#
|
|
@@ -737,14 +818,14 @@ module Aws::S3
|
|
|
737
818
|
# @return [String]
|
|
738
819
|
#
|
|
739
820
|
# @!attribute [rw] checksum_sha256
|
|
740
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
741
|
-
# only
|
|
742
|
-
# use an API operation on an object that was uploaded
|
|
743
|
-
# uploads, this value may not be a direct checksum
|
|
744
|
-
# object. Instead, it's a calculation based on the
|
|
745
|
-
# each individual part. For more information about
|
|
746
|
-
# calculated with multipart uploads, see [ Checking
|
|
747
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
821
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
822
|
+
# checksum is only present if the checksum was uploaded with the
|
|
823
|
+
# object. When you use an API operation on an object that was uploaded
|
|
824
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
825
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
826
|
+
# checksum values of each individual part. For more information about
|
|
827
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
828
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
748
829
|
#
|
|
749
830
|
#
|
|
750
831
|
#
|
|
@@ -874,7 +955,7 @@ module Aws::S3
|
|
|
874
955
|
#
|
|
875
956
|
# @!attribute [rw] checksum_crc32
|
|
876
957
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
877
|
-
# checksum is only
|
|
958
|
+
# checksum is only present if the checksum was uploaded with the
|
|
878
959
|
# object. When you use an API operation on an object that was uploaded
|
|
879
960
|
# using multipart uploads, this value may not be a direct checksum
|
|
880
961
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -916,14 +997,15 @@ module Aws::S3
|
|
|
916
997
|
# @return [String]
|
|
917
998
|
#
|
|
918
999
|
# @!attribute [rw] checksum_sha1
|
|
919
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
920
|
-
# only
|
|
921
|
-
# use the API operation on an object that was
|
|
922
|
-
# uploads, this value may not be a direct
|
|
923
|
-
# object. Instead, it's a calculation
|
|
924
|
-
# each individual part. For more
|
|
925
|
-
#
|
|
926
|
-
# integrity][1] in the *Amazon S3 User
|
|
1000
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
1001
|
+
# checksum is only present if the checksum was uploaded with the
|
|
1002
|
+
# object. When you use the API operation on an object that was
|
|
1003
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
1004
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
1005
|
+
# based on the checksum values of each individual part. For more
|
|
1006
|
+
# information about how checksums are calculated with multipart
|
|
1007
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
1008
|
+
# Guide*.
|
|
927
1009
|
#
|
|
928
1010
|
#
|
|
929
1011
|
#
|
|
@@ -931,14 +1013,14 @@ module Aws::S3
|
|
|
931
1013
|
# @return [String]
|
|
932
1014
|
#
|
|
933
1015
|
# @!attribute [rw] checksum_sha256
|
|
934
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
935
|
-
# only
|
|
936
|
-
# use an API operation on an object that was uploaded
|
|
937
|
-
# uploads, this value may not be a direct checksum
|
|
938
|
-
# object. Instead, it's a calculation based on the
|
|
939
|
-
# each individual part. For more information about
|
|
940
|
-
# calculated with multipart uploads, see [ Checking
|
|
941
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
1016
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
1017
|
+
# checksum is only present if the checksum was uploaded with the
|
|
1018
|
+
# object. When you use an API operation on an object that was uploaded
|
|
1019
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
1020
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
1021
|
+
# checksum values of each individual part. For more information about
|
|
1022
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
1023
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
942
1024
|
#
|
|
943
1025
|
#
|
|
944
1026
|
#
|
|
@@ -1915,6 +1997,40 @@ module Aws::S3
|
|
|
1915
1997
|
# </note>
|
|
1916
1998
|
# @return [String]
|
|
1917
1999
|
#
|
|
2000
|
+
# @!attribute [rw] if_match
|
|
2001
|
+
# Copies the object if the entity tag (ETag) of the destination object
|
|
2002
|
+
# matches the specified tag. If the ETag values do not match, the
|
|
2003
|
+
# operation returns a `412 Precondition Failed` error. If a concurrent
|
|
2004
|
+
# operation occurs during the upload S3 returns a `409
|
|
2005
|
+
# ConditionalRequestConflict` response. On a 409 failure you should
|
|
2006
|
+
# fetch the object's ETag and retry the upload.
|
|
2007
|
+
#
|
|
2008
|
+
# Expects the ETag value as a string.
|
|
2009
|
+
#
|
|
2010
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
2011
|
+
#
|
|
2012
|
+
#
|
|
2013
|
+
#
|
|
2014
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
|
2015
|
+
# @return [String]
|
|
2016
|
+
#
|
|
2017
|
+
# @!attribute [rw] if_none_match
|
|
2018
|
+
# Copies the object only if the object key name at the destination
|
|
2019
|
+
# does not already exist in the bucket specified. Otherwise, Amazon S3
|
|
2020
|
+
# returns a `412 Precondition Failed` error. If a concurrent operation
|
|
2021
|
+
# occurs during the upload S3 returns a `409
|
|
2022
|
+
# ConditionalRequestConflict` response. On a 409 failure you should
|
|
2023
|
+
# retry the upload.
|
|
2024
|
+
#
|
|
2025
|
+
# Expects the '*' (asterisk) character.
|
|
2026
|
+
#
|
|
2027
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
2028
|
+
#
|
|
2029
|
+
#
|
|
2030
|
+
#
|
|
2031
|
+
# [1]: https://tools.ietf.org/html/rfc7232
|
|
2032
|
+
# @return [String]
|
|
2033
|
+
#
|
|
1918
2034
|
# @!attribute [rw] key
|
|
1919
2035
|
# The key of the destination object.
|
|
1920
2036
|
# @return [String]
|
|
@@ -2441,6 +2557,8 @@ module Aws::S3
|
|
|
2441
2557
|
:grant_read,
|
|
2442
2558
|
:grant_read_acp,
|
|
2443
2559
|
:grant_write_acp,
|
|
2560
|
+
:if_match,
|
|
2561
|
+
:if_none_match,
|
|
2444
2562
|
:key,
|
|
2445
2563
|
:metadata,
|
|
2446
2564
|
:metadata_directive,
|
|
@@ -2502,9 +2620,9 @@ module Aws::S3
|
|
|
2502
2620
|
#
|
|
2503
2621
|
# @!attribute [rw] checksum_crc32c
|
|
2504
2622
|
# The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
|
|
2505
|
-
#
|
|
2506
|
-
# more information, see [ Checking object integrity][1] in
|
|
2507
|
-
# S3 User Guide*.
|
|
2623
|
+
# checksum is only present if the checksum was uploaded with the
|
|
2624
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
2625
|
+
# the *Amazon S3 User Guide*.
|
|
2508
2626
|
#
|
|
2509
2627
|
#
|
|
2510
2628
|
#
|
|
@@ -2525,10 +2643,10 @@ module Aws::S3
|
|
|
2525
2643
|
# @return [String]
|
|
2526
2644
|
#
|
|
2527
2645
|
# @!attribute [rw] checksum_sha1
|
|
2528
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
2529
|
-
# only
|
|
2530
|
-
# information, see [ Checking object integrity][1] in
|
|
2531
|
-
# User Guide*.
|
|
2646
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
2647
|
+
# checksum is only present if the checksum was uploaded with the
|
|
2648
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
2649
|
+
# the *Amazon S3 User Guide*.
|
|
2532
2650
|
#
|
|
2533
2651
|
#
|
|
2534
2652
|
#
|
|
@@ -2536,10 +2654,10 @@ module Aws::S3
|
|
|
2536
2654
|
# @return [String]
|
|
2537
2655
|
#
|
|
2538
2656
|
# @!attribute [rw] checksum_sha256
|
|
2539
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
2540
|
-
# only
|
|
2541
|
-
# information, see [ Checking object integrity][1] in
|
|
2542
|
-
# User Guide*.
|
|
2657
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
2658
|
+
# checksum is only present if the checksum was uploaded with the
|
|
2659
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
2660
|
+
# the *Amazon S3 User Guide*.
|
|
2543
2661
|
#
|
|
2544
2662
|
#
|
|
2545
2663
|
#
|
|
@@ -2705,6 +2823,9 @@ module Aws::S3
|
|
|
2705
2823
|
# <note markdown="1"> This parameter is only supported for S3 directory buckets. For more
|
|
2706
2824
|
# information, see [Using tags with directory buckets][1].
|
|
2707
2825
|
#
|
|
2826
|
+
# You must have the `s3express:TagResource` permission to create a
|
|
2827
|
+
# directory bucket with tags.
|
|
2828
|
+
#
|
|
2708
2829
|
# </note>
|
|
2709
2830
|
#
|
|
2710
2831
|
#
|
|
@@ -4659,17 +4780,16 @@ module Aws::S3
|
|
|
4659
4780
|
# @return [String]
|
|
4660
4781
|
#
|
|
4661
4782
|
# @!attribute [rw] if_match
|
|
4662
|
-
#
|
|
4663
|
-
#
|
|
4664
|
-
#
|
|
4665
|
-
#
|
|
4666
|
-
# Content) response`.
|
|
4667
|
-
#
|
|
4668
|
-
# For more information about conditional requests, see [RFC 7232][1].
|
|
4783
|
+
# Deletes the object if the ETag (entity tag) value provided during
|
|
4784
|
+
# the delete operation matches the ETag of the object in S3. If the
|
|
4785
|
+
# ETag values do not match, the operation returns a `412 Precondition
|
|
4786
|
+
# Failed` error.
|
|
4669
4787
|
#
|
|
4670
|
-
#
|
|
4788
|
+
# Expects the ETag value as a string. `If-Match` does accept a string
|
|
4789
|
+
# value of an '*' (asterisk) character to denote a match of any
|
|
4790
|
+
# ETag.
|
|
4671
4791
|
#
|
|
4672
|
-
#
|
|
4792
|
+
# For more information about conditional requests, see [RFC 7232][1].
|
|
4673
4793
|
#
|
|
4674
4794
|
#
|
|
4675
4795
|
#
|
|
@@ -6325,6 +6445,36 @@ module Aws::S3
|
|
|
6325
6445
|
include Aws::Structure
|
|
6326
6446
|
end
|
|
6327
6447
|
|
|
6448
|
+
# @!attribute [rw] abac_status
|
|
6449
|
+
# The ABAC status of the general purpose bucket.
|
|
6450
|
+
# @return [Types::AbacStatus]
|
|
6451
|
+
#
|
|
6452
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAbacOutput AWS API Documentation
|
|
6453
|
+
#
|
|
6454
|
+
class GetBucketAbacOutput < Struct.new(
|
|
6455
|
+
:abac_status)
|
|
6456
|
+
SENSITIVE = []
|
|
6457
|
+
include Aws::Structure
|
|
6458
|
+
end
|
|
6459
|
+
|
|
6460
|
+
# @!attribute [rw] bucket
|
|
6461
|
+
# The name of the general purpose bucket.
|
|
6462
|
+
# @return [String]
|
|
6463
|
+
#
|
|
6464
|
+
# @!attribute [rw] expected_bucket_owner
|
|
6465
|
+
# The Amazon Web Services account ID of the general purpose bucket's
|
|
6466
|
+
# owner.
|
|
6467
|
+
# @return [String]
|
|
6468
|
+
#
|
|
6469
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketAbacRequest AWS API Documentation
|
|
6470
|
+
#
|
|
6471
|
+
class GetBucketAbacRequest < Struct.new(
|
|
6472
|
+
:bucket,
|
|
6473
|
+
:expected_bucket_owner)
|
|
6474
|
+
SENSITIVE = []
|
|
6475
|
+
include Aws::Structure
|
|
6476
|
+
end
|
|
6477
|
+
|
|
6328
6478
|
# @!attribute [rw] status
|
|
6329
6479
|
# The accelerate configuration of the bucket.
|
|
6330
6480
|
# @return [String]
|
|
@@ -8003,9 +8153,9 @@ module Aws::S3
|
|
|
8003
8153
|
#
|
|
8004
8154
|
# @!attribute [rw] checksum_crc32c
|
|
8005
8155
|
# The Base64 encoded, 32-bit `CRC32C` checksum of the object. This
|
|
8006
|
-
#
|
|
8007
|
-
# more information, see [ Checking object integrity][1] in
|
|
8008
|
-
# S3 User Guide*.
|
|
8156
|
+
# checksum is only present if the checksum was uploaded with the
|
|
8157
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
8158
|
+
# the *Amazon S3 User Guide*.
|
|
8009
8159
|
#
|
|
8010
8160
|
#
|
|
8011
8161
|
#
|
|
@@ -8023,10 +8173,10 @@ module Aws::S3
|
|
|
8023
8173
|
# @return [String]
|
|
8024
8174
|
#
|
|
8025
8175
|
# @!attribute [rw] checksum_sha1
|
|
8026
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
8027
|
-
# only
|
|
8028
|
-
# information, see [ Checking object integrity][1] in
|
|
8029
|
-
# User Guide*.
|
|
8176
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
8177
|
+
# checksum is only present if the checksum was uploaded with the
|
|
8178
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
8179
|
+
# the *Amazon S3 User Guide*.
|
|
8030
8180
|
#
|
|
8031
8181
|
#
|
|
8032
8182
|
#
|
|
@@ -8034,10 +8184,10 @@ module Aws::S3
|
|
|
8034
8184
|
# @return [String]
|
|
8035
8185
|
#
|
|
8036
8186
|
# @!attribute [rw] checksum_sha256
|
|
8037
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
8038
|
-
# only
|
|
8039
|
-
# information, see [ Checking object integrity][1] in
|
|
8040
|
-
# User Guide*.
|
|
8187
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
8188
|
+
# checksum is only present if the checksum was uploaded with the
|
|
8189
|
+
# object. For more information, see [ Checking object integrity][1] in
|
|
8190
|
+
# the *Amazon S3 User Guide*.
|
|
8041
8191
|
#
|
|
8042
8192
|
#
|
|
8043
8193
|
#
|
|
@@ -8965,6 +9115,19 @@ module Aws::S3
|
|
|
8965
9115
|
include Aws::Structure
|
|
8966
9116
|
end
|
|
8967
9117
|
|
|
9118
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
9119
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
9120
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
9121
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
9122
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
9123
|
+
#
|
|
9124
|
+
# This change affects the following Amazon Web Services Regions: US
|
|
9125
|
+
# East
|
|
9126
|
+
# (N. Virginia) Region, US West (N. California) Region, US West (Oregon)
|
|
9127
|
+
# Region, Asia Pacific (Singapore) Region, Asia Pacific (Sydney) Region,
|
|
9128
|
+
# Asia Pacific (Tokyo) Region, Europe (Ireland) Region, and South
|
|
9129
|
+
# America (São Paulo) Region.
|
|
9130
|
+
#
|
|
8968
9131
|
# Container for the person being granted permissions.
|
|
8969
9132
|
#
|
|
8970
9133
|
# @!attribute [rw] display_name
|
|
@@ -9240,7 +9403,7 @@ module Aws::S3
|
|
|
9240
9403
|
#
|
|
9241
9404
|
# @!attribute [rw] checksum_crc32
|
|
9242
9405
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
9243
|
-
# checksum is only
|
|
9406
|
+
# checksum is only present if the checksum was uploaded with the
|
|
9244
9407
|
# object. When you use an API operation on an object that was uploaded
|
|
9245
9408
|
# using multipart uploads, this value may not be a direct checksum
|
|
9246
9409
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -9279,14 +9442,15 @@ module Aws::S3
|
|
|
9279
9442
|
# @return [String]
|
|
9280
9443
|
#
|
|
9281
9444
|
# @!attribute [rw] checksum_sha1
|
|
9282
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
9283
|
-
# only
|
|
9284
|
-
# use the API operation on an object that was
|
|
9285
|
-
# uploads, this value may not be a direct
|
|
9286
|
-
# object. Instead, it's a calculation
|
|
9287
|
-
# each individual part. For more
|
|
9288
|
-
#
|
|
9289
|
-
# integrity][1] in the *Amazon S3 User
|
|
9445
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
9446
|
+
# checksum is only present if the checksum was uploaded with the
|
|
9447
|
+
# object. When you use the API operation on an object that was
|
|
9448
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
9449
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
9450
|
+
# based on the checksum values of each individual part. For more
|
|
9451
|
+
# information about how checksums are calculated with multipart
|
|
9452
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
9453
|
+
# Guide*.
|
|
9290
9454
|
#
|
|
9291
9455
|
#
|
|
9292
9456
|
#
|
|
@@ -9294,14 +9458,14 @@ module Aws::S3
|
|
|
9294
9458
|
# @return [String]
|
|
9295
9459
|
#
|
|
9296
9460
|
# @!attribute [rw] checksum_sha256
|
|
9297
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
9298
|
-
# only
|
|
9299
|
-
# use an API operation on an object that was uploaded
|
|
9300
|
-
# uploads, this value may not be a direct checksum
|
|
9301
|
-
# object. Instead, it's a calculation based on the
|
|
9302
|
-
# each individual part. For more information about
|
|
9303
|
-
# calculated with multipart uploads, see [ Checking
|
|
9304
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
9461
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
9462
|
+
# checksum is only present if the checksum was uploaded with the
|
|
9463
|
+
# object. When you use an API operation on an object that was uploaded
|
|
9464
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
9465
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
9466
|
+
# checksum values of each individual part. For more information about
|
|
9467
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
9468
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
9305
9469
|
#
|
|
9306
9470
|
#
|
|
9307
9471
|
#
|
|
@@ -10700,8 +10864,10 @@ module Aws::S3
|
|
|
10700
10864
|
# @return [String]
|
|
10701
10865
|
#
|
|
10702
10866
|
# @!attribute [rw] prefix
|
|
10703
|
-
#
|
|
10704
|
-
#
|
|
10867
|
+
# The general purpose bucket prefix that identifies one or more
|
|
10868
|
+
# objects to which the rule applies. We recommend using `Filter`
|
|
10869
|
+
# instead of `Prefix` for new PUTs. Previous configurations where a
|
|
10870
|
+
# prefix is defined will continue to operate as before.
|
|
10705
10871
|
#
|
|
10706
10872
|
# Replacement must be made for object keys containing special
|
|
10707
10873
|
# characters (such as carriage returns) when using XML requests. For
|
|
@@ -13817,11 +13983,11 @@ module Aws::S3
|
|
|
13817
13983
|
include Aws::Structure
|
|
13818
13984
|
end
|
|
13819
13985
|
|
|
13820
|
-
# End of support notice: Beginning
|
|
13821
|
-
# returning `DisplayName`. Update your applications to use
|
|
13822
|
-
# (unique identifier for Amazon Web Services accounts),
|
|
13823
|
-
# Services account ID (12 digit identifier) or IAM ARNs (full
|
|
13824
|
-
# naming) as a direct replacement of `DisplayName`.
|
|
13986
|
+
# End of support notice: Beginning November 21, 2025, Amazon S3 will
|
|
13987
|
+
# stop returning `DisplayName`. Update your applications to use
|
|
13988
|
+
# canonical IDs (unique identifier for Amazon Web Services accounts),
|
|
13989
|
+
# Amazon Web Services account ID (12 digit identifier) or IAM ARNs (full
|
|
13990
|
+
# resource naming) as a direct replacement of `DisplayName`.
|
|
13825
13991
|
#
|
|
13826
13992
|
# This change affects the following Amazon Web Services Regions: US
|
|
13827
13993
|
# East
|
|
@@ -14183,6 +14349,58 @@ module Aws::S3
|
|
|
14183
14349
|
include Aws::Structure
|
|
14184
14350
|
end
|
|
14185
14351
|
|
|
14352
|
+
# @!attribute [rw] bucket
|
|
14353
|
+
# The name of the general purpose bucket.
|
|
14354
|
+
# @return [String]
|
|
14355
|
+
#
|
|
14356
|
+
# @!attribute [rw] content_md5
|
|
14357
|
+
# The MD5 hash of the `PutBucketAbac` request body.
|
|
14358
|
+
#
|
|
14359
|
+
# For requests made using the Amazon Web Services Command Line
|
|
14360
|
+
# Interface (CLI) or Amazon Web Services SDKs, this field is
|
|
14361
|
+
# calculated automatically.
|
|
14362
|
+
# @return [String]
|
|
14363
|
+
#
|
|
14364
|
+
# @!attribute [rw] checksum_algorithm
|
|
14365
|
+
# Indicates the algorithm that you want Amazon S3 to use to create the
|
|
14366
|
+
# checksum. For more information, see [ Checking object integrity][1]
|
|
14367
|
+
# in the *Amazon S3 User Guide*.
|
|
14368
|
+
#
|
|
14369
|
+
#
|
|
14370
|
+
#
|
|
14371
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
|
|
14372
|
+
# @return [String]
|
|
14373
|
+
#
|
|
14374
|
+
# @!attribute [rw] expected_bucket_owner
|
|
14375
|
+
# The Amazon Web Services account ID of the general purpose bucket's
|
|
14376
|
+
# owner.
|
|
14377
|
+
# @return [String]
|
|
14378
|
+
#
|
|
14379
|
+
# @!attribute [rw] abac_status
|
|
14380
|
+
# The ABAC status of the general purpose bucket. When ABAC is enabled
|
|
14381
|
+
# for the general purpose bucket, you can use tags to manage access to
|
|
14382
|
+
# the general purpose buckets as well as for cost tracking purposes.
|
|
14383
|
+
# When ABAC is disabled for the general purpose buckets, you can only
|
|
14384
|
+
# use tags for cost tracking purposes. For more information, see
|
|
14385
|
+
# [Using tags with S3 general purpose buckets][1].
|
|
14386
|
+
#
|
|
14387
|
+
#
|
|
14388
|
+
#
|
|
14389
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/buckets-tagging.html
|
|
14390
|
+
# @return [Types::AbacStatus]
|
|
14391
|
+
#
|
|
14392
|
+
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketAbacRequest AWS API Documentation
|
|
14393
|
+
#
|
|
14394
|
+
class PutBucketAbacRequest < Struct.new(
|
|
14395
|
+
:bucket,
|
|
14396
|
+
:content_md5,
|
|
14397
|
+
:checksum_algorithm,
|
|
14398
|
+
:expected_bucket_owner,
|
|
14399
|
+
:abac_status)
|
|
14400
|
+
SENSITIVE = []
|
|
14401
|
+
include Aws::Structure
|
|
14402
|
+
end
|
|
14403
|
+
|
|
14186
14404
|
# @!attribute [rw] bucket
|
|
14187
14405
|
# The name of the bucket for which the accelerate configuration is
|
|
14188
14406
|
# set.
|
|
@@ -15273,7 +15491,17 @@ module Aws::S3
|
|
|
15273
15491
|
# @!attribute [rw] mfa
|
|
15274
15492
|
# The concatenation of the authentication device's serial number, a
|
|
15275
15493
|
# space, and the value that is displayed on your authentication
|
|
15276
|
-
# device.
|
|
15494
|
+
# device. The serial number is the number that uniquely identifies the
|
|
15495
|
+
# MFA device. For physical MFA devices, this is the unique serial
|
|
15496
|
+
# number that's provided with the device. For virtual MFA devices,
|
|
15497
|
+
# the serial number is the device ARN. For more information, see
|
|
15498
|
+
# [Enabling versioning on buckets][1] and [Configuring MFA delete][2]
|
|
15499
|
+
# in the *Amazon Simple Storage Service User Guide*.
|
|
15500
|
+
#
|
|
15501
|
+
#
|
|
15502
|
+
#
|
|
15503
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/manage-versioning-examples.html
|
|
15504
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiFactorAuthenticationDelete.html
|
|
15277
15505
|
# @return [String]
|
|
15278
15506
|
#
|
|
15279
15507
|
# @!attribute [rw] versioning_configuration
|
|
@@ -15809,7 +16037,7 @@ module Aws::S3
|
|
|
15809
16037
|
#
|
|
15810
16038
|
# @!attribute [rw] checksum_crc32
|
|
15811
16039
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
15812
|
-
# checksum is only
|
|
16040
|
+
# checksum is only present if the checksum was uploaded with the
|
|
15813
16041
|
# object. When you use an API operation on an object that was uploaded
|
|
15814
16042
|
# using multipart uploads, this value may not be a direct checksum
|
|
15815
16043
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -15852,14 +16080,15 @@ module Aws::S3
|
|
|
15852
16080
|
# @return [String]
|
|
15853
16081
|
#
|
|
15854
16082
|
# @!attribute [rw] checksum_sha1
|
|
15855
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
15856
|
-
# only
|
|
15857
|
-
# use the API operation on an object that was
|
|
15858
|
-
# uploads, this value may not be a direct
|
|
15859
|
-
# object. Instead, it's a calculation
|
|
15860
|
-
# each individual part. For more
|
|
15861
|
-
#
|
|
15862
|
-
# integrity][1] in the *Amazon S3 User
|
|
16083
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
16084
|
+
# checksum is only present if the checksum was uploaded with the
|
|
16085
|
+
# object. When you use the API operation on an object that was
|
|
16086
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
16087
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
16088
|
+
# based on the checksum values of each individual part. For more
|
|
16089
|
+
# information about how checksums are calculated with multipart
|
|
16090
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
16091
|
+
# Guide*.
|
|
15863
16092
|
#
|
|
15864
16093
|
#
|
|
15865
16094
|
#
|
|
@@ -15867,14 +16096,14 @@ module Aws::S3
|
|
|
15867
16096
|
# @return [String]
|
|
15868
16097
|
#
|
|
15869
16098
|
# @!attribute [rw] checksum_sha256
|
|
15870
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
15871
|
-
# only
|
|
15872
|
-
# use an API operation on an object that was uploaded
|
|
15873
|
-
# uploads, this value may not be a direct checksum
|
|
15874
|
-
# object. Instead, it's a calculation based on the
|
|
15875
|
-
# each individual part. For more information about
|
|
15876
|
-
# calculated with multipart uploads, see [ Checking
|
|
15877
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
16099
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
16100
|
+
# checksum is only present if the checksum was uploaded with the
|
|
16101
|
+
# object. When you use an API operation on an object that was uploaded
|
|
16102
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
16103
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
16104
|
+
# checksum values of each individual part. For more information about
|
|
16105
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
16106
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
15878
16107
|
#
|
|
15879
16108
|
#
|
|
15880
16109
|
#
|
|
@@ -16990,21 +17219,9 @@ module Aws::S3
|
|
|
16990
17219
|
# @return [String]
|
|
16991
17220
|
#
|
|
16992
17221
|
# @!attribute [rw] request_payer
|
|
16993
|
-
# Confirms that the requester knows that
|
|
16994
|
-
# request. Bucket owners need not specify this
|
|
16995
|
-
#
|
|
16996
|
-
# Requester Pays enabled, the requester will pay for corresponding
|
|
16997
|
-
# charges to copy the object. For information about downloading
|
|
16998
|
-
# objects from Requester Pays buckets, see [Downloading Objects in
|
|
16999
|
-
# Requester Pays Buckets][1] in the *Amazon S3 User Guide*.
|
|
17000
|
-
#
|
|
17001
|
-
# <note markdown="1"> This functionality is not supported for directory buckets.
|
|
17002
|
-
#
|
|
17003
|
-
# </note>
|
|
17004
|
-
#
|
|
17005
|
-
#
|
|
17006
|
-
#
|
|
17007
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html
|
|
17222
|
+
# Confirms that the requester knows that she or he will be charged for
|
|
17223
|
+
# the tagging object request. Bucket owners need not specify this
|
|
17224
|
+
# parameter in their requests.
|
|
17008
17225
|
# @return [String]
|
|
17009
17226
|
#
|
|
17010
17227
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutObjectTaggingRequest AWS API Documentation
|
|
@@ -18690,11 +18907,36 @@ module Aws::S3
|
|
|
18690
18907
|
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-import-job
|
|
18691
18908
|
# @return [Boolean]
|
|
18692
18909
|
#
|
|
18910
|
+
# @!attribute [rw] blocked_encryption_types
|
|
18911
|
+
# A bucket-level setting for Amazon S3 general purpose buckets used to
|
|
18912
|
+
# prevent the upload of new objects encrypted with the specified
|
|
18913
|
+
# server-side encryption type. For example, blocking an encryption
|
|
18914
|
+
# type will block `PutObject`, `CopyObject`, `PostObject`, multipart
|
|
18915
|
+
# upload, and replication requests to the bucket for objects with the
|
|
18916
|
+
# specified encryption type. However, you can continue to read and
|
|
18917
|
+
# list any pre-existing objects already encrypted with the specified
|
|
18918
|
+
# encryption type. For more information, see [Blocking an encryption
|
|
18919
|
+
# type for a general purpose bucket][1].
|
|
18920
|
+
#
|
|
18921
|
+
# <note markdown="1"> Currently, this parameter only supports blocking or unblocking
|
|
18922
|
+
# Server Side Encryption with Customer Provided Keys (SSE-C). For more
|
|
18923
|
+
# information about SSE-C, see [Using server-side encryption with
|
|
18924
|
+
# customer-provided keys (SSE-C)][2].
|
|
18925
|
+
#
|
|
18926
|
+
# </note>
|
|
18927
|
+
#
|
|
18928
|
+
#
|
|
18929
|
+
#
|
|
18930
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/userguide/block-encryption-type.html
|
|
18931
|
+
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html
|
|
18932
|
+
# @return [Types::BlockedEncryptionTypes]
|
|
18933
|
+
#
|
|
18693
18934
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ServerSideEncryptionRule AWS API Documentation
|
|
18694
18935
|
#
|
|
18695
18936
|
class ServerSideEncryptionRule < Struct.new(
|
|
18696
18937
|
:apply_server_side_encryption_by_default,
|
|
18697
|
-
:bucket_key_enabled
|
|
18938
|
+
:bucket_key_enabled,
|
|
18939
|
+
:blocked_encryption_types)
|
|
18698
18940
|
SENSITIVE = []
|
|
18699
18941
|
include Aws::Structure
|
|
18700
18942
|
end
|
|
@@ -19648,7 +19890,7 @@ module Aws::S3
|
|
|
19648
19890
|
#
|
|
19649
19891
|
# @!attribute [rw] checksum_crc32
|
|
19650
19892
|
# The Base64 encoded, 32-bit `CRC32 checksum` of the object. This
|
|
19651
|
-
# checksum is only
|
|
19893
|
+
# checksum is only present if the checksum was uploaded with the
|
|
19652
19894
|
# object. When you use an API operation on an object that was uploaded
|
|
19653
19895
|
# using multipart uploads, this value may not be a direct checksum
|
|
19654
19896
|
# value of the full object. Instead, it's a calculation based on the
|
|
@@ -19689,14 +19931,15 @@ module Aws::S3
|
|
|
19689
19931
|
# @return [String]
|
|
19690
19932
|
#
|
|
19691
19933
|
# @!attribute [rw] checksum_sha1
|
|
19692
|
-
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
19693
|
-
# only
|
|
19694
|
-
# use the API operation on an object that was
|
|
19695
|
-
# uploads, this value may not be a direct
|
|
19696
|
-
# object. Instead, it's a calculation
|
|
19697
|
-
# each individual part. For more
|
|
19698
|
-
#
|
|
19699
|
-
# integrity][1] in the *Amazon S3 User
|
|
19934
|
+
# The Base64 encoded, 160-bit `SHA1` digest of the object. This
|
|
19935
|
+
# checksum is only present if the checksum was uploaded with the
|
|
19936
|
+
# object. When you use the API operation on an object that was
|
|
19937
|
+
# uploaded using multipart uploads, this value may not be a direct
|
|
19938
|
+
# checksum value of the full object. Instead, it's a calculation
|
|
19939
|
+
# based on the checksum values of each individual part. For more
|
|
19940
|
+
# information about how checksums are calculated with multipart
|
|
19941
|
+
# uploads, see [ Checking object integrity][1] in the *Amazon S3 User
|
|
19942
|
+
# Guide*.
|
|
19700
19943
|
#
|
|
19701
19944
|
#
|
|
19702
19945
|
#
|
|
@@ -19704,14 +19947,14 @@ module Aws::S3
|
|
|
19704
19947
|
# @return [String]
|
|
19705
19948
|
#
|
|
19706
19949
|
# @!attribute [rw] checksum_sha256
|
|
19707
|
-
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
19708
|
-
# only
|
|
19709
|
-
# use an API operation on an object that was uploaded
|
|
19710
|
-
# uploads, this value may not be a direct checksum
|
|
19711
|
-
# object. Instead, it's a calculation based on the
|
|
19712
|
-
# each individual part. For more information about
|
|
19713
|
-
# calculated with multipart uploads, see [ Checking
|
|
19714
|
-
# integrity][1] in the *Amazon S3 User Guide*.
|
|
19950
|
+
# The Base64 encoded, 256-bit `SHA256` digest of the object. This
|
|
19951
|
+
# checksum is only present if the checksum was uploaded with the
|
|
19952
|
+
# object. When you use an API operation on an object that was uploaded
|
|
19953
|
+
# using multipart uploads, this value may not be a direct checksum
|
|
19954
|
+
# value of the full object. Instead, it's a calculation based on the
|
|
19955
|
+
# checksum values of each individual part. For more information about
|
|
19956
|
+
# how checksums are calculated with multipart uploads, see [ Checking
|
|
19957
|
+
# object integrity][1] in the *Amazon S3 User Guide*.
|
|
19715
19958
|
#
|
|
19716
19959
|
#
|
|
19717
19960
|
#
|