aws-sdk-s3 1.113.2 → 1.115.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-s3/bucket.rb +1 -1
- data/lib/aws-sdk-s3/client.rb +126 -121
- data/lib/aws-sdk-s3/client_api.rb +94 -94
- data/lib/aws-sdk-s3/object_summary.rb +3 -1
- data/lib/aws-sdk-s3/resource.rb +1 -1
- data/lib/aws-sdk-s3/types.rb +10 -6
- data/lib/aws-sdk-s3.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
@@ -1,7 +1,7 @@
|
|
1
1
|
---
|
2
2
|
SHA256:
|
3
|
-
metadata.gz:
|
4
|
-
data.tar.gz:
|
3
|
+
metadata.gz: 8f6bcf037d303611c499b18e346918dfa94632af0e0f2170ddea71b04022b646
|
4
|
+
data.tar.gz: 87619f8106356f34e070a7215bbd81de9e58ac3a3d7a586b5f93064eb1989d2d
|
5
5
|
SHA512:
|
6
|
-
metadata.gz:
|
7
|
-
data.tar.gz:
|
6
|
+
metadata.gz: 0f218e976873fed04027aa60f9b946f02e0329d6e9f375f2024072744b372070966dec41dd9386e9c69da1875e575c8b481f47584e84e16561e18f669d3ae020
|
7
|
+
data.tar.gz: '08d983381937f557e2b7b3159bd8d7bfce48cc80962c9319d81f2a6032ecb7a7e95fe0af3b140d0ef3db6d2023ebca0c880a8b2337c40bcd459cadc67599d595'
|
data/CHANGELOG.md
CHANGED
@@ -1,6 +1,16 @@
|
|
1
1
|
Unreleased Changes
|
2
2
|
------------------
|
3
3
|
|
4
|
+
1.115.0 (2022-10-19)
|
5
|
+
------------------
|
6
|
+
|
7
|
+
* Feature - Updates internal logic for constructing API endpoints. We have added rule-based endpoints and internal model parameters.
|
8
|
+
|
9
|
+
1.114.0 (2022-05-03)
|
10
|
+
------------------
|
11
|
+
|
12
|
+
* Feature - Documentation only update for doc bug fixes for the S3 API docs.
|
13
|
+
|
4
14
|
1.113.2 (2022-04-26)
|
5
15
|
------------------
|
6
16
|
|
data/VERSION
CHANGED
@@ -1 +1 @@
|
|
1
|
-
1.
|
1
|
+
1.115.0
|
data/lib/aws-sdk-s3/bucket.rb
CHANGED
@@ -223,7 +223,7 @@ module Aws::S3
|
|
223
223
|
# bucket.create({
|
224
224
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
225
225
|
# create_bucket_configuration: {
|
226
|
-
# 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
|
+
# 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, ap-southeast-3, 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
|
227
227
|
# },
|
228
228
|
# grant_full_control: "GrantFullControl",
|
229
229
|
# grant_read: "GrantRead",
|
data/lib/aws-sdk-s3/client.rb
CHANGED
@@ -1662,33 +1662,33 @@ module Aws::S3
|
|
1662
1662
|
# * {Types::CreateBucketOutput#location #location} => String
|
1663
1663
|
#
|
1664
1664
|
#
|
1665
|
-
# @example Example: To create a bucket
|
1665
|
+
# @example Example: To create a bucket in a specific region
|
1666
1666
|
#
|
1667
|
-
# # The following example creates a bucket.
|
1667
|
+
# # The following example creates a bucket. The request specifies an AWS region where to create the bucket.
|
1668
1668
|
#
|
1669
1669
|
# resp = client.create_bucket({
|
1670
1670
|
# bucket: "examplebucket",
|
1671
|
+
# create_bucket_configuration: {
|
1672
|
+
# location_constraint: "eu-west-1",
|
1673
|
+
# },
|
1671
1674
|
# })
|
1672
1675
|
#
|
1673
1676
|
# resp.to_h outputs the following:
|
1674
1677
|
# {
|
1675
|
-
# location: "/
|
1678
|
+
# location: "http://examplebucket.<Region>.s3.amazonaws.com/",
|
1676
1679
|
# }
|
1677
1680
|
#
|
1678
|
-
# @example Example: To create a bucket
|
1681
|
+
# @example Example: To create a bucket
|
1679
1682
|
#
|
1680
|
-
# # The following example creates a bucket.
|
1683
|
+
# # The following example creates a bucket.
|
1681
1684
|
#
|
1682
1685
|
# resp = client.create_bucket({
|
1683
1686
|
# bucket: "examplebucket",
|
1684
|
-
# create_bucket_configuration: {
|
1685
|
-
# location_constraint: "eu-west-1",
|
1686
|
-
# },
|
1687
1687
|
# })
|
1688
1688
|
#
|
1689
1689
|
# resp.to_h outputs the following:
|
1690
1690
|
# {
|
1691
|
-
# location: "
|
1691
|
+
# location: "/examplebucket",
|
1692
1692
|
# }
|
1693
1693
|
#
|
1694
1694
|
# @example Request syntax with placeholder values
|
@@ -1697,7 +1697,7 @@ module Aws::S3
|
|
1697
1697
|
# acl: "private", # accepts private, public-read, public-read-write, authenticated-read
|
1698
1698
|
# bucket: "BucketName", # required
|
1699
1699
|
# create_bucket_configuration: {
|
1700
|
-
# 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
|
1700
|
+
# 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, ap-southeast-3, 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
|
1701
1701
|
# },
|
1702
1702
|
# grant_full_control: "GrantFullControl",
|
1703
1703
|
# grant_read: "GrantRead",
|
@@ -3109,15 +3109,6 @@ module Aws::S3
|
|
3109
3109
|
# * {Types::DeleteObjectOutput#request_charged #request_charged} => String
|
3110
3110
|
#
|
3111
3111
|
#
|
3112
|
-
# @example Example: To delete an object (from a non-versioned bucket)
|
3113
|
-
#
|
3114
|
-
# # The following example deletes an object from a non-versioned bucket.
|
3115
|
-
#
|
3116
|
-
# resp = client.delete_object({
|
3117
|
-
# bucket: "ExampleBucket",
|
3118
|
-
# key: "HappyFace.jpg",
|
3119
|
-
# })
|
3120
|
-
#
|
3121
3112
|
# @example Example: To delete an object
|
3122
3113
|
#
|
3123
3114
|
# # The following example deletes an object from an S3 bucket.
|
@@ -3131,6 +3122,15 @@ module Aws::S3
|
|
3131
3122
|
# {
|
3132
3123
|
# }
|
3133
3124
|
#
|
3125
|
+
# @example Example: To delete an object (from a non-versioned bucket)
|
3126
|
+
#
|
3127
|
+
# # The following example deletes an object from a non-versioned bucket.
|
3128
|
+
#
|
3129
|
+
# resp = client.delete_object({
|
3130
|
+
# bucket: "ExampleBucket",
|
3131
|
+
# key: "HappyFace.jpg",
|
3132
|
+
# })
|
3133
|
+
#
|
3134
3134
|
# @example Request syntax with placeholder values
|
3135
3135
|
#
|
3136
3136
|
# resp = client.delete_object({
|
@@ -3223,35 +3223,35 @@ module Aws::S3
|
|
3223
3223
|
# * {Types::DeleteObjectTaggingOutput#version_id #version_id} => String
|
3224
3224
|
#
|
3225
3225
|
#
|
3226
|
-
# @example Example: To remove tag set from an object
|
3226
|
+
# @example Example: To remove tag set from an object
|
3227
3227
|
#
|
3228
|
-
# # The following example removes tag set associated with the specified object
|
3229
|
-
# #
|
3228
|
+
# # The following example removes tag set associated with the specified object. If the bucket is versioning enabled, the
|
3229
|
+
# # operation removes tag set from the latest object version.
|
3230
3230
|
#
|
3231
3231
|
# resp = client.delete_object_tagging({
|
3232
3232
|
# bucket: "examplebucket",
|
3233
3233
|
# key: "HappyFace.jpg",
|
3234
|
-
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
3235
3234
|
# })
|
3236
3235
|
#
|
3237
3236
|
# resp.to_h outputs the following:
|
3238
3237
|
# {
|
3239
|
-
# version_id: "
|
3238
|
+
# version_id: "null",
|
3240
3239
|
# }
|
3241
3240
|
#
|
3242
|
-
# @example Example: To remove tag set from an object
|
3241
|
+
# @example Example: To remove tag set from an object version
|
3243
3242
|
#
|
3244
|
-
# # The following example removes tag set associated with the specified object.
|
3245
|
-
# #
|
3243
|
+
# # The following example removes tag set associated with the specified object version. The request specifies both the
|
3244
|
+
# # object key and object version.
|
3246
3245
|
#
|
3247
3246
|
# resp = client.delete_object_tagging({
|
3248
3247
|
# bucket: "examplebucket",
|
3249
3248
|
# key: "HappyFace.jpg",
|
3249
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
3250
3250
|
# })
|
3251
3251
|
#
|
3252
3252
|
# resp.to_h outputs the following:
|
3253
3253
|
# {
|
3254
|
-
# version_id: "
|
3254
|
+
# version_id: "ydlaNkwWm0SfKJR.T1b1fIdPRbldTYRI",
|
3255
3255
|
# }
|
3256
3256
|
#
|
3257
3257
|
# @example Request syntax with placeholder values
|
@@ -3410,22 +3410,20 @@ module Aws::S3
|
|
3410
3410
|
# * {Types::DeleteObjectsOutput#errors #errors} => Array<Types::Error>
|
3411
3411
|
#
|
3412
3412
|
#
|
3413
|
-
# @example Example: To delete multiple
|
3413
|
+
# @example Example: To delete multiple objects from a versioned bucket
|
3414
3414
|
#
|
3415
|
-
# # The following example deletes objects from a bucket. The
|
3416
|
-
# #
|
3415
|
+
# # The following example deletes objects from a bucket. The bucket is versioned, and the request does not specify the
|
3416
|
+
# # object version to delete. In this case, all versions remain in the bucket and S3 adds a delete marker.
|
3417
3417
|
#
|
3418
3418
|
# resp = client.delete_objects({
|
3419
3419
|
# bucket: "examplebucket",
|
3420
3420
|
# delete: {
|
3421
3421
|
# objects: [
|
3422
3422
|
# {
|
3423
|
-
# key: "
|
3424
|
-
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
3423
|
+
# key: "objectkey1",
|
3425
3424
|
# },
|
3426
3425
|
# {
|
3427
|
-
# key: "
|
3428
|
-
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
3426
|
+
# key: "objectkey2",
|
3429
3427
|
# },
|
3430
3428
|
# ],
|
3431
3429
|
# quiet: false,
|
@@ -3436,30 +3434,34 @@ module Aws::S3
|
|
3436
3434
|
# {
|
3437
3435
|
# deleted: [
|
3438
3436
|
# {
|
3439
|
-
#
|
3440
|
-
#
|
3437
|
+
# delete_marker: true,
|
3438
|
+
# delete_marker_version_id: "A._w1z6EFiCF5uhtQMDal9JDkID9tQ7F",
|
3439
|
+
# key: "objectkey1",
|
3441
3440
|
# },
|
3442
3441
|
# {
|
3443
|
-
#
|
3444
|
-
#
|
3442
|
+
# delete_marker: true,
|
3443
|
+
# delete_marker_version_id: "iOd_ORxhkKe_e8G8_oSGxt2PjsCZKlkt",
|
3444
|
+
# key: "objectkey2",
|
3445
3445
|
# },
|
3446
3446
|
# ],
|
3447
3447
|
# }
|
3448
3448
|
#
|
3449
|
-
# @example Example: To delete multiple
|
3449
|
+
# @example Example: To delete multiple object versions from a versioned bucket
|
3450
3450
|
#
|
3451
|
-
# # The following example deletes objects from a bucket. The
|
3452
|
-
# #
|
3451
|
+
# # The following example deletes objects from a bucket. The request specifies object versions. S3 deletes specific object
|
3452
|
+
# # versions and returns the key and versions of deleted objects in the response.
|
3453
3453
|
#
|
3454
3454
|
# resp = client.delete_objects({
|
3455
3455
|
# bucket: "examplebucket",
|
3456
3456
|
# delete: {
|
3457
3457
|
# objects: [
|
3458
3458
|
# {
|
3459
|
-
# key: "
|
3459
|
+
# key: "HappyFace.jpg",
|
3460
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
3460
3461
|
# },
|
3461
3462
|
# {
|
3462
|
-
# key: "
|
3463
|
+
# key: "HappyFace.jpg",
|
3464
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
3463
3465
|
# },
|
3464
3466
|
# ],
|
3465
3467
|
# quiet: false,
|
@@ -3470,14 +3472,12 @@ module Aws::S3
|
|
3470
3472
|
# {
|
3471
3473
|
# deleted: [
|
3472
3474
|
# {
|
3473
|
-
#
|
3474
|
-
#
|
3475
|
-
# key: "objectkey1",
|
3475
|
+
# key: "HappyFace.jpg",
|
3476
|
+
# version_id: "yoz3HB.ZhCS_tKVEmIOr7qYyyAaZSKVd",
|
3476
3477
|
# },
|
3477
3478
|
# {
|
3478
|
-
#
|
3479
|
-
#
|
3480
|
-
# key: "objectkey2",
|
3479
|
+
# key: "HappyFace.jpg",
|
3480
|
+
# version_id: "2LWg7lQLnY41.maGB5Z6SWW.dcq0vx7b",
|
3481
3481
|
# },
|
3482
3482
|
# ],
|
3483
3483
|
# }
|
@@ -4418,7 +4418,7 @@ module Aws::S3
|
|
4418
4418
|
#
|
4419
4419
|
# @example Response structure
|
4420
4420
|
#
|
4421
|
-
# 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"
|
4421
|
+
# 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", "ap-southeast-3", "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"
|
4422
4422
|
#
|
4423
4423
|
# @see http://docs.aws.amazon.com/goto/WebAPI/s3-2006-03-01/GetBucketLocation AWS API Documentation
|
4424
4424
|
#
|
@@ -10028,7 +10028,9 @@ module Aws::S3
|
|
10028
10028
|
#
|
10029
10029
|
# You specify the lifecycle configuration in your request body. The
|
10030
10030
|
# lifecycle configuration is specified as XML consisting of one or more
|
10031
|
-
# rules.
|
10031
|
+
# rules. An Amazon S3 Lifecycle configuration can have up to 1,000
|
10032
|
+
# rules. This limit is not adjustable. Each rule consists of the
|
10033
|
+
# following:
|
10032
10034
|
#
|
10033
10035
|
# * Filter identifying a subset of objects to which the rule applies.
|
10034
10036
|
# The filter can be based on a key name prefix, object tags, or a
|
@@ -12179,22 +12181,21 @@ module Aws::S3
|
|
12179
12181
|
# version_id: "psM2sYY4.o1501dSx8wMvnkOzSBB.V4a",
|
12180
12182
|
# }
|
12181
12183
|
#
|
12182
|
-
# @example Example: To upload an object
|
12184
|
+
# @example Example: To upload an object
|
12183
12185
|
#
|
12184
|
-
# # The following example uploads
|
12185
|
-
# #
|
12186
|
+
# # The following example uploads an object to a versioning-enabled bucket. The source file is specified using Windows file
|
12187
|
+
# # syntax. S3 returns VersionId of the newly created object.
|
12186
12188
|
#
|
12187
12189
|
# resp = client.put_object({
|
12188
|
-
#
|
12189
|
-
# body: "filetoupload",
|
12190
|
+
# body: "HappyFace.jpg",
|
12190
12191
|
# bucket: "examplebucket",
|
12191
|
-
# key: "
|
12192
|
+
# key: "HappyFace.jpg",
|
12192
12193
|
# })
|
12193
12194
|
#
|
12194
12195
|
# resp.to_h outputs the following:
|
12195
12196
|
# {
|
12196
12197
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
12197
|
-
# version_id: "
|
12198
|
+
# version_id: "tpf3zF08nBplQK1XLOefGskR7mGDwcDk",
|
12198
12199
|
# }
|
12199
12200
|
#
|
12200
12201
|
# @example Example: To upload an object and specify server-side encryption and object tags
|
@@ -12217,78 +12218,79 @@ module Aws::S3
|
|
12217
12218
|
# version_id: "Ri.vC6qVlA4dEnjgRV4ZHsHoFIjqEMNt",
|
12218
12219
|
# }
|
12219
12220
|
#
|
12220
|
-
# @example Example: To
|
12221
|
+
# @example Example: To upload object and specify user-defined metadata
|
12221
12222
|
#
|
12222
|
-
# # The following example creates an object.
|
12223
|
+
# # The following example creates an object. The request also specifies optional metadata. If the bucket is versioning
|
12224
|
+
# # enabled, S3 returns version ID in response.
|
12223
12225
|
#
|
12224
12226
|
# resp = client.put_object({
|
12225
12227
|
# body: "filetoupload",
|
12226
12228
|
# bucket: "examplebucket",
|
12227
|
-
# key: "
|
12229
|
+
# key: "exampleobject",
|
12230
|
+
# metadata: {
|
12231
|
+
# "metadata1" => "value1",
|
12232
|
+
# "metadata2" => "value2",
|
12233
|
+
# },
|
12228
12234
|
# })
|
12229
12235
|
#
|
12230
12236
|
# resp.to_h outputs the following:
|
12231
12237
|
# {
|
12232
12238
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
12233
|
-
# version_id: "
|
12239
|
+
# version_id: "pSKidl4pHBiNwukdbcPXAIs.sshFFOc0",
|
12234
12240
|
# }
|
12235
12241
|
#
|
12236
|
-
# @example Example: To upload an object
|
12242
|
+
# @example Example: To upload an object (specify optional headers)
|
12237
12243
|
#
|
12238
|
-
# # The following example uploads an object
|
12239
|
-
# #
|
12244
|
+
# # The following example uploads an object. The request specifies optional request headers to directs S3 to use specific
|
12245
|
+
# # storage class and use server-side encryption.
|
12240
12246
|
#
|
12241
12247
|
# resp = client.put_object({
|
12242
12248
|
# body: "HappyFace.jpg",
|
12243
12249
|
# bucket: "examplebucket",
|
12244
12250
|
# key: "HappyFace.jpg",
|
12251
|
+
# server_side_encryption: "AES256",
|
12252
|
+
# storage_class: "STANDARD_IA",
|
12245
12253
|
# })
|
12246
12254
|
#
|
12247
12255
|
# resp.to_h outputs the following:
|
12248
12256
|
# {
|
12249
12257
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
12250
|
-
#
|
12258
|
+
# server_side_encryption: "AES256",
|
12259
|
+
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
12251
12260
|
# }
|
12252
12261
|
#
|
12253
|
-
# @example Example: To upload an object
|
12262
|
+
# @example Example: To upload an object and specify canned ACL.
|
12254
12263
|
#
|
12255
|
-
# # The following example uploads
|
12256
|
-
# #
|
12264
|
+
# # The following example uploads and object. The request specifies optional canned ACL (access control list) to all READ
|
12265
|
+
# # access to authenticated users. If the bucket is versioning enabled, S3 returns version ID in response.
|
12257
12266
|
#
|
12258
12267
|
# resp = client.put_object({
|
12259
|
-
#
|
12268
|
+
# acl: "authenticated-read",
|
12269
|
+
# body: "filetoupload",
|
12260
12270
|
# bucket: "examplebucket",
|
12261
|
-
# key: "
|
12262
|
-
# server_side_encryption: "AES256",
|
12263
|
-
# storage_class: "STANDARD_IA",
|
12271
|
+
# key: "exampleobject",
|
12264
12272
|
# })
|
12265
12273
|
#
|
12266
12274
|
# resp.to_h outputs the following:
|
12267
12275
|
# {
|
12268
12276
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
12269
|
-
#
|
12270
|
-
# version_id: "CG612hodqujkf8FaaNfp8U..FIhLROcp",
|
12277
|
+
# version_id: "Kirh.unyZwjQ69YxcQLA8z4F5j3kJJKr",
|
12271
12278
|
# }
|
12272
12279
|
#
|
12273
|
-
# @example Example: To
|
12280
|
+
# @example Example: To create an object.
|
12274
12281
|
#
|
12275
|
-
# # The following example creates an object.
|
12276
|
-
# # enabled, S3 returns version ID in response.
|
12282
|
+
# # The following example creates an object. If the bucket is versioning enabled, S3 returns version ID in response.
|
12277
12283
|
#
|
12278
12284
|
# resp = client.put_object({
|
12279
12285
|
# body: "filetoupload",
|
12280
12286
|
# bucket: "examplebucket",
|
12281
|
-
# key: "
|
12282
|
-
# metadata: {
|
12283
|
-
# "metadata1" => "value1",
|
12284
|
-
# "metadata2" => "value2",
|
12285
|
-
# },
|
12287
|
+
# key: "objectkey",
|
12286
12288
|
# })
|
12287
12289
|
#
|
12288
12290
|
# resp.to_h outputs the following:
|
12289
12291
|
# {
|
12290
12292
|
# etag: "\"6805f2cfc46c0f04559748bb039d69ae\"",
|
12291
|
-
# version_id: "
|
12293
|
+
# version_id: "Bvq0EDKxOcXLJXNo_Lkz37eM3R4pfzyQ",
|
12292
12294
|
# }
|
12293
12295
|
#
|
12294
12296
|
# @example Streaming a file from disk
|
@@ -14230,9 +14232,11 @@ module Aws::S3
|
|
14230
14232
|
# number uniquely identifies a part and also defines its position within
|
14231
14233
|
# the object being created. If you upload a new part using the same part
|
14232
14234
|
# number that was used with a previous part, the previously uploaded
|
14233
|
-
# part is overwritten.
|
14234
|
-
#
|
14235
|
-
#
|
14235
|
+
# part is overwritten.
|
14236
|
+
#
|
14237
|
+
# For information about maximum and minimum part sizes and other
|
14238
|
+
# multipart upload specifications, see [Multipart upload limits][3] in
|
14239
|
+
# the *Amazon S3 User Guide*.
|
14236
14240
|
#
|
14237
14241
|
# To ensure that data is not corrupted when traversing the network,
|
14238
14242
|
# specify the `Content-MD5` header in the upload part request. Amazon S3
|
@@ -14243,7 +14247,7 @@ module Aws::S3
|
|
14243
14247
|
# Web Services S3 uses the `x-amz-content-sha256` header as a checksum
|
14244
14248
|
# instead of `Content-MD5`. For more information see [Authenticating
|
14245
14249
|
# Requests: Using the Authorization Header (Amazon Web Services
|
14246
|
-
# Signature Version 4)][
|
14250
|
+
# Signature Version 4)][4].
|
14247
14251
|
#
|
14248
14252
|
# **Note:** After you initiate multipart upload and upload one or more
|
14249
14253
|
# parts, you must either complete or abort multipart upload in order to
|
@@ -14252,10 +14256,10 @@ module Aws::S3
|
|
14252
14256
|
# parts storage and stops charging you for the parts storage.
|
14253
14257
|
#
|
14254
14258
|
# For more information on multipart uploads, go to [Multipart Upload
|
14255
|
-
# Overview][
|
14259
|
+
# Overview][5] in the <i>Amazon S3 User Guide </i>.
|
14256
14260
|
#
|
14257
14261
|
# For information on the permissions required to use the multipart
|
14258
|
-
# upload API, go to [Multipart Upload and Permissions][
|
14262
|
+
# upload API, go to [Multipart Upload and Permissions][6] in the *Amazon
|
14259
14263
|
# S3 User Guide*.
|
14260
14264
|
#
|
14261
14265
|
# You can optionally request server-side encryption where Amazon S3
|
@@ -14266,7 +14270,7 @@ module Aws::S3
|
|
14266
14270
|
# encryption key, the request headers you provide in the request must
|
14267
14271
|
# match the headers you used in the request to initiate the upload by
|
14268
14272
|
# using [CreateMultipartUpload][2]. For more information, go to [Using
|
14269
|
-
# Server-Side Encryption][
|
14273
|
+
# Server-Side Encryption][7] in the *Amazon S3 User Guide*.
|
14270
14274
|
#
|
14271
14275
|
# Server-side encryption is supported by the S3 Multipart Upload
|
14272
14276
|
# actions. Unless you are using a customer-provided encryption key, you
|
@@ -14302,26 +14306,27 @@ module Aws::S3
|
|
14302
14306
|
#
|
14303
14307
|
# * [CreateMultipartUpload][2]
|
14304
14308
|
#
|
14305
|
-
# * [CompleteMultipartUpload][
|
14309
|
+
# * [CompleteMultipartUpload][8]
|
14306
14310
|
#
|
14307
|
-
# * [AbortMultipartUpload][
|
14311
|
+
# * [AbortMultipartUpload][9]
|
14308
14312
|
#
|
14309
|
-
# * [ListParts][
|
14313
|
+
# * [ListParts][10]
|
14310
14314
|
#
|
14311
|
-
# * [ListMultipartUploads][
|
14315
|
+
# * [ListMultipartUploads][11]
|
14312
14316
|
#
|
14313
14317
|
#
|
14314
14318
|
#
|
14315
14319
|
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPartCopy.html
|
14316
14320
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateMultipartUpload.html
|
14317
|
-
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14318
|
-
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14319
|
-
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
14320
|
-
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/
|
14321
|
-
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14322
|
-
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
14323
|
-
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
14324
|
-
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/
|
14321
|
+
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
|
14322
|
+
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-auth-using-authorization-header.html
|
14323
|
+
# [5]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuoverview.html
|
14324
|
+
# [6]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
14325
|
+
# [7]: https://docs.aws.amazon.com/AmazonS3/latest/dev/UsingServerSideEncryption.html
|
14326
|
+
# [8]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_CompleteMultipartUpload.html
|
14327
|
+
# [9]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_AbortMultipartUpload.html
|
14328
|
+
# [10]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListParts.html
|
14329
|
+
# [11]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_ListMultipartUploads.html
|
14325
14330
|
#
|
14326
14331
|
# @option params [String, StringIO, File] :body
|
14327
14332
|
# Object data.
|
@@ -14551,9 +14556,9 @@ module Aws::S3
|
|
14551
14556
|
# `x-amz-copy-source` in your request and a byte range by adding the
|
14552
14557
|
# request header `x-amz-copy-source-range` in your request.
|
14553
14558
|
#
|
14554
|
-
#
|
14555
|
-
#
|
14556
|
-
#
|
14559
|
+
# For information about maximum and minimum part sizes and other
|
14560
|
+
# multipart upload specifications, see [Multipart upload limits][1] in
|
14561
|
+
# the *Amazon S3 User Guide*.
|
14557
14562
|
#
|
14558
14563
|
# <note markdown="1"> Instead of using an existing object as part data, you might use the
|
14559
14564
|
# [UploadPart][2] action and provide data in your request.
|
@@ -14664,7 +14669,7 @@ module Aws::S3
|
|
14664
14669
|
#
|
14665
14670
|
#
|
14666
14671
|
#
|
14667
|
-
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/
|
14672
|
+
# [1]: https://docs.aws.amazon.com/AmazonS3/latest/userguide/qfacts.html
|
14668
14673
|
# [2]: https://docs.aws.amazon.com/AmazonS3/latest/API/API_UploadPart.html
|
14669
14674
|
# [3]: https://docs.aws.amazon.com/AmazonS3/latest/dev/uploadobjusingmpu.html
|
14670
14675
|
# [4]: https://docs.aws.amazon.com/AmazonS3/latest/dev/mpuAndPermissions.html
|
@@ -14844,45 +14849,45 @@ module Aws::S3
|
|
14844
14849
|
# * {Types::UploadPartCopyOutput#request_charged #request_charged} => String
|
14845
14850
|
#
|
14846
14851
|
#
|
14847
|
-
# @example Example: To upload a part by copying
|
14852
|
+
# @example Example: To upload a part by copying byte range from an existing object as data source
|
14848
14853
|
#
|
14849
|
-
# # The following example uploads a part of a multipart upload by copying
|
14854
|
+
# # The following example uploads a part of a multipart upload by copying a specified byte range from an existing object as
|
14855
|
+
# # data source.
|
14850
14856
|
#
|
14851
14857
|
# resp = client.upload_part_copy({
|
14852
14858
|
# bucket: "examplebucket",
|
14853
14859
|
# copy_source: "/bucketname/sourceobjectkey",
|
14860
|
+
# copy_source_range: "bytes=1-100000",
|
14854
14861
|
# key: "examplelargeobject",
|
14855
|
-
# part_number:
|
14862
|
+
# part_number: 2,
|
14856
14863
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
14857
14864
|
# })
|
14858
14865
|
#
|
14859
14866
|
# resp.to_h outputs the following:
|
14860
14867
|
# {
|
14861
14868
|
# copy_part_result: {
|
14862
|
-
# etag: "\"
|
14863
|
-
# last_modified: Time.parse("2016-12-29T21:
|
14869
|
+
# etag: "\"65d16d19e65a7508a51f043180edcc36\"",
|
14870
|
+
# last_modified: Time.parse("2016-12-29T21:44:28.000Z"),
|
14864
14871
|
# },
|
14865
14872
|
# }
|
14866
14873
|
#
|
14867
|
-
# @example Example: To upload a part by copying
|
14874
|
+
# @example Example: To upload a part by copying data from an existing object as data source
|
14868
14875
|
#
|
14869
|
-
# # The following example uploads a part of a multipart upload by copying
|
14870
|
-
# # data source.
|
14876
|
+
# # The following example uploads a part of a multipart upload by copying data from an existing object as data source.
|
14871
14877
|
#
|
14872
14878
|
# resp = client.upload_part_copy({
|
14873
14879
|
# bucket: "examplebucket",
|
14874
14880
|
# copy_source: "/bucketname/sourceobjectkey",
|
14875
|
-
# copy_source_range: "bytes=1-100000",
|
14876
14881
|
# key: "examplelargeobject",
|
14877
|
-
# part_number:
|
14882
|
+
# part_number: 1,
|
14878
14883
|
# upload_id: "exampleuoh_10OhKhT7YukE9bjzTPRiuaCotmZM_pFngJFir9OZNrSr5cWa3cq3LZSUsfjI4FI7PkP91We7Nrw--",
|
14879
14884
|
# })
|
14880
14885
|
#
|
14881
14886
|
# resp.to_h outputs the following:
|
14882
14887
|
# {
|
14883
14888
|
# copy_part_result: {
|
14884
|
-
# etag: "\"
|
14885
|
-
# last_modified: Time.parse("2016-12-29T21:
|
14889
|
+
# etag: "\"b0c6f0e7e054ab8fa2536a2677f8734d\"",
|
14890
|
+
# last_modified: Time.parse("2016-12-29T21:24:43.000Z"),
|
14886
14891
|
# },
|
14887
14892
|
# }
|
14888
14893
|
#
|
@@ -15332,7 +15337,7 @@ module Aws::S3
|
|
15332
15337
|
params: params,
|
15333
15338
|
config: config)
|
15334
15339
|
context[:gem_name] = 'aws-sdk-s3'
|
15335
|
-
context[:gem_version] = '1.
|
15340
|
+
context[:gem_version] = '1.115.0'
|
15336
15341
|
Seahorse::Client::Request.new(handlers, context)
|
15337
15342
|
end
|
15338
15343
|
|