@aws-sdk/client-s3 3.258.0 → 3.261.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 (84) hide show
  1. package/dist-cjs/endpoint/ruleset.js +3 -3
  2. package/dist-cjs/protocols/Aws_restXml.js +1 -1
  3. package/dist-es/endpoint/ruleset.js +3 -3
  4. package/dist-es/protocols/Aws_restXml.js +1 -1
  5. package/dist-types/S3.d.ts +41 -356
  6. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +0 -3
  7. package/dist-types/commands/CopyObjectCommand.d.ts +0 -2
  8. package/dist-types/commands/CreateBucketCommand.d.ts +0 -1
  9. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +0 -12
  10. package/dist-types/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +0 -2
  11. package/dist-types/commands/DeleteBucketCommand.d.ts +0 -1
  12. package/dist-types/commands/DeleteBucketCorsCommand.d.ts +0 -1
  13. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +0 -1
  14. package/dist-types/commands/DeleteBucketLifecycleCommand.d.ts +0 -2
  15. package/dist-types/commands/DeleteBucketMetricsConfigurationCommand.d.ts +0 -2
  16. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +0 -3
  17. package/dist-types/commands/DeleteBucketReplicationCommand.d.ts +0 -2
  18. package/dist-types/commands/DeleteBucketTaggingCommand.d.ts +0 -1
  19. package/dist-types/commands/DeleteBucketWebsiteCommand.d.ts +0 -3
  20. package/dist-types/commands/DeleteObjectCommand.d.ts +0 -5
  21. package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +0 -3
  22. package/dist-types/commands/DeleteObjectsCommand.d.ts +0 -5
  23. package/dist-types/commands/DeletePublicAccessBlockCommand.d.ts +0 -1
  24. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +0 -1
  25. package/dist-types/commands/GetBucketAclCommand.d.ts +0 -1
  26. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +0 -1
  27. package/dist-types/commands/GetBucketCorsCommand.d.ts +0 -3
  28. package/dist-types/commands/GetBucketInventoryConfigurationCommand.d.ts +0 -3
  29. package/dist-types/commands/GetBucketLifecycleConfigurationCommand.d.ts +0 -2
  30. package/dist-types/commands/GetBucketLocationCommand.d.ts +0 -3
  31. package/dist-types/commands/GetBucketLoggingCommand.d.ts +0 -1
  32. package/dist-types/commands/GetBucketMetricsConfigurationCommand.d.ts +0 -3
  33. package/dist-types/commands/GetBucketNotificationConfigurationCommand.d.ts +0 -3
  34. package/dist-types/commands/GetBucketPolicyCommand.d.ts +0 -4
  35. package/dist-types/commands/GetBucketPolicyStatusCommand.d.ts +0 -2
  36. package/dist-types/commands/GetBucketReplicationCommand.d.ts +0 -5
  37. package/dist-types/commands/GetBucketRequestPaymentCommand.d.ts +0 -1
  38. package/dist-types/commands/GetBucketTaggingCommand.d.ts +0 -2
  39. package/dist-types/commands/GetBucketVersioningCommand.d.ts +0 -2
  40. package/dist-types/commands/GetObjectAclCommand.d.ts +1 -1
  41. package/dist-types/commands/GetObjectAttributesCommand.d.ts +40 -46
  42. package/dist-types/commands/GetObjectCommand.d.ts +0 -20
  43. package/dist-types/commands/GetObjectLegalHoldCommand.d.ts +0 -1
  44. package/dist-types/commands/GetObjectLockConfigurationCommand.d.ts +0 -1
  45. package/dist-types/commands/GetObjectRetentionCommand.d.ts +0 -1
  46. package/dist-types/commands/GetObjectTaggingCommand.d.ts +0 -4
  47. package/dist-types/commands/GetPublicAccessBlockCommand.d.ts +0 -3
  48. package/dist-types/commands/HeadBucketCommand.d.ts +0 -5
  49. package/dist-types/commands/HeadObjectCommand.d.ts +0 -7
  50. package/dist-types/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +0 -4
  51. package/dist-types/commands/ListBucketInventoryConfigurationsCommand.d.ts +0 -4
  52. package/dist-types/commands/ListBucketMetricsConfigurationsCommand.d.ts +0 -4
  53. package/dist-types/commands/ListMultipartUploadsCommand.d.ts +0 -5
  54. package/dist-types/commands/ListObjectsCommand.d.ts +0 -2
  55. package/dist-types/commands/ListObjectsV2Command.d.ts +0 -4
  56. package/dist-types/commands/ListPartsCommand.d.ts +0 -3
  57. package/dist-types/commands/PutBucketAccelerateConfigurationCommand.d.ts +0 -8
  58. package/dist-types/commands/PutBucketAclCommand.d.ts +0 -7
  59. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +0 -11
  60. package/dist-types/commands/PutBucketCorsCommand.d.ts +0 -1
  61. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +0 -1
  62. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +0 -1
  63. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +0 -2
  64. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +0 -15
  65. package/dist-types/commands/PutBucketLoggingCommand.d.ts +0 -9
  66. package/dist-types/commands/PutBucketMetricsConfigurationCommand.d.ts +0 -4
  67. package/dist-types/commands/PutBucketNotificationConfigurationCommand.d.ts +0 -8
  68. package/dist-types/commands/PutBucketPolicyCommand.d.ts +0 -3
  69. package/dist-types/commands/PutBucketReplicationCommand.d.ts +0 -8
  70. package/dist-types/commands/PutBucketRequestPaymentCommand.d.ts +0 -1
  71. package/dist-types/commands/PutBucketTaggingCommand.d.ts +0 -4
  72. package/dist-types/commands/PutBucketVersioningCommand.d.ts +0 -6
  73. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +0 -4
  74. package/dist-types/commands/PutObjectAclCommand.d.ts +0 -3
  75. package/dist-types/commands/PutObjectCommand.d.ts +0 -8
  76. package/dist-types/commands/PutObjectTaggingCommand.d.ts +0 -12
  77. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +0 -6
  78. package/dist-types/commands/RestoreObjectCommand.d.ts +0 -1
  79. package/dist-types/commands/SelectObjectContentCommand.d.ts +0 -3
  80. package/dist-types/commands/UploadPartCommand.d.ts +0 -18
  81. package/dist-types/commands/UploadPartCopyCommand.d.ts +0 -10
  82. package/dist-types/models/models_0.d.ts +21 -50
  83. package/dist-types/models/models_1.d.ts +52 -53
  84. package/package.json +12 -12
