aws-sdk-s3 1.75.0 → 1.79.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/lib/aws-sdk-s3.rb +2 -2
- data/lib/aws-sdk-s3/bucket.rb +2 -2
- data/lib/aws-sdk-s3/client.rb +145 -119
- data/lib/aws-sdk-s3/encryption.rb +2 -0
- data/lib/aws-sdk-s3/encryption/client.rb +11 -0
- data/lib/aws-sdk-s3/encryption/decrypt_handler.rb +64 -29
- data/lib/aws-sdk-s3/encryption/default_cipher_provider.rb +41 -5
- data/lib/aws-sdk-s3/encryption/encrypt_handler.rb +5 -5
- data/lib/aws-sdk-s3/encryption/io_decrypter.rb +7 -6
- data/lib/aws-sdk-s3/encryption/kms_cipher_provider.rb +32 -3
- data/lib/aws-sdk-s3/encryption/utils.rb +23 -0
- data/lib/aws-sdk-s3/encryptionV2/client.rb +201 -23
- data/lib/aws-sdk-s3/encryptionV2/decrypt_handler.rb +40 -12
- data/lib/aws-sdk-s3/encryptionV2/default_cipher_provider.rb +77 -10
- data/lib/aws-sdk-s3/encryptionV2/default_key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/encrypt_handler.rb +7 -4
- data/lib/aws-sdk-s3/encryptionV2/errors.rb +24 -0
- data/lib/aws-sdk-s3/encryptionV2/io_auth_decrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/io_decrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/io_encrypter.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/key_provider.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/kms_cipher_provider.rb +90 -20
- data/lib/aws-sdk-s3/encryptionV2/materials.rb +2 -0
- data/lib/aws-sdk-s3/encryptionV2/utils.rb +2 -15
- data/lib/aws-sdk-s3/encryption_v2.rb +4 -1
- data/lib/aws-sdk-s3/multipart_upload_part.rb +1 -1
- data/lib/aws-sdk-s3/object.rb +1 -1
- data/lib/aws-sdk-s3/object_summary.rb +19 -3
- data/lib/aws-sdk-s3/presigned_post.rb +1 -0
- data/lib/aws-sdk-s3/presigner.rb +2 -2
- data/lib/aws-sdk-s3/resource.rb +1 -1
- data/lib/aws-sdk-s3/types.rb +25 -8
- metadata +4 -4
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: da602f15baa7e2102b675dc8b13aae19954e04df5be6120a09b634a69b195043
|
4
|
+
data.tar.gz: 8667cc19707dc6da21e9483904c9f652b9e665ae82f86599a54a52a29e3a1e40
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 0a7baa7b2490bd556dc00d6a08218fd071f688d9a7b870e43b8dd73dd930677df899d2cc24e642f48bbb2e8f9f3fca0866613905777bf41b2a7b0373c2724a88
|
7
|
+
data.tar.gz: ecc4134f3f59c49f7f195029639e236022a6702af191074da6a7cbede7f406db0d465fb364e87a314ea51675af85e75d585985aac0720a8e6e596e915af4aaa8
|
data/lib/aws-sdk-s3.rb
CHANGED
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -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: "
|
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,
|
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.
|
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -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::
|
126
|
-
#
|
139
|
+
# * `Aws::ECSCredentials` - Used for loading credentials from
|
140
|
+
# instances running in ECS.
|
127
141
|
#
|
128
|
-
# * `Aws::
|
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
|
139
|
-
# very aggressive. Construct and pass an instance of
|
140
|
-
# `Aws::InstanceProfileCredentails`
|
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
|
-
# `
|
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: "
|
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
|
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
|
2497
|
+
# @example Example: To remove tag set from an object
|
2483
2498
|
#
|
2484
|
-
# # The following example removes tag set associated with the specified object
|
2485
|
-
# #
|
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: "
|
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.
|
2501
|
-
# #
|
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: "
|
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
|
2644
|
+
# @example Example: To delete multiple objects from a versioned bucket
|
2630
2645
|
#
|
2631
|
-
# # The following example deletes objects from a bucket. The
|
2632
|
-
# #
|
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: "
|
2640
|
-
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
2654
|
+
# key: "objectkey1",
|
2641
2655
|
# },
|
2642
2656
|
# {
|
2643
|
-
# key: "
|
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
|
-
#
|
2656
|
-
#
|
2668
|
+
# delete_marker: true,
|
2669
|
+
# delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
|
2670
|
+
# key: "objectkey1",
|
2657
2671
|
# },
|
2658
2672
|
# {
|
2659
|
-
#
|
2660
|
-
#
|
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
|
2680
|
+
# @example Example: To delete multiple object versions from a versioned bucket
|
2666
2681
|
#
|
2667
|
-
# # The following example deletes objects from a bucket. The
|
2668
|
-
# #
|
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: "
|
2690
|
+
# key: "HappyFace.jpg",
|
2691
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
2676
2692
|
# },
|
2677
2693
|
# {
|
2678
|
-
# key: "
|
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
|
-
#
|
2690
|
-
#
|
2691
|
-
# key: "objectkey1",
|
2706
|
+
# key: "HappyFace.jpg",
|
2707
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
2692
2708
|
# },
|
2693
2709
|
# {
|
2694
|
-
#
|
2695
|
-
#
|
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 "
|
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
|
4540
|
+
# @example Example: To retrieve an object
|
4526
4541
|
#
|
4527
|
-
# # The following example retrieves an object for an S3 bucket.
|
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: "
|
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:
|
4540
|
-
#
|
4541
|
-
#
|
4542
|
-
#
|
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: "
|
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:
|
4562
|
-
#
|
4563
|
-
#
|
4564
|
-
#
|
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
|
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: "
|
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: "
|
5051
|
-
# value: "
|
5052
|
-
# },
|
5053
|
-
# {
|
5054
|
-
# key: "Key3",
|
5055
|
-
# value: "Value3",
|
5066
|
+
# key: "Key1",
|
5067
|
+
# value: "Value1",
|
5056
5068
|
# },
|
5057
5069
|
# ],
|
5058
|
-
# version_id: "
|
5070
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
5059
5071
|
# }
|
5060
5072
|
#
|
5061
|
-
# @example Example: To retrieve tag set of
|
5073
|
+
# @example Example: To retrieve tag set of an object
|
5062
5074
|
#
|
5063
|
-
# # The following example retrieves tag set of an object.
|
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: "
|
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: "
|
5076
|
-
# value: "
|
5086
|
+
# key: "Key4",
|
5087
|
+
# value: "Value4",
|
5088
|
+
# },
|
5089
|
+
# {
|
5090
|
+
# key: "Key3",
|
5091
|
+
# value: "Value3",
|
5077
5092
|
# },
|
5078
5093
|
# ],
|
5079
|
-
# version_id: "
|
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,
|
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
|
9411
|
+
# @example Example: To upload an object and specify canned ACL.
|
9386
9412
|
#
|
9387
|
-
# # The following example uploads and object. The request specifies
|
9388
|
-
# #
|
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
|
-
#
|
9402
|
-
#
|
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
|
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
|
9483
|
-
# #
|
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
|
-
#
|
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
|
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,
|
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.
|
11703
|
+
context[:gem_version] = '1.79.1'
|
11678
11704
|
Seahorse::Client::Request.new(handlers, context)
|
11679
11705
|
end
|
11680
11706
|
|