aws-sdk-s3 1.166.0 → 1.169.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.
@@ -344,11 +344,18 @@ module Aws::S3
344
344
  # changes to your bucket, such as editing its bucket policy.
345
345
  # @return [Time]
346
346
  #
347
+ # @!attribute [rw] bucket_region
348
+ # `BucketRegion` indicates the Amazon Web Services region where the
349
+ # bucket is located. If the request contains at least one valid
350
+ # parameter, it is included in the response.
351
+ # @return [String]
352
+ #
347
353
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/Bucket AWS API Documentation
348
354
  #
349
355
  class Bucket < Struct.new(
350
356
  :name,
351
- :creation_date)
357
+ :creation_date,
358
+ :bucket_region)
352
359
  SENSITIVE = []
353
360
  include Aws::Structure
354
361
  end
@@ -634,7 +641,7 @@ module Aws::S3
634
641
  # Contains all the possible checksum or digest values for an object.
635
642
  #
636
643
  # @!attribute [rw] checksum_crc32
637
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
644
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
638
645
  # only be present if it was uploaded with the object. When you use an
639
646
  # API operation on an object that was uploaded using multipart
640
647
  # uploads, this value may not be a direct checksum value of the full
@@ -649,7 +656,7 @@ module Aws::S3
649
656
  # @return [String]
650
657
  #
651
658
  # @!attribute [rw] checksum_crc32c
652
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
659
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
653
660
  # only be present if it was uploaded with the object. When you use an
654
661
  # API operation on an object that was uploaded using multipart
655
662
  # uploads, this value may not be a direct checksum value of the full
@@ -803,7 +810,7 @@ module Aws::S3
803
810
  # @return [String]
804
811
  #
805
812
  # @!attribute [rw] checksum_crc32
806
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
813
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
807
814
  # only be present if it was uploaded with the object. When you use an
808
815
  # API operation on an object that was uploaded using multipart
809
816
  # uploads, this value may not be a direct checksum value of the full
@@ -818,7 +825,7 @@ module Aws::S3
818
825
  # @return [String]
819
826
  #
820
827
  # @!attribute [rw] checksum_crc32c
821
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
828
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
822
829
  # only be present if it was uploaded with the object. When you use an
823
830
  # API operation on an object that was uploaded using multipart
824
831
  # uploads, this value may not be a direct checksum value of the full
@@ -977,7 +984,7 @@ module Aws::S3
977
984
  # @!attribute [rw] checksum_crc32
978
985
  # This header can be used as a data integrity check to verify that the
979
986
  # data received is the same data that was originally sent. This header
980
- # specifies the base64-encoded, 32-bit CRC32 checksum of the object.
987
+ # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
981
988
  # For more information, see [Checking object integrity][1] in the
982
989
  # *Amazon S3 User Guide*.
983
990
  #
@@ -989,7 +996,7 @@ module Aws::S3
989
996
  # @!attribute [rw] checksum_crc32c
990
997
  # This header can be used as a data integrity check to verify that the
991
998
  # data received is the same data that was originally sent. This header
992
- # specifies the base64-encoded, 32-bit CRC32C checksum of the object.
999
+ # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
993
1000
  # For more information, see [Checking object integrity][1] in the
994
1001
  # *Amazon S3 User Guide*.
995
1002
  #
@@ -1159,7 +1166,7 @@ module Aws::S3
1159
1166
  # @return [String]
1160
1167
  #
1161
1168
  # @!attribute [rw] checksum_crc32
1162
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
1169
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
1163
1170
  # only be present if it was uploaded with the object. When you use an
1164
1171
  # API operation on an object that was uploaded using multipart
1165
1172
  # uploads, this value may not be a direct checksum value of the full
@@ -1174,7 +1181,7 @@ module Aws::S3
1174
1181
  # @return [String]
1175
1182
  #
1176
1183
  # @!attribute [rw] checksum_crc32c
1177
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
1184
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
1178
1185
  # only be present if it was uploaded with the object. When you use an
1179
1186
  # API operation on an object that was uploaded using multipart
1180
1187
  # uploads, this value may not be a direct checksum value of the full
@@ -1857,14 +1864,14 @@ module Aws::S3
1857
1864
  # * To encrypt new object copies to a directory bucket with SSE-KMS,
1858
1865
  # we recommend you specify SSE-KMS as the directory bucket's
1859
1866
  # default encryption configuration with a KMS key (specifically, a
