@aws-sdk/client-s3 3.454.0 → 3.458.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.
Files changed (56) hide show
  1. package/README.md +93 -93
  2. package/dist-cjs/commands/AbortMultipartUploadCommand.js +1 -0
  3. package/dist-cjs/commands/CompleteMultipartUploadCommand.js +1 -0
  4. package/dist-cjs/commands/CreateMultipartUploadCommand.js +1 -0
  5. package/dist-cjs/commands/DeleteObjectCommand.js +1 -0
  6. package/dist-cjs/commands/GetObjectAclCommand.js +1 -0
  7. package/dist-cjs/commands/GetObjectCommand.js +1 -0
  8. package/dist-cjs/commands/HeadObjectCommand.js +1 -0
  9. package/dist-cjs/commands/ListMultipartUploadsCommand.js +1 -0
  10. package/dist-cjs/commands/ListObjectVersionsCommand.js +1 -0
  11. package/dist-cjs/commands/ListObjectsCommand.js +1 -0
  12. package/dist-cjs/commands/ListObjectsV2Command.js +1 -0
  13. package/dist-cjs/commands/ListPartsCommand.js +1 -0
  14. package/dist-cjs/commands/PutObjectAclCommand.js +1 -0
  15. package/dist-cjs/commands/PutObjectCommand.js +1 -0
  16. package/dist-cjs/commands/UploadPartCommand.js +1 -0
  17. package/dist-cjs/endpoint/ruleset.js +1 -1
  18. package/dist-cjs/models/models_0.js +6 -2
  19. package/dist-cjs/protocols/Aws_restXml.js +52 -0
  20. package/dist-es/commands/AbortMultipartUploadCommand.js +1 -0
  21. package/dist-es/commands/CompleteMultipartUploadCommand.js +1 -0
  22. package/dist-es/commands/CreateMultipartUploadCommand.js +1 -0
  23. package/dist-es/commands/DeleteObjectCommand.js +1 -0
  24. package/dist-es/commands/GetObjectAclCommand.js +1 -0
  25. package/dist-es/commands/GetObjectCommand.js +1 -0
  26. package/dist-es/commands/HeadObjectCommand.js +1 -0
  27. package/dist-es/commands/ListMultipartUploadsCommand.js +1 -0
  28. package/dist-es/commands/ListObjectVersionsCommand.js +1 -0
  29. package/dist-es/commands/ListObjectsCommand.js +1 -0
  30. package/dist-es/commands/ListObjectsV2Command.js +1 -0
  31. package/dist-es/commands/ListPartsCommand.js +1 -0
  32. package/dist-es/commands/PutObjectAclCommand.js +1 -0
  33. package/dist-es/commands/PutObjectCommand.js +1 -0
  34. package/dist-es/commands/UploadPartCommand.js +1 -0
  35. package/dist-es/endpoint/ruleset.js +1 -1
  36. package/dist-es/models/models_0.js +4 -0
  37. package/dist-es/protocols/Aws_restXml.js +52 -0
  38. package/dist-types/commands/DeleteObjectsCommand.d.ts +22 -22
  39. package/dist-types/commands/GetBucketLoggingCommand.d.ts +6 -0
  40. package/dist-types/commands/GetObjectCommand.d.ts +5 -4
  41. package/dist-types/commands/HeadObjectCommand.d.ts +14 -3
  42. package/dist-types/commands/ListObjectVersionsCommand.d.ts +0 -1
  43. package/dist-types/commands/PutBucketLoggingCommand.d.ts +6 -0
  44. package/dist-types/commands/PutObjectAclCommand.d.ts +1 -1
  45. package/dist-types/commands/PutObjectCommand.d.ts +41 -41
  46. package/dist-types/commands/PutObjectLegalHoldCommand.d.ts +1 -1
  47. package/dist-types/commands/PutObjectLockConfigurationCommand.d.ts +3 -2
  48. package/dist-types/endpoint/EndpointParameters.d.ts +2 -0
  49. package/dist-types/models/models_0.d.ts +77 -204
  50. package/dist-types/models/models_1.d.ts +189 -1
  51. package/dist-types/ts3.4/commands/PutObjectAclCommand.d.ts +1 -1
  52. package/dist-types/ts3.4/commands/PutObjectLegalHoldCommand.d.ts +1 -1
  53. package/dist-types/ts3.4/endpoint/EndpointParameters.d.ts +2 -0
  54. package/dist-types/ts3.4/models/models_0.d.ts +15 -32
  55. package/dist-types/ts3.4/models/models_1.d.ts +34 -0
  56. package/package.json +3 -3
