@aws-sdk/client-s3 3.36.0 → 3.39.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/CHANGELOG.md +42 -0
- package/dist-cjs/S3.js +0 -3
- package/dist-cjs/S3Client.js +0 -8
- package/dist-cjs/commands/AbortMultipartUploadCommand.js +0 -62
- package/dist-cjs/commands/CompleteMultipartUploadCommand.js +0 -133
- package/dist-cjs/commands/CopyObjectCommand.js +0 -193
- package/dist-cjs/commands/CreateBucketCommand.js +0 -142
- package/dist-cjs/commands/CreateMultipartUploadCommand.js +0 -281
- package/dist-cjs/commands/DeleteBucketAnalyticsConfigurationCommand.js +0 -53
- package/dist-cjs/commands/DeleteBucketCommand.js +0 -41
- package/dist-cjs/commands/DeleteBucketCorsCommand.js +0 -45
- package/dist-cjs/commands/DeleteBucketEncryptionCommand.js +0 -47
- package/dist-cjs/commands/DeleteBucketIntelligentTieringConfigurationCommand.js +0 -46
- package/dist-cjs/commands/DeleteBucketInventoryConfigurationCommand.js +0 -49
- package/dist-cjs/commands/DeleteBucketLifecycleCommand.js +0 -49
- package/dist-cjs/commands/DeleteBucketMetricsConfigurationCommand.js +0 -59
- package/dist-cjs/commands/DeleteBucketOwnershipControlsCommand.js +0 -42
- package/dist-cjs/commands/DeleteBucketPolicyCommand.js +0 -56
- package/dist-cjs/commands/DeleteBucketReplicationCommand.js +0 -49
- package/dist-cjs/commands/DeleteBucketTaggingCommand.js +0 -41
- package/dist-cjs/commands/DeleteBucketWebsiteCommand.js +0 -50
- package/dist-cjs/commands/DeleteObjectCommand.js +0 -54
- package/dist-cjs/commands/DeleteObjectTaggingCommand.js +0 -48
- package/dist-cjs/commands/DeleteObjectsCommand.js +0 -80
- package/dist-cjs/commands/DeletePublicAccessBlockCommand.js +0 -52
- package/dist-cjs/commands/GetBucketAccelerateConfigurationCommand.js +0 -50
- package/dist-cjs/commands/GetBucketAclCommand.js +0 -39
- package/dist-cjs/commands/GetBucketAnalyticsConfigurationCommand.js +0 -53
- package/dist-cjs/commands/GetBucketCorsCommand.js +0 -44
- package/dist-cjs/commands/GetBucketEncryptionCommand.js +0 -45
- package/dist-cjs/commands/GetBucketIntelligentTieringConfigurationCommand.js +0 -46
- package/dist-cjs/commands/GetBucketInventoryConfigurationCommand.js +0 -53
- package/dist-cjs/commands/GetBucketLifecycleConfigurationCommand.js +0 -79
- package/dist-cjs/commands/GetBucketLocationCommand.js +0 -44
- package/dist-cjs/commands/GetBucketLoggingCommand.js +0 -39
- package/dist-cjs/commands/GetBucketMetricsConfigurationCommand.js +0 -60
- package/dist-cjs/commands/GetBucketNotificationConfigurationCommand.js +0 -44
- package/dist-cjs/commands/GetBucketOwnershipControlsCommand.js +0 -41
- package/dist-cjs/commands/GetBucketPolicyCommand.js +0 -50
- package/dist-cjs/commands/GetBucketPolicyStatusCommand.js +0 -54
- package/dist-cjs/commands/GetBucketReplicationCommand.js +0 -58
- package/dist-cjs/commands/GetBucketRequestPaymentCommand.js +0 -34
- package/dist-cjs/commands/GetBucketTaggingCommand.js +0 -55
- package/dist-cjs/commands/GetBucketVersioningCommand.js +0 -48
- package/dist-cjs/commands/GetBucketWebsiteCommand.js +0 -44
- package/dist-cjs/commands/GetObjectAclCommand.js +0 -50
- package/dist-cjs/commands/GetObjectCommand.js +0 -204
- package/dist-cjs/commands/GetObjectLegalHoldCommand.js +0 -25
- package/dist-cjs/commands/GetObjectLockConfigurationCommand.js +0 -27
- package/dist-cjs/commands/GetObjectRetentionCommand.js +0 -25
- package/dist-cjs/commands/GetObjectTaggingCommand.js +0 -51
- package/dist-cjs/commands/GetObjectTorrentCommand.js +0 -40
- package/dist-cjs/commands/GetPublicAccessBlockCommand.js +0 -63
- package/dist-cjs/commands/HeadBucketCommand.js +0 -39
- package/dist-cjs/commands/HeadObjectCommand.js +0 -135
- package/dist-cjs/commands/ListBucketAnalyticsConfigurationsCommand.js +0 -63
- package/dist-cjs/commands/ListBucketIntelligentTieringConfigurationsCommand.js +0 -46
- package/dist-cjs/commands/ListBucketInventoryConfigurationsCommand.js +0 -62
- package/dist-cjs/commands/ListBucketMetricsConfigurationsCommand.js +0 -64
- package/dist-cjs/commands/ListBucketsCommand.js +0 -24
- package/dist-cjs/commands/ListMultipartUploadsCommand.js +0 -74
- package/dist-cjs/commands/ListObjectVersionsCommand.js +0 -62
- package/dist-cjs/commands/ListObjectsCommand.js +0 -61
- package/dist-cjs/commands/ListObjectsV2Command.js +0 -65
- package/dist-cjs/commands/ListPartsCommand.js +0 -68
- package/dist-cjs/commands/PutBucketAccelerateConfigurationCommand.js +0 -69
- package/dist-cjs/commands/PutBucketAclCommand.js +0 -213
- package/dist-cjs/commands/PutBucketAnalyticsConfigurationCommand.js +0 -139
- package/dist-cjs/commands/PutBucketCorsCommand.js +0 -80
- package/dist-cjs/commands/PutBucketEncryptionCommand.js +0 -56
- package/dist-cjs/commands/PutBucketIntelligentTieringConfigurationCommand.js +0 -106
- package/dist-cjs/commands/PutBucketInventoryConfigurationCommand.js +0 -124
- package/dist-cjs/commands/PutBucketLifecycleConfigurationCommand.js +0 -117
- package/dist-cjs/commands/PutBucketLoggingCommand.js +0 -103
- package/dist-cjs/commands/PutBucketMetricsConfigurationCommand.js +0 -74
- package/dist-cjs/commands/PutBucketNotificationConfigurationCommand.js +0 -85
- package/dist-cjs/commands/PutBucketOwnershipControlsCommand.js +0 -40
- package/dist-cjs/commands/PutBucketPolicyCommand.js +0 -53
- package/dist-cjs/commands/PutBucketReplicationCommand.js +0 -93
- package/dist-cjs/commands/PutBucketRequestPaymentCommand.js +0 -42
- package/dist-cjs/commands/PutBucketTaggingCommand.js +0 -102
- package/dist-cjs/commands/PutBucketVersioningCommand.js +0 -72
- package/dist-cjs/commands/PutBucketWebsiteCommand.js +0 -149
- package/dist-cjs/commands/PutObjectAclCommand.js +0 -200
- package/dist-cjs/commands/PutObjectCommand.js +0 -118
- package/dist-cjs/commands/PutObjectLegalHoldCommand.js +0 -27
- package/dist-cjs/commands/PutObjectLockConfigurationCommand.js +0 -44
- package/dist-cjs/commands/PutObjectRetentionCommand.js +0 -36
- package/dist-cjs/commands/PutObjectTaggingCommand.js +0 -127
- package/dist-cjs/commands/PutPublicAccessBlockCommand.js +0 -68
- package/dist-cjs/commands/RestoreObjectCommand.js +0 -315
- package/dist-cjs/commands/SelectObjectContentCommand.js +0 -140
- package/dist-cjs/commands/UploadPartCommand.js +0 -161
- package/dist-cjs/commands/UploadPartCopyCommand.js +0 -202
- package/dist-cjs/commands/WriteGetObjectResponseCommand.js +0 -46
- package/dist-cjs/commands/index.js +95 -0
- package/dist-cjs/endpoints.js +6 -1
- package/dist-cjs/index.js +5 -101
- package/dist-cjs/models/models_0.js +0 -753
- package/dist-cjs/models/models_1.js +0 -96
- package/dist-cjs/pagination/ListObjectsV2Paginator.js +0 -10
- package/dist-cjs/pagination/ListPartsPaginator.js +0 -10
- package/dist-cjs/pagination/index.js +6 -0
- package/dist-cjs/protocols/Aws_restXml.js +0 -2
- package/dist-cjs/runtimeConfig.browser.js +1 -5
- package/dist-cjs/runtimeConfig.js +1 -5
- package/dist-cjs/runtimeConfig.native.js +0 -3
- package/dist-cjs/runtimeConfig.shared.js +0 -3
- package/dist-cjs/waiters/index.js +7 -0
- package/dist-cjs/waiters/waitForBucketExists.js +0 -9
- package/dist-cjs/waiters/waitForBucketNotExists.js +0 -9
- package/dist-cjs/waiters/waitForObjectExists.js +0 -9
- package/dist-cjs/waiters/waitForObjectNotExists.js +0 -9
- package/dist-es/commands/index.js +92 -0
- package/dist-es/endpoints.js +6 -1
- package/dist-es/index.js +5 -101
- package/dist-es/pagination/index.js +3 -0
- package/dist-es/waiters/index.js +4 -0
- package/dist-types/commands/index.d.ts +92 -0
- package/dist-types/index.d.ts +5 -101
- package/dist-types/pagination/index.d.ts +3 -0
- package/dist-types/ts3.4/S3.d.ts +93 -5172
- package/dist-types/ts3.4/S3Client.d.ts +30 -109
- package/dist-types/ts3.4/commands/AbortMultipartUploadCommand.d.ts +2 -58
- package/dist-types/ts3.4/commands/CompleteMultipartUploadCommand.d.ts +2 -129
- package/dist-types/ts3.4/commands/CopyObjectCommand.d.ts +2 -189
- package/dist-types/ts3.4/commands/CreateBucketCommand.d.ts +2 -138
- package/dist-types/ts3.4/commands/CreateMultipartUploadCommand.d.ts +2 -277
- package/dist-types/ts3.4/commands/DeleteBucketAnalyticsConfigurationCommand.d.ts +2 -49
- package/dist-types/ts3.4/commands/DeleteBucketCommand.d.ts +2 -37
- package/dist-types/ts3.4/commands/DeleteBucketCorsCommand.d.ts +2 -41
- package/dist-types/ts3.4/commands/DeleteBucketEncryptionCommand.d.ts +2 -43
- package/dist-types/ts3.4/commands/DeleteBucketIntelligentTieringConfigurationCommand.d.ts +2 -42
- package/dist-types/ts3.4/commands/DeleteBucketInventoryConfigurationCommand.d.ts +2 -45
- package/dist-types/ts3.4/commands/DeleteBucketLifecycleCommand.d.ts +2 -45
- package/dist-types/ts3.4/commands/DeleteBucketMetricsConfigurationCommand.d.ts +2 -55
- package/dist-types/ts3.4/commands/DeleteBucketOwnershipControlsCommand.d.ts +2 -38
- package/dist-types/ts3.4/commands/DeleteBucketPolicyCommand.d.ts +2 -52
- package/dist-types/ts3.4/commands/DeleteBucketReplicationCommand.d.ts +2 -45
- package/dist-types/ts3.4/commands/DeleteBucketTaggingCommand.d.ts +2 -37
- package/dist-types/ts3.4/commands/DeleteBucketWebsiteCommand.d.ts +2 -46
- package/dist-types/ts3.4/commands/DeleteObjectCommand.d.ts +2 -50
- package/dist-types/ts3.4/commands/DeleteObjectTaggingCommand.d.ts +2 -44
- package/dist-types/ts3.4/commands/DeleteObjectsCommand.d.ts +2 -76
- package/dist-types/ts3.4/commands/DeletePublicAccessBlockCommand.d.ts +2 -48
- package/dist-types/ts3.4/commands/GetBucketAccelerateConfigurationCommand.d.ts +2 -46
- package/dist-types/ts3.4/commands/GetBucketAclCommand.d.ts +2 -35
- package/dist-types/ts3.4/commands/GetBucketAnalyticsConfigurationCommand.d.ts +2 -49
- package/dist-types/ts3.4/commands/GetBucketCorsCommand.d.ts +2 -40
- package/dist-types/ts3.4/commands/GetBucketEncryptionCommand.d.ts +2 -41
- package/dist-types/ts3.4/commands/GetBucketIntelligentTieringConfigurationCommand.d.ts +2 -42
- package/dist-types/ts3.4/commands/GetBucketInventoryConfigurationCommand.d.ts +2 -49
- package/dist-types/ts3.4/commands/GetBucketLifecycleConfigurationCommand.d.ts +2 -75
- package/dist-types/ts3.4/commands/GetBucketLocationCommand.d.ts +2 -40
- package/dist-types/ts3.4/commands/GetBucketLoggingCommand.d.ts +2 -35
- package/dist-types/ts3.4/commands/GetBucketMetricsConfigurationCommand.d.ts +2 -56
- package/dist-types/ts3.4/commands/GetBucketNotificationConfigurationCommand.d.ts +2 -40
- package/dist-types/ts3.4/commands/GetBucketOwnershipControlsCommand.d.ts +2 -37
- package/dist-types/ts3.4/commands/GetBucketPolicyCommand.d.ts +2 -46
- package/dist-types/ts3.4/commands/GetBucketPolicyStatusCommand.d.ts +2 -50
- package/dist-types/ts3.4/commands/GetBucketReplicationCommand.d.ts +2 -54
- package/dist-types/ts3.4/commands/GetBucketRequestPaymentCommand.d.ts +2 -30
- package/dist-types/ts3.4/commands/GetBucketTaggingCommand.d.ts +2 -51
- package/dist-types/ts3.4/commands/GetBucketVersioningCommand.d.ts +2 -44
- package/dist-types/ts3.4/commands/GetBucketWebsiteCommand.d.ts +2 -40
- package/dist-types/ts3.4/commands/GetObjectAclCommand.d.ts +2 -46
- package/dist-types/ts3.4/commands/GetObjectCommand.d.ts +2 -200
- package/dist-types/ts3.4/commands/GetObjectLegalHoldCommand.d.ts +2 -21
- package/dist-types/ts3.4/commands/GetObjectLockConfigurationCommand.d.ts +2 -23
- package/dist-types/ts3.4/commands/GetObjectRetentionCommand.d.ts +2 -21
- package/dist-types/ts3.4/commands/GetObjectTaggingCommand.d.ts +2 -47
- package/dist-types/ts3.4/commands/GetObjectTorrentCommand.d.ts +2 -36
- package/dist-types/ts3.4/commands/GetPublicAccessBlockCommand.d.ts +2 -59
- package/dist-types/ts3.4/commands/HeadBucketCommand.d.ts +2 -35
- package/dist-types/ts3.4/commands/HeadObjectCommand.d.ts +2 -131
- package/dist-types/ts3.4/commands/ListBucketAnalyticsConfigurationsCommand.d.ts +2 -59
- package/dist-types/ts3.4/commands/ListBucketIntelligentTieringConfigurationsCommand.d.ts +2 -42
- package/dist-types/ts3.4/commands/ListBucketInventoryConfigurationsCommand.d.ts +2 -58
- package/dist-types/ts3.4/commands/ListBucketMetricsConfigurationsCommand.d.ts +2 -60
- package/dist-types/ts3.4/commands/ListBucketsCommand.d.ts +2 -20
- package/dist-types/ts3.4/commands/ListMultipartUploadsCommand.d.ts +2 -70
- package/dist-types/ts3.4/commands/ListObjectVersionsCommand.d.ts +2 -58
- package/dist-types/ts3.4/commands/ListObjectsCommand.d.ts +2 -57
- package/dist-types/ts3.4/commands/ListObjectsV2Command.d.ts +2 -61
- package/dist-types/ts3.4/commands/ListPartsCommand.d.ts +2 -64
- package/dist-types/ts3.4/commands/PutBucketAccelerateConfigurationCommand.d.ts +2 -65
- package/dist-types/ts3.4/commands/PutBucketAclCommand.d.ts +2 -209
- package/dist-types/ts3.4/commands/PutBucketAnalyticsConfigurationCommand.d.ts +2 -135
- package/dist-types/ts3.4/commands/PutBucketCorsCommand.d.ts +2 -76
- package/dist-types/ts3.4/commands/PutBucketEncryptionCommand.d.ts +2 -52
- package/dist-types/ts3.4/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +2 -102
- package/dist-types/ts3.4/commands/PutBucketInventoryConfigurationCommand.d.ts +2 -120
- package/dist-types/ts3.4/commands/PutBucketLifecycleConfigurationCommand.d.ts +2 -113
- package/dist-types/ts3.4/commands/PutBucketLoggingCommand.d.ts +2 -99
- package/dist-types/ts3.4/commands/PutBucketMetricsConfigurationCommand.d.ts +2 -70
- package/dist-types/ts3.4/commands/PutBucketNotificationConfigurationCommand.d.ts +2 -81
- package/dist-types/ts3.4/commands/PutBucketOwnershipControlsCommand.d.ts +2 -36
- package/dist-types/ts3.4/commands/PutBucketPolicyCommand.d.ts +2 -49
- package/dist-types/ts3.4/commands/PutBucketReplicationCommand.d.ts +2 -89
- package/dist-types/ts3.4/commands/PutBucketRequestPaymentCommand.d.ts +2 -38
- package/dist-types/ts3.4/commands/PutBucketTaggingCommand.d.ts +2 -98
- package/dist-types/ts3.4/commands/PutBucketVersioningCommand.d.ts +2 -68
- package/dist-types/ts3.4/commands/PutBucketWebsiteCommand.d.ts +2 -145
- package/dist-types/ts3.4/commands/PutObjectAclCommand.d.ts +2 -196
- package/dist-types/ts3.4/commands/PutObjectCommand.d.ts +5 -121
- package/dist-types/ts3.4/commands/PutObjectLegalHoldCommand.d.ts +2 -23
- package/dist-types/ts3.4/commands/PutObjectLockConfigurationCommand.d.ts +2 -40
- package/dist-types/ts3.4/commands/PutObjectRetentionCommand.d.ts +2 -32
- package/dist-types/ts3.4/commands/PutObjectTaggingCommand.d.ts +2 -123
- package/dist-types/ts3.4/commands/PutPublicAccessBlockCommand.d.ts +2 -64
- package/dist-types/ts3.4/commands/RestoreObjectCommand.d.ts +2 -311
- package/dist-types/ts3.4/commands/SelectObjectContentCommand.d.ts +2 -136
- package/dist-types/ts3.4/commands/UploadPartCommand.d.ts +5 -164
- package/dist-types/ts3.4/commands/UploadPartCopyCommand.d.ts +2 -198
- package/dist-types/ts3.4/commands/WriteGetObjectResponseCommand.d.ts +5 -49
- package/dist-types/ts3.4/commands/index.d.ts +92 -0
- package/dist-types/ts3.4/index.d.ts +5 -101
- package/dist-types/ts3.4/models/models_0.d.ts +1305 -7281
- package/dist-types/ts3.4/models/models_1.d.ts +223 -956
- package/dist-types/ts3.4/pagination/index.d.ts +3 -0
- package/dist-types/ts3.4/runtimeConfig.browser.d.ts +2 -4
- package/dist-types/ts3.4/runtimeConfig.d.ts +2 -4
- package/dist-types/ts3.4/runtimeConfig.native.d.ts +2 -4
- package/dist-types/ts3.4/runtimeConfig.shared.d.ts +1 -3
- package/dist-types/ts3.4/waiters/index.d.ts +4 -0
- package/dist-types/ts3.4/waiters/waitForBucketExists.d.ts +2 -9
- package/dist-types/ts3.4/waiters/waitForBucketNotExists.d.ts +2 -9
- package/dist-types/ts3.4/waiters/waitForObjectExists.d.ts +2 -9
- package/dist-types/ts3.4/waiters/waitForObjectNotExists.d.ts +2 -9
- package/dist-types/waiters/index.d.ts +4 -0
- package/package.json +46 -46
|
@@ -7,64 +7,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
|
|
|
7
7
|
const smithy_client_1 = require("@aws-sdk/smithy-client");
|
|
8
8
|
const models_0_1 = require("../models/models_0");
|
|
9
9
|
const Aws_restXml_1 = require("../protocols/Aws_restXml");
|
|
10
|
-
/**
|
|
11
|
-
* <p>Applies an Amazon S3 bucket policy to an Amazon S3 bucket. If you are using an identity other than
|
|
12
|
-
* the root user of the Amazon Web Services account that owns the bucket, the calling identity must have the
|
|
13
|
-
* <code>PutBucketPolicy</code> permissions on the specified bucket and belong to the
|
|
14
|
-
* bucket owner's account in order to use this operation.</p>
|
|
15
|
-
*
|
|
16
|
-
* <p>If you don't have <code>PutBucketPolicy</code> permissions, Amazon S3 returns a <code>403
|
|
17
|
-
* Access Denied</code> error. If you have the correct permissions, but you're not using an
|
|
18
|
-
* identity that belongs to the bucket owner's account, Amazon S3 returns a <code>405 Method Not
|
|
19
|
-
* Allowed</code> error.</p>
|
|
20
|
-
*
|
|
21
|
-
* <important>
|
|
22
|
-
* <p> As a security precaution, the root user of the Amazon Web Services account that owns a bucket can
|
|
23
|
-
* always use this operation, even if the policy explicitly denies the root user the
|
|
24
|
-
* ability to perform this action. </p>
|
|
25
|
-
* </important>
|
|
26
|
-
* <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
|
-
* <p>The following operations are related to <code>PutBucketPolicy</code>:</p>
|
|
29
|
-
* <ul>
|
|
30
|
-
* <li>
|
|
31
|
-
* <p>
|
|
32
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>
|
|
33
|
-
* </p>
|
|
34
|
-
* </li>
|
|
35
|
-
* <li>
|
|
36
|
-
* <p>
|
|
37
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html">DeleteBucket</a>
|
|
38
|
-
* </p>
|
|
39
|
-
* </li>
|
|
40
|
-
* </ul>
|
|
41
|
-
* @example
|
|
42
|
-
* Use a bare-bones client and the command you need to make an API call.
|
|
43
|
-
* ```javascript
|
|
44
|
-
* import { S3Client, PutBucketPolicyCommand } from "@aws-sdk/client-s3"; // ES Modules import
|
|
45
|
-
* // const { S3Client, PutBucketPolicyCommand } = require("@aws-sdk/client-s3"); // CommonJS import
|
|
46
|
-
* const client = new S3Client(config);
|
|
47
|
-
* const command = new PutBucketPolicyCommand(input);
|
|
48
|
-
* const response = await client.send(command);
|
|
49
|
-
* ```
|
|
50
|
-
*
|
|
51
|
-
* @see {@link PutBucketPolicyCommandInput} for command's `input` shape.
|
|
52
|
-
* @see {@link PutBucketPolicyCommandOutput} for command's `response` shape.
|
|
53
|
-
* @see {@link S3ClientResolvedConfig | config} for command's `input` shape.
|
|
54
|
-
*
|
|
55
|
-
*/
|
|
56
10
|
class PutBucketPolicyCommand extends smithy_client_1.Command {
|
|
57
|
-
// Start section: command_properties
|
|
58
|
-
// End section: command_properties
|
|
59
11
|
constructor(input) {
|
|
60
|
-
// Start section: command_constructor
|
|
61
12
|
super();
|
|
62
13
|
this.input = input;
|
|
63
|
-
// End section: command_constructor
|
|
64
14
|
}
|
|
65
|
-
/**
|
|
66
|
-
* @internal
|
|
67
|
-
*/
|
|
68
15
|
resolveMiddleware(clientStack, configuration, options) {
|
|
69
16
|
this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
|
|
70
17
|
this.middlewareStack.use(middleware_bucket_endpoint_1.getBucketEndpointPlugin(configuration));
|
|
@@ -7,104 +7,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
|
|
|
7
7
|
const smithy_client_1 = require("@aws-sdk/smithy-client");
|
|
8
8
|
const models_0_1 = require("../models/models_0");
|
|
9
9
|
const Aws_restXml_1 = require("../protocols/Aws_restXml");
|
|
10
|
-
/**
|
|
11
|
-
* <p> Creates a replication configuration or replaces an existing one. For more information,
|
|
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
|
-
* <p>Specify the replication configuration in the request body. In the replication
|
|
15
|
-
* configuration, you provide the name of the destination bucket or buckets where you want
|
|
16
|
-
* Amazon S3 to replicate objects, the IAM role that Amazon S3 can assume to replicate objects on your
|
|
17
|
-
* behalf, and other relevant information.</p>
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
* <p>A replication configuration must include at least one rule, and can contain a maximum of
|
|
21
|
-
* 1,000. Each rule identifies a subset of objects to replicate by filtering the objects in
|
|
22
|
-
* the source bucket. To choose additional subsets of objects to replicate, add a rule for
|
|
23
|
-
* each subset.</p>
|
|
24
|
-
*
|
|
25
|
-
* <p>To specify a subset of the objects in the source bucket to apply a replication rule to,
|
|
26
|
-
* add the Filter element as a child of the Rule element. You can filter objects based on an
|
|
27
|
-
* object key prefix, one or more object tags, or both. When you add the Filter element in the
|
|
28
|
-
* configuration, you must also add the following elements:
|
|
29
|
-
* <code>DeleteMarkerReplication</code>, <code>Status</code>, and
|
|
30
|
-
* <code>Priority</code>.</p>
|
|
31
|
-
* <note>
|
|
32
|
-
* <p>If you are using an earlier version of the replication configuration, Amazon S3 handles
|
|
33
|
-
* 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
|
-
* </note>
|
|
35
|
-
* <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
|
-
* <p>
|
|
38
|
-
* <b>Handling Replication of Encrypted Objects</b>
|
|
39
|
-
* </p>
|
|
40
|
-
* <p>By default, Amazon S3 doesn't replicate objects that are stored at rest using server-side
|
|
41
|
-
* encryption with KMS keys. To replicate Amazon Web Services KMS-encrypted objects, add the
|
|
42
|
-
* following: <code>SourceSelectionCriteria</code>, <code>SseKmsEncryptedObjects</code>,
|
|
43
|
-
* <code>Status</code>, <code>EncryptionConfiguration</code>, and
|
|
44
|
-
* <code>ReplicaKmsKeyID</code>. For information about replication configuration, see
|
|
45
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html">Replicating Objects
|
|
46
|
-
* Created with SSE Using KMS keys</a>.</p>
|
|
47
|
-
*
|
|
48
|
-
* <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
|
-
* replication-related error codes</a>
|
|
50
|
-
* </p>
|
|
51
|
-
*
|
|
52
|
-
* <p>
|
|
53
|
-
* <b>Permissions</b>
|
|
54
|
-
* </p>
|
|
55
|
-
* <p>To create a <code>PutBucketReplication</code> request, you must have <code>s3:PutReplicationConfiguration</code>
|
|
56
|
-
* permissions for the bucket.
|
|
57
|
-
* </p>
|
|
58
|
-
* <p>By default, a resource owner, in this case the Amazon Web Services account that created the bucket, can
|
|
59
|
-
* perform this operation. The resource owner can also grant others permissions to perform the
|
|
60
|
-
* operation. For more information about permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/using-with-s3-actions.html">Specifying Permissions in a Policy</a>
|
|
61
|
-
* and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to Your
|
|
62
|
-
* Amazon S3 Resources</a>.</p>
|
|
63
|
-
* <note>
|
|
64
|
-
* <p>To perform this operation, the user or role performing the action must have the
|
|
65
|
-
* <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">iam:PassRole</a> permission.</p>
|
|
66
|
-
* </note>
|
|
67
|
-
*
|
|
68
|
-
* <p>The following operations are related to <code>PutBucketReplication</code>:</p>
|
|
69
|
-
* <ul>
|
|
70
|
-
* <li>
|
|
71
|
-
* <p>
|
|
72
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketReplication.html">GetBucketReplication</a>
|
|
73
|
-
* </p>
|
|
74
|
-
* </li>
|
|
75
|
-
* <li>
|
|
76
|
-
* <p>
|
|
77
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketReplication.html">DeleteBucketReplication</a>
|
|
78
|
-
* </p>
|
|
79
|
-
* </li>
|
|
80
|
-
* </ul>
|
|
81
|
-
* @example
|
|
82
|
-
* Use a bare-bones client and the command you need to make an API call.
|
|
83
|
-
* ```javascript
|
|
84
|
-
* import { S3Client, PutBucketReplicationCommand } from "@aws-sdk/client-s3"; // ES Modules import
|
|
85
|
-
* // const { S3Client, PutBucketReplicationCommand } = require("@aws-sdk/client-s3"); // CommonJS import
|
|
86
|
-
* const client = new S3Client(config);
|
|
87
|
-
* const command = new PutBucketReplicationCommand(input);
|
|
88
|
-
* const response = await client.send(command);
|
|
89
|
-
* ```
|
|
90
|
-
*
|
|
91
|
-
* @see {@link PutBucketReplicationCommandInput} for command's `input` shape.
|
|
92
|
-
* @see {@link PutBucketReplicationCommandOutput} for command's `response` shape.
|
|
93
|
-
* @see {@link S3ClientResolvedConfig | config} for command's `input` shape.
|
|
94
|
-
*
|
|
95
|
-
*/
|
|
96
10
|
class PutBucketReplicationCommand extends smithy_client_1.Command {
|
|
97
|
-
// Start section: command_properties
|
|
98
|
-
// End section: command_properties
|
|
99
11
|
constructor(input) {
|
|
100
|
-
// Start section: command_constructor
|
|
101
12
|
super();
|
|
102
13
|
this.input = input;
|
|
103
|
-
// End section: command_constructor
|
|
104
14
|
}
|
|
105
|
-
/**
|
|
106
|
-
* @internal
|
|
107
|
-
*/
|
|
108
15
|
resolveMiddleware(clientStack, configuration, options) {
|
|
109
16
|
this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
|
|
110
17
|
this.middlewareStack.use(middleware_bucket_endpoint_1.getBucketEndpointPlugin(configuration));
|
|
@@ -7,53 +7,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
|
|
|
7
7
|
const smithy_client_1 = require("@aws-sdk/smithy-client");
|
|
8
8
|
const models_0_1 = require("../models/models_0");
|
|
9
9
|
const Aws_restXml_1 = require("../protocols/Aws_restXml");
|
|
10
|
-
/**
|
|
11
|
-
* <p>Sets the request payment configuration for a bucket. By default, the bucket owner pays
|
|
12
|
-
* for downloads from the bucket. This configuration parameter enables the bucket owner (only)
|
|
13
|
-
* to specify that the person requesting the download will be charged for the download. For
|
|
14
|
-
* more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/RequesterPaysBuckets.html">Requester Pays
|
|
15
|
-
* Buckets</a>.</p>
|
|
16
|
-
*
|
|
17
|
-
* <p>The following operations are related to <code>PutBucketRequestPayment</code>:</p>
|
|
18
|
-
* <ul>
|
|
19
|
-
* <li>
|
|
20
|
-
* <p>
|
|
21
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>
|
|
22
|
-
* </p>
|
|
23
|
-
* </li>
|
|
24
|
-
* <li>
|
|
25
|
-
* <p>
|
|
26
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketRequestPayment.html">GetBucketRequestPayment</a>
|
|
27
|
-
* </p>
|
|
28
|
-
* </li>
|
|
29
|
-
* </ul>
|
|
30
|
-
* @example
|
|
31
|
-
* Use a bare-bones client and the command you need to make an API call.
|
|
32
|
-
* ```javascript
|
|
33
|
-
* import { S3Client, PutBucketRequestPaymentCommand } from "@aws-sdk/client-s3"; // ES Modules import
|
|
34
|
-
* // const { S3Client, PutBucketRequestPaymentCommand } = require("@aws-sdk/client-s3"); // CommonJS import
|
|
35
|
-
* const client = new S3Client(config);
|
|
36
|
-
* const command = new PutBucketRequestPaymentCommand(input);
|
|
37
|
-
* const response = await client.send(command);
|
|
38
|
-
* ```
|
|
39
|
-
*
|
|
40
|
-
* @see {@link PutBucketRequestPaymentCommandInput} for command's `input` shape.
|
|
41
|
-
* @see {@link PutBucketRequestPaymentCommandOutput} for command's `response` shape.
|
|
42
|
-
* @see {@link S3ClientResolvedConfig | config} for command's `input` shape.
|
|
43
|
-
*
|
|
44
|
-
*/
|
|
45
10
|
class PutBucketRequestPaymentCommand extends smithy_client_1.Command {
|
|
46
|
-
// Start section: command_properties
|
|
47
|
-
// End section: command_properties
|
|
48
11
|
constructor(input) {
|
|
49
|
-
// Start section: command_constructor
|
|
50
12
|
super();
|
|
51
13
|
this.input = input;
|
|
52
|
-
// End section: command_constructor
|
|
53
14
|
}
|
|
54
|
-
/**
|
|
55
|
-
* @internal
|
|
56
|
-
*/
|
|
57
15
|
resolveMiddleware(clientStack, configuration, options) {
|
|
58
16
|
this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
|
|
59
17
|
this.middlewareStack.use(middleware_bucket_endpoint_1.getBucketEndpointPlugin(configuration));
|
|
@@ -7,113 +7,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
|
|
|
7
7
|
const smithy_client_1 = require("@aws-sdk/smithy-client");
|
|
8
8
|
const models_0_1 = require("../models/models_0");
|
|
9
9
|
const Aws_restXml_1 = require("../protocols/Aws_restXml");
|
|
10
|
-
/**
|
|
11
|
-
* <p>Sets the tags for a bucket.</p>
|
|
12
|
-
* <p>Use tags to organize your Amazon Web Services bill to reflect your own cost structure. To do this, sign
|
|
13
|
-
* up to get your Amazon Web Services account bill with tag key values included. Then, to see the cost of
|
|
14
|
-
* combined resources, organize your billing information according to resources with the same
|
|
15
|
-
* tag key values. For example, you can tag several resources with a specific application
|
|
16
|
-
* name, and then organize your billing information to see the total cost of that application
|
|
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
|
-
* and Tagging</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/CostAllocTagging.html">Using Cost Allocation in Amazon S3 Bucket
|
|
19
|
-
* Tags</a>.</p>
|
|
20
|
-
*
|
|
21
|
-
* <note>
|
|
22
|
-
* <p>
|
|
23
|
-
* When this operation sets the tags for a bucket, it will overwrite any current tags the
|
|
24
|
-
* bucket already has. You cannot use this operation to add tags to an existing list of tags.</p>
|
|
25
|
-
* </note>
|
|
26
|
-
* <p>To use this operation, you must have permissions to perform the
|
|
27
|
-
* <code>s3:PutBucketTagging</code> action. The bucket owner has this permission by default
|
|
28
|
-
* 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
|
-
* Resources</a>.</p>
|
|
30
|
-
*
|
|
31
|
-
* <p>
|
|
32
|
-
* <code>PutBucketTagging</code> has the following special errors:</p>
|
|
33
|
-
* <ul>
|
|
34
|
-
* <li>
|
|
35
|
-
* <p>Error code: <code>InvalidTagError</code>
|
|
36
|
-
* </p>
|
|
37
|
-
* <ul>
|
|
38
|
-
* <li>
|
|
39
|
-
* <p>Description: The tag provided was not a valid tag. This error can occur if
|
|
40
|
-
* the tag did not pass input validation. For information about tag restrictions,
|
|
41
|
-
* 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>
|
|
42
|
-
* </li>
|
|
43
|
-
* </ul>
|
|
44
|
-
* </li>
|
|
45
|
-
* <li>
|
|
46
|
-
* <p>Error code: <code>MalformedXMLError</code>
|
|
47
|
-
* </p>
|
|
48
|
-
* <ul>
|
|
49
|
-
* <li>
|
|
50
|
-
* <p>Description: The XML provided does not match the schema.</p>
|
|
51
|
-
* </li>
|
|
52
|
-
* </ul>
|
|
53
|
-
* </li>
|
|
54
|
-
* <li>
|
|
55
|
-
* <p>Error code: <code>OperationAbortedError </code>
|
|
56
|
-
* </p>
|
|
57
|
-
* <ul>
|
|
58
|
-
* <li>
|
|
59
|
-
* <p>Description: A conflicting conditional action is currently in progress
|
|
60
|
-
* against this resource. Please try again.</p>
|
|
61
|
-
* </li>
|
|
62
|
-
* </ul>
|
|
63
|
-
* </li>
|
|
64
|
-
* <li>
|
|
65
|
-
* <p>Error code: <code>InternalError</code>
|
|
66
|
-
* </p>
|
|
67
|
-
* <ul>
|
|
68
|
-
* <li>
|
|
69
|
-
* <p>Description: The service was unable to apply the provided tag to the
|
|
70
|
-
* bucket.</p>
|
|
71
|
-
* </li>
|
|
72
|
-
* </ul>
|
|
73
|
-
* </li>
|
|
74
|
-
* </ul>
|
|
75
|
-
*
|
|
76
|
-
*
|
|
77
|
-
* <p>The following operations are related to <code>PutBucketTagging</code>:</p>
|
|
78
|
-
* <ul>
|
|
79
|
-
* <li>
|
|
80
|
-
* <p>
|
|
81
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketTagging.html">GetBucketTagging</a>
|
|
82
|
-
* </p>
|
|
83
|
-
* </li>
|
|
84
|
-
* <li>
|
|
85
|
-
* <p>
|
|
86
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucketTagging.html">DeleteBucketTagging</a>
|
|
87
|
-
* </p>
|
|
88
|
-
* </li>
|
|
89
|
-
* </ul>
|
|
90
|
-
* @example
|
|
91
|
-
* Use a bare-bones client and the command you need to make an API call.
|
|
92
|
-
* ```javascript
|
|
93
|
-
* import { S3Client, PutBucketTaggingCommand } from "@aws-sdk/client-s3"; // ES Modules import
|
|
94
|
-
* // const { S3Client, PutBucketTaggingCommand } = require("@aws-sdk/client-s3"); // CommonJS import
|
|
95
|
-
* const client = new S3Client(config);
|
|
96
|
-
* const command = new PutBucketTaggingCommand(input);
|
|
97
|
-
* const response = await client.send(command);
|
|
98
|
-
* ```
|
|
99
|
-
*
|
|
100
|
-
* @see {@link PutBucketTaggingCommandInput} for command's `input` shape.
|
|
101
|
-
* @see {@link PutBucketTaggingCommandOutput} for command's `response` shape.
|
|
102
|
-
* @see {@link S3ClientResolvedConfig | config} for command's `input` shape.
|
|
103
|
-
*
|
|
104
|
-
*/
|
|
105
10
|
class PutBucketTaggingCommand extends smithy_client_1.Command {
|
|
106
|
-
// Start section: command_properties
|
|
107
|
-
// End section: command_properties
|
|
108
11
|
constructor(input) {
|
|
109
|
-
// Start section: command_constructor
|
|
110
12
|
super();
|
|
111
13
|
this.input = input;
|
|
112
|
-
// End section: command_constructor
|
|
113
14
|
}
|
|
114
|
-
/**
|
|
115
|
-
* @internal
|
|
116
|
-
*/
|
|
117
15
|
resolveMiddleware(clientStack, configuration, options) {
|
|
118
16
|
this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
|
|
119
17
|
this.middlewareStack.use(middleware_bucket_endpoint_1.getBucketEndpointPlugin(configuration));
|
|
@@ -7,83 +7,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
|
|
|
7
7
|
const smithy_client_1 = require("@aws-sdk/smithy-client");
|
|
8
8
|
const models_0_1 = require("../models/models_0");
|
|
9
9
|
const Aws_restXml_1 = require("../protocols/Aws_restXml");
|
|
10
|
-
/**
|
|
11
|
-
* <p>Sets the versioning state of an existing bucket. To set the versioning state, you must
|
|
12
|
-
* be the bucket owner.</p>
|
|
13
|
-
* <p>You can set the versioning state with one of the following values:</p>
|
|
14
|
-
*
|
|
15
|
-
* <p>
|
|
16
|
-
* <b>Enabled</b>—Enables versioning for the objects in the
|
|
17
|
-
* bucket. All objects added to the bucket receive a unique version ID.</p>
|
|
18
|
-
*
|
|
19
|
-
* <p>
|
|
20
|
-
* <b>Suspended</b>—Disables versioning for the objects in the
|
|
21
|
-
* bucket. All objects added to the bucket receive the version ID null.</p>
|
|
22
|
-
*
|
|
23
|
-
* <p>If the versioning state has never been set on a bucket, it has no versioning state; a
|
|
24
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a> request does not return a versioning state value.</p>
|
|
25
|
-
*
|
|
26
|
-
* <p>If the bucket owner enables MFA Delete in the bucket versioning configuration, the
|
|
27
|
-
* bucket owner must include the <code>x-amz-mfa request</code> header and the
|
|
28
|
-
* <code>Status</code> and the <code>MfaDelete</code> request elements in a request to set
|
|
29
|
-
* the versioning state of the bucket.</p>
|
|
30
|
-
*
|
|
31
|
-
* <important>
|
|
32
|
-
* <p>If you have an object expiration lifecycle policy in your non-versioned bucket and
|
|
33
|
-
* you want to maintain the same permanent delete behavior when you enable versioning, you
|
|
34
|
-
* must add a noncurrent expiration policy. The noncurrent expiration lifecycle policy will
|
|
35
|
-
* manage the deletes of the noncurrent object versions in the version-enabled bucket. (A
|
|
36
|
-
* version-enabled bucket maintains one current and zero or more noncurrent object
|
|
37
|
-
* 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
|
-
* </important>
|
|
39
|
-
*
|
|
40
|
-
* <p class="title">
|
|
41
|
-
* <b>Related Resources</b>
|
|
42
|
-
* </p>
|
|
43
|
-
* <ul>
|
|
44
|
-
* <li>
|
|
45
|
-
* <p>
|
|
46
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html">CreateBucket</a>
|
|
47
|
-
* </p>
|
|
48
|
-
* </li>
|
|
49
|
-
* <li>
|
|
50
|
-
* <p>
|
|
51
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_DeleteBucket.html">DeleteBucket</a>
|
|
52
|
-
* </p>
|
|
53
|
-
* </li>
|
|
54
|
-
* <li>
|
|
55
|
-
* <p>
|
|
56
|
-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetBucketVersioning.html">GetBucketVersioning</a>
|
|
57
|
-
* </p>
|
|
58
|
-
* </li>
|
|
59
|
-
* </ul>
|
|
60
|
-
* @example
|
|
61
|
-
* Use a bare-bones client and the command you need to make an API call.
|
|
62
|
-
* ```javascript
|
|
63
|
-
* import { S3Client, PutBucketVersioningCommand } from "@aws-sdk/client-s3"; // ES Modules import
|
|
64
|
-
* // const { S3Client, PutBucketVersioningCommand } = require("@aws-sdk/client-s3"); // CommonJS import
|
|
65
|
-
* const client = new S3Client(config);
|
|
66
|
-
* const command = new PutBucketVersioningCommand(input);
|
|
67
|
-
* const response = await client.send(command);
|
|
68
|
-
* ```
|
|
69
|
-
*
|
|
70
|
-
* @see {@link PutBucketVersioningCommandInput} for command's `input` shape.
|
|
71
|
-
* @see {@link PutBucketVersioningCommandOutput} for command's `response` shape.
|
|
72
|
-
* @see {@link S3ClientResolvedConfig | config} for command's `input` shape.
|
|
73
|
-
*
|
|
74
|
-
*/
|
|
75
10
|
class PutBucketVersioningCommand extends smithy_client_1.Command {
|
|
76
|
-
// Start section: command_properties
|
|
77
|
-
// End section: command_properties
|
|
78
11
|
constructor(input) {
|
|
79
|
-
// Start section: command_constructor
|
|
80
12
|
super();
|
|
81
13
|
this.input = input;
|
|
82
|
-
// End section: command_constructor
|
|
83
14
|
}
|
|
84
|
-
/**
|
|
85
|
-
* @internal
|
|
86
|
-
*/
|
|
87
15
|
resolveMiddleware(clientStack, configuration, options) {
|
|
88
16
|
this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
|
|
89
17
|
this.middlewareStack.use(middleware_bucket_endpoint_1.getBucketEndpointPlugin(configuration));
|
|
@@ -7,160 +7,11 @@ const middleware_serde_1 = require("@aws-sdk/middleware-serde");
|
|
|
7
7
|
const smithy_client_1 = require("@aws-sdk/smithy-client");
|
|
8
8
|
const models_0_1 = require("../models/models_0");
|
|
9
9
|
const Aws_restXml_1 = require("../protocols/Aws_restXml");
|
|
10
|
-
/**
|
|
11
|
-
* <p>Sets the configuration of the website that is specified in the <code>website</code>
|
|
12
|
-
* subresource. To configure a bucket as a website, you can add this subresource on the bucket
|
|
13
|
-
* with website configuration information such as the file name of the index document and any
|
|
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
|
-
* <p>This PUT action requires the <code>S3:PutBucketWebsite</code> permission. By default,
|
|
17
|
-
* only the bucket owner can configure the website attached to a bucket; however, bucket
|
|
18
|
-
* owners can allow other users to set the website configuration by writing a bucket policy
|
|
19
|
-
* that grants them the <code>S3:PutBucketWebsite</code> permission.</p>
|
|
20
|
-
*
|
|
21
|
-
* <p>To redirect all website requests sent to the bucket's website endpoint, you add a
|
|
22
|
-
* website configuration with the following elements. Because all requests are sent to another
|
|
23
|
-
* website, you don't need to provide index document name for the bucket.</p>
|
|
24
|
-
* <ul>
|
|
25
|
-
* <li>
|
|
26
|
-
* <p>
|
|
27
|
-
* <code>WebsiteConfiguration</code>
|
|
28
|
-
* </p>
|
|
29
|
-
* </li>
|
|
30
|
-
* <li>
|
|
31
|
-
* <p>
|
|
32
|
-
* <code>RedirectAllRequestsTo</code>
|
|
33
|
-
* </p>
|
|
34
|
-
* </li>
|
|
35
|
-
* <li>
|
|
36
|
-
* <p>
|
|
37
|
-
* <code>HostName</code>
|
|
38
|
-
* </p>
|
|
39
|
-
* </li>
|
|
40
|
-
* <li>
|
|
41
|
-
* <p>
|
|
42
|
-
* <code>Protocol</code>
|
|
43
|
-
* </p>
|
|
44
|
-
* </li>
|
|
45
|
-
* </ul>
|
|
46
|
-
*
|
|
47
|
-
* <p>If you want granular control over redirects, you can use the following elements to add
|
|
48
|
-
* routing rules that describe conditions for redirecting requests and information about the
|
|
49
|
-
* redirect destination. In this case, the website configuration must provide an index
|
|
50
|
-
* document for the bucket, because some requests might not be redirected. </p>
|
|
51
|
-
* <ul>
|
|
52
|
-
* <li>
|
|
53
|
-
* <p>
|
|
54
|
-
* <code>WebsiteConfiguration</code>
|
|
55
|
-
* </p>
|
|
56
|
-
* </li>
|
|
57
|
-
* <li>
|
|
58
|
-
* <p>
|
|
59
|
-
* <code>IndexDocument</code>
|
|
60
|
-
* </p>
|
|
61
|
-
* </li>
|
|
62
|
-
* <li>
|
|
63
|
-
* <p>
|
|
64
|
-
* <code>Suffix</code>
|
|
65
|
-
* </p>
|
|
66
|
-
* </li>
|
|
67
|
-
* <li>
|
|
68
|
-
* <p>
|
|
69
|
-
* <code>ErrorDocument</code>
|
|
70
|
-
* </p>
|
|
71
|
-
* </li>
|
|
72
|
-
* <li>
|
|
73
|
-
* <p>
|
|
74
|
-
* <code>Key</code>
|
|
75
|
-
* </p>
|
|
76
|
-
* </li>
|
|
77
|
-
* <li>
|
|
78
|
-
* <p>
|
|
79
|
-
* <code>RoutingRules</code>
|
|
80
|
-
* </p>
|
|
81
|
-
* </li>
|
|
82
|
-
* <li>
|
|
83
|
-
* <p>
|
|
84
|
-
* <code>RoutingRule</code>
|
|
85
|
-
* </p>
|
|
86
|
-
* </li>
|
|
87
|
-
* <li>
|
|
88
|
-
* <p>
|
|
89
|
-
* <code>Condition</code>
|
|
90
|
-
* </p>
|
|
91
|
-
* </li>
|
|
92
|
-
* <li>
|
|
93
|
-
* <p>
|
|
94
|
-
* <code>HttpErrorCodeReturnedEquals</code>
|
|
95
|
-
* </p>
|
|
96
|
-
* </li>
|
|
97
|
-
* <li>
|
|
98
|
-
* <p>
|
|
99
|
-
* <code>KeyPrefixEquals</code>
|
|
100
|
-
* </p>
|
|
101
|
-
* </li>
|
|
102
|
-
* <li>
|
|
103
|
-
* <p>
|
|
104
|
-
* <code>Redirect</code>
|
|
105
|
-
* </p>
|
|
106
|
-
* </li>
|
|
107
|
-
* <li>
|
|
108
|
-
* <p>
|
|
109
|
-
* <code>Protocol</code>
|
|
110
|
-
* </p>
|
|
111
|
-
* </li>
|
|
112
|
-
* <li>
|
|
113
|
-
* <p>
|
|
114
|
-
* <code>HostName</code>
|
|
115
|
-
* </p>
|
|
116
|
-
* </li>
|
|
117
|
-
* <li>
|
|
118
|
-
* <p>
|
|
119
|
-
* <code>ReplaceKeyPrefixWith</code>
|
|
120
|
-
* </p>
|
|
121
|
-
* </li>
|
|
122
|
-
* <li>
|
|
123
|
-
* <p>
|
|
124
|
-
* <code>ReplaceKeyWith</code>
|
|
125
|
-
* </p>
|
|
126
|
-
* </li>
|
|
127
|
-
* <li>
|
|
128
|
-
* <p>
|
|
129
|
-
* <code>HttpRedirectCode</code>
|
|
130
|
-
* </p>
|
|
131
|
-
* </li>
|
|
132
|
-
* </ul>
|
|
133
|
-
*
|
|
134
|
-
* <p>Amazon S3 has a limitation of 50 routing rules per website configuration. If you require more
|
|
135
|
-
* 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
|
-
* Object Redirect</a> in the <i>Amazon S3 User Guide</i>.</p>
|
|
137
|
-
* @example
|
|
138
|
-
* Use a bare-bones client and the command you need to make an API call.
|
|
139
|
-
* ```javascript
|
|
140
|
-
* import { S3Client, PutBucketWebsiteCommand } from "@aws-sdk/client-s3"; // ES Modules import
|
|
141
|
-
* // const { S3Client, PutBucketWebsiteCommand } = require("@aws-sdk/client-s3"); // CommonJS import
|
|
142
|
-
* const client = new S3Client(config);
|
|
143
|
-
* const command = new PutBucketWebsiteCommand(input);
|
|
144
|
-
* const response = await client.send(command);
|
|
145
|
-
* ```
|
|
146
|
-
*
|
|
147
|
-
* @see {@link PutBucketWebsiteCommandInput} for command's `input` shape.
|
|
148
|
-
* @see {@link PutBucketWebsiteCommandOutput} for command's `response` shape.
|
|
149
|
-
* @see {@link S3ClientResolvedConfig | config} for command's `input` shape.
|
|
150
|
-
*
|
|
151
|
-
*/
|
|
152
10
|
class PutBucketWebsiteCommand extends smithy_client_1.Command {
|
|
153
|
-
// Start section: command_properties
|
|
154
|
-
// End section: command_properties
|
|
155
11
|
constructor(input) {
|
|
156
|
-
// Start section: command_constructor
|
|
157
12
|
super();
|
|
158
13
|
this.input = input;
|
|
159
|
-
// End section: command_constructor
|
|
160
14
|
}
|
|
161
|
-
/**
|
|
162
|
-
* @internal
|
|
163
|
-
*/
|
|
164
15
|
resolveMiddleware(clientStack, configuration, options) {
|
|
165
16
|
this.middlewareStack.use(middleware_serde_1.getSerdePlugin(configuration, this.serialize, this.deserialize));
|
|
166
17
|
this.middlewareStack.use(middleware_bucket_endpoint_1.getBucketEndpointPlugin(configuration));
|