1860
- # [customer managed key][4]). [Amazon Web Services managed key][5]
1861
- # (`aws/s3`) isn't supported. Your SSE-KMS configuration can only
1862
- # support 1 [customer managed key][4] per directory bucket for the
1863
- # lifetime of the bucket. After you specify a customer managed key
1864
- # for SSE-KMS, you can't override the customer managed key for the
1865
- # bucket's SSE-KMS configuration. Then, when you perform a
1866
- # `CopyObject` operation and want to specify server-side encryption
1867
- # settings for new object copies with SSE-KMS in the
1867
+ # [customer managed key][4]). The [Amazon Web Services managed
1868
+ # key][5] (`aws/s3`) isn't supported. Your SSE-KMS configuration
1869
+ # can only support 1 [customer managed key][4] per directory bucket
1870
+ # for the lifetime of the bucket. After you specify a customer
1871
+ # managed key for SSE-KMS, you can't override the customer managed
1872
+ # key for the bucket's SSE-KMS configuration. Then, when you
1873
+ # perform a `CopyObject` operation and want to specify server-side
1874
+ # encryption settings for new object copies with SSE-KMS in the
1868
1875
  # encryption-related request headers, you must ensure the encryption
1869
1876
  # key is the same customer managed key that you specified for the
1870
1877
  # directory bucket's default encryption configuration.
@@ -1990,15 +1997,20 @@ module Aws::S3
1990
1997
  # User Guide*.
1991
1998
  #
1992
1999
  # **Directory buckets** - If you specify
1993
- # `x-amz-server-side-encryption` with `aws:kms`, you must specify the
1994
- # ` x-amz-server-side-encryption-aws-kms-key-id` header with the ID
1995
- # (Key ID or Key ARN) of the KMS symmetric encryption customer managed
1996
- # key to use. Otherwise, you get an HTTP `400 Bad Request` error. Only
1997
- # use the key ID or key ARN. The key alias format of the KMS key
1998
- # isn't supported. Your SSE-KMS configuration can only support 1
1999
- # [customer managed key][2] per directory bucket for the lifetime of
2000
- # the bucket. [Amazon Web Services managed key][3] (`aws/s3`) isn't
2001
- # supported.
2000
+ # `x-amz-server-side-encryption` with `aws:kms`, the `
2001
+ # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
2002
+ # assigned the ID of the KMS symmetric encryption customer managed key
2003
+ # that's configured for your directory bucket's default encryption
2004
+ # setting. If you want to specify the `
2005
+ # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
2006
+ # can only specify it with the ID (Key ID or Key ARN) of the KMS
2007
+ # customer managed key that's configured for your directory bucket's
2008
+ # default encryption setting. Otherwise, you get an HTTP `400 Bad
2009
+ # Request` error. Only use the key ID or key ARN. The key alias format
2010
+ # of the KMS key isn't supported. Your SSE-KMS configuration can only
2011
+ # support 1 [customer managed key][2] per directory bucket for the
2012
+ # lifetime of the bucket. The [Amazon Web Services managed key][3]
2013
+ # (`aws/s3`) isn't supported.
2002
2014
  #
2003
2015
  #
2004
2016
  #
@@ -2273,7 +2285,7 @@ module Aws::S3
2273
2285
  # @return [Time]
2274
2286
  #
2275
2287
  # @!attribute [rw] checksum_crc32
2276
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
2288
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
2277
2289
  # only be present if it was uploaded with the object. For more
2278
2290
  # information, see [ Checking object integrity][1] in the *Amazon S3
2279
2291
  # User Guide*.
@@ -2284,7 +2296,7 @@ module Aws::S3
2284
2296
  # @return [String]
2285
2297
  #
2286
2298
  # @!attribute [rw] checksum_crc32c
2287
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
2299
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
2288
2300
  # only be present if it was uploaded with the object. For more
2289
2301
  # information, see [ Checking object integrity][1] in the *Amazon S3
2290
2302
  # User Guide*.
@@ -2340,7 +2352,7 @@ module Aws::S3
2340
2352
  # @return [Time]
2341
2353
  #
2342
2354
  # @!attribute [rw] checksum_crc32
2343
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
2355
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
2344
2356
  # only be present if it was uploaded with the object. When you use an
2345
2357
  # API operation on an object that was uploaded using multipart
2346
2358
  # uploads, this value may not be a direct checksum value of the full
@@ -2355,7 +2367,7 @@ module Aws::S3
2355
2367
  # @return [String]
2356
2368
  #
2357
2369
  # @!attribute [rw] checksum_crc32c
2358
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
2370
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
2359
2371
  # only be present if it was uploaded with the object. When you use an
2360
2372
  # API operation on an object that was uploaded using multipart
2361
2373
  # uploads, this value may not be a direct checksum value of the full
@@ -3245,15 +3257,20 @@ module Aws::S3
3245
3257
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
3246
3258
  #
3247
3259
  # **Directory buckets** - If you specify