@@ -570,10 +570,10 @@ export interface CompleteMultipartUploadRequest {
570
570
  ExpectedBucketOwner?: string;
571
571
  /**
572
572
  * @public
573
- * <p>The server-side encryption (SSE) algorithm used to encrypt the object. This parameter is needed only when the object was created
574
- * using a checksum algorithm. For more information,
575
- * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ServerSideEncryptionCustomerKeys.html">Protecting data using SSE-C keys</a> in the
576
- * <i>Amazon S3 User Guide</i>.</p>
573
+ * <p>The server-side encryption (SSE) algorithm used to encrypt the object. This parameter is
574
+ * required only when the object was created using a checksum algorithm or if
575
+ * your bucket policy requires the use of SSE-C. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerSideEncryptionCustomerKeys.html#ssec-require-condition-key">Protecting data
576
+ * using SSE-C keys</a> in the <i>Amazon S3 User Guide</i>.</p>
577
577
  */
578
578
  SSECustomerAlgorithm?: string;
579
579
  /**
@@ -1022,7 +1022,8 @@ export interface CopyObjectRequest {
1022
1022
  * @public
1023
1023
  * <p>Specifies the Amazon Web Services KMS Encryption Context to use for object encryption. The value of
1024
1024
  * this header is a base64-encoded UTF-8 string holding JSON with the encryption context
1025
- * key-value pairs.</p>
1025
+ * key-value pairs. This value must be explicitly added to specify encryption context for
1026
+ * CopyObject requests.</p>
1026
1027
  */
1027
1028
  SSEKMSEncryptionContext?: string;
1028
1029
  /**
@@ -5093,9 +5094,10 @@ export interface NoncurrentVersionExpiration {
5093
5094
  NoncurrentDays?: number;
5094
5095
  /**
5095
5096
  * @public
5096
- * <p>Specifies how many noncurrent versions Amazon S3 will retain. If there are this many more
5097
- * recent noncurrent versions, Amazon S3 will take the associated action. For more information
5098
- * about noncurrent versions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html">Lifecycle configuration
5097
+ * <p>Specifies how many newer noncurrent versions must exist before Amazon S3 can perform the
5098
+ * associated action on a given version. If there are this many more recent noncurrent
5099
+ * versions, Amazon S3 will take the associated action. For more information about noncurrent
5100
+ * versions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html">Lifecycle configuration
5099
5101
  * elements</a> in the <i>Amazon S3 User Guide</i>.</p>
5100
5102
  */
5101
5103
  NewerNoncurrentVersions?: number;
@@ -5143,9 +5145,10 @@ export interface NoncurrentVersionTransition {
5143
5145
  StorageClass?: TransitionStorageClass;
5144
5146
  /**
5145
5147
  * @public
5146
- * <p>Specifies how many noncurrent versions Amazon S3 will retain. If there are this many more
5147
- * recent noncurrent versions, Amazon S3 will take the associated action. For more information
5148
- * about noncurrent versions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html">Lifecycle configuration
5148
+ * <p>Specifies how many newer noncurrent versions must exist before Amazon S3 can perform the
5149
+ * associated action on a given version. If there are this many more recent noncurrent
5150
+ * versions, Amazon S3 will take the associated action. For more information about noncurrent
5151
+ * versions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/intro-lifecycle-rules.html">Lifecycle configuration
5149
5152
  * elements</a> in the <i>Amazon S3 User Guide</i>.</p>
5150
5153
  */
5151
5154
  NewerNoncurrentVersions?: number;
@@ -5356,6 +5359,58 @@ export interface TargetGrant {
5356
5359
  */
5357
5360
  Permission?: BucketLogsPermission;
5358
5361
  }
5362
+ /**
5363
+ * @public
5364
+ * @enum
5365
+ */
5366
+ export declare const PartitionDateSource: {
5367
+ readonly DeliveryTime: "DeliveryTime";
5368
+ readonly EventTime: "EventTime";
5369
+ };
5370
+ /**
5371
+ * @public
5372
+ */
5373
+ export type PartitionDateSource = (typeof PartitionDateSource)[keyof typeof PartitionDateSource];
5374
+ /**
5375
+ * @public
5376
+ * <p>Amazon S3 keys for log objects are partitioned in the following format:</p>
5377
+ * <p>
5378
+ * <code>[DestinationPrefix][SourceAccountId]/[SourceRegion]/[SourceBucket]/[YYYY]/[MM]/[DD]/[YYYY]-[MM]-[DD]-[hh]-[mm]-[ss]-[UniqueString]</code>
5379
+ * </p>
5380
+ * <p>PartitionedPrefix defaults to EventTime delivery when server access logs are delivered.</p>
5381
+ */
5382
+ export interface PartitionedPrefix {
5383
+ /**
5384
+ * @public
5385
+ * <p>Specifies the partition date source for the partitioned prefix. PartitionDateSource can be EventTime or DeliveryTime.</p>
5386
+ */
5387
+ PartitionDateSource?: PartitionDateSource;
5388
+ }
5389
+ /**
5390
+ * @public
5391
+ * <p>To use simple format for S3 keys for log objects, set SimplePrefix to an empty object.</p>
5392
+ * <p>
5393
+ * <code>[DestinationPrefix][YYYY]-[MM]-[DD]-[hh]-[mm]-[ss]-[UniqueString]</code>
5394
+ * </p>
5395
+ */
5396
+ export interface SimplePrefix {
5397
+ }
5398
+ /**
5399
+ * @public
5400
+ * <p>Amazon S3 key format for log objects. Only one format, PartitionedPrefix or SimplePrefix, is allowed.</p>
5401
+ */
5402
+ export interface TargetObjectKeyFormat {
5403
+ /**
5404
+ * @public
5405
+ * <p>To use the simple format for S3 keys for log objects. To specify SimplePrefix format, set SimplePrefix to \{\}.</p>
5406
+ */
5407
+ SimplePrefix?: SimplePrefix;
5408
+ /**
5409
+ * @public
5410
+ * <p>Partitioned S3 key for log objects.</p>
5411
+ */
5412
+ PartitionedPrefix?: PartitionedPrefix;
5413
+ }
5359
5414
  /**
5360
5415
  * @public
5361
5416
  * <p>Describes where logs are stored and the prefix that Amazon S3 assigns to all log object keys
@@ -5387,6 +5442,11 @@ export interface LoggingEnabled {
5387
5442
  * bucket.</p>
5388
5443
  */
5389
5444
  TargetPrefix: string | undefined;
5445
+ /**
5446
+ * @public
5447
+ * <p>Amazon S3 key format for log objects.</p>
5448
+ */
5449
+ TargetObjectKeyFormat?: TargetObjectKeyFormat;
5390
5450
  }
5391
5451
  /**
5392
5452
  * @public
@@ -6900,7 +6960,7 @@ export interface GetObjectOutput {
6900
6960
  Restore?: string;
6901
6961
  /**
6902
6962
  * @public
6903
- * <p>Creation date of the object.</p>
6963
+ * <p>Date and time when the object was last modified.</p>
6904
6964
  */
6905
6965
  LastModified?: Date;
6906
6966
  /**
@@ -8125,7 +8185,7 @@ export interface HeadObjectOutput {
8125
8185
  ArchiveStatus?: ArchiveStatus;
8126
8186
  /**
8127
8187
  * @public
8128
- * <p>Creation date of the object.</p>
8188
+ * <p>Date and time when the object was last modified.</p>
8129
8189
  */
8130
8190
  LastModified?: Date;
8131
8191
  /**
@@ -9472,7 +9532,7 @@ export interface DeleteMarkerEntry {
9472
9532
  IsLatest?: boolean;
9473
9533
  /**
9474
9534
  * @public
9475
- * <p>Date and time the object was last modified.</p>
9535
+ * <p>Date and time when the object was last modified.</p>
9476
9536
  */
9477
9537
  LastModified?: Date;
9478
9538
  }
