aws-sdk-s3 1.75.0 → 1.79.1

Sign up to get free protection for your applications and to get access to all the features.
Files changed (34) hide show
  1. checksums.yaml +4 -4
  2. data/lib/aws-sdk-s3.rb +2 -2
  3. data/lib/aws-sdk-s3/bucket.rb +2 -2
  4. data/lib/aws-sdk-s3/client.rb +145 -119
  5. data/lib/aws-sdk-s3/encryption.rb +2 -0
  6. data/lib/aws-sdk-s3/encryption/client.rb +11 -0
  7. data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +64 -29
  8. data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +41 -5
  9. data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +5 -5
  10. data/lib/aws-sdk-s3/encryption/io_decrypter.rb +7 -6
  11. data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +32 -3
  12. data/lib/aws-sdk-s3/encryption/utils.rb +23 -0
  13. data/lib/aws-sdk-s3/encryptionV2/client.rb +201 -23
  14. data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +40 -12
  15. data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +77 -10
  16. data/lib/aws-sdk-s3/encryptionV2/default_key_provider.rb +2 -0
  17. data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +7 -4
  18. data/lib/aws-sdk-s3/encryptionV2/errors.rb +24 -0
  19. data/lib/aws-sdk-s3/encryptionV2/io_auth_decrypter.rb +2 -0
  20. data/lib/aws-sdk-s3/encryptionV2/io_decrypter.rb +2 -0
  21. data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +2 -0
  22. data/lib/aws-sdk-s3/encryptionV2/key_provider.rb +2 -0
  23. data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +90 -20
  24. data/lib/aws-sdk-s3/encryptionV2/materials.rb +2 -0
  25. data/lib/aws-sdk-s3/encryptionV2/utils.rb +2 -15
  26. data/lib/aws-sdk-s3/encryption_v2.rb +4 -1
  27. data/lib/aws-sdk-s3/multipart_upload_part.rb +1 -1
  28. data/lib/aws-sdk-s3/object.rb +1 -1
  29. data/lib/aws-sdk-s3/object_summary.rb +19 -3
  30. data/lib/aws-sdk-s3/presigned_post.rb +1 -0
  31. data/lib/aws-sdk-s3/presigner.rb +2 -2
  32. data/lib/aws-sdk-s3/resource.rb +1 -1
  33. data/lib/aws-sdk-s3/types.rb +25 -8
  34. metadata +4 -4
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: 75f8d275e892e31dfb80d004f49fb465fc4388e92f20e2827089d5dc76e0d821
4
- data.tar.gz: 1f84cba631bb2e6a81d07ea671fec120d6bf33dcbfe6e427de26444c36627cf8
3
+ metadata.gz: da602f15baa7e2102b675dc8b13aae19954e04df5be6120a09b634a69b195043
4
+ data.tar.gz: 8667cc19707dc6da21e9483904c9f652b9e665ae82f86599a54a52a29e3a1e40
5
5
  SHA512:
6
- metadata.gz: f034970098a597fd9d6eeb87a8a82c1ed30ff918ca292b1a0a3f380f08e5b8f504ec619b1763312720f1b28e1df6ba7b56c0bac19dc09c9923bc21aa8be189d1
7
- data.tar.gz: 0bb581e24c1e3d0fa6306c574146f7ef1e85ff949911d7917c0f4cf8cf85b364cf8b0210ed2ba54a85ec5838a463368ede8f978846e123f79f78e92e3fffd4c9
6
+ metadata.gz: 0a7baa7b2490bd556dc00d6a08218fd071f688d9a7b870e43b8dd73dd930677df899d2cc24e642f48bbb2e8f9f3fca0866613905777bf41b2a7b0373c2724a88
7
+ data.tar.gz: ecc4134f3f59c49f7f195029639e236022a6702af191074da6a7cbede7f406db0d465fb364e87a314ea51675af85e75d585985aac0720a8e6e596e915af4aaa8
@@ -65,9 +65,9 @@ require_relative 'aws-sdk-s3/event_streams'
65
65
  #