3248
- # `x-amz-server-side-encryption` with `aws:kms`, you must specify the
3249
- # ` x-amz-server-side-encryption-aws-kms-key-id` header with the ID
3250
- # (Key ID or Key ARN) of the KMS symmetric encryption customer managed
3251
- # key to use. Otherwise, you get an HTTP `400 Bad Request` error. Only
3252
- # use the key ID or key ARN. The key alias format of the KMS key
3253
- # isn't supported. Your SSE-KMS configuration can only support 1
3254
- # [customer managed key][1] per directory bucket for the lifetime of
3255
- # the bucket. [Amazon Web Services managed key][2] (`aws/s3`) isn't
3256
- # supported.
3260
+ # `x-amz-server-side-encryption` with `aws:kms`, the `
3261
+ # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
3262
+ # assigned the ID of the KMS symmetric encryption customer managed key
3263
+ # that's configured for your directory bucket's default encryption
3264
+ # setting. If you want to specify the `
3265
+ # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
3266
+ # can only specify it with the ID (Key ID or Key ARN) of the KMS
3267
+ # customer managed key that's configured for your directory bucket's
3268
+ # default encryption setting. Otherwise, you get an HTTP `400 Bad
3269
+ # Request` error. Only use the key ID or key ARN. The key alias format
3270
+ # of the KMS key isn't supported. Your SSE-KMS configuration can only
3271
+ # support 1 [customer managed key][1] per directory bucket for the
3272
+ # lifetime of the bucket. The [Amazon Web Services managed key][2]
3273
+ # (`aws/s3`) isn't supported.
3257
3274
  #
3258
3275
  #
3259
3276
  #
@@ -3491,8 +3508,8 @@ module Aws::S3
3491
3508
  # must use the full Key ARN not the Key ID.
3492
3509
  #
3493
3510
  # Your SSE-KMS configuration can only support 1 [customer managed
3494
- # key][1] per directory bucket for the lifetime of the bucket. [Amazon
3495
- # Web Services managed key][2] (`aws/s3`) isn't supported.
3511
+ # key][1] per directory bucket for the lifetime of the bucket. The
3512
+ # [Amazon Web Services managed key][2] (`aws/s3`) isn't supported.
3496
3513
  #
3497
3514
  #
3498
3515
  #