@@ -9530,7 +9590,7 @@ export interface ObjectVersion {
9530
9590
  IsLatest?: boolean;
9531
9591
  /**
9532
9592
  * @public
9533
- * <p>Date and time the object was last modified.</p>
9593
+ * <p>Date and time when the object was last modified.</p>
9534
9594
  */
9535
9595
  LastModified?: Date;
9536
9596
  /**
@@ -11110,7 +11170,8 @@ export interface PutObjectRequest {
11110
11170
  * this header is a base64-encoded UTF-8 string holding JSON with the encryption context
11111
11171
  * key-value pairs. This value is stored as object metadata and automatically gets passed on
11112
11172
  * to Amazon Web Services KMS for future <code>GetObject</code> or <code>CopyObject</code> operations on
11113
- * this object.</p>
11173
+ * this object. This value must be explicitly added during CopyObject
11174
+ * operations.</p>
11114
11175
  */
11115
11176
  SSEKMSEncryptionContext?: string;
11116
11177
  /**
@@ -11162,194 +11223,6 @@ export interface PutObjectRequest {
11162
11223
  */
11163
11224
  ExpectedBucketOwner?: string;
11164
11225
  }
11165
- /**
11166
- * @public
11167
- */
11168
- export interface PutObjectAclOutput {
11169
- /**
11170
- * @public
11171
- * <p>If present, indicates that the requester was successfully charged for the
11172
- * request.</p>
11173
- */
11174
- RequestCharged?: RequestCharged;
11175
- }
11176
- /**
11177
- * @public
11178
- */
11179
- export interface PutObjectAclRequest {
11180
- /**
11181
- * @public
11182
- * <p>The canned ACL to apply to the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned
11183
- * ACL</a>.</p>
11184
- */
11185
- ACL?: ObjectCannedACL;
11186
- /**
11187
- * @public
11188
- * <p>Contains the elements that set the ACL permissions for an object per grantee.</p>
11189
- */
11190
- AccessControlPolicy?: AccessControlPolicy;
11191
- /**
11192
- * @public
11193
- * <p>The bucket name that contains the object to which you want to attach the ACL. </p>
11194
- * <p>When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p>
11195
- * <p>Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "@aws-sdk/signature-v4-crt" package to your project dependencies.
11196
- * For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues</p>
11197
- */
11198
- Bucket: string | undefined;
11199
- /**
11200
- * @public
11201
- * <p>The base64-encoded 128-bit MD5 digest of the data. This header must be used as a message
11202
- * integrity check to verify that the request body was not corrupted in transit. For more
11203
- * information, go to <a href="http://www.ietf.org/rfc/rfc1864.txt">RFC
11204
- * 1864.></a>
11205
- * </p>
11206
- * <p>For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.</p>
11207
- */
11208
- ContentMD5?: string;
11209
- /**
11210
- * @public
11211
- * <p>Indicates the algorithm used to create the checksum for the object when using the SDK. This header will not provide any
11212
- * additional functionality if not using the SDK. When sending this header, there must be a corresponding <code>x-amz-checksum</code> or
11213
- * <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more
11214
- * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in
11215
- * the <i>Amazon S3 User Guide</i>.</p>
11216
- * <p>If you provide an individual checksum, Amazon S3 ignores any provided
11217
- * <code>ChecksumAlgorithm</code> parameter.</p>
11218
- */
11219
- ChecksumAlgorithm?: ChecksumAlgorithm;
11220
- /**
11221
- * @public
11222
- * <p>Allows grantee the read, write, read ACP, and write ACP permissions on the
11223
- * bucket.</p>
11224
- * <p>This action is not supported by Amazon S3 on Outposts.</p>
11225
- */
11226
- GrantFullControl?: string;
11227
- /**
11228
- * @public
11229
- * <p>Allows grantee to list the objects in the bucket.</p>
11230
- * <p>This action is not supported by Amazon S3 on Outposts.</p>
11231
- */
11232
- GrantRead?: string;
11233
- /**
11234
- * @public
11235
- * <p>Allows grantee to read the bucket ACL.</p>
11236
- * <p>This action is not supported by Amazon S3 on Outposts.</p>
11237
- */
11238
- GrantReadACP?: string;
11239
- /**
11240
- * @public
11241
- * <p>Allows grantee to create new objects in the bucket.</p>
11242
- * <p>For the bucket and object owners of existing objects, also allows deletions and
11243
- * overwrites of those objects.</p>
11244
- */
11245
- GrantWrite?: string;
11246
- /**
11247
- * @public
11248
- * <p>Allows grantee to write the ACL for the applicable bucket.</p>
11249
- * <p>This action is not supported by Amazon S3 on Outposts.</p>
11250
- */
11251
- GrantWriteACP?: string;
11252
- /**
11253
- * @public
11254
- * <p>Key for which the PUT action was initiated.</p>
11255
- * <p>When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p>
11256
- * <p>When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code>
11257
- * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
11258
- */
11259
- Key: string | undefined;
11260
- /**
11261
- * @public
11262
- * <p>Confirms that the requester knows that they will be charged for the request. Bucket
11263
- * owners need not specify this parameter in their requests. If either the source or
11264
- * destination Amazon S3 bucket has Requester Pays enabled, the requester will pay for
11265
- * corresponding charges to copy the object. For information about downloading objects from
11266
- * Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in
11267
- * Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p>
11268
- */
11269
- RequestPayer?: RequestPayer;
11270
- /**
11271
- * @public
11272
- * <p>VersionId used to reference a specific version of the object.</p>
11273
- */
11274
- VersionId?: string;
11275
- /**
11276
- * @public
11277
- * <p>The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
11278
- */
11279
- ExpectedBucketOwner?: string;
11280
- }
11281
- /**
11282
- * @public
11283
- */
11284
- export interface PutObjectLegalHoldOutput {
11285
- /**
11286
- * @public
11287
- * <p>If present, indicates that the requester was successfully charged for the
11288
- * request.</p>
11289
- */
11290
- RequestCharged?: RequestCharged;
11291
- }
11292
- /**
11293
- * @public
11294
- */
11295
- export interface PutObjectLegalHoldRequest {
11296
- /**
11297
- * @public
11298
- * <p>The bucket name containing the object that you want to place a legal hold on. </p>
11299
- * <p>When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p>
11300
- * <p>Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "@aws-sdk/signature-v4-crt" package to your project dependencies.
11301
- * For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues</p>
11302
- */
11303
- Bucket: string | undefined;
11304
- /**
11305
- * @public
11306
- * <p>The key name for the object that you want to place a legal hold on.</p>
11307
- */
11308
- Key: string | undefined;
11309
- /**
11310
- * @public
11311
- * <p>Container element for the legal hold configuration you want to apply to the specified
11312
- * object.</p>
11313
- */
11314
- LegalHold?: ObjectLockLegalHold;
11315
- /**
11316
- * @public
11317
- * <p>Confirms that the requester knows that they will be charged for the request. Bucket
11318
- * owners need not specify this parameter in their requests. If either the source or
11319
- * destination Amazon S3 bucket has Requester Pays enabled, the requester will pay for
11320
- * corresponding charges to copy the object. For information about downloading objects from
11321
- * Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in
11322
- * Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p>
11323
- */
11324
- RequestPayer?: RequestPayer;
11325
- /**
11326
- * @public
11327
- * <p>The version ID of the object that you want to place a legal hold on.</p>
11328
- */
11329
- VersionId?: string;
11330
- /**
11331
- * @public
11332
- * <p>The MD5 hash for the request body.</p>
11333
- * <p>For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.</p>
11334
- */
11335
- ContentMD5?: string;
11336
- /**
11337
- * @public
11338
- * <p>Indicates the algorithm used to create the checksum for the object when using the SDK. This header will not provide any
11339
- * additional functionality if not using the SDK. When sending this header, there must be a corresponding <code>x-amz-checksum</code> or
11340
- * <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more
11341
- * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in
11342
- * the <i>Amazon S3 User Guide</i>.</p>
11343
- * <p>If you provide an individual checksum, Amazon S3 ignores any provided
11344
- * <code>ChecksumAlgorithm</code> parameter.</p>
11345
- */
11346
- ChecksumAlgorithm?: ChecksumAlgorithm;
11347
- /**
11348
- * @public
11349
- * <p>The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
11350
- */
11351
- ExpectedBucketOwner?: string;
11352
- }
11353
11226
  /**
11354
11227
  * @internal
11355
11228
  */