66
66
  # See {Errors} for more information.
67
67
  #
68
- # @service
68
+ # @!group service
69
69
  module Aws::S3
70
70
 
71
- GEM_VERSION = '1.75.0'
71
+ GEM_VERSION = '1.79.1'
72
72
 
73
73
  end
@@ -222,7 +222,7 @@ module Aws::S3
222
222
  # bucket.create({
223
223
  # acl: "private", # accepts private, public-read, public-read-write, authenticated-read
224
224
  # create_bucket_configuration: {
225
- # location_constraint: "EU", # accepts EU, eu-west-1, us-west-1, us-west-2, ap-south-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, sa-east-1, cn-north-1, eu-central-1
225
+ # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
226
226
  # },
227
227
  # grant_full_control: "GrantFullControl",
228
228
  # grant_read: "GrantRead",
@@ -357,7 +357,7 @@ module Aws::S3
357
357
  #
358
358
  #
359
359
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
360
- # @option options [String, IO] :body
360
+ # @option options [String, StringIO, File] :body
361
361
  # Object data.
362
362
  # @option options [String] :cache_control
363
363
  # Can be used to specify caching behavior along the request/reply chain.
@@ -119,13 +119,28 @@ module Aws::S3
119
119
  # * `Aws::Credentials` - Used for configuring static, non-refreshing
120
120
  # credentials.
121
121
  #
122
+ # * `Aws::SharedCredentials` - Used for loading static credentials from a
123
+ # shared file, such as `~/.aws/config`.
124
+ #
125
+ # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
126
+ #
127
+ # * `Aws::AssumeRoleWebIdentityCredentials` - Used when you need to
128
+ # assume a role after providing credentials via the web.
129
+ #
130
+ # * `Aws::SSOCredentials` - Used for loading credentials from AWS SSO using an
131
+ # access token generated from `aws login`.
132
+ #
133
+ # * `Aws::ProcessCredentials` - Used for loading credentials from a
134
+ # process that outputs to stdout.
135
+ #
122
136
  # * `Aws::InstanceProfileCredentials` - Used for loading credentials
123
137
  # from an EC2 IMDS on an EC2 instance.
124
138
  #
125
- # * `Aws::SharedCredentials` - Used for loading credentials from a
126
- # shared file, such as `~/.aws/config`.
139
+ # * `Aws::ECSCredentials` - Used for loading credentials from
140
+ # instances running in ECS.
127
141
  #
128
- # * `Aws::AssumeRoleCredentials` - Used when you need to assume a role.
142
+ # * `Aws::CognitoIdentityCredentials` - Used for loading credentials
143
+ # from the Cognito Identity service.
129
144
  #
130
145
  # When `:credentials` are not configured directly, the following
131
146
  # locations will be searched for credentials:
@@ -135,10 +150,10 @@ module Aws::S3
135
150
  # * ENV['AWS_ACCESS_KEY_ID'], ENV['AWS_SECRET_ACCESS_KEY']
136
151
  # * `~/.aws/credentials`
137
152
  # * `~/.aws/config`
138
- # * EC2 IMDS instance profile - When used by default, the timeouts are
139
- # very aggressive. Construct and pass an instance of
140
- # `Aws::InstanceProfileCredentails` to enable retries and extended
141
- # timeouts.
153
+ # * EC2/ECS IMDS instance profile - When used by default, the timeouts
154
+ # are very aggressive. Construct and pass an instance of
155
+ # `Aws::InstanceProfileCredentails` or `Aws::ECSCredentials` to
156
+ # enable retries and extended timeouts.
142
157
  #
143
158
  # @option options [required, String] :region
144
159
  # The AWS region to connect to. The configured `:region` is
@@ -529,7 +544,7 @@ module Aws::S3
529
544
  # For information about permissions required to use the multipart upload
530
545
  # API, see [Multipart Upload API and Permissions][3].
531
546
  #
532
- # `GetBucketLifecycle` has the following special errors:
547
+ # `CompleteMultipartUpload` has the following special errors:
533
548
  #