@@ -4414,13 +4431,13 @@ module Aws::S3
4414
4431
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm `
4415
4432
  # with the supported algorithm from the following list:
4416
4433
  #
4417
- # * CRC32
4434
+ # * `CRC32`
4418
4435
  #
4419
- # * CRC32C
4436
+ # * `CRC32C`
4420
4437
  #
4421
- # * SHA1
4438
+ # * `SHA1`
4422
4439
  #
4423
- # * SHA256
4440
+ # * `SHA256`
4424
4441
  #
4425
4442
  # For more information, see [Checking object integrity][1] in the
4426
4443
  # *Amazon S3 User Guide*.
@@ -5933,10 +5950,29 @@ module Aws::S3
5933
5950
  # Container for a lifecycle rule.
5934
5951
  # @return [Array<Types::LifecycleRule>]
5935
5952
  #
5953
+ # @!attribute [rw] transition_default_minimum_object_size
5954
+ # Indicates which default minimum object size behavior is applied to
5955
+ # the lifecycle configuration.
5956
+ #
5957
+ # * `all_storage_classes_128K` - Objects smaller than 128 KB will not
5958
+ # transition to any storage class by default.
5959
+ #
5960
+ # * `varies_by_storage_class` - Objects smaller than 128 KB will
5961
+ # transition to Glacier Flexible Retrieval or Glacier Deep Archive
5962
+ # storage classes. By default, all other storage classes will
5963
+ # prevent transitions smaller than 128 KB.
5964
+ #
5965
+ # To customize the minimum object size for any transition you can add
5966
+ # a filter that specifies a custom `ObjectSizeGreaterThan` or
5967
+ # `ObjectSizeLessThan` in the body of your transition rule. Custom
5968
+ # filters always take precedence over the default transition behavior.
5969
+ # @return [String]
5970
+ #
5936
5971
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLifecycleConfigurationOutput AWS API Documentation
5937
5972
  #
5938
5973
  class GetBucketLifecycleConfigurationOutput < Struct.new(
5939
- :rules)
5974
+ :rules,
5975
+ :transition_default_minimum_object_size)
5940
5976
  SENSITIVE = []
5941
5977
  include Aws::Structure
5942
5978
  end
@@ -7062,7 +7098,7 @@ module Aws::S3
7062
7098
  # @return [String]
7063
7099
  #
7064
7100
  # @!attribute [rw] checksum_crc32
7065
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
7101
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
7066
7102
  # only be present if it was uploaded with the object. For more
7067
7103
  # information, see [ Checking object integrity][1] in the *Amazon S3
7068
7104
  # User Guide*.
@@ -7073,7 +7109,7 @@ module Aws::S3
7073
7109
  # @return [String]
7074
7110
  #
7075
7111
  # @!attribute [rw] checksum_crc32c
7076
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
7112
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
7077
7113
  # only be present if it was uploaded with the object. For more
7078
7114
  # information, see [ Checking object integrity][1] in the *Amazon S3
7079
7115
  # User Guide*.
@@ -8244,7 +8280,7 @@ module Aws::S3
8244
8280
  # @return [Integer]
8245
8281
  #
8246
8282
  # @!attribute [rw] checksum_crc32
8247
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
8283
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
8248
8284
  # only be present if it was uploaded with the object. When you use an
8249
8285
  # API operation on an object that was uploaded using multipart
8250
8286
  # uploads, this value may not be a direct checksum value of the full
@@ -8259,7 +8295,7 @@ module Aws::S3
8259
8295
  # @return [String]
8260
8296
  #
8261
8297
  # @!attribute [rw] checksum_crc32c
8262
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
8298
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
8263
8299
  # only be present if it was uploaded with the object. When you use an
8264
8300
  # API operation on an object that was uploaded using multipart
8265
8301
  # uploads, this value may not be a direct checksum value of the full
@@ -9799,12 +9835,21 @@ module Aws::S3
9799
9835
  # `ContinuationToken` is obfuscated and is not a real bucket.
9800
9836
  # @return [String]
9801
9837
  #
9838
+ # @!attribute [rw] prefix
9839
+ # If `Prefix` was sent with the request, it is included in the
9840
+ # response.
9841
+ #
9842
+ # All bucket names in the response begin with the specified bucket
9843
+ # name prefix.
9844
+ # @return [String]
9845
+ #
9802
9846
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketsOutput AWS API Documentation
9803
9847
  #
9804
9848
  class ListBucketsOutput < Struct.new(
9805
9849
  :buckets,
9806
9850
  :owner,
9807
- :continuation_token)
9851
+ :continuation_token,
9852
+ :prefix)
9808
9853
  SENSITIVE = []
9809
9854
  include Aws::Structure
9810
9855
  end
@@ -9826,11 +9871,38 @@ module Aws::S3
9826
9871
  # Required: No.
9827
9872
  # @return [String]
9828
9873
  #
9874
+ # @!attribute [rw] prefix
9875
+ # Limits the response to bucket names that begin with the specified
9876
+ # bucket name prefix.
9877
+ # @return [String]
9878
+ #
9879
+ # @!attribute [rw] bucket_region
9880
+ # Limits the response to buckets that are located in the specified
9881
+ # Amazon Web Services Region. The Amazon Web Services Region must be
9882
+ # expressed according to the Amazon Web Services Region code, such as
9883
+ # `us-west-2` for the US West (Oregon) Region. For a list of the valid
9884
+ # values for all of the Amazon Web Services Regions, see [Regions and
9885
+ # Endpoints][1].
9886
+ #
9887
+ # <note markdown="1"> Requests made to a Regional endpoint that is different from the
9888
+ # `bucket-region` parameter are not supported. For example, if you
9889
+ # want to limit the response to your buckets in Region `us-west-2`,
9890
+ # the request must be made to an endpoint in Region `us-west-2`.
9891
+ #
9892
+ # </note>
9893
+ #
9894
+ #
9895
+ #
9896
+ # [1]: https://docs.aws.amazon.com/general/latest/gr/rande.html#s3_region
9897
+ # @return [String]
9898
+ #
9829
9899
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/ListBucketsRequest AWS API Documentation
9830
9900
  #
9831
9901
  class ListBucketsRequest < Struct.new(
9832
9902
  :max_buckets,
9833
- :continuation_token)
9903
+ :continuation_token,
9904
+ :prefix,
9905
+ :bucket_region)
9834
9906
  SENSITIVE = []
9835
9907
  include Aws::Structure
9836
9908
  end
@@ -11962,7 +12034,7 @@ module Aws::S3
11962
12034
  # @!attribute [rw] checksum_crc32
11963
12035
  # This header can be used as a data integrity check to verify that the
11964
12036
  # data received is the same data that was originally sent. This header
11965
- # specifies the base64-encoded, 32-bit CRC32 checksum of the object.
12037
+ # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
11966
12038
  # For more information, see [Checking object integrity][1] in the
11967
12039
  # *Amazon S3 User Guide*.
11968
12040
  #
@@ -11972,7 +12044,7 @@ module Aws::S3
11972
12044
  # @return [String]
11973
12045
  #
11974
12046
  # @!attribute [rw] checksum_crc32c
11975
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
12047
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
11976
12048
  # only be present if it was uploaded with the object. When you use an
11977
12049
  # API operation on an object that was uploaded using multipart
11978
12050
  # uploads, this value may not be a direct checksum value of the full
@@ -12262,7 +12334,7 @@ module Aws::S3
12262
12334
  # @!attribute [rw] checksum_crc32
12263
12335
  # This header can be used as a data integrity check to verify that the
12264
12336
  # data received is the same data that was originally sent. This header
12265
- # specifies the base64-encoded, 32-bit CRC32 checksum of the object.
12337
+ # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
12266
12338
  # For more information, see [Checking object integrity][1] in the
12267
12339
  # *Amazon S3 User Guide*.
12268
12340
  #
@@ -12272,7 +12344,7 @@ module Aws::S3
12272
12344
  # @return [String]
12273
12345
  #
12274
12346
  # @!attribute [rw] checksum_crc32c
12275
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
12347
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
12276
12348
  # only be present if it was uploaded with the object. When you use an
12277
12349
  # API operation on an object that was uploaded using multipart
12278
12350
  # uploads, this value may not be a direct checksum value of the full
@@ -12459,7 +12531,7 @@ module Aws::S3
12459
12531
  # @!attribute [rw] restrict_public_buckets
12460
12532
  # Specifies whether Amazon S3 should restrict public bucket policies
12461
12533
  # for this bucket. Setting this element to `TRUE` restricts access to
12462
- # this bucket to only Amazon Web Servicesservice principals and
12534
+ # this bucket to only Amazon Web Services service principals and
12463
12535
  # authorized users within this account if the bucket has a public
12464
12536
  # policy.
12465
12537
  #
@@ -12852,6 +12924,32 @@ module Aws::S3
12852
12924
  include Aws::Structure
12853
12925
  end
12854
12926
 
12927
+ # @!attribute [rw] transition_default_minimum_object_size
12928
+ # Indicates which default minimum object size behavior is applied to
12929
+ # the lifecycle configuration.
12930
+ #
12931
+ # * `all_storage_classes_128K` - Objects smaller than 128 KB will not
12932
+ # transition to any storage class by default.
12933
+ #
12934
+ # * `varies_by_storage_class` - Objects smaller than 128 KB will
12935
+ # transition to Glacier Flexible Retrieval or Glacier Deep Archive
12936
+ # storage classes. By default, all other storage classes will
12937
+ # prevent transitions smaller than 128 KB.
12938
+ #
12939
+ # To customize the minimum object size for any transition you can add
12940
+ # a filter that specifies a custom `ObjectSizeGreaterThan` or
12941
+ # `ObjectSizeLessThan` in the body of your transition rule. Custom
12942
+ # filters always take precedence over the default transition behavior.
12943
+ # @return [String]
12944
+ #
12945
+ # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycleConfigurationOutput AWS API Documentation
12946
+ #
12947
+ class PutBucketLifecycleConfigurationOutput < Struct.new(
12948
+ :transition_default_minimum_object_size)
12949
+ SENSITIVE = []
12950
+ include Aws::Structure
12951
+ end
12952
+
12855
12953
  # @!attribute [rw] bucket
12856
12954
  # The name of the bucket for which to set the configuration.
12857
12955
  # @return [String]
@@ -12884,13 +12982,32 @@ module Aws::S3
12884
12982
  # denied).
12885
12983
  # @return [String]
12886
12984
  #
12985
+ # @!attribute [rw] transition_default_minimum_object_size
12986
+ # Indicates which default minimum object size behavior is applied to
12987
+ # the lifecycle configuration.
12988
+ #
12989
+ # * `all_storage_classes_128K` - Objects smaller than 128 KB will not
12990
+ # transition to any storage class by default.
12991
+ #
12992
+ # * `varies_by_storage_class` - Objects smaller than 128 KB will
12993
+ # transition to Glacier Flexible Retrieval or Glacier Deep Archive
12994
+ # storage classes. By default, all other storage classes will
12995
+ # prevent transitions smaller than 128 KB.
12996
+ #
12997
+ # To customize the minimum object size for any transition you can add
12998
+ # a filter that specifies a custom `ObjectSizeGreaterThan` or
12999
+ # `ObjectSizeLessThan` in the body of your transition rule. Custom
13000
+ # filters always take precedence over the default transition behavior.
13001
+ # @return [String]
13002
+ #
12887
13003
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/PutBucketLifecycleConfigurationRequest AWS API Documentation
12888
13004
  #
12889
13005
  class PutBucketLifecycleConfigurationRequest < Struct.new(
12890
13006
  :bucket,
12891
13007
  :checksum_algorithm,
12892
13008
  :lifecycle_configuration,
12893
- :expected_bucket_owner)
13009
+ :expected_bucket_owner,
13010
+ :transition_default_minimum_object_size)
12894
13011
  SENSITIVE = []
12895
13012
  include Aws::Structure
12896
13013
  end
@@ -13189,13 +13306,13 @@ module Aws::S3
13189
13306
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm `
13190
13307
  # with the supported algorithm from the following list:
