aws-sdk-s3 1.113.2 → 1.115.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- 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
|
|