@aws-sdk/client-s3 3.414.0 → 3.418.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.
- package/dist-cjs/commands/AbortMultipartUploadCommand.js +5 -0
- package/dist-cjs/commands/CompleteMultipartUploadCommand.js +5 -0
- package/dist-cjs/commands/CopyObjectCommand.js +5 -0
- package/dist-cjs/commands/CreateBucketCommand.js +5 -0
- package/dist-cjs/commands/CreateMultipartUploadCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketAnalyticsConfigurationCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketCorsCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketEncryptionCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketIntelligentTieringConfigurationCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketInventoryConfigurationCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketLifecycleCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketMetricsConfigurationCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketOwnershipControlsCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketPolicyCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketReplicationCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketTaggingCommand.js +5 -0
- package/dist-cjs/commands/DeleteBucketWebsiteCommand.js +5 -0
- package/dist-cjs/commands/DeleteObjectCommand.js +5 -0
- package/dist-cjs/commands/DeleteObjectTaggingCommand.js +5 -0
- package/dist-cjs/commands/DeleteObjectsCommand.js +5 -0
- package/dist-cjs/commands/DeletePublicAccessBlockCommand.js +5 -0
- package/dist-cjs/commands/GetBucketAccelerateConfigurationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketAclCommand.js +5 -0
- package/dist-cjs/commands/GetBucketAnalyticsConfigurationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketCorsCommand.js +5 -0
- package/dist-cjs/commands/GetBucketEncryptionCommand.js +5 -0
- package/dist-cjs/commands/GetBucketIntelligentTieringConfigurationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketInventoryConfigurationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketLifecycleConfigurationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketLocationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketLoggingCommand.js +5 -0
- package/dist-cjs/commands/GetBucketMetricsConfigurationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketNotificationConfigurationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketOwnershipControlsCommand.js +5 -0
- package/dist-cjs/commands/GetBucketPolicyCommand.js +5 -0
- package/dist-cjs/commands/GetBucketPolicyStatusCommand.js +5 -0
- package/dist-cjs/commands/GetBucketReplicationCommand.js +5 -0
- package/dist-cjs/commands/GetBucketRequestPaymentCommand.js +5 -0
- package/dist-cjs/commands/GetBucketTaggingCommand.js +5 -0
- package/dist-cjs/commands/GetBucketVersioningCommand.js +5 -0
- package/dist-cjs/commands/GetBucketWebsiteCommand.js +5 -0
- package/dist-cjs/commands/GetObjectAclCommand.js +5 -0
- package/dist-cjs/commands/GetObjectAttributesCommand.js +5 -0
- package/dist-cjs/commands/GetObjectCommand.js +5 -0
- package/dist-cjs/commands/GetObjectLegalHoldCommand.js +5 -0
- package/dist-cjs/commands/GetObjectLockConfigurationCommand.js +5 -0
- package/dist-cjs/commands/GetObjectRetentionCommand.js +5 -0
- package/dist-cjs/commands/GetObjectTaggingCommand.js +5 -0
- package/dist-cjs/commands/GetObjectTorrentCommand.js +5 -0
- package/dist-cjs/commands/GetPublicAccessBlockCommand.js +5 -0
- package/dist-cjs/commands/HeadBucketCommand.js +5 -0
- package/dist-cjs/commands/HeadObjectCommand.js +5 -0
- package/dist-cjs/commands/ListBucketAnalyticsConfigurationsCommand.js +5 -0
- package/dist-cjs/commands/ListBucketIntelligentTieringConfigurationsCommand.js +5 -0
- package/dist-cjs/commands/ListBucketInventoryConfigurationsCommand.js +5 -0
- package/dist-cjs/commands/ListBucketMetricsConfigurationsCommand.js +5 -0
- package/dist-cjs/commands/ListBucketsCommand.js +5 -0
- package/dist-cjs/commands/ListMultipartUploadsCommand.js +5 -0
- package/dist-cjs/commands/ListObjectVersionsCommand.js +5 -0
- package/dist-cjs/commands/ListObjectsCommand.js +5 -0
- package/dist-cjs/commands/ListObjectsV2Command.js +5 -0
- package/dist-cjs/commands/ListPartsCommand.js +5 -0
- package/dist-cjs/commands/PutBucketAccelerateConfigurationCommand.js +5 -0
- package/dist-cjs/commands/PutBucketAclCommand.js +5 -0
- package/dist-cjs/commands/PutBucketAnalyticsConfigurationCommand.js +5 -0
- package/dist-cjs/commands/PutBucketCorsCommand.js +5 -0
- package/dist-cjs/commands/PutBucketEncryptionCommand.js +5 -0
- package/dist-cjs/commands/PutBucketIntelligentTieringConfigurationCommand.js +5 -0
- package/dist-cjs/commands/PutBucketInventoryConfigurationCommand.js +5 -0
- package/dist-cjs/commands/PutBucketLifecycleConfigurationCommand.js +5 -0
- package/dist-cjs/commands/PutBucketLoggingCommand.js +5 -0
- package/dist-cjs/commands/PutBucketMetricsConfigurationCommand.js +5 -0
- package/dist-cjs/commands/PutBucketNotificationConfigurationCommand.js +5 -0
- package/dist-cjs/commands/PutBucketOwnershipControlsCommand.js +5 -0
- package/dist-cjs/commands/PutBucketPolicyCommand.js +5 -0
- package/dist-cjs/commands/PutBucketReplicationCommand.js +5 -0
- package/dist-cjs/commands/PutBucketRequestPaymentCommand.js +5 -0
- package/dist-cjs/commands/PutBucketTaggingCommand.js +5 -0
- package/dist-cjs/commands/PutBucketVersioningCommand.js +5 -0
- package/dist-cjs/commands/PutBucketWebsiteCommand.js +5 -0
- package/dist-cjs/commands/PutObjectAclCommand.js +5 -0
- package/dist-cjs/commands/PutObjectCommand.js +5 -0
- package/dist-cjs/commands/PutObjectLegalHoldCommand.js +5 -0
- package/dist-cjs/commands/PutObjectLockConfigurationCommand.js +5 -0
- package/dist-cjs/commands/PutObjectRetentionCommand.js +5 -0
- package/dist-cjs/commands/PutObjectTaggingCommand.js +5 -0
- package/dist-cjs/commands/PutPublicAccessBlockCommand.js +5 -0
- package/dist-cjs/commands/RestoreObjectCommand.js +5 -0
- package/dist-cjs/commands/SelectObjectContentCommand.js +5 -0
- package/dist-cjs/commands/UploadPartCommand.js +5 -0
- package/dist-cjs/commands/UploadPartCopyCommand.js +5 -0
- package/dist-cjs/commands/WriteGetObjectResponseCommand.js +5 -0
- package/dist-es/commands/AbortMultipartUploadCommand.js +5 -0
- package/dist-es/commands/CompleteMultipartUploadCommand.js +5 -0
- package/dist-es/commands/CopyObjectCommand.js +5 -0
- package/dist-es/commands/CreateBucketCommand.js +5 -0
- package/dist-es/commands/CreateMultipartUploadCommand.js +5 -0
- package/dist-es/commands/DeleteBucketAnalyticsConfigurationCommand.js +5 -0
- package/dist-es/commands/DeleteBucketCommand.js +5 -0
- package/dist-es/commands/DeleteBucketCorsCommand.js +5 -0
- package/dist-es/commands/DeleteBucketEncryptionCommand.js +5 -0
- package/dist-es/commands/DeleteBucketIntelligentTieringConfigurationCommand.js +5 -0
- package/dist-es/commands/DeleteBucketInventoryConfigurationCommand.js +5 -0
- package/dist-es/commands/DeleteBucketLifecycleCommand.js +5 -0
- package/dist-es/commands/DeleteBucketMetricsConfigurationCommand.js +5 -0
- package/dist-es/commands/DeleteBucketOwnershipControlsCommand.js +5 -0
- package/dist-es/commands/DeleteBucketPolicyCommand.js +5 -0
- package/dist-es/commands/DeleteBucketReplicationCommand.js +5 -0
- package/dist-es/commands/DeleteBucketTaggingCommand.js +5 -0
- package/dist-es/commands/DeleteBucketWebsiteCommand.js +5 -0
- package/dist-es/commands/DeleteObjectCommand.js +5 -0
- package/dist-es/commands/DeleteObjectTaggingCommand.js +5 -0
- package/dist-es/commands/DeleteObjectsCommand.js +5 -0
- package/dist-es/commands/DeletePublicAccessBlockCommand.js +5 -0
- package/dist-es/commands/GetBucketAccelerateConfigurationCommand.js +5 -0
- package/dist-es/commands/GetBucketAclCommand.js +5 -0
- package/dist-es/commands/GetBucketAnalyticsConfigurationCommand.js +5 -0
- package/dist-es/commands/GetBucketCorsCommand.js +5 -0
- package/dist-es/commands/GetBucketEncryptionCommand.js +5 -0
- package/dist-es/commands/GetBucketIntelligentTieringConfigurationCommand.js +5 -0
- package/dist-es/commands/GetBucketInventoryConfigurationCommand.js +5 -0
- package/dist-es/commands/GetBucketLifecycleConfigurationCommand.js +5 -0
- package/dist-es/commands/GetBucketLocationCommand.js +5 -0
- package/dist-es/commands/GetBucketLoggingCommand.js +5 -0
- package/dist-es/commands/GetBucketMetricsConfigurationCommand.js +5 -0
- package/dist-es/commands/GetBucketNotificationConfigurationCommand.js +5 -0
- package/dist-es/commands/GetBucketOwnershipControlsCommand.js +5 -0
- package/dist-es/commands/GetBucketPolicyCommand.js +5 -0
- package/dist-es/commands/GetBucketPolicyStatusCommand.js +5 -0
- package/dist-es/commands/GetBucketReplicationCommand.js +5 -0
- package/dist-es/commands/GetBucketRequestPaymentCommand.js +5 -0
- package/dist-es/commands/GetBucketTaggingCommand.js +5 -0
- package/dist-es/commands/GetBucketVersioningCommand.js +5 -0
- package/dist-es/commands/GetBucketWebsiteCommand.js +5 -0
- package/dist-es/commands/GetObjectAclCommand.js +5 -0
- package/dist-es/commands/GetObjectAttributesCommand.js +5 -0
- package/dist-es/commands/GetObjectCommand.js +5 -0
- package/dist-es/commands/GetObjectLegalHoldCommand.js +5 -0
- package/dist-es/commands/GetObjectLockConfigurationCommand.js +5 -0
- package/dist-es/commands/GetObjectRetentionCommand.js +5 -0
- package/dist-es/commands/GetObjectTaggingCommand.js +5 -0
- package/dist-es/commands/GetObjectTorrentCommand.js +5 -0
- package/dist-es/commands/GetPublicAccessBlockCommand.js +5 -0
- package/dist-es/commands/HeadBucketCommand.js +5 -0
- package/dist-es/commands/HeadObjectCommand.js +5 -0
- package/dist-es/commands/ListBucketAnalyticsConfigurationsCommand.js +5 -0
- package/dist-es/commands/ListBucketIntelligentTieringConfigurationsCommand.js +5 -0
- package/dist-es/commands/ListBucketInventoryConfigurationsCommand.js +5 -0
- package/dist-es/commands/ListBucketMetricsConfigurationsCommand.js +5 -0
- package/dist-es/commands/ListBucketsCommand.js +5 -0
- package/dist-es/commands/ListMultipartUploadsCommand.js +5 -0
- package/dist-es/commands/ListObjectVersionsCommand.js +5 -0
- package/dist-es/commands/ListObjectsCommand.js +5 -0
- package/dist-es/commands/ListObjectsV2Command.js +5 -0
- package/dist-es/commands/ListPartsCommand.js +5 -0
- package/dist-es/commands/PutBucketAccelerateConfigurationCommand.js +5 -0
- package/dist-es/commands/PutBucketAclCommand.js +5 -0
- package/dist-es/commands/PutBucketAnalyticsConfigurationCommand.js +5 -0
- package/dist-es/commands/PutBucketCorsCommand.js +5 -0
- package/dist-es/commands/PutBucketEncryptionCommand.js +5 -0
- package/dist-es/commands/PutBucketIntelligentTieringConfigurationCommand.js +5 -0
- package/dist-es/commands/PutBucketInventoryConfigurationCommand.js +5 -0
- package/dist-es/commands/PutBucketLifecycleConfigurationCommand.js +5 -0
- package/dist-es/commands/PutBucketLoggingCommand.js +5 -0
- package/dist-es/commands/PutBucketMetricsConfigurationCommand.js +5 -0
- package/dist-es/commands/PutBucketNotificationConfigurationCommand.js +5 -0
- package/dist-es/commands/PutBucketOwnershipControlsCommand.js +5 -0
- package/dist-es/commands/PutBucketPolicyCommand.js +5 -0
- package/dist-es/commands/PutBucketReplicationCommand.js +5 -0
- package/dist-es/commands/PutBucketRequestPaymentCommand.js +5 -0
- package/dist-es/commands/PutBucketTaggingCommand.js +5 -0
- package/dist-es/commands/PutBucketVersioningCommand.js +5 -0
- package/dist-es/commands/PutBucketWebsiteCommand.js +5 -0
- package/dist-es/commands/PutObjectAclCommand.js +5 -0
- package/dist-es/commands/PutObjectCommand.js +5 -0
- package/dist-es/commands/PutObjectLegalHoldCommand.js +5 -0
- package/dist-es/commands/PutObjectLockConfigurationCommand.js +5 -0
- package/dist-es/commands/PutObjectRetentionCommand.js +5 -0
- package/dist-es/commands/PutObjectTaggingCommand.js +5 -0
- package/dist-es/commands/PutPublicAccessBlockCommand.js +5 -0
- package/dist-es/commands/RestoreObjectCommand.js +5 -0
- package/dist-es/commands/SelectObjectContentCommand.js +5 -0
- package/dist-es/commands/UploadPartCommand.js +5 -0
- package/dist-es/commands/UploadPartCopyCommand.js +5 -0
- package/dist-es/commands/WriteGetObjectResponseCommand.js +5 -0
- package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +6 -6
- package/dist-types/commands/CopyObjectCommand.d.ts +90 -76
- package/dist-types/commands/CreateBucketCommand.d.ts +76 -50
- package/dist-types/commands/CreateMultipartUploadCommand.d.ts +14 -12
- package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +3 -3
- package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +3 -2
- package/dist-types/commands/DeleteObjectCommand.d.ts +10 -10
- package/dist-types/commands/DeleteObjectTaggingCommand.d.ts +11 -11
- package/dist-types/commands/DeleteObjectsCommand.d.ts +24 -23
- package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +2 -1
- package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +2 -1
- package/dist-types/commands/GetBucketPolicyCommand.d.ts +5 -4
- package/dist-types/commands/GetObjectAttributesCommand.d.ts +15 -12
- package/dist-types/commands/GetObjectCommand.d.ts +44 -37
- package/dist-types/commands/GetObjectTaggingCommand.d.ts +19 -19
- package/dist-types/commands/HeadBucketCommand.d.ts +3 -3
- package/dist-types/commands/HeadObjectCommand.d.ts +11 -11
- package/dist-types/commands/PutBucketAclCommand.d.ts +41 -35
- package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +2 -1
- package/dist-types/commands/PutBucketEncryptionCommand.d.ts +4 -8
- package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +5 -4
- package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +18 -18
- package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +29 -25
- package/dist-types/commands/PutBucketLoggingCommand.d.ts +12 -10
- package/dist-types/commands/PutBucketPolicyCommand.d.ts +5 -4
- package/dist-types/commands/PutBucketReplicationCommand.d.ts +23 -17
- package/dist-types/commands/PutBucketTaggingCommand.d.ts +18 -35
- package/dist-types/commands/PutBucketVersioningCommand.d.ts +6 -6
- package/dist-types/commands/PutBucketWebsiteCommand.d.ts +1 -0
- package/dist-types/commands/PutObjectAclCommand.d.ts +39 -36
- package/dist-types/commands/PutObjectCommand.d.ts +43 -43
- package/dist-types/commands/PutObjectTaggingCommand.d.ts +21 -58
- package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -1
- package/dist-types/commands/RestoreObjectCommand.d.ts +93 -91
- package/dist-types/commands/SelectObjectContentCommand.d.ts +46 -40
- package/dist-types/commands/UploadPartCopyCommand.d.ts +16 -14
- package/dist-types/models/models_0.d.ts +173 -110
- package/dist-types/models/models_1.d.ts +25 -13
- package/package.json +46 -46
|
@@ -57,29 +57,33 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
|
|
|
57
57
|
* <p>You can set access permissions by using one of the following methods:</p>
|
|
58
58
|
* <ul>
|
|
59
59
|
* <li>
|
|
60
|
-
* <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3
|
|
61
|
-
* a set of predefined ACLs, known as <i>canned
|
|
62
|
-
* has a predefined set of grantees and
|
|
63
|
-
*
|
|
64
|
-
*
|
|
65
|
-
*
|
|
60
|
+
* <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3
|
|
61
|
+
* supports a set of predefined ACLs, known as <i>canned
|
|
62
|
+
* ACLs</i>. Each canned ACL has a predefined set of grantees and
|
|
63
|
+
* permissions. Specify the canned ACL name as the value of
|
|
64
|
+
* <code>x-amz-acl</code>. If you use this header, you cannot use other
|
|
65
|
+
* access control-specific headers in your request. For more information, see
|
|
66
|
+
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned
|
|
67
|
+
* ACL</a>.</p>
|
|
66
68
|
* </li>
|
|
67
69
|
* <li>
|
|
68
|
-
* <p>Specify access permissions explicitly with the
|
|
69
|
-
*
|
|
70
|
-
*
|
|
71
|
-
*
|
|
72
|
-
*
|
|
73
|
-
*
|
|
74
|
-
*
|
|
75
|
-
*
|
|
76
|
-
*
|
|
77
|
-
*
|
|
70
|
+
* <p>Specify access permissions explicitly with the
|
|
71
|
+
* <code>x-amz-grant-read</code>, <code>x-amz-grant-read-acp</code>,
|
|
72
|
+
* <code>x-amz-grant-write-acp</code>, and
|
|
73
|
+
* <code>x-amz-grant-full-control</code> headers. When using these headers,
|
|
74
|
+
* you specify explicit access permissions and grantees (Amazon Web Services accounts or Amazon S3
|
|
75
|
+
* groups) who will receive the permission. If you use these ACL-specific
|
|
76
|
+
* headers, you cannot use the <code>x-amz-acl</code> header to set a canned
|
|
77
|
+
* ACL. These parameters map to the set of permissions that Amazon S3 supports in an
|
|
78
|
+
* ACL. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL)
|
|
79
|
+
* Overview</a>.</p>
|
|
80
|
+
* <p>You specify each grantee as a type=value pair, where the type is one of
|
|
81
|
+
* the following:</p>
|
|
78
82
|
* <ul>
|
|
79
83
|
* <li>
|
|
80
84
|
* <p>
|
|
81
|
-
* <code>id</code> – if the value specified is the canonical user ID
|
|
82
|
-
* Amazon Web Services account</p>
|
|
85
|
+
* <code>id</code> – if the value specified is the canonical user ID
|
|
86
|
+
* of an Amazon Web Services account</p>
|
|
83
87
|
* </li>
|
|
84
88
|
* <li>
|
|
85
89
|
* <p>
|
|
@@ -88,8 +92,8 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
|
|
|
88
92
|
* </li>
|
|
89
93
|
* <li>
|
|
90
94
|
* <p>
|
|
91
|
-
* <code>emailAddress</code> – if the value specified is the email
|
|
92
|
-
* an Amazon Web Services account</p>
|
|
95
|
+
* <code>emailAddress</code> – if the value specified is the email
|
|
96
|
+
* address of an Amazon Web Services account</p>
|
|
93
97
|
* <note>
|
|
94
98
|
* <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
|
|
95
99
|
* <ul>
|
|
@@ -122,29 +126,31 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
|
|
|
122
126
|
* </note>
|
|
123
127
|
* </li>
|
|
124
128
|
* </ul>
|
|
125
|
-
* <p>For example, the following <code>x-amz-grant-write</code> header grants
|
|
126
|
-
* overwrite, and delete objects permission to LogDelivery group
|
|
127
|
-
* two Amazon Web Services accounts identified by their email
|
|
129
|
+
* <p>For example, the following <code>x-amz-grant-write</code> header grants
|
|
130
|
+
* create, overwrite, and delete objects permission to LogDelivery group
|
|
131
|
+
* predefined by Amazon S3 and two Amazon Web Services accounts identified by their email
|
|
132
|
+
* addresses.</p>
|
|
128
133
|
* <p>
|
|
129
|
-
* <code>x-amz-grant-write:
|
|
130
|
-
*
|
|
134
|
+
* <code>x-amz-grant-write:
|
|
135
|
+
* uri="http://acs.amazonaws.com/groups/s3/LogDelivery", id="111122223333",
|
|
136
|
+
* id="555566667777" </code>
|
|
131
137
|
* </p>
|
|
132
138
|
* </li>
|
|
133
139
|
* </ul>
|
|
134
|
-
* <p>You can use either a canned ACL or specify access permissions explicitly. You
|
|
135
|
-
* both.</p>
|
|
140
|
+
* <p>You can use either a canned ACL or specify access permissions explicitly. You
|
|
141
|
+
* cannot do both.</p>
|
|
136
142
|
* </dd>
|
|
137
143
|
* <dt>Grantee Values</dt>
|
|
138
144
|
* <dd>
|
|
139
|
-
* <p>You can specify the person (grantee) to whom you're assigning access rights
|
|
140
|
-
* request elements) in the following ways:</p>
|
|
145
|
+
* <p>You can specify the person (grantee) to whom you're assigning access rights
|
|
146
|
+
* (using request elements) in the following ways:</p>
|
|
141
147
|
* <ul>
|
|
142
148
|
* <li>
|
|
143
149
|
* <p>By the person's ID:</p>
|
|
144
150
|
* <p>
|
|
145
151
|
* <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
146
|
-
*
|
|
147
|
-
*
|
|
152
|
+
* xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
|
|
153
|
+
* </Grantee></code>
|
|
148
154
|
* </p>
|
|
149
155
|
* <p>DisplayName is optional and ignored in the request</p>
|
|
150
156
|
* </li>
|
|
@@ -152,17 +158,17 @@ export interface PutBucketAclCommandOutput extends __MetadataBearer {
|
|
|
152
158
|
* <p>By URI:</p>
|
|
153
159
|
* <p>
|
|
154
160
|
* <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
155
|
-
*
|
|
161
|
+
* xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
|
|
156
162
|
* </p>
|
|
157
163
|
* </li>
|
|
158
164
|
* <li>
|
|
159
165
|
* <p>By Email address:</p>
|
|
160
166
|
* <p>
|
|
161
167
|
* <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
162
|
-
*
|
|
168
|
+
* xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress>&</Grantee></code>
|
|
163
169
|
* </p>
|
|
164
|
-
* <p>The grantee is resolved to the CanonicalUser and, in a response to a GET
|
|
165
|
-
* acl request, appears as the CanonicalUser. </p>
|
|
170
|
+
* <p>The grantee is resolved to the CanonicalUser and, in a response to a GET
|
|
171
|
+
* Object acl request, appears as the CanonicalUser. </p>
|
|
166
172
|
* <note>
|
|
167
173
|
* <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
|
|
168
174
|
* <ul>
|
|
@@ -107,7 +107,8 @@ export interface PutBucketAnalyticsConfigurationCommandOutput extends __Metadata
|
|
|
107
107
|
* </ul>
|
|
108
108
|
* </li>
|
|
109
109
|
* </ul>
|
|
110
|
-
* <p>The following operations are related to
|
|
110
|
+
* <p>The following operations are related to
|
|
111
|
+
* <code>PutBucketAnalyticsConfiguration</code>:</p>
|
|
111
112
|
* <ul>
|
|
112
113
|
* <li>
|
|
113
114
|
* <p>
|
|
@@ -27,14 +27,10 @@ export interface PutBucketEncryptionCommandOutput extends __MetadataBearer {
|
|
|
27
27
|
* and Amazon S3 Bucket Keys for an existing bucket.</p>
|
|
28
28
|
* <p>By default, all buckets have a default encryption configuration that uses server-side
|
|
29
29
|
* encryption with Amazon S3 managed keys (SSE-S3). You can optionally configure default encryption
|
|
30
|
-
* for a bucket by using server-side encryption with Key Management Service (KMS) keys (SSE-KMS)
|
|
31
|
-
* dual-layer server-side encryption with Amazon Web Services KMS keys (DSSE-KMS)
|
|
32
|
-
*
|
|
33
|
-
*
|
|
34
|
-
* encryption, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">Amazon S3 bucket default encryption</a>
|
|
35
|
-
* in the <i>Amazon S3 User Guide</i>. For more information about S3 Bucket Keys, see
|
|
36
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket
|
|
37
|
-
* Keys</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
30
|
+
* for a bucket by using server-side encryption with Key Management Service (KMS) keys (SSE-KMS) or
|
|
31
|
+
* dual-layer server-side encryption with Amazon Web Services KMS keys (DSSE-KMS). If you specify default encryption by using
|
|
32
|
+
* SSE-KMS, you can also configure <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-key.html">Amazon S3 Bucket
|
|
33
|
+
* Keys</a>. If you use PutBucketEncryption to set your <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/bucket-encryption.html">default bucket encryption</a> to SSE-KMS, you should verify that your KMS key ID is correct. Amazon S3 does not validate the KMS key ID provided in PutBucketEncryption requests.</p>
|
|
38
34
|
* <important>
|
|
39
35
|
* <p>This action requires Amazon Web Services Signature Version 4. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sig-v4-authenticating-requests.html">
|
|
40
36
|
* Authenticating Requests (Amazon Web Services Signature Version 4)</a>. </p>
|
|
@@ -52,7 +52,8 @@ export interface PutBucketIntelligentTieringConfigurationCommandOutput extends _
|
|
|
52
52
|
* or Deep Archive Access tier.</p>
|
|
53
53
|
* </note>
|
|
54
54
|
* <p>
|
|
55
|
-
* <code>PutBucketIntelligentTieringConfiguration</code> has the following special
|
|
55
|
+
* <code>PutBucketIntelligentTieringConfiguration</code> has the following special
|
|
56
|
+
* errors:</p>
|
|
56
57
|
* <dl>
|
|
57
58
|
* <dt>HTTP 400 Bad Request Error</dt>
|
|
58
59
|
* <dd>
|
|
@@ -72,9 +73,9 @@ export interface PutBucketIntelligentTieringConfigurationCommandOutput extends _
|
|
|
72
73
|
* <dt>HTTP 403 Forbidden Error</dt>
|
|
73
74
|
* <dd>
|
|
74
75
|
* <p>
|
|
75
|
-
* <i>Cause:</i> You are not the owner of the specified bucket,
|
|
76
|
-
*
|
|
77
|
-
*
|
|
76
|
+
* <i>Cause:</i> You are not the owner of the specified bucket, or
|
|
77
|
+
* you do not have the <code>s3:PutIntelligentTieringConfiguration</code> bucket
|
|
78
|
+
* permission to set the configuration on the bucket. </p>
|
|
78
79
|
* </dd>
|
|
79
80
|
* </dl>
|
|
80
81
|
* @example
|
|
@@ -47,20 +47,19 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
|
|
|
47
47
|
* <dt>Permissions</dt>
|
|
48
48
|
* <dd>
|
|
49
49
|
* <p>To use this operation, you must have permission to perform the
|
|
50
|
-
*
|
|
51
|
-
* by default and can grant this permission to others. </p>
|
|
52
|
-
* <p>The <code>s3:PutInventoryConfiguration</code> permission allows a user to
|
|
53
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html">S3
|
|
54
|
-
*
|
|
55
|
-
*
|
|
56
|
-
*
|
|
57
|
-
* the inventory report. </p>
|
|
50
|
+
* <code>s3:PutInventoryConfiguration</code> action. The bucket owner has this
|
|
51
|
+
* permission by default and can grant this permission to others. </p>
|
|
52
|
+
* <p>The <code>s3:PutInventoryConfiguration</code> permission allows a user to
|
|
53
|
+
* create an <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html">S3 Inventory</a>
|
|
54
|
+
* report that includes all object metadata fields available and to specify the
|
|
55
|
+
* destination bucket to store the inventory. A user with read access to objects in
|
|
56
|
+
* the destination bucket can also access all object metadata fields that are
|
|
57
|
+
* available in the inventory report. </p>
|
|
58
58
|
* <p>To restrict access to an inventory report, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html#example-bucket-policies-use-case-10">Restricting access to an Amazon S3 Inventory report</a> in the
|
|
59
|
-
*
|
|
60
|
-
* available in S3 Inventory, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html#storage-inventory-contents">Amazon S3
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
* access management in Amazon S3</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
59
|
+
* <i>Amazon S3 User Guide</i>. For more information about the metadata
|
|
60
|
+
* fields available in S3 Inventory, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage-inventory.html#storage-inventory-contents">Amazon S3 Inventory lists</a> in the <i>Amazon S3 User Guide</i>. For
|
|
61
|
+
* 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">Identity and access management in Amazon S3</a> in the
|
|
62
|
+
* <i>Amazon S3 User Guide</i>.</p>
|
|
64
63
|
* </dd>
|
|
65
64
|
* </dl>
|
|
66
65
|
* <p>
|
|
@@ -79,17 +78,18 @@ export interface PutBucketInventoryConfigurationCommandOutput extends __Metadata
|
|
|
79
78
|
* <i>Code:</i> TooManyConfigurations</p>
|
|
80
79
|
* <p>
|
|
81
80
|
* <i>Cause:</i> You are attempting to create a new configuration
|
|
82
|
-
*
|
|
81
|
+
* but have already reached the 1,000-configuration limit. </p>
|
|
83
82
|
* </dd>
|
|
84
83
|
* <dt>HTTP 403 Forbidden Error</dt>
|
|
85
84
|
* <dd>
|
|
86
85
|
* <p>
|
|
87
|
-
* <i>Cause:</i> You are not the owner of the specified bucket,
|
|
88
|
-
*
|
|
89
|
-
*
|
|
86
|
+
* <i>Cause:</i> You are not the owner of the specified bucket, or
|
|
87
|
+
* you do not have the <code>s3:PutInventoryConfiguration</code> bucket permission to
|
|
88
|
+
* set the configuration on the bucket. </p>
|
|
90
89
|
* </dd>
|
|
91
90
|
* </dl>
|
|
92
|
-
* <p>The following operations are related to
|
|
91
|
+
* <p>The following operations are related to
|
|
92
|
+
* <code>PutBucketInventoryConfiguration</code>:</p>
|
|
93
93
|
* <ul>
|
|
94
94
|
* <li>
|
|
95
95
|
* <p>
|
|
@@ -39,40 +39,43 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
|
|
|
39
39
|
* <dt>Rules</dt>
|
|
40
40
|
* <dd>
|
|
41
41
|
* <p>You specify the lifecycle configuration in your request body. The lifecycle
|
|
42
|
-
* configuration is specified as XML consisting of one or more rules. An Amazon S3
|
|
43
|
-
* configuration can have up to 1,000 rules. This limit is not adjustable.
|
|
44
|
-
* of the following:</p>
|
|
42
|
+
* configuration is specified as XML consisting of one or more rules. An Amazon S3
|
|
43
|
+
* Lifecycle configuration can have up to 1,000 rules. This limit is not adjustable.
|
|
44
|
+
* Each rule consists of the following:</p>
|
|
45
45
|
* <ul>
|
|
46
46
|
* <li>
|
|
47
|
-
* <p>A filter identifying a subset of objects to which the rule applies. The
|
|
48
|
-
* be based on a key name prefix, object tags, or a combination of
|
|
47
|
+
* <p>A filter identifying a subset of objects to which the rule applies. The
|
|
48
|
+
* filter can be based on a key name prefix, object tags, or a combination of
|
|
49
|
+
* both.</p>
|
|
49
50
|
* </li>
|
|
50
51
|
* <li>
|
|
51
52
|
* <p>A status indicating whether the rule is in effect.</p>
|
|
52
53
|
* </li>
|
|
53
54
|
* <li>
|
|
54
|
-
* <p>One or more lifecycle transition and expiration actions that you want
|
|
55
|
-
* perform on the objects identified by the filter. If the state of
|
|
56
|
-
* versioning-enabled or versioning-suspended, you can have many
|
|
57
|
-
* object (one current version and zero or more noncurrent
|
|
58
|
-
* predefined actions that you can specify for current
|
|
59
|
-
* versions.</p>
|
|
55
|
+
* <p>One or more lifecycle transition and expiration actions that you want
|
|
56
|
+
* Amazon S3 to perform on the objects identified by the filter. If the state of
|
|
57
|
+
* your bucket is versioning-enabled or versioning-suspended, you can have many
|
|
58
|
+
* versions of the same object (one current version and zero or more noncurrent
|
|
59
|
+
* versions). Amazon S3 provides predefined actions that you can specify for current
|
|
60
|
+
* and noncurrent object versions.</p>
|
|
60
61
|
* </li>
|
|
61
62
|
* </ul>
|
|
62
|
-
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle
|
|
63
|
-
*
|
|
63
|
+
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-lifecycle-mgmt.html">Object Lifecycle
|
|
64
|
+
* Management</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/intro-lifecycle-rules.html">Lifecycle Configuration
|
|
65
|
+
* Elements</a>.</p>
|
|
64
66
|
* </dd>
|
|
65
67
|
* <dt>Permissions</dt>
|
|
66
68
|
* <dd>
|
|
67
|
-
* <p>By default, all Amazon S3 resources are private, including buckets, objects, and
|
|
68
|
-
* subresources (for example, lifecycle configuration and website
|
|
69
|
-
* resource owner (that is, the Amazon Web Services account that created
|
|
70
|
-
*
|
|
71
|
-
* policy. For this operation, a user must
|
|
72
|
-
* permission.</p>
|
|
73
|
-
* <p>You can also explicitly deny permissions. An explicit deny also supersedes any
|
|
74
|
-
* permissions. If you want to block users or accounts from removing or
|
|
75
|
-
* your bucket, you must deny them permissions for the
|
|
69
|
+
* <p>By default, all Amazon S3 resources are private, including buckets, objects, and
|
|
70
|
+
* related subresources (for example, lifecycle configuration and website
|
|
71
|
+
* configuration). Only the resource owner (that is, the Amazon Web Services account that created
|
|
72
|
+
* it) can access the resource. The resource owner can optionally grant access
|
|
73
|
+
* permissions to others by writing an access policy. For this operation, a user must
|
|
74
|
+
* get the <code>s3:PutLifecycleConfiguration</code> permission.</p>
|
|
75
|
+
* <p>You can also explicitly deny permissions. An explicit deny also supersedes any
|
|
76
|
+
* other permissions. If you want to block users or accounts from removing or
|
|
77
|
+
* deleting objects from your bucket, you must deny them permissions for the
|
|
78
|
+
* following actions:</p>
|
|
76
79
|
* <ul>
|
|
77
80
|
* <li>
|
|
78
81
|
* <p>
|
|
@@ -90,11 +93,12 @@ export interface PutBucketLifecycleConfigurationCommandOutput extends __Metadata
|
|
|
90
93
|
* </p>
|
|
91
94
|
* </li>
|
|
92
95
|
* </ul>
|
|
93
|
-
* <p>For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access
|
|
94
|
-
*
|
|
96
|
+
* <p>For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access
|
|
97
|
+
* Permissions to Your Amazon S3 Resources</a>.</p>
|
|
95
98
|
* </dd>
|
|
96
99
|
* </dl>
|
|
97
|
-
* <p>The following operations are related to
|
|
100
|
+
* <p>The following operations are related to
|
|
101
|
+
* <code>PutBucketLifecycleConfiguration</code>:</p>
|
|
98
102
|
* <ul>
|
|
99
103
|
* <li>
|
|
100
104
|
* <p>
|
|
@@ -41,15 +41,15 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
|
|
|
41
41
|
* <dl>
|
|
42
42
|
* <dt>Grantee Values</dt>
|
|
43
43
|
* <dd>
|
|
44
|
-
* <p>You can specify the person (grantee) to whom you're assigning access rights (by
|
|
45
|
-
* request elements) in the following ways:</p>
|
|
44
|
+
* <p>You can specify the person (grantee) to whom you're assigning access rights (by
|
|
45
|
+
* using request elements) in the following ways:</p>
|
|
46
46
|
* <ul>
|
|
47
47
|
* <li>
|
|
48
48
|
* <p>By the person's ID:</p>
|
|
49
49
|
* <p>
|
|
50
50
|
* <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
51
|
-
*
|
|
52
|
-
*
|
|
51
|
+
* xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
|
|
52
|
+
* </Grantee></code>
|
|
53
53
|
* </p>
|
|
54
54
|
* <p>
|
|
55
55
|
* <code>DisplayName</code> is optional and ignored in the request.</p>
|
|
@@ -58,23 +58,25 @@ export interface PutBucketLoggingCommandOutput extends __MetadataBearer {
|
|
|
58
58
|
* <p>By Email address:</p>
|
|
59
59
|
* <p>
|
|
60
60
|
* <code> <Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
61
|
-
*
|
|
61
|
+
* xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress></Grantee></code>
|
|
62
62
|
* </p>
|
|
63
|
-
* <p>The grantee is resolved to the <code>CanonicalUser</code> and, in a
|
|
64
|
-
*
|
|
63
|
+
* <p>The grantee is resolved to the <code>CanonicalUser</code> and, in a
|
|
64
|
+
* response to a <code>GETObjectAcl</code> request, appears as the
|
|
65
|
+
* CanonicalUser.</p>
|
|
65
66
|
* </li>
|
|
66
67
|
* <li>
|
|
67
68
|
* <p>By URI:</p>
|
|
68
69
|
* <p>
|
|
69
70
|
* <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
|
|
70
|
-
*
|
|
71
|
+
* xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
|
|
71
72
|
* </p>
|
|
72
73
|
* </li>
|
|
73
74
|
* </ul>
|
|
74
75
|
* </dd>
|
|
75
76
|
* </dl>
|
|
76
|
-
* <p>To enable logging, you use <code>LoggingEnabled</code> and its children request
|
|
77
|
-
* logging, you use an empty <code>BucketLoggingStatus</code> request
|
|
77
|
+
* <p>To enable logging, you use <code>LoggingEnabled</code> and its children request
|
|
78
|
+
* elements. To disable logging, you use an empty <code>BucketLoggingStatus</code> request
|
|
79
|
+
* element:</p>
|
|
78
80
|
* <p>
|
|
79
81
|
* <code><BucketLoggingStatus xmlns="http://doc.s3.amazonaws.com/2006-03-01"
|
|
80
82
|
* /></code>
|
|
@@ -34,10 +34,11 @@ export interface PutBucketPolicyCommandOutput extends __MetadataBearer {
|
|
|
34
34
|
* <important>
|
|
35
35
|
* <p>To ensure that bucket owners don't inadvertently lock themselves out of their own
|
|
36
36
|
* buckets, the root principal in a bucket owner's Amazon Web Services account can perform the
|
|
37
|
-
*
|
|
38
|
-
*
|
|
39
|
-
* denies the root principal's access. Bucket owner root principals can only be blocked
|
|
40
|
-
* these API actions by VPC endpoint policies and Amazon Web Services Organizations
|
|
37
|
+
* <code>GetBucketPolicy</code>, <code>PutBucketPolicy</code>, and
|
|
38
|
+
* <code>DeleteBucketPolicy</code> API actions, even if their bucket policy explicitly
|
|
39
|
+
* denies the root principal's access. Bucket owner root principals can only be blocked
|
|
40
|
+
* from performing these API actions by VPC endpoint policies and Amazon Web Services Organizations
|
|
41
|
+
* policies.</p>
|
|
41
42
|
* </important>
|
|
42
43
|
* <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-bucket-policies.html">Bucket policy
|
|
43
44
|
* examples</a>.</p>
|
|
@@ -28,7 +28,11 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
|
|
|
28
28
|
* <p>Specify the replication configuration in the request body. In the replication
|
|
29
29
|
* configuration, you provide the name of the destination bucket or buckets where you want
|
|
30
30
|
* Amazon S3 to replicate objects, the IAM role that Amazon S3 can assume to replicate objects on your
|
|
31
|
-
* behalf, and other relevant information
|
|
31
|
+
* behalf, and other relevant information. You can invoke this request for a specific
|
|
32
|
+
* Amazon Web Services Region by using the
|
|
33
|
+
* <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_condition-keys.html#condition-keys-requestedregion">
|
|
34
|
+
* <code>aws:RequestedRegion</code>
|
|
35
|
+
* </a> condition key.</p>
|
|
32
36
|
* <p>A replication configuration must include at least one rule, and can contain a maximum of
|
|
33
37
|
* 1,000. Each rule identifies a subset of objects to replicate by filtering the objects in
|
|
34
38
|
* the source bucket. To choose additional subsets of objects to replicate, add a rule for
|
|
@@ -47,31 +51,33 @@ export interface PutBucketReplicationCommandOutput extends __MetadataBearer {
|
|
|
47
51
|
* <dl>
|
|
48
52
|
* <dt>Handling Replication of Encrypted Objects</dt>
|
|
49
53
|
* <dd>
|
|
50
|
-
* <p>By default, Amazon S3 doesn't replicate objects that are stored at rest using
|
|
51
|
-
* encryption with KMS keys. To replicate Amazon Web Services KMS-encrypted objects,
|
|
52
|
-
* <code>SourceSelectionCriteria</code>,
|
|
53
|
-
*
|
|
54
|
-
*
|
|
55
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html">Replicating
|
|
56
|
-
* Created with SSE Using KMS keys</a>.</p>
|
|
54
|
+
* <p>By default, Amazon S3 doesn't replicate objects that are stored at rest using
|
|
55
|
+
* server-side encryption with KMS keys. To replicate Amazon Web Services KMS-encrypted objects,
|
|
56
|
+
* add the following: <code>SourceSelectionCriteria</code>,
|
|
57
|
+
* <code>SseKmsEncryptedObjects</code>, <code>Status</code>,
|
|
58
|
+
* <code>EncryptionConfiguration</code>, and <code>ReplicaKmsKeyID</code>. For
|
|
59
|
+
* information about replication configuration, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html">Replicating
|
|
60
|
+
* Objects Created with SSE Using KMS keys</a>.</p>
|
|
57
61
|
* <p>For information on <code>PutBucketReplication</code> errors, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#ReplicationErrorCodeList">List of
|
|
58
|
-
*
|
|
62
|
+
* replication-related error codes</a>
|
|
59
63
|
* </p>
|
|
60
64
|
* </dd>
|
|
61
65
|
* <dt>Permissions</dt>
|
|
62
66
|
* <dd>
|
|
63
67
|
* <p>To create a <code>PutBucketReplication</code> request, you must have
|
|
64
|
-
*
|
|
68
|
+
* <code>s3:PutReplicationConfiguration</code> permissions for the bucket.
|
|
65
69
|
*
|
|
66
70
|
* </p>
|
|
67
|
-
* <p>By default, a resource owner, in this case the Amazon Web Services account that created the
|
|
68
|
-
* can perform this operation. The resource owner can also grant others
|
|
69
|
-
* the operation. For more information about permissions, see
|
|
70
|
-
*
|
|
71
|
-
*
|
|
71
|
+
* <p>By default, a resource owner, in this case the Amazon Web Services account that created the
|
|
72
|
+
* bucket, can perform this operation. The resource owner can also grant others
|
|
73
|
+
* permissions to perform the operation. For more information about permissions, see
|
|
74
|
+
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in
|
|
75
|
+
* a Policy</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access
|
|
76
|
+
* Permissions to Your Amazon S3 Resources</a>.</p>
|
|
72
77
|
* <note>
|
|
73
|
-
* <p>To perform this operation, the user or role performing the action must have
|
|
74
|
-
* <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">iam:PassRole</a>
|
|
78
|
+
* <p>To perform this operation, the user or role performing the action must have
|
|
79
|
+
* the <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">iam:PassRole</a>
|
|
80
|
+
* permission.</p>
|
|
75
81
|
* </note>
|
|
76
82
|
* </dd>
|
|
77
83
|
* </dl>
|
|
@@ -30,8 +30,8 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
|
|
|
30
30
|
* same tag key values. For example, you can tag several resources with a specific application
|
|
31
31
|
* name, and then organize your billing information to see the total cost of that application
|
|
32
32
|
* across several services. For more information, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/cost-alloc-tags.html">Cost Allocation and
|
|
33
|
-
* Tagging</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/
|
|
34
|
-
* Tags</a>.</p>
|
|
33
|
+
* Tagging</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/CostAllocTagging.html">Using Cost Allocation in Amazon S3
|
|
34
|
+
* Bucket Tags</a>.</p>
|
|
35
35
|
* <note>
|
|
36
36
|
* <p> When this operation sets the tags for a bucket, it will overwrite any current tags
|
|
37
37
|
* the bucket already has. You cannot use this operation to add tags to an existing list of
|
|
@@ -42,47 +42,30 @@ export interface PutBucketTaggingCommandOutput extends __MetadataBearer {
|
|
|
42
42
|
* 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
|
|
43
43
|
* Access Permissions to Your Amazon S3 Resources</a>.</p>
|
|
44
44
|
* <p>
|
|
45
|
-
* <code>PutBucketTagging</code> has the following special errors
|
|
45
|
+
* <code>PutBucketTagging</code> has the following special errors. For more Amazon S3 errors
|
|
46
|
+
* see, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html">Error
|
|
47
|
+
* Responses</a>.</p>
|
|
46
48
|
* <ul>
|
|
47
49
|
* <li>
|
|
48
|
-
* <p>
|
|
49
|
-
*
|
|
50
|
-
* <
|
|
51
|
-
*
|
|
52
|
-
* <p>Description: The tag provided was not a valid tag. This error can occur if
|
|
53
|
-
* the tag did not pass input validation. For information about tag restrictions,
|
|
54
|
-
* see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html">User-Defined Tag Restrictions</a> and <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/aws-tag-restrictions.html">Amazon Web Services-Generated Cost Allocation Tag Restrictions</a>.</p>
|
|
55
|
-
* </li>
|
|
56
|
-
* </ul>
|
|
50
|
+
* <p>
|
|
51
|
+
* <code>InvalidTag</code> - The tag provided was not a valid tag. This error
|
|
52
|
+
* can occur if the tag did not pass input validation. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/CostAllocTagging.html">Using
|
|
53
|
+
* Cost Allocation in Amazon S3 Bucket Tags</a>.</p>
|
|
57
54
|
* </li>
|
|
58
55
|
* <li>
|
|
59
|
-
* <p>
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
* <li>
|
|
63
|
-
* <p>Description: The XML provided does not match the schema.</p>
|
|
64
|
-
* </li>
|
|
65
|
-
* </ul>
|
|
56
|
+
* <p>
|
|
57
|
+
* <code>MalformedXML</code> - The XML provided does not match the
|
|
58
|
+
* schema.</p>
|
|
66
59
|
* </li>
|
|
67
60
|
* <li>
|
|
68
|
-
* <p>
|
|
69
|
-
*
|
|
70
|
-
*
|
|
71
|
-
* <li>
|
|
72
|
-
* <p>Description: A conflicting conditional action is currently in progress
|
|
73
|
-
* against this resource. Please try again.</p>
|
|
74
|
-
* </li>
|
|
75
|
-
* </ul>
|
|
61
|
+
* <p>
|
|
62
|
+
* <code>OperationAborted</code> - A conflicting conditional action is
|
|
63
|
+
* currently in progress against this resource. Please try again.</p>
|
|
76
64
|
* </li>
|
|
77
65
|
* <li>
|
|
78
|
-
* <p>
|
|
79
|
-
*
|
|
80
|
-
*
|
|
81
|
-
* <li>
|
|
82
|
-
* <p>Description: The service was unable to apply the provided tag to the
|
|
83
|
-
* bucket.</p>
|
|
84
|
-
* </li>
|
|
85
|
-
* </ul>
|
|
66
|
+
* <p>
|
|
67
|
+
* <code>InternalError</code> - The service was unable to apply the provided
|
|
68
|
+
* tag to the bucket.</p>
|
|
86
69
|
* </li>
|
|
87
70
|
* </ul>
|
|
88
71
|
* <p>The following operations are related to <code>PutBucketTagging</code>:</p>
|
|
@@ -39,12 +39,12 @@ export interface PutBucketVersioningCommandOutput extends __MetadataBearer {
|
|
|
39
39
|
* <code>MfaDelete</code> request elements in a request to set the versioning state of the
|
|
40
40
|
* bucket.</p>
|
|
41
41
|
* <important>
|
|
42
|
-
* <p>If you have an object expiration lifecycle configuration in your non-versioned bucket
|
|
43
|
-
* you want to maintain the same permanent delete behavior when you enable versioning,
|
|
44
|
-
* must add a noncurrent expiration policy. The noncurrent expiration lifecycle
|
|
45
|
-
* manage the deletes of the noncurrent object versions in the
|
|
46
|
-
* version-enabled bucket maintains one current and zero or more
|
|
47
|
-
* 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>
|
|
42
|
+
* <p>If you have an object expiration lifecycle configuration in your non-versioned bucket
|
|
43
|
+
* and you want to maintain the same permanent delete behavior when you enable versioning,
|
|
44
|
+
* you must add a noncurrent expiration policy. The noncurrent expiration lifecycle
|
|
45
|
+
* configuration will manage the deletes of the noncurrent object versions in the
|
|
46
|
+
* version-enabled bucket. (A version-enabled bucket maintains one current and zero or more
|
|
47
|
+
* noncurrent object 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>
|
|
48
48
|
* </important>
|
|
49
49
|
* <p>The following operations are related to <code>PutBucketVersioning</code>:</p>
|
|
50
50
|
* <ul>
|
|
@@ -145,6 +145,7 @@ export interface PutBucketWebsiteCommandOutput extends __MetadataBearer {
|
|
|
145
145
|
* <p>Amazon S3 has a limitation of 50 routing rules per website configuration. If you require more
|
|
146
146
|
* 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
|
|
147
147
|
* Object Redirect</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
148
|
+
* <p>The maximum request length is limited to 128 KB.</p>
|
|
148
149
|
* @example
|
|
149
150
|
* Use a bare-bones client and the command you need to make an API call.
|
|
150
151
|
* ```javascript
|