534
549
  # * Error code: `EntityTooSmall`
535
550
  #
@@ -1290,7 +1305,7 @@ module Aws::S3
1290
1305
  # acl: "private", # accepts private, public-read, public-read-write, authenticated-read
1291
1306
  # bucket: "BucketName", # required
1292
1307
  # create_bucket_configuration: {
1293
- # location_constraint: "EU", # accepts EU, eu-west-1, us-west-1, us-west-2, ap-south-1, ap-southeast-1, ap-southeast-2, ap-northeast-1, sa-east-1, cn-north-1, eu-central-1
1308
+ # location_constraint: "af-south-1", # accepts af-south-1, ap-east-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-south-1, ap-southeast-1, ap-southeast-2, ca-central-1, cn-north-1, cn-northwest-1, EU, eu-central-1, eu-north-1, eu-south-1, eu-west-1, eu-west-2, eu-west-3, me-south-1, sa-east-1, us-east-2, us-gov-east-1, us-gov-west-1, us-west-1, us-west-2
1294
1309
  # },
1295
1310
  # grant_full_control: "GrantFullControl",
1296
1311
  # grant_read: "GrantRead",
@@ -2384,6 +2399,15 @@ module Aws::S3
2384
2399
  # * {Types::DeleteObjectOutput#request_charged #request_charged} => String
2385
2400
  #
2386
2401
  #
2402
+ # @example Example: To delete an object (from a non-versioned bucket)
2403
+ #
2404
+ # # The following example deletes an object from a non-versioned bucket.
2405
+ #
2406
+ # resp = client.delete_object({
2407
+ # bucket: "ExampleBucket",
2408
+ # key: "HappyFace.jpg",
2409
+ # })
2410
+ #
2387
2411
  # @example Example: To delete an object
2388
2412
  #
2389
2413
  # # The following example deletes an object from an S3 bucket.
@@ -2397,15 +2421,6 @@ module Aws::S3
2397
2421
  # {
2398
2422
  # }
2399
2423
  #
2400
- # @example Example: To delete an object (from a non-versioned bucket)
2401
- #
2402
- # # The following example deletes an object from a non-versioned bucket.
2403
- #
2404
- # resp = client.delete_object({
2405
- # bucket: "ExampleBucket",
2406
- # key: "HappyFace.jpg",
2407
- # })
2408
- #
2409
2424
  # @example Request syntax with placeholder values
2410
2425
  #
2411
2426
  # resp = client.delete_object({
@@ -2469,7 +2484,7 @@ module Aws::S3
2469
2484
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
2470
2485
  #
2471
2486
  # @option params [required, String] :key
2472
- # Name of the tag.
2487
+ # Name of the object key.
2473
2488
  #
2474
2489
  # @option params [String] :version_id
2475
2490
  # The versionId of the object that the tag-set will be removed from.
@@ -2479,35 +2494,35 @@ module Aws::S3
2479
2494
  # * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
2480
2495
  #
2481
2496
  #
2482
- # @example Example: To remove tag set from an object version
2497
+ # @example Example: To remove tag set from an object
2483
2498
  #
2484
- # # The following example removes tag set associated with the specified object version. The request specifies both the
2485
- # # object key and object version.
2499
+ # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2500
+ # # operation removes tag set from the latest object version.
2486
2501
  #
2487
2502
  # resp = client.delete_object_tagging({
2488
2503
  # bucket: "examplebucket",
2489
2504
  # key: "HappyFace.jpg",
2490
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2491
2505
  # })
2492
2506
  #
2493
2507
  # resp.to_h outputs the following:
2494
2508
  # {
2495
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2509
+ # version_id: "null",
2496
2510
  # }
2497
2511
  #
2498
- # @example Example: To remove tag set from an object
2512
+ # @example Example: To remove tag set from an object version
2499
2513
  #
2500
- # # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
2501
- # # operation removes tag set from the latest object version.
2514
+ # # The following example removes tag set associated with the specified object version. The request specifies both the
2515
+ # # object key and object version.
2502
2516
  #