13191
13308
  #
13192
- # * CRC32
13309
+ # * `CRC32`
13193
13310
  #
13194
- # * CRC32C
13311
+ # * `CRC32C`
13195
13312
  #
13196
- # * SHA1
13313
+ # * `SHA1`
13197
13314
  #
13198
- # * SHA256
13315
+ # * `SHA256`
13199
13316
  #
13200
13317
  # For more information, see [Checking object integrity][1] in the
13201
13318
  # *Amazon S3 User Guide*.
@@ -13991,7 +14108,7 @@ module Aws::S3
13991
14108
  # @return [String]
13992
14109
  #
13993
14110
  # @!attribute [rw] checksum_crc32
13994
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
14111
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
13995
14112
  # only be present if it was uploaded with the object. When you use an
13996
14113
  # API operation on an object that was uploaded using multipart
13997
14114
  # uploads, this value may not be a direct checksum value of the full
@@ -14006,7 +14123,7 @@ module Aws::S3
14006
14123
  # @return [String]
14007
14124
  #
14008
14125
  # @!attribute [rw] checksum_crc32c
14009
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
14126
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
14010
14127
  # only be present if it was uploaded with the object. When you use an
14011
14128
  # API operation on an object that was uploaded using multipart
14012
14129
  # uploads, this value may not be a direct checksum value of the full