@@ -11,7 +11,6 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
11
11
  * <p>Sets the permissions on an existing bucket using access control lists (ACL). For more
12
12
  * information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/S3_ACLs_UsingACLs.html">Using ACLs</a>. To set
13
13
  * the ACL of a bucket, you must have <code>WRITE_ACP</code> permission.</p>
14
- *
15
14
  * <p>You can use one of the following two ways to set a bucket's permissions:</p>
16
15
  * <ul>
17
16
  * <li>
@@ -21,17 +20,14 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
21
20
  * <p>Specify permissions using request headers</p>
22
21
  * </li>
23
22
  * </ul>
24
- *
25
23
  * <note>
26
24
  * <p>You cannot specify access permission using both the body and the request
27
25
  * headers.</p>
28
26
  * </note>
29
- *
30
27
  * <p>Depending on your application needs, you may choose to set the ACL on a bucket using
31
28
  * either the request body or the headers. For example, if you have an existing application
32
29
  * that updates a bucket ACL using the request body, then you can continue to use that
33
30
  * approach.</p>
34
- *
35
31
  * <important>
36
32
  * <p>If your bucket uses the bucket owner enforced setting for S3 Object Ownership, ACLs are disabled and no longer affect permissions.
37
33
  * You must use policies to grant access to your bucket and the objects in it. Requests to set ACLs or update ACLs fail and
@@ -115,7 +111,6 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
115
111
  * <code>x-amz-grant-write: uri="http://acs.amazonaws.com/groups/s3/LogDelivery",
116
112
  * id="111122223333", id="555566667777" </code>
117
113
  * </p>
118
- *
119
114
  * </li>
120
115
  * </ul>
121
116
  * <p>You can use either a canned ACL or specify access permissions explicitly. You cannot do
@@ -182,8 +177,6 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
182
177
  * </note>
183
178
  * </li>
184
179
  * </ul>
185
- *
186
- *
187
180
  * <p class="title">
188
181
  * <b>Related Resources</b>
189
182
  * </p>