2503
2517
  # resp = client.delete_object_tagging({
2504
2518
  # bucket: "examplebucket",
2505
2519
  # key: "HappyFace.jpg",
2520
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2506
2521
  # })
2507
2522
  #
2508
2523
  # resp.to_h outputs the following:
2509
2524
  # {
2510
- # version_id: "null",
2525
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
2511
2526
  # }
2512
2527
  #
2513
2528
  # @example Request syntax with placeholder values
@@ -2626,22 +2641,20 @@ module Aws::S3
2626
2641
  # * {Types::DeleteObjectsOutput#errors #errors} => Array<Types::Error>
2627
2642
  #
2628
2643
  #
2629
- # @example Example: To delete multiple object versions from a versioned bucket
2644
+ # @example Example: To delete multiple objects from a versioned bucket
2630
2645
  #
2631
- # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
2632
- # # versions and returns the key and versions of deleted objects in the response.
2646
+ # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
2647
+ # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
2633
2648
  #
2634
2649
  # resp = client.delete_objects({
2635
2650
  # bucket: "examplebucket",
2636
2651
  # delete: {
2637
2652
  # objects: [
2638
2653
  # {
2639
- # key: "HappyFace.jpg",
2640
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
2654
+ # key: "objectkey1",
2641
2655
  # },
2642
2656
  # {
2643
- # key: "HappyFace.jpg",
2644
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
2657
+ # key: "objectkey2",
2645
2658
  # },
2646
2659
  # ],
2647
2660
  # quiet: false,
@@ -2652,30 +2665,34 @@ module Aws::S3
2652
2665
  # {
2653
2666
  # deleted: [
2654
2667
  # {
2655
- # key: "HappyFace.jpg",
2656
- # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
2668
+ # delete_marker: true,
2669
+ # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
2670
+ # key: "objectkey1",
2657
2671
  # },
2658
2672
  # {
2659
- # key: "HappyFace.jpg",
2660
- # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
2673
+ # delete_marker: true,
2674
+ # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
2675
+ # key: "objectkey2",
2661
2676
  # },
2662
2677
  # ],
2663
2678
  # }
2664
2679
  #
2665
- # @example Example: To delete multiple objects from a versioned bucket
2680
+ # @example Example: To delete multiple object versions from a versioned bucket
2666
2681
  #
2667
- # # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
2668
- # # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
2682
+ # # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
2683
+ # # versions and returns the key and versions of deleted objects in the response.
2669
2684
  #
2670
2685
  # resp = client.delete_objects({
2671
2686
  # bucket: "examplebucket",
2672
2687
  # delete: {
2673
2688
  # objects: [
2674
2689
  # {
2675
- # key: "objectkey1",
2690
+ # key: "HappyFace.jpg",
2691
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
2676
2692
  # },
2677
2693
  # {
2678
- # key: "objectkey2",
2694
+ # key: "HappyFace.jpg",
2695
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
2679
2696
  # },
2680
2697
  # ],
2681
2698
  # quiet: false,
@@ -2686,14 +2703,12 @@ module Aws::S3
2686
2703
  # {
2687
2704
  # deleted: [
2688
2705
  # {
2689
- # delete_marker: true,
2690
- # delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
2691
- # key: "objectkey1",
2706
+ # key: "HappyFace.jpg",
2707
+ # version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
2692
2708
  # },
2693
2709
  # {
2694
- # delete_marker: true,
2695
- # delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
2696
- # key: "objectkey2",
2710
+ # key: "HappyFace.jpg",
2711
+ # version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
2697
2712
  # },
2698
2713
  # ],
2699
2714
  # }
@@ -3433,7 +3448,7 @@ module Aws::S3
3433
3448
  #
3434
3449
  # @example Response structure
3435
3450
  #