@@ -14293,10 +14410,11 @@ module Aws::S3
14293
14410
  # information about REST request authentication, see [REST
14294
14411
  # Authentication][1].
14295
14412
  #
14296
- # <note markdown="1"> The `Content-MD5` header is required for any request to upload an
14297
- # object with a retention period configured using Amazon S3 Object
14298
- # Lock. For more information about Amazon S3 Object Lock, see [Amazon
14299
- # S3 Object Lock Overview][2] in the *Amazon S3 User Guide*.
14413
+ # <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is
14414
+ # required for any request to upload an object with a retention period
14415
+ # configured using Amazon S3 Object Lock. For more information, see
14416
+ # [Uploading objects to an Object Lock enabled bucket ][2] in the
14417
+ # *Amazon S3 User Guide*.
14300
14418
  #
14301
14419
  # </note>
14302
14420
  #
@@ -14307,7 +14425,7 @@ module Aws::S3
14307
14425
  #
14308
14426
  #
14309
14427
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/RESTAuthentication.html
14310
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lock-overview.html
14428
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-managing.html#object-lock-put-object
14311
14429
  # @return [String]
14312
14430
  #
14313
14431
  # @!attribute [rw] content_type
@@ -14331,13 +14449,13 @@ module Aws::S3
14331
14449
  # For the `x-amz-checksum-algorithm ` header, replace ` algorithm `
14332
14450
  # with the supported algorithm from the following list:
14333
14451
  #
14334
- # * CRC32
14452
+ # * `CRC32`
14335
14453
  #
14336
- # * CRC32C
14454
+ # * `CRC32C`
14337
14455
  #
14338
- # * SHA1
14456
+ # * `SHA1`
14339
14457
  #
14340
- # * SHA256
14458
+ # * `SHA256`
14341
14459
  #
14342
14460
  # For more information, see [Checking object integrity][1] in the
14343
14461
  # *Amazon S3 User Guide*.
@@ -14349,21 +14467,28 @@ module Aws::S3
14349
14467
  # algorithm that matches the provided value in
14350
14468
  # `x-amz-checksum-algorithm `.
14351
14469
  #
14352
- # <note markdown="1"> For directory buckets, when you use Amazon Web Services SDKs,
14353
- # `CRC32` is the default checksum algorithm that's used for
14354
- # performance.
14470
+ # <note markdown="1"> The `Content-MD5` or `x-amz-sdk-checksum-algorithm` header is
14471
+ # required for any request to upload an object with a retention period
14472
+ # configured using Amazon S3 Object Lock. For more information, see
14473
+ # [Uploading objects to an Object Lock enabled bucket ][2] in the
14474
+ # *Amazon S3 User Guide*.
14355
14475
  #
14356
14476
  # </note>
14357
14477
  #
14478
+ # For directory buckets, when you use Amazon Web Services SDKs,
14479
+ # `CRC32` is the default checksum algorithm that's used for
14480
+ # performance.
14481
+ #
14358
14482
  #
14359
14483
  #
14360
14484
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html
14485
+ # [2]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lock-managing.html#object-lock-put-object
14361
14486
  # @return [String]
14362
14487
  #
14363
14488
  # @!attribute [rw] checksum_crc32
14364
14489
  # This header can be used as a data integrity check to verify that the
14365
14490
  # data received is the same data that was originally sent. This header
14366
- # specifies the base64-encoded, 32-bit CRC32 checksum of the object.
14491
+ # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
14367
14492
  # For more information, see [Checking object integrity][1] in the
14368
14493
  # *Amazon S3 User Guide*.
14369
14494
  #
@@ -14375,7 +14500,7 @@ module Aws::S3
14375
14500
  # @!attribute [rw] checksum_crc32c
14376
14501
  # This header can be used as a data integrity check to verify that the
14377
14502
  # data received is the same data that was originally sent. This header
14378
- # specifies the base64-encoded, 32-bit CRC32C checksum of the object.
14503
+ # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
14379
14504
  # For more information, see [Checking object integrity][1] in the
14380
14505
  # *Amazon S3 User Guide*.
14381
14506
  #
@@ -14652,15 +14777,20 @@ module Aws::S3
14652
14777
  # Amazon Web Services managed key (`aws/s3`) to protect the data.
14653
14778
  #
14654
14779
  # **Directory buckets** - If you specify
