aws-sdk-s3 1.166.0 → 1.168.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -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`