@@ -1,7 +1,195 @@
1
1
  import { ExceptionOptionType as __ExceptionOptionType } from "@smithy/smithy-client";
2
2
  import { StreamingBlobTypes } from "@smithy/types";
3
- import { ChecksumAlgorithm, Grant, ObjectCannedACL, ObjectLockConfiguration, ObjectLockLegalHoldStatus, ObjectLockMode, ObjectLockRetention, PublicAccessBlockConfiguration, ReplicationStatus, RequestCharged, RequestPayer, ServerSideEncryption, StorageClass, Tagging } from "./models_0";
3
+ import { AccessControlPolicy, ChecksumAlgorithm, Grant, ObjectCannedACL, ObjectLockConfiguration, ObjectLockLegalHold, ObjectLockLegalHoldStatus, ObjectLockMode, ObjectLockRetention, PublicAccessBlockConfiguration, ReplicationStatus, RequestCharged, RequestPayer, ServerSideEncryption, StorageClass, Tagging } from "./models_0";
4
4
  import { S3ServiceException as __BaseException } from "./S3ServiceException";
5
+ /**
6
+ * @public
7
+ */
8
+ export interface PutObjectAclOutput {
9
+ /**
10
+ * @public
11
+ * <p>If present, indicates that the requester was successfully charged for the
12
+ * request.</p>
13
+ */
14
+ RequestCharged?: RequestCharged;
15
+ }
16
+ /**
17
+ * @public
18
+ */
19
+ export interface PutObjectAclRequest {
20
+ /**
21
+ * @public
22
+ * <p>The canned ACL to apply to the object. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned
23
+ * ACL</a>.</p>
24
+ */
25
+ ACL?: ObjectCannedACL;
26
+ /**
27
+ * @public
28
+ * <p>Contains the elements that set the ACL permissions for an object per grantee.</p>
29
+ */
30
+ AccessControlPolicy?: AccessControlPolicy;
31
+ /**
32
+ * @public
33
+ * <p>The bucket name that contains the object to which you want to attach the ACL. </p>
34
+ * <p>When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p>
35
+ * <p>Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "@aws-sdk/signature-v4-crt" package to your project dependencies.
36
+ * For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues</p>
37
+ */
38
+ Bucket: string | undefined;
39
+ /**
40
+ * @public
41
+ * <p>The base64-encoded 128-bit MD5 digest of the data. This header must be used as a message
42
+ * integrity check to verify that the request body was not corrupted in transit. For more
43
+ * information, go to <a href="http://www.ietf.org/rfc/rfc1864.txt">RFC
44
+ * 1864.></a>
45
+ * </p>
46
+ * <p>For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.</p>
47
+ */
48
+ ContentMD5?: string;
49
+ /**
50
+ * @public
51
+ * <p>Indicates the algorithm used to create the checksum for the object when using the SDK. This header will not provide any
52
+ * additional functionality if not using the SDK. When sending this header, there must be a corresponding <code>x-amz-checksum</code> or
53
+ * <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more
54
+ * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in
55
+ * the <i>Amazon S3 User Guide</i>.</p>
56
+ * <p>If you provide an individual checksum, Amazon S3 ignores any provided
57
+ * <code>ChecksumAlgorithm</code> parameter.</p>
58
+ */
59
+ ChecksumAlgorithm?: ChecksumAlgorithm;
60
+ /**
61
+ * @public
62
+ * <p>Allows grantee the read, write, read ACP, and write ACP permissions on the
63
+ * bucket.</p>
64
+ * <p>This action is not supported by Amazon S3 on Outposts.</p>
65
+ */
66
+ GrantFullControl?: string;
67
+ /**
68
+ * @public
69
+ * <p>Allows grantee to list the objects in the bucket.</p>
70
+ * <p>This action is not supported by Amazon S3 on Outposts.</p>
71
+ */
72
+ GrantRead?: string;
73
+ /**
74
+ * @public
75
+ * <p>Allows grantee to read the bucket ACL.</p>
76
+ * <p>This action is not supported by Amazon S3 on Outposts.</p>
77
+ */
78
+ GrantReadACP?: string;
79
+ /**
80
+ * @public
81
+ * <p>Allows grantee to create new objects in the bucket.</p>
82
+ * <p>For the bucket and object owners of existing objects, also allows deletions and
83
+ * overwrites of those objects.</p>
84
+ */
85
+ GrantWrite?: string;
86
+ /**
87
+ * @public
88
+ * <p>Allows grantee to write the ACL for the applicable bucket.</p>
89
+ * <p>This action is not supported by Amazon S3 on Outposts.</p>
90
+ */
91
+ GrantWriteACP?: string;
92
+ /**
93
+ * @public
94
+ * <p>Key for which the PUT action was initiated.</p>
95
+ * <p>When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p>
96
+ * <p>When you use this action with Amazon S3 on Outposts, you must direct requests to the S3 on Outposts hostname. The S3 on Outposts hostname takes the form <code>
97
+ * <i>AccessPointName</i>-<i>AccountId</i>.<i>outpostID</i>.s3-outposts.<i>Region</i>.amazonaws.com</code>. When you use this action with S3 on Outposts through the Amazon Web Services SDKs, you provide the Outposts access point ARN in place of the bucket name. For more information about S3 on Outposts ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/S3onOutposts.html">What is S3 on Outposts?</a> in the <i>Amazon S3 User Guide</i>.</p>
98
+ */
99
+ Key: string | undefined;
100
+ /**
101
+ * @public
102
+ * <p>Confirms that the requester knows that they will be charged for the request. Bucket
103
+ * owners need not specify this parameter in their requests. If either the source or
104
+ * destination Amazon S3 bucket has Requester Pays enabled, the requester will pay for
105
+ * corresponding charges to copy the object. For information about downloading objects from
106
+ * Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in
107
+ * Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p>
108
+ */
109
+ RequestPayer?: RequestPayer;
110
+ /**
111
+ * @public
112
+ * <p>VersionId used to reference a specific version of the object.</p>
113
+ */
114
+ VersionId?: string;
115
+ /**
116
+ * @public
117
+ * <p>The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
118
+ */
119
+ ExpectedBucketOwner?: string;
120
+ }
121
+ /**
122
+ * @public
123
+ */
124
+ export interface PutObjectLegalHoldOutput {
125
+ /**
126
+ * @public
127
+ * <p>If present, indicates that the requester was successfully charged for the
128
+ * request.</p>
129
+ */
130
+ RequestCharged?: RequestCharged;
131
+ }
132
+ /**
133
+ * @public
134
+ */
135
+ export interface PutObjectLegalHoldRequest {
136
+ /**
137
+ * @public
138
+ * <p>The bucket name containing the object that you want to place a legal hold on. </p>
139
+ * <p>When using this action with an access point, you must direct requests to the access point hostname. The access point hostname takes the form <i>AccessPointName</i>-<i>AccountId</i>.s3-accesspoint.<i>Region</i>.amazonaws.com. When using this action with an access point through the Amazon Web Services SDKs, you provide the access point ARN in place of the bucket name. For more information about access point ARNs, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-access-points.html">Using access points</a> in the <i>Amazon S3 User Guide</i>.</p>
140
+ * <p>Note: To supply the Multi-region Access Point (MRAP) to Bucket, you need to install the "@aws-sdk/signature-v4-crt" package to your project dependencies.
141
+ * For more information, please go to https://github.com/aws/aws-sdk-js-v3#known-issues</p>
142
+ */
143
+ Bucket: string | undefined;
144
+ /**
145
+ * @public
146
+ * <p>The key name for the object that you want to place a legal hold on.</p>
147
+ */
148
+ Key: string | undefined;
149
+ /**
150
+ * @public
151
+ * <p>Container element for the legal hold configuration you want to apply to the specified
152
+ * object.</p>
153
+ */
154
+ LegalHold?: ObjectLockLegalHold;
155
+ /**
156
+ * @public
157
+ * <p>Confirms that the requester knows that they will be charged for the request. Bucket
158
+ * owners need not specify this parameter in their requests. If either the source or
159
+ * destination Amazon S3 bucket has Requester Pays enabled, the requester will pay for
160
+ * corresponding charges to copy the object. For information about downloading objects from
161
+ * Requester Pays buckets, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/ObjectsinRequesterPaysBuckets.html">Downloading Objects in
162
+ * Requester Pays Buckets</a> in the <i>Amazon S3 User Guide</i>.</p>
163
+ */
164
+ RequestPayer?: RequestPayer;
165
+ /**
166
+ * @public
167
+ * <p>The version ID of the object that you want to place a legal hold on.</p>
168
+ */
169
+ VersionId?: string;
170
+ /**
171
+ * @public
172
+ * <p>The MD5 hash for the request body.</p>
173
+ * <p>For requests made using the Amazon Web Services Command Line Interface (CLI) or Amazon Web Services SDKs, this field is calculated automatically.</p>
174
+ */
175
+ ContentMD5?: string;
176
+ /**
177
+ * @public
178
+ * <p>Indicates the algorithm used to create the checksum for the object when using the SDK. This header will not provide any
179
+ * additional functionality if not using the SDK. When sending this header, there must be a corresponding <code>x-amz-checksum</code> or
180
+ * <code>x-amz-trailer</code> header sent. Otherwise, Amazon S3 fails the request with the HTTP status code <code>400 Bad Request</code>. For more
181
+ * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/checking-object-integrity.html">Checking object integrity</a> in
182
+ * the <i>Amazon S3 User Guide</i>.</p>
183
+ * <p>If you provide an individual checksum, Amazon S3 ignores any provided
184
+ * <code>ChecksumAlgorithm</code> parameter.</p>
185
+ */
186
+ ChecksumAlgorithm?: ChecksumAlgorithm;
187
+ /**
188
+ * @public
189
+ * <p>The account ID of the expected bucket owner. If the bucket is owned by a different account, the request fails with the HTTP status code <code>403 Forbidden</code> (access denied).</p>
190
+ */
191
+ ExpectedBucketOwner?: string;
192
+ }
5
193
  /**
6
194
  * @public
7
195
  */