14655
- # `x-amz-server-side-encryption` with `aws:kms`, you must specify the
14656
- # ` x-amz-server-side-encryption-aws-kms-key-id` header with the ID
14657
- # (Key ID or Key ARN) of the KMS symmetric encryption customer managed
14658
- # key to use. Otherwise, you get an HTTP `400 Bad Request` error. Only
14659
- # use the key ID or key ARN. The key alias format of the KMS key
14660
- # isn't supported. Your SSE-KMS configuration can only support 1
14661
- # [customer managed key][1] per directory bucket for the lifetime of
14662
- # the bucket. [Amazon Web Services managed key][2] (`aws/s3`) isn't
14663
- # supported.
14780
+ # `x-amz-server-side-encryption` with `aws:kms`, the `
14781
+ # x-amz-server-side-encryption-aws-kms-key-id` header is implicitly
14782
+ # assigned the ID of the KMS symmetric encryption customer managed key
14783
+ # that's configured for your directory bucket's default encryption
14784
+ # setting. If you want to specify the `
14785
+ # x-amz-server-side-encryption-aws-kms-key-id` header explicitly, you
14786
+ # can only specify it with the ID (Key ID or Key ARN) of the KMS
14787
+ # customer managed key that's configured for your directory bucket's
14788
+ # default encryption setting. Otherwise, you get an HTTP `400 Bad
14789
+ # Request` error. Only use the key ID or key ARN. The key alias format
14790
+ # of the KMS key isn't supported. Your SSE-KMS configuration can only
14791
+ # support 1 [customer managed key][1] per directory bucket for the
14792
+ # lifetime of the bucket. The [Amazon Web Services managed key][2]
14793
+ # (`aws/s3`) isn't supported.
14664
14794
  #
14665
14795
  #
14666
14796
  #
@@ -15771,15 +15901,7 @@ module Aws::S3
15771
15901
  # @return [Types::GlacierJobParameters]
15772
15902
  #
15773
15903
  # @!attribute [rw] type
15774
- # Amazon S3 Select is no longer available to new customers. Existing
15775
- # customers of Amazon S3 Select can continue to use the feature as
15776
- # usual. [Learn more][1]
15777
- #
15778
15904
  # Type of restore request.
15779
- #
15780
- #
15781
- #
15782
- # [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
15783
15905
  # @return [String]
15784
15906
  #
15785
15907
  # @!attribute [rw] tier
@@ -15791,15 +15913,7 @@ module Aws::S3
15791
15913
  # @return [String]
15792
15914
  #
15793
15915
  # @!attribute [rw] select_parameters
15794
- # Amazon S3 Select is no longer available to new customers. Existing
15795
- # customers of Amazon S3 Select can continue to use the feature as
15796
- # usual. [Learn more][1]
15797
- #
15798
15916
  # Describes the parameters for Select job types.
15799
- #
15800
- #
15801
- #
15802
- # [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
15803
15917
  # @return [Types::SelectParameters]
15804
15918
  #
15805
15919
  # @!attribute [rw] output_location
@@ -16130,12 +16244,6 @@ module Aws::S3
16130
16244
  include Aws::Structure
16131
16245
  end
16132
16246
 
16133
- # <note markdown="1"> Learn Amazon S3 Select is no longer available to new customers.
16134
- # Existing customers of Amazon S3 Select can continue to use the feature
16135
- # as usual. [Learn more][1]
16136
- #
16137
- # </note>
16138
- #
16139
16247
  # Request to filter the contents of an Amazon S3 object based on a
16140
16248
  # simple Structured Query Language (SQL) statement. In the request,
16141
16249
  # along with the SQL expression, you must specify a data serialization
@@ -16143,12 +16251,11 @@ module Aws::S3
16143
16251
  # object data into records. It returns only records that match the
16144
16252
  # specified SQL expression. You must also specify the data serialization
16145
16253
  # format for the response. For more information, see [S3Select API
16146
- # Documentation][2].
16254
+ # Documentation][1].
16147
16255
  #
16148
16256
  #
16149
16257
  #
16150
- # [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
16151
- # [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html
16258
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/RESTObjectSELECTContent.html
16152
16259
  #
16153
16260
  # @!attribute [rw] bucket
16154
16261
  # The S3 bucket.
@@ -16260,21 +16367,8 @@ module Aws::S3
16260
16367
  include Aws::Structure
16261
16368
  end
16262
16369
 
16263
- # Amazon S3 Select is no longer available to new customers. Existing
16264
- # customers of Amazon S3 Select can continue to use the feature as
16265
- # usual. [Learn more][1]
16266
- #
16267
16370
  # Describes the parameters for Select job types.
16268
16371
  #
16269
- # Learn [How to optimize querying your data in Amazon S3][1] using
16270
- # [Amazon Athena][2], [S3 Object Lambda][3], or client-side filtering.
16271
- #
16272
- #
16273
- #
16274
- # [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
16275
- # [2]: https://docs.aws.amazon.com/athena/latest/ug/what-is.html
16276
- # [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/transforming-objects.html
16277
- #
16278
16372
  # @!attribute [rw] input_serialization
16279
16373
  # Describes the serialization format of the object.