3436
- # resp.location_constraint #=> String, one of "EU", "eu-west-1", "us-west-1", "us-west-2", "ap-south-1", "ap-southeast-1", "ap-southeast-2", "ap-northeast-1", "sa-east-1", "cn-north-1", "eu-central-1"
3451
+ # resp.location_constraint #=> String, one of "af-south-1", "ap-east-1", "ap-northeast-1", "ap-northeast-2", "ap-northeast-3", "ap-south-1", "ap-southeast-1", "ap-southeast-2", "ca-central-1", "cn-north-1", "cn-northwest-1", "EU", "eu-central-1", "eu-north-1", "eu-south-1", "eu-west-1", "eu-west-2", "eu-west-3", "me-south-1", "sa-east-1", "us-east-2", "us-gov-east-1", "us-gov-west-1", "us-west-1", "us-west-2"
3437
3452
  #
3438
3453
  # @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation AWS API Documentation
3439
3454
  #
@@ -4522,49 +4537,49 @@ module Aws::S3
4522
4537
  # * {Types::GetObjectOutput#object_lock_legal_hold_status #object_lock_legal_hold_status} => String
4523
4538
  #
4524
4539
  #
4525
- # @example Example: To retrieve a byte range of an object
4540
+ # @example Example: To retrieve an object
4526
4541
  #
4527
- # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
4528
- # # specific byte range.
4542
+ # # The following example retrieves an object for an S3 bucket.
4529
4543
  #
4530
4544
  # resp = client.get_object({
4531
4545
  # bucket: "examplebucket",
4532
- # key: "SampleFile.txt",
4533
- # range: "bytes=0-9",
4546
+ # key: "HappyFace.jpg",
4534
4547
  # })
4535
4548
  #
4536
4549
  # resp.to_h outputs the following:
4537
4550
  # {
4538
4551
  # accept_ranges: "bytes",
4539
- # content_length: 10,
4540
- # content_range: "bytes 0-9/43",
4541
- # content_type: "text/plain",
4542
- # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
4543
- # last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
4552
+ # content_length: 3191,
4553
+ # content_type: "image/jpeg",
4554
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
4555
+ # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
4544
4556
  # metadata: {
4545
4557
  # },
4558
+ # tag_count: 2,
4546
4559
  # version_id: "null",
4547
4560
  # }
4548
4561
  #
4549
- # @example Example: To retrieve an object
4562
+ # @example Example: To retrieve a byte range of an object
4550
4563
  #
4551
- # # The following example retrieves an object for an S3 bucket.
4564
+ # # The following example retrieves an object for an S3 bucket. The request specifies the range header to retrieve a
4565
+ # # specific byte range.
4552
4566
  #
4553
4567
  # resp = client.get_object({
4554
4568
  # bucket: "examplebucket",
4555
- # key: "HappyFace.jpg",
4569
+ # key: "SampleFile.txt",
4570
+ # range: "bytes=0-9",
4556
4571
  # })
4557
4572
  #
4558
4573
  # resp.to_h outputs the following:
4559
4574
  # {
4560
4575
  # accept_ranges: "bytes",
4561
- # content_length: 3191,
4562
- # content_type: "image/jpeg",
4563
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
4564
- # last_modified: Time.parse("Thu, 15 Dec 2016 01:19:41 GMT"),
4576
+ # content_length: 10,
4577
+ # content_range: "bytes 0-9/43",
4578
+ # content_type: "text/plain",
4579
+ # etag: "\"0d94420ffd0bc68cd3d152506b97a9cc\"",
4580
+ # last_modified: Time.parse("Thu, 09 Oct 2014 22:57:28 GMT"),
4565
4581
  # metadata: {
4566
4582
  # },
4567
- # tag_count: 2,
4568
4583
  # version_id: "null",
4569
4584
  # }
4570
4585
  #
@@ -5034,49 +5049,49 @@ module Aws::S3
5034
5049
  # * {Types::GetObjectTaggingOutput#tag_set #tag_set} => Array<Types::Tag>
5035
5050
  #
5036
5051
  #
5037
- # @example Example: To retrieve tag set of an object
5052
+ # @example Example: To retrieve tag set of a specific object version
5038
5053
  #