@@ -6,7 +6,7 @@ import {
6
6
  MetadataBearer as __MetadataBearer,
7
7
  MiddlewareStack,
8
8
  } from "@smithy/types";
9
- import { PutObjectAclOutput, PutObjectAclRequest } from "../models/models_0";
9
+ import { PutObjectAclOutput, PutObjectAclRequest } from "../models/models_1";
10
10
  import {
11
11
  S3ClientResolvedConfig,
12
12
  ServiceInputTypes,
@@ -9,7 +9,7 @@ import {
9
9
  import {
10
10
  PutObjectLegalHoldOutput,
11
11
  PutObjectLegalHoldRequest,
12
- } from "../models/models_0";
12
+ } from "../models/models_1";
13
13
  import {
14
14
  S3ClientResolvedConfig,
15
15
  ServiceInputTypes,
@@ -40,6 +40,8 @@ export interface EndpointParameters extends __EndpointParameters {
40
40
  Accelerate?: boolean;
41
41
  UseGlobalEndpoint?: boolean;
42
42
  UseObjectLambdaEndpoint?: boolean;
43
+ Key?: string;
44
+ Prefix?: string;
43
45
  DisableAccessPoints?: boolean;
44
46
  DisableMultiRegionAccessPoints?: boolean;
45
47
  UseArnRegion?: boolean;
@@ -890,10 +890,25 @@ export interface TargetGrant {
890
890
  Grantee?: Grantee;
891
891
  Permission?: BucketLogsPermission;
892
892
  }
893
+ export declare const PartitionDateSource: {
894
+ readonly DeliveryTime: "DeliveryTime";
895
+ readonly EventTime: "EventTime";
896
+ };
897
+ export type PartitionDateSource =
898
+ (typeof PartitionDateSource)[keyof typeof PartitionDateSource];
899
+ export interface PartitionedPrefix {
900
+ PartitionDateSource?: PartitionDateSource;
901
+ }
902
+ export interface SimplePrefix {}
903
+ export interface TargetObjectKeyFormat {
904
+ SimplePrefix?: SimplePrefix;
905
+ PartitionedPrefix?: PartitionedPrefix;
906
+ }
893
907
  export interface LoggingEnabled {
894
908
  TargetBucket: string | undefined;
895
909
  TargetGrants?: TargetGrant[];
896
910
  TargetPrefix: string | undefined;
911
+ TargetObjectKeyFormat?: TargetObjectKeyFormat;
897
912
  }
898
913
  export interface GetBucketLoggingOutput {
899
914
  LoggingEnabled?: LoggingEnabled;
@@ -2100,38 +2115,6 @@ export interface PutObjectRequest {
2100
2115
  ObjectLockLegalHoldStatus?: ObjectLockLegalHoldStatus;
2101
2116
  ExpectedBucketOwner?: string;
2102
2117
  }
2103
- export interface PutObjectAclOutput {
2104
- RequestCharged?: RequestCharged;
2105
- }
2106
- export interface PutObjectAclRequest {
2107
- ACL?: ObjectCannedACL;
2108
- AccessControlPolicy?: AccessControlPolicy;
2109
- Bucket: string | undefined;
2110
- ContentMD5?: string;
2111
- ChecksumAlgorithm?: ChecksumAlgorithm;
2112
- GrantFullControl?: string;
2113
- GrantRead?: string;
2114
- GrantReadACP?: string;
2115
- GrantWrite?: string;
2116
- GrantWriteACP?: string;
2117
- Key: string | undefined;
2118
- RequestPayer?: RequestPayer;
2119
- VersionId?: string;
2120
- ExpectedBucketOwner?: string;
2121
- }
2122
- export interface PutObjectLegalHoldOutput {
2123
- RequestCharged?: RequestCharged;
2124
- }
2125
- export interface PutObjectLegalHoldRequest {
2126
- Bucket: string | undefined;
2127
- Key: string | undefined;
2128
- LegalHold?: ObjectLockLegalHold;
2129
- RequestPayer?: RequestPayer;
2130
- VersionId?: string;
2131
- ContentMD5?: string;
2132
- ChecksumAlgorithm?: ChecksumAlgorithm;
2133
- ExpectedBucketOwner?: string;
2134
- }
2135
2118
  export declare const CompleteMultipartUploadOutputFilterSensitiveLog: (
2136
2119
  obj: CompleteMultipartUploadOutput
2137
2120
  ) => any;