16280
16374
  # @return [Types::InputSerialization]
@@ -16284,15 +16378,7 @@ module Aws::S3
16284
16378
  # @return [String]
16285
16379
  #
16286
16380
  # @!attribute [rw] expression
16287
- # Amazon S3 Select is no longer available to new customers. Existing
16288
- # customers of Amazon S3 Select can continue to use the feature as
16289
- # usual. [Learn more][1]
16290
- #
16291
16381
  # The expression that is used to query the object.
16292
- #
16293
- #
16294
- #
16295
- # [1]: http://aws.amazon.com/blogs/storage/how-to-optimize-querying-your-data-in-amazon-s3/
16296
16382
  # @return [String]
16297
16383
  #
16298
16384
  # @!attribute [rw] output_serialization
@@ -16323,8 +16409,8 @@ module Aws::S3
16323
16409
  #
16324
16410
  # * **Directory buckets** - Your SSE-KMS configuration can only support
16325
16411
  # 1 [customer managed key][2] per directory bucket for the lifetime of
16326
- # the bucket. [Amazon Web Services managed key][3] (`aws/s3`) isn't
16327
- # supported.
16412
+ # the bucket. The [Amazon Web Services managed key][3] (`aws/s3`)
16413
+ # isn't supported.
16328
16414
  #
16329
16415
  # * **Directory buckets** - For directory buckets, there are only two
16330
16416
  # supported options for server-side encryption: SSE-S3 and SSE-KMS.
@@ -17317,7 +17403,7 @@ module Aws::S3
17317
17403
  # @return [String]
17318
17404
  #
17319
17405
  # @!attribute [rw] checksum_crc32
17320
- # The base64-encoded, 32-bit CRC32 checksum of the object. This will
17406
+ # The base64-encoded, 32-bit CRC-32 checksum of the object. This will
17321
17407
  # only be present if it was uploaded with the object. When you use an
17322
17408
  # API operation on an object that was uploaded using multipart
17323
17409
  # uploads, this value may not be a direct checksum value of the full
@@ -17332,7 +17418,7 @@ module Aws::S3
17332
17418
  # @return [String]
17333
17419
  #
17334
17420
  # @!attribute [rw] checksum_crc32c
17335
- # The base64-encoded, 32-bit CRC32C checksum of the object. This will
17421
+ # The base64-encoded, 32-bit CRC-32C checksum of the object. This will
17336
17422
  # only be present if it was uploaded with the object. When you use an
17337
17423
  # API operation on an object that was uploaded using multipart
17338
17424
  # uploads, this value may not be a direct checksum value of the full
@@ -17522,7 +17608,7 @@ module Aws::S3
17522
17608
  # @!attribute [rw] checksum_crc32
17523
17609
  # This header can be used as a data integrity check to verify that the
17524
17610
  # data received is the same data that was originally sent. This header
17525
- # specifies the base64-encoded, 32-bit CRC32 checksum of the object.
17611
+ # specifies the base64-encoded, 32-bit CRC-32 checksum of the object.
17526
17612
  # For more information, see [Checking object integrity][1] in the
17527
17613
  # *Amazon S3 User Guide*.
17528
17614
  #
@@ -17534,7 +17620,7 @@ module Aws::S3
17534
17620
  # @!attribute [rw] checksum_crc32c
17535
17621
  # This header can be used as a data integrity check to verify that the
17536
17622
  # data received is the same data that was originally sent. This header
17537
- # specifies the base64-encoded, 32-bit CRC32C checksum of the object.
17623
+ # specifies the base64-encoded, 32-bit CRC-32C checksum of the object.
17538
17624
  # For more information, see [Checking object integrity][1] in the
17539
17625
  # *Amazon S3 User Guide*.
17540
17626
  #
@@ -17824,7 +17910,7 @@ module Aws::S3
17824
17910
  # @!attribute [rw] checksum_crc32
17825
17911
  # This header can be used as a data integrity check to verify that the
17826
17912
  # data received is the same data that was originally sent. This
17827
- # specifies the base64-encoded, 32-bit CRC32 checksum of the object
17913
+ # specifies the base64-encoded, 32-bit CRC-32 checksum of the object
17828
17914
  # returned by the Object Lambda function. This may not match the
17829
17915
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
17830
17916
  # validation of the checksum values only when the original `GetObject`
@@ -17845,7 +17931,7 @@ module Aws::S3
17845
17931
  # @!attribute [rw] checksum_crc32c
17846
17932
  # This header can be used as a data integrity check to verify that the
17847
17933
  # data received is the same data that was originally sent. This
17848
- # specifies the base64-encoded, 32-bit CRC32C checksum of the object
17934
+ # specifies the base64-encoded, 32-bit CRC-32C checksum of the object
17849
17935
  # returned by the Object Lambda function. This may not match the
17850
17936
  # checksum for the object stored in Amazon S3. Amazon S3 will perform
17851
17937
  # validation of the checksum values only when the original `GetObject`