5039
- # # The following example retrieves tag set of an object.
5054
+ # # The following example retrieves tag set of an object. The request specifies object version.
5040
5055
  #
5041
5056
  # resp = client.get_object_tagging({
5042
5057
  # bucket: "examplebucket",
5043
- # key: "HappyFace.jpg",
5058
+ # key: "exampleobject",
5059
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5044
5060
  # })
5045
5061
  #
5046
5062
  # resp.to_h outputs the following:
5047
5063
  # {
5048
5064
  # tag_set: [
5049
5065
  # {
5050
- # key: "Key4",
5051
- # value: "Value4",
5052
- # },
5053
- # {
5054
- # key: "Key3",
5055
- # value: "Value3",
5066
+ # key: "Key1",
5067
+ # value: "Value1",
5056
5068
  # },
5057
5069
  # ],
5058
- # version_id: "null",
5070
+ # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5059
5071
  # }
5060
5072
  #
5061
- # @example Example: To retrieve tag set of a specific object version
5073
+ # @example Example: To retrieve tag set of an object
5062
5074
  #
5063
- # # The following example retrieves tag set of an object. The request specifies object version.
5075
+ # # The following example retrieves tag set of an object.
5064
5076
  #
5065
5077
  # resp = client.get_object_tagging({
5066
5078
  # bucket: "examplebucket",
5067
- # key: "exampleobject",
5068
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5079
+ # key: "HappyFace.jpg",
5069
5080
  # })
5070
5081
  #
5071
5082
  # resp.to_h outputs the following:
5072
5083
  # {
5073
5084
  # tag_set: [
5074
5085
  # {
5075
- # key: "Key1",
5076
- # value: "Value1",
5086
+ # key: "Key4",
5087
+ # value: "Value4",
5088
+ # },
5089
+ # {
5090
+ # key: "Key3",
5091
+ # value: "Value3",
5077
5092
  # },
5078
5093
  # ],
5079
- # version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
5094
+ # version_id: "null",
5080
5095
  # }
5081
5096
  #
5082
5097
  # @example Request syntax with placeholder values
@@ -8472,6 +8487,17 @@ module Aws::S3
8472
8487
  # configuration, you must also add the following elements:
8473
8488
  # `DeleteMarkerReplication`, `Status`, and `Priority`.
8474
8489
  #
8490
+ # <note markdown="1"> The latest version of the replication configuration XML is V2. XML V2
8491
+ # replication configurations are those that contain the `Filter` element
8492
+ # for rules, and rules that specify S3 Replication Time Control (S3
8493
+ # RTC). In XML V2 replication configurations, Amazon S3 doesn't
8494
+ # replicate delete markers. Therefore, you must set the
8495
+ # `DeleteMarkerReplication` element to `Disabled`. For backward
8496
+ # compatibility, Amazon S3 continues to support the XML V1 replication
8497
+ # configuration.
8498
+ #
8499
+ # </note>
8500
+ #
8475
8501
  # For information about enabling versioning on a bucket, see [Using
8476
8502
  # Versioning][3].
8477
8503
  #
@@ -9164,7 +9190,7 @@ module Aws::S3
9164
9190
  #
9165
9191
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL
9166
9192
  #
9167
- # @option params [String, IO] :body
9193
+ # @option params [String, StringIO, File] :body
9168
9194
  # Object data.
9169
9195
  #
9170
9196
  # @option params [required, String] :bucket
@@ -9382,24 +9408,39 @@ module Aws::S3
9382
9408
  # * {Types::PutObjectOutput#request_charged #request_charged} => String
9383
9409
  #
9384
9410
  #
9385
- # @example Example: To upload an object and specify server-side encryption and object tags
9411
+ # @example Example: To upload an object and specify canned ACL.
9386
9412
  #
9387
- # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
9388
- # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
9413
+ # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
9414
+ # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
9389
9415
  #
9390
9416
  # resp = client.put_object({
9417
+ # acl: "authenticated-read",
9391
9418
  # body: "filetoupload",