@@ -10,7 +10,6 @@ export interface PutBucketAnalyticsConfigurationCommandOutput extends __Metadata
10
10
  /**
11
11
  * <p>Sets an analytics configuration for the bucket (specified by the analytics configuration
12
12
  * ID). You can have up to 1,000 analytics configurations per bucket.</p>
13
- *
14
13
  * <p>You can choose to have storage class analysis export analysis reports sent to a
15
14
  * comma-separated values (CSV) flat file. See the <code>DataExport</code> request element.
16
15
  * Reports are updated daily and are based on the object filters that you configure. When
@@ -19,20 +18,16 @@ export interface PutBucketAnalyticsConfigurationCommandOutput extends __Metadata
19
18
  * account. However, the destination bucket must be in the same Region as the bucket that you
20
19
  * are making the PUT analytics configuration to. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/analytics-storage-class.html">Amazon S3 Analytics – Storage Class
21
20
  * Analysis</a>. </p>
22
- *
23
21
  * <important>
24
22
  * <p>You must create a bucket policy on the destination bucket where the exported file is
25
23
  * written to grant permissions to Amazon S3 to write objects to the bucket. For an example
26
24
  * policy, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/example-bucket-policies.html#example-bucket-policies-use-case-9">Granting Permissions for Amazon S3 Inventory and Storage Class Analysis</a>.</p>
27
25
  * </important>
28
- *
29
26
  * <p>To use this operation, you must have permissions to perform the
30
27
  * <code>s3:PutAnalyticsConfiguration</code> action. The bucket owner has this permission
31
28
  * by default. The bucket owner can grant this permission to others. For more information
32
29
  * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
33
30
  * Resources</a>.</p>
34
- *
35
- *
36
31
  * <p class="title">
37
32
  * <b>Special Errors</b>
38
33
  * </p>
@@ -98,12 +93,6 @@ export interface PutBucketAnalyticsConfigurationCommandOutput extends __Metadata
98
93
  * </ul>
99
94
  * </li>
100
95
  * </ul>
101
- *
102
- *
103
- *
104
- *
105
- *
106
- *
107
96
  * <p class="title">
108
97
  * <b>Related Resources</b>
109
98
  * </p>
@@ -44,7 +44,6 @@ export interface PutBucketCorsCommandOutput extends __MetadataBearer {
44
44
  * </ul>
45
45
  * <p> For more information about CORS, go to <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cors.html">Enabling
46
46
  * Cross-Origin Resource Sharing</a> in the <i>Amazon S3 User Guide</i>.</p>
47
- *
48
47
  * <p class="title">
49
48
  * <b>Related Resources</b>
50
49
  * </p>
@@ -27,7 +27,6 @@ export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
27
27
  * by default. The bucket owner can grant this permission to others. For more information
28
28
  * about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
29
29
  * Resources</a> in the Amazon S3 User Guide. </p>
30
- *
31
30
  * <p class="title">
32
31
  * <b>Related Resources</b>
33
32
  * </p>
@@ -37,7 +37,6 @@ export interface PutBucketIntelligentTieringConfigurationCommandOutput extends _
37
37
  * move objects stored in the S3 Intelligent-Tiering storage class to the
38
38
  * Archive Access or Deep Archive Access tier.</p>
39
39
  * </note>
40
- *
41
40
  * <p class="title">
42
41
  * <b>Special Errors</b>
43
42
  * </p>
@@ -34,7 +34,6 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
34
34
  * by default and can grant this permission to others. For more information about permissions,
35
35
  * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
36
36
  * Resources</a> in the Amazon S3 User Guide.</p>
37
- *
38
37
  * <p class="title">
39
38
  * <b>Special Errors</b>
40
39
  * </p>
@@ -88,7 +87,6 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
88
87
  * </ul>
89
88
  * </li>
90
89
  * </ul>
91
- *
92
90
  * <p class="title">
93
91
  * <b>Related Resources</b>
94
92
  * </p>
@@ -13,7 +13,6 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
13
13
  * you want to retain any configuration details, they must be included in the new lifecycle
14
14
  * configuration. For information about lifecycle configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-lifecycle-mgmt.html">Managing your storage
15
15
  * lifecycle</a>.</p>
16
- *
17
16
  * <note>
18
17
  * <p>Bucket lifecycle configuration now supports specifying a lifecycle rule using an
19
18
  * object key name prefix, one or more object tags, or a combination of both. Accordingly,
@@ -21,9 +20,6 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
21
20
  * filtering based only on an object key name prefix, which is supported for backward
22
21
  * compatibility. For the related API description, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_PutBucketLifecycle.html">PutBucketLifecycle</a>.</p>
23
22
  * </note>
24
- *
25
- *
26
- *
27
23
  * <p>
28
24
  * <b>Rules</b>
29
25
  * </p>
@@ -31,7 +27,6 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
31
27
  * configuration is specified as XML consisting of one or more rules. An Amazon S3 Lifecycle
32
28
  * configuration can have up to 1,000 rules. This limit is not adjustable. Each rule consists
33
29
  * of the following:</p>
34
- *
35
30
  * <ul>
36
31
  * <li>
37
32
  * <p>Filter identifying a subset of objects to which the rule applies. The filter can
@@ -49,27 +44,20 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
49
44
  * versions.</p>
50
45
  * </li>
51
46
  * </ul>
52
- *
53
47
  * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object
54
48
  * Lifecycle Management</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html">Lifecycle Configuration Elements</a>.</p>
55
- *
56
- *
57
49
  * <p>
58
50
  * <b>Permissions</b>
59
51
  * </p>
60
- *
61
- *
62
52
  * <p>By default, all Amazon S3 resources are private, including buckets, objects, and related
63
53
  * subresources (for example, lifecycle configuration and website configuration). Only the
64
54
  * resource owner (that is, the Amazon Web Services account that created it) can access the resource. The
65
55
  * resource owner can optionally grant access permissions to others by writing an access
66
56
  * policy. For this operation, a user must get the <code>s3:PutLifecycleConfiguration</code>
67
57
  * permission.</p>
68
- *
69
58
  * <p>You can also explicitly deny permissions. Explicit deny also supersedes any other
70
59
  * permissions. If you want to block users or accounts from removing or deleting objects from
71
60
  * your bucket, you must deny them permissions for the following actions:</p>
72
- *
73
61
  * <ul>
74
62
  * <li>
75
63
  * <p>
@@ -87,11 +75,8 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
87
75
  * </p>
88
76
  * </li>
89
77
  * </ul>
90
- *
91
- *
92
78
  * <p>For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
93
79
  * Resources</a>.</p>
94
- *
95
80
  * <p>The following are related to <code>PutBucketLifecycleConfiguration</code>:</p>
96
81
  * <ul>
97
82
  * <li>
@@ -11,7 +11,6 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
11
11
  * <p>Set the logging parameters for a bucket and to specify permissions for who can view and
12
12
  * modify the logging parameters. All logs are saved to buckets in the same Amazon Web Services Region as the
13
13
  * source bucket. To set the logging status of a bucket, you must be the bucket owner.</p>
14
- *
15
14
  * <p>The bucket owner is automatically granted FULL_CONTROL to all logs. You use the <code>Grantee</code> request element to grant access to other people. The
16
15
  * <code>Permissions</code> request element specifies the kind of access the grantee has to
17
16
  * the logs.</p>
@@ -21,13 +20,11 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
21
20
  * to grant access to others. Permissions can only be granted using policies. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/enable-server-access-logging.html#grant-log-delivery-permissions-general">Permissions for server access log delivery</a> in the
22
21
  * <i>Amazon S3 User Guide</i>.</p>
23
22
  * </important>
24
- *
25
23
  * <p>
26
24
  * <b>Grantee Values</b>
27
25
  * </p>
28
26
  * <p>You can specify the person (grantee) to whom you're assigning access rights (using
29
27
  * request elements) in the following ways:</p>
30
- *
31
28
  * <ul>
32
29
  * <li>
33
30
  * <p>By the person's ID:</p>
@@ -55,21 +52,15 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
55
52
  * </p>
56
53
  * </li>
57
54
  * </ul>
58
- *
59
- *
60
55
  * <p>To enable logging, you use LoggingEnabled and its children request elements. To disable
61
56
  * logging, you use an empty BucketLoggingStatus request element:</p>
62
- *
63
57
  * <p>
64
58
  * <code><BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01"
65
59
  * /></code>
66
60
  * </p>
67
- *
68
61
  * <p>For more information about server access logging, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/ServerLogs.html">Server Access Logging</a> in the <i>Amazon S3 User Guide</i>. </p>
69
- *
70
62
  * <p>For more information about creating a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>. For more
71
63
  * information about returning the logging status of a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketLogging.html">GetBucketLogging</a>.</p>
72
- *
73
64
  * <p>The following operations are related to <code>PutBucketLogging</code>:</p>
74
65
  * <ul>
75
66
  * <li>
@@ -12,16 +12,13 @@ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBe
12
12
  * You can have up to 1,000 metrics configurations per bucket. If you're updating an existing
13
13
  * metrics configuration, note that this is a full replacement of the existing metrics
14
14
  * configuration. If you don't include the elements you want to keep, they are erased.</p>
15
- *
16
15
  * <p>To use this operation, you must have permissions to perform the
17
16
  * <code>s3:PutMetricsConfiguration</code> action. The bucket owner has this permission by
18
17
  * default. The bucket owner can grant this permission to others. For more information about
19
18
  * permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
20
19
  * Resources</a>.</p>
21
- *
22
20
  * <p>For information about CloudWatch request metrics for Amazon S3, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/cloudwatch-monitoring.html">Monitoring Metrics with Amazon
23
21
  * CloudWatch</a>.</p>
24
- *
25
22
  * <p>The following operations are related to
26
23
  * <code>PutBucketMetricsConfiguration</code>:</p>
27
24
  * <ul>
@@ -41,7 +38,6 @@ export interface PutBucketMetricsConfigurationCommandOutput extends __MetadataBe
41
38
  * </p>
42
39
  * </li>
43
40
  * </ul>
44
- *
45
41
  * <p>
46
42
  * <code>GetBucketLifecycle</code> has the following special error:</p>
47
43
  * <ul>
@@ -11,15 +11,12 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
11
11
  * <p>Enables notifications of specified events for a bucket. For more information about event
12
12
  * notifications, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Event
13
13
  * Notifications</a>.</p>
14
- *
15
14
  * <p>Using this API, you can replace an existing notification configuration. The
16
15
  * configuration is an XML file that defines the event types that you want Amazon S3 to publish and
17
16
  * the destination where you want Amazon S3 to publish an event notification when it detects an
18
17
  * event of the specified type.</p>
19
- *
20
18
  * <p>By default, your bucket has no event notifications configured. That is, the notification
21
19
  * configuration will be an empty <code>NotificationConfiguration</code>.</p>
22
- *
23
20
  * <p>
24
21
  * <code><NotificationConfiguration></code>
25
22
  * </p>
@@ -28,7 +25,6 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
28
25
  * </p>
29
26
  * <p>This action replaces the existing notification configuration with the configuration
30
27
  * you include in the request body.</p>
31
- *
32
28
  * <p>After Amazon S3 receives this request, it first verifies that any Amazon Simple Notification
33
29
  * Service (Amazon SNS) or Amazon Simple Queue Service (Amazon SQS) destination exists, and
34
30
  * that the bucket owner has permission to publish to it by sending a test notification. In
@@ -36,7 +32,6 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
36
32
  * grant Amazon S3 permission to invoke the function from the Amazon S3 bucket. For more information,
37
33
  * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/NotificationHowTo.html">Configuring Notifications for Amazon S3
38
34
  * Events</a>.</p>
39
- *
40
35
  * <p>You can disable notifications by adding the empty NotificationConfiguration
41
36
  * element.</p>
42
37
  * <p>For more information about the number of event notification configurations that you can create per bucket, see
@@ -44,7 +39,6 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
44
39
  * <p>By default, only the bucket owner can configure notifications on a bucket. However,
45
40
  * bucket owners can use a bucket policy to grant permission to other users to set this
46
41
  * configuration with <code>s3:PutBucketNotification</code> permission.</p>
47
- *
48
42
  * <note>
49
43
  * <p>The PUT notification is an atomic operation. For example, suppose your notification
50
44
  * configuration includes SNS topic, SQS queue, and Lambda function configurations. When
@@ -52,7 +46,6 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
52
46
  * topic. If the message fails, the entire PUT action will fail, and Amazon S3 will not add
53
47
  * the configuration to your bucket.</p>
54
48
  * </note>
55
- *
56
49
  * <p>
57
50
  * <b>Responses</b>
58
51
  * </p>
@@ -61,7 +54,6 @@ export interface PutBucketNotificationConfigurationCommandOutput extends __Metad
61
54
  * <code>s3:ReducedRedundancyLostObject</code> event type, the response will also include
62
55
  * the <code>x-amz-sns-test-message-id</code> header containing the message ID of the test
63
56
  * notification sent to the topic.</p>
64
- *
65
57
  * <p>The following action is related to
66
58
  * <code>PutBucketNotificationConfiguration</code>:</p>
67
59
  * <ul>
@@ -12,19 +12,16 @@ export interface PutBucketPolicyCommandOutput extends __MetadataBearer {
12
12
  * the root user of the Amazon Web Services account that owns the bucket, the calling identity must have the
13
13
  * <code>PutBucketPolicy</code> permissions on the specified bucket and belong to the
14
14
  * bucket owner's account in order to use this operation.</p>
15
- *
16
15
  * <p>If you don't have <code>PutBucketPolicy</code> permissions, Amazon S3 returns a <code>403
17
16
  * Access Denied</code> error. If you have the correct permissions, but you're not using an
18
17
  * identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
19
18
  * Allowed</code> error.</p>
20
- *
21
19
  * <important>
22
20
  * <p> As a security precaution, the root user of the Amazon Web Services account that owns a bucket can
23
21
  * always use this operation, even if the policy explicitly denies the root user the
24
22
  * ability to perform this action. </p>
25
23
  * </important>
26
24
  * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html">Bucket policy examples</a>.</p>
27
- *
28
25
  * <p>The following operations are related to <code>PutBucketPolicy</code>:</p>
29
26
  * <ul>
30
27
  * <li>
@@ -10,18 +10,14 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
10
10
  /**
11
11
  * <p> Creates a replication configuration or replaces an existing one. For more information,
12
12
  * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication.html">Replication</a> in the <i>Amazon S3 User Guide</i>. </p>
13
- *
14
13
  * <p>Specify the replication configuration in the request body. In the replication
15
14
  * configuration, you provide the name of the destination bucket or buckets where you want
16
15
  * Amazon S3 to replicate objects, the IAM role that Amazon S3 can assume to replicate objects on your
17
16
  * behalf, and other relevant information.</p>
18
- *
19
- *
20
17
  * <p>A replication configuration must include at least one rule, and can contain a maximum of
21
18
  * 1,000. Each rule identifies a subset of objects to replicate by filtering the objects in
22
19
  * the source bucket. To choose additional subsets of objects to replicate, add a rule for
23
20
  * each subset.</p>
24
- *
25
21
  * <p>To specify a subset of the objects in the source bucket to apply a replication rule to,
26
22
  * add the Filter element as a child of the Rule element. You can filter objects based on an
27
23
  * object key prefix, one or more object tags, or both. When you add the Filter element in the
@@ -33,7 +29,6 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
33
29
  * replication of delete markers differently. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-add-config.html#replication-backward-compat-considerations">Backward Compatibility</a>.</p>
34
30
  * </note>
35
31
  * <p>For information about enabling versioning on a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/Versioning.html">Using Versioning</a>.</p>
36
- *
37
32
  * <p>
38
33
  * <b>Handling Replication of Encrypted Objects</b>
39
34
  * </p>
@@ -44,11 +39,9 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
44
39
  * <code>ReplicaKmsKeyID</code>. For information about replication configuration, see
45
40
  * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html">Replicating Objects
46
41
  * Created with SSE Using KMS keys</a>.</p>
47
- *
48
42
  * <p>For information on <code>PutBucketReplication</code> errors, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList">List of
49
43
  * replication-related error codes</a>
50
44
  * </p>
51
- *
52
45
  * <p>
53
46
  * <b>Permissions</b>
54
47
  * </p>
@@ -64,7 +57,6 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
64
57
  * <p>To perform this operation, the user or role performing the action must have the
65
58
  * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">iam:PassRole</a> permission.</p>
66
59
  * </note>
67
- *
68
60
  * <p>The following operations are related to <code>PutBucketReplication</code>:</p>
69
61
  * <ul>
70
62
  * <li>
@@ -13,7 +13,6 @@ export interface PutBucketRequestPaymentCommandOutput extends __MetadataBearer {
13
13
  * to specify that the person requesting the download will be charged for the download. For
14
14
  * more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester Pays
15
15
  * Buckets</a>.</p>
16
- *
17
16
  * <p>The following operations are related to <code>PutBucketRequestPayment</code>:</p>
18
17
  * <ul>
19
18
  * <li>
@@ -17,7 +17,6 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
17
17
  * across several services. For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html">Cost Allocation
18
18
  * and Tagging</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CostAllocTagging.html">Using Cost Allocation in Amazon S3 Bucket
19
19
  * Tags</a>.</p>
20
- *
21
20
  * <note>
22
21
  * <p>
23
22
  * When this operation sets the tags for a bucket, it will overwrite any current tags the
@@ -27,7 +26,6 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
27
26
  * <code>s3:PutBucketTagging</code> action. The bucket owner has this permission by default
28
27
  * and can grant this permission to others. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/using-with-s3-actions.html#using-with-s3-actions-related-to-bucket-subresources">Permissions Related to Bucket Subresource Operations</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your Amazon S3
29
28
  * Resources</a>.</p>
30
- *
31
29
  * <p>
32
30
  * <code>PutBucketTagging</code> has the following special errors:</p>
33
31
  * <ul>
@@ -72,8 +70,6 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
72
70
  * </ul>
73
71
  * </li>
74
72
  * </ul>
75
- *
76
- *
77
73
  * <p>The following operations are related to <code>PutBucketTagging</code>:</p>
78
74
  * <ul>
79
75
  * <li>
@@ -10,24 +10,19 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
10
10
  /**
11
11
  * <p>Sets the versioning state of an existing bucket.</p>
12
12
  * <p>You can set the versioning state with one of the following values:</p>
13
- *
14
13
  * <p>
15
14
  * <b>Enabled</b>—Enables versioning for the objects in the
16
15
  * bucket. All objects added to the bucket receive a unique version ID.</p>
17
- *
18
16
  * <p>
19
17
  * <b>Suspended</b>—Disables versioning for the objects in the
20
18
  * bucket. All objects added to the bucket receive the version ID null.</p>
21
- *
22
19
  * <p>If the versioning state has never been set on a bucket, it has no versioning state; a
23
20
  * <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a> request does not return a versioning state value.</p>
24
- *
25
21
  * <p>In order to enable MFA Delete, you must be the bucket owner. If you are the bucket owner
26
22
  * and want to enable MFA Delete in the bucket versioning configuration, you must
27
23
  * include the <code>x-amz-mfa request</code> header and the
28
24
  * <code>Status</code> and the <code>MfaDelete</code> request elements in a request to set
29
25
  * the versioning state of the bucket.</p>
30
- *
31
26
  * <important>
32
27
  * <p>If you have an object expiration lifecycle policy in your non-versioned bucket and
33
28
  * you want to maintain the same permanent delete behavior when you enable versioning, you
@@ -36,7 +31,6 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
36
31
  * version-enabled bucket maintains one current and zero or more noncurrent object
37
32
  * versions.) For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html#lifecycle-and-other-bucket-config">Lifecycle and Versioning</a>.</p>
38
33
  * </important>
39
- *
40
34
  * <p class="title">
41
35
  * <b>Related Resources</b>
42
36
  * </p>
@@ -12,12 +12,10 @@ export interface PutBucketWebsiteCommandOutput extends __MetadataBearer {
12
12
  * subresource. To configure a bucket as a website, you can add this subresource on the bucket
13
13
  * with website configuration information such as the file name of the index document and any
14
14
  * redirect rules. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/WebsiteHosting.html">Hosting Websites on Amazon S3</a>.</p>
15
- *
16
15
  * <p>This PUT action requires the <code>S3:PutBucketWebsite</code> permission. By default,
17
16
  * only the bucket owner can configure the website attached to a bucket; however, bucket
18
17
  * owners can allow other users to set the website configuration by writing a bucket policy
19
18
  * that grants them the <code>S3:PutBucketWebsite</code> permission.</p>
20
- *
21
19
  * <p>To redirect all website requests sent to the bucket's website endpoint, you add a
22
20
  * website configuration with the following elements. Because all requests are sent to another
23
21
  * website, you don't need to provide index document name for the bucket.</p>
@@ -43,7 +41,6 @@ export interface PutBucketWebsiteCommandOutput extends __MetadataBearer {
43
41
  * </p>
44
42
  * </li>
45
43
  * </ul>
46
- *
47
44
  * <p>If you want granular control over redirects, you can use the following elements to add
48
45
  * routing rules that describe conditions for redirecting requests and information about the
49
46
  * redirect destination. In this case, the website configuration must provide an index
@@ -130,7 +127,6 @@ export interface PutBucketWebsiteCommandOutput extends __MetadataBearer {
130
127
  * </p>
131
128
  * </li>
132
129
  * </ul>
133
- *
134
130
  * <p>Amazon S3 has a limitation of 50 routing rules per website configuration. If you require more
135
131
  * than 50 routing rules, you can use object redirect. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/how-to-page-redirect.html">Configuring an
136
132
  * Object Redirect</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -24,7 +24,6 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
24
24
  * For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/about-object-ownership.html">Controlling object ownership</a>
25
25
  * in the <i>Amazon S3 User Guide</i>.</p>
26
26
  * </important>
27
- *
28
27
  * <p>
29
28
  * <b>Access Permissions</b>
30
29
  * </p>
@@ -46,7 +45,6 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
46
45
  * <code>x-amz-acl</code> header to set a canned ACL. These parameters map to the set
47
46
  * of permissions that Amazon S3 supports in an ACL. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL)
48
47
  * Overview</a>.</p>
49
- *
50
48
  * <p>You specify each grantee as a type=value pair, where the type is one of the
51
49
  * following:</p>
52
50
  * <ul>
@@ -102,7 +100,6 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
102
100
  * <code>x-amz-grant-read: emailAddress="xyz@amazon.com",
103
101
  * emailAddress="abc@amazon.com" </code>
104
102
  * </p>
105
- *
106
103
  * </li>
107
104
  * </ul>
108
105
  * <p>You can use either a canned ACL or specify access permissions explicitly. You cannot do
@@ -20,16 +20,12 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
20
20
  /**
21
21
  * <p>Adds an object to a bucket. You must have WRITE permissions on a bucket to add an object
22
22
  * to it.</p>
23
- *
24
- *
25
23
  * <p>Amazon S3 never adds partial objects; if you receive a success response, Amazon S3 added the
26
24
  * entire object to the bucket.</p>
27
- *
28
25
  * <p>Amazon S3 is a distributed system. If it receives multiple write requests for the same object
29
26
  * simultaneously, it overwrites all but the last object written. Amazon S3 does not provide object
30
27
  * locking; if you need this, make sure to build it into your application layer or use
31
28
  * versioning instead.</p>
32
- *
33
29
  * <p>To ensure that data is not corrupted traversing the network, use the
34
30
  * <code>Content-MD5</code> header. When you use this header, Amazon S3 checks the object
35
31
  * against the provided MD5 value and, if they do not match, returns an error. Additionally,
@@ -96,8 +92,6 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
96
92
  * performance needs, you can specify a different Storage Class. Amazon S3 on Outposts only uses
97
93
  * the OUTPOSTS Storage Class. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/storage-class-intro.html">Storage Classes</a> in the
98
94
  * <i>Amazon S3 User Guide</i>.</p>
99
- *
100
- *
101
95
  * <p>
102
96
  * <b>Versioning</b>
103
97
  * </p>
@@ -108,8 +102,6 @@ export interface PutObjectCommandOutput extends PutObjectOutput, __MetadataBeare
108
102
  * <p>For more information about versioning, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/AddingObjectstoVersioningEnabledBuckets.html">Adding Objects to
109
103
  * Versioning Enabled Buckets</a>. For information about returning the versioning state
110
104
  * of a bucket, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>. </p>
111
- *
112
- *
113
105
  * <p class="title">
114
106
  * <b>Related Resources</b>
115
107
  * </p>
@@ -12,21 +12,15 @@ export interface PutObjectTaggingCommandOutput extends PutObjectTaggingOutput, _
12
12
  * <p>A tag is a key-value pair. You can associate tags with an object by sending a PUT
13
13
  * request against the tagging subresource that is associated with the object. You can
14
14
  * retrieve tags by sending a GET request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html">GetObjectTagging</a>.</p>
15
- *
16
15
  * <p>For tagging-related restrictions related to characters and encodings, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html">Tag
17
16
  * Restrictions</a>. Note that Amazon S3 limits the maximum number of tags to 10 tags per
18
17
  * object.</p>
19
- *
20
18
  * <p>To use this operation, you must have permission to perform the
21
19
  * <code>s3:PutObjectTagging</code> action. By default, the bucket owner has this
22
20
  * permission and can grant this permission to others.</p>
23
- *
24
21
  * <p>To put tags of any other version, use the <code>versionId</code> query parameter. You
25
22
  * also need permission for the <code>s3:PutObjectVersionTagging</code> action.</p>
26
- *
27
23
  * <p>For information about the Amazon S3 object tagging feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html">Object Tagging</a>.</p>
28
- *
29
- *
30
24
  * <p class="title">
31
25
  * <b>Special Errors</b>
32
26
  * </p>
@@ -91,12 +85,6 @@ export interface PutObjectTaggingCommandOutput extends PutObjectTaggingOutput, _
91
85
  * </ul>
92
86
  * </li>
93
87
  * </ul>
94
- *
95
- *
96
- *
97
- *
98
- *
99
- *
100
88
  * <p class="title">
101
89
  * <b>Related Resources</b>
102
90
  * </p>
@@ -12,7 +12,6 @@ export interface PutPublicAccessBlockCommandOutput extends __MetadataBearer {
12
12
  * To use this operation, you must have the <code>s3:PutBucketPublicAccessBlock</code>
13
13
  * permission. For more information about Amazon S3 permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a
14
14
  * Policy</a>.</p>
15
- *
16
15
  * <important>
17
16
  * <p>When Amazon S3 evaluates the <code>PublicAccessBlock</code> configuration for a bucket or
18
17
  * an object, it checks the <code>PublicAccessBlock</code> configuration for both the
@@ -21,12 +20,7 @@ export interface PutPublicAccessBlockCommandOutput extends __MetadataBearer {
21
20
  * the account, Amazon S3 uses the most restrictive combination of the bucket-level and
22
21
  * account-level settings.</p>
23
22
  * </important>
24
- *
25
- *
26
23
  * <p>For more information about when Amazon S3 considers a bucket or an object public, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status">The Meaning of "Public"</a>.</p>
27
- *
28
- *
29
- *
30
24
  * <p class="title">
31
25
  * <b>Related Resources</b>
32
26
  * </p>
@@ -270,7 +270,6 @@ export interface RestoreObjectCommandOutput extends RestoreObjectOutput, __Metad
270
270
  * </ul>
271
271
  * </li>
272
272
  * </ul>
273
- *
274
273
  * <p class="title">
275
274
  * <b>Related Resources</b>
276
275
  * </p>