9392
9419
  # bucket: "examplebucket",
9393
9420
  # key: "exampleobject",
9394
- # server_side_encryption: "AES256",
9395
- # tagging: "key1=value1&key2=value2",
9396
9421
  # })
9397
9422
  #
9398
9423
  # resp.to_h outputs the following:
9399
9424
  # {
9400
9425
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9401
- # server_side_encryption: "AES256",
9402
- # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
9426
+ # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
9427
+ # }
9428
+ #
9429
+ # @example Example: To upload an object
9430
+ #
9431
+ # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
9432
+ # # syntax. S3 returns VersionId of the newly created object.
9433
+ #
9434
+ # resp = client.put_object({
9435
+ # body: "HappyFace.jpg",
9436
+ # bucket: "examplebucket",
9437
+ # key: "HappyFace.jpg",
9438
+ # })
9439
+ #
9440
+ # resp.to_h outputs the following:
9441
+ # {
9442
+ # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9443
+ # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
9403
9444
  # }
9404
9445
  #
9405
9446
  # @example Example: To create an object.
@@ -9477,39 +9518,24 @@ module Aws::S3
9477
9518
  # version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
9478
9519
  # }
9479
9520
  #
9480
- # @example Example: To upload an object and specify canned ACL.
9521
+ # @example Example: To upload an object and specify server-side encryption and object tags
9481
9522
  #
9482
- # # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
9483
- # # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
9523
+ # # The following example uploads and object. The request specifies the optional server-side encryption option. The request
9524
+ # # also specifies optional object tags. If the bucket is versioning enabled, S3 returns version ID in response.
9484
9525
  #
9485
9526
  # resp = client.put_object({
9486
- # acl: "authenticated-read",
9487
9527
  # body: "filetoupload",
9488
9528
  # bucket: "examplebucket",
9489
9529
  # key: "exampleobject",
9530
+ # server_side_encryption: "AES256",
9531
+ # tagging: "key1=value1&key2=value2",
9490
9532
  # })
9491
9533
  #
9492
9534
  # resp.to_h outputs the following:
9493
9535
  # {
9494
9536
  # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9495
- # version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
9496
- # }
9497
- #
9498
- # @example Example: To upload an object
9499
- #
9500
- # # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
9501
- # # syntax. S3 returns VersionId of the newly created object.
9502
- #
9503
- # resp = client.put_object({
9504
- # body: "HappyFace.jpg",
9505
- # bucket: "examplebucket",
9506
- # key: "HappyFace.jpg",
9507
- # })
9508
- #
9509
- # resp.to_h outputs the following:
9510
- # {
9511
- # etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
9512
- # version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
9537
+ # server_side_encryption: "AES256",
9538
+ # version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
9513
9539
  # }
9514
9540
  #
9515
9541
  # @example Streaming a file from disk
@@ -10189,7 +10215,7 @@ module Aws::S3
10189
10215
  # [1]: https://docs.aws.amazon.com/AmazonS3/latest/dev/using-access-points.html
10190
10216
  #
10191
10217
  # @option params [required, String] :key
10192
- # Name of the tag.
10218
+ # Name of the object key.
10193
10219
  #
10194
10220
  # @option params [String] :version_id
10195
10221
  # The versionId of the object that the tag-set will be added to.
@@ -11240,7 +11266,7 @@ module Aws::S3
11240
11266
  # [2]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
11241
11267
  # [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
11242
11268
  #
11243
- # @option params [String, IO] :body
11269
+ # @option params [String, StringIO, File] :body
11244
11270
  # Object data.
11245
11271
  #
11246
11272
  # @option params [required, String] :bucket
@@ -11674,7 +11700,7 @@ module Aws::S3
11674
11700
  params: params,
11675
11701
  config: config)
11676
11702
  context[:gem_name] = 'aws-sdk-s3'
11677
- context[:gem_version] = '1.75.0'
11703
+ context[:gem_version] = '1.79.1'
11678
11704
  Seahorse::Client::Request.new(handlers, context)
11679
11705
  end
11680
11706