@aws-sdk/client-s3 3.413.0 → 3.417.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (39) hide show
  1. package/dist-cjs/runtimeExtensions.js +3 -0
  2. package/dist-es/runtimeExtensions.js +3 -0
  3. package/dist-types/commands/CompleteMultipartUploadCommand.d.ts +6 -6
  4. package/dist-types/commands/CopyObjectCommand.d.ts +90 -76
  5. package/dist-types/commands/CreateBucketCommand.d.ts +63 -37
  6. package/dist-types/commands/CreateMultipartUploadCommand.d.ts +14 -12
  7. package/dist-types/commands/DeleteBucketEncryptionCommand.d.ts +3 -3
  8. package/dist-types/commands/DeleteBucketPolicyCommand.d.ts +3 -2
  9. package/dist-types/commands/DeleteObjectsCommand.d.ts +2 -1
  10. package/dist-types/commands/GetBucketAccelerateConfigurationCommand.d.ts +2 -1
  11. package/dist-types/commands/GetBucketAnalyticsConfigurationCommand.d.ts +2 -1
  12. package/dist-types/commands/GetBucketPolicyCommand.d.ts +5 -4
  13. package/dist-types/commands/GetObjectAttributesCommand.d.ts +15 -12
  14. package/dist-types/commands/GetObjectCommand.d.ts +44 -37
  15. package/dist-types/commands/HeadBucketCommand.d.ts +3 -3
  16. package/dist-types/commands/HeadObjectCommand.d.ts +11 -11
  17. package/dist-types/commands/PutBucketAclCommand.d.ts +41 -35
  18. package/dist-types/commands/PutBucketAnalyticsConfigurationCommand.d.ts +2 -1
  19. package/dist-types/commands/PutBucketEncryptionCommand.d.ts +4 -8
  20. package/dist-types/commands/PutBucketIntelligentTieringConfigurationCommand.d.ts +5 -4
  21. package/dist-types/commands/PutBucketInventoryConfigurationCommand.d.ts +18 -18
  22. package/dist-types/commands/PutBucketLifecycleConfigurationCommand.d.ts +29 -25
  23. package/dist-types/commands/PutBucketLoggingCommand.d.ts +12 -10
  24. package/dist-types/commands/PutBucketPolicyCommand.d.ts +5 -4
  25. package/dist-types/commands/PutBucketReplicationCommand.d.ts +23 -17
  26. package/dist-types/commands/PutBucketTaggingCommand.d.ts +18 -35
  27. package/dist-types/commands/PutBucketVersioningCommand.d.ts +6 -6
  28. package/dist-types/commands/PutBucketWebsiteCommand.d.ts +1 -0
  29. package/dist-types/commands/PutObjectAclCommand.d.ts +39 -36
  30. package/dist-types/commands/PutObjectTaggingCommand.d.ts +21 -58
  31. package/dist-types/commands/PutPublicAccessBlockCommand.d.ts +1 -1
  32. package/dist-types/commands/RestoreObjectCommand.d.ts +93 -91
  33. package/dist-types/commands/SelectObjectContentCommand.d.ts +46 -40
  34. package/dist-types/commands/UploadPartCopyCommand.d.ts +16 -14
  35. package/dist-types/extensionConfiguration.d.ts +2 -1
  36. package/dist-types/models/models_0.d.ts +173 -110
  37. package/dist-types/models/models_1.d.ts +25 -13
  38. package/dist-types/ts3.4/extensionConfiguration.d.ts +3 -1
  39. package/package.json +5 -4
@@ -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 using
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
- * xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
52
- * </Grantee></code>
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
- * xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress></Grantee></code>
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 response to a <code>GETObjectAcl</code>
64
- * request, appears as the CanonicalUser.</p>
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
- * xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
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 elements. To disable
77
- * logging, you use an empty <code>BucketLoggingStatus</code> request element:</p>
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
- * <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 from performing
40
- * these API actions by VPC endpoint policies and Amazon Web Services Organizations policies.</p>
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.</p>
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 server-side
51
- * encryption with KMS keys. To replicate Amazon Web Services KMS-encrypted objects, add the following:
52
- * <code>SourceSelectionCriteria</code>, <code>SseKmsEncryptedObjects</code>,
53
- * <code>Status</code>, <code>EncryptionConfiguration</code>, and
54
- * <code>ReplicaKmsKeyID</code>. For information about replication configuration, see
55
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/replication-config-for-kms-objects.html">Replicating Objects
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
- * replication-related error codes</a>
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
- * <code>s3:PutReplicationConfiguration</code> permissions for the bucket.
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 bucket,
68
- * can perform this operation. The resource owner can also grant others permissions to perform
69
- * the 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
70
- * Policy</a> and <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-access-control.html">Managing Access Permissions to
71
- * Your Amazon S3 Resources</a>.</p>
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 the
74
- * <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_use_passrole.html">iam:PassRole</a> permission.</p>
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/dev/CostAllocTagging.html">Using Cost Allocation in Amazon S3 Bucket
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:</p>
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>Error code: <code>InvalidTagError</code>
49
- * </p>
50
- * <ul>
51
- * <li>
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>Error code: <code>MalformedXMLError</code>
60
- * </p>
61
- * <ul>
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>Error code: <code>OperationAbortedError </code>
69
- * </p>
70
- * <ul>
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>Error code: <code>InternalError</code>
79
- * </p>
80
- * <ul>
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 and
43
- * you want to maintain the same permanent delete behavior when you enable versioning, you
44
- * must add a noncurrent expiration policy. The noncurrent expiration lifecycle configuration will
45
- * manage the deletes of the noncurrent object versions in the version-enabled bucket. (A
46
- * version-enabled bucket maintains one current and zero or more noncurrent object
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
@@ -47,29 +47,32 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
47
47
  * <p>You can set access permissions using one of the following methods:</p>
48
48
  * <ul>
49
49
  * <li>
50
- * <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3 supports
51
- * a set of predefined ACLs, known as canned ACLs. Each canned ACL has a predefined set
52
- * of grantees and permissions. Specify the canned ACL name as the value of
53
- * <code>x-amz-ac</code>l. If you use this header, you cannot use other access
54
- * control-specific headers in your request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned
55
- * ACL</a>.</p>
50
+ * <p>Specify a canned ACL with the <code>x-amz-acl</code> request header. Amazon S3
51
+ * supports a set of predefined ACLs, known as canned ACLs. Each canned ACL has
52
+ * a predefined set of grantees and permissions. Specify the canned ACL name as
53
+ * the value of <code>x-amz-ac</code>l. If you use this header, you cannot use
54
+ * other access control-specific headers in your request. For more information,
55
+ * see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html#CannedACL">Canned
56
+ * ACL</a>.</p>
56
57
  * </li>
57
58
  * <li>
58
- * <p>Specify access permissions explicitly with the <code>x-amz-grant-read</code>,
59
- * <code>x-amz-grant-read-acp</code>, <code>x-amz-grant-write-acp</code>, and
60
- * <code>x-amz-grant-full-control</code> headers. When using these headers, you
61
- * specify explicit access permissions and grantees (Amazon Web Services accounts or Amazon S3 groups) who
62
- * will receive the permission. If you use these ACL-specific headers, you cannot use
63
- * <code>x-amz-acl</code> header to set a canned ACL. These parameters map to the set
64
- * of permissions that Amazon S3 supports in an ACL. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control
65
- * List (ACL) Overview</a>.</p>
66
- * <p>You specify each grantee as a type=value pair, where the type is one of the
67
- * following:</p>
59
+ * <p>Specify access permissions explicitly with the
60
+ * <code>x-amz-grant-read</code>, <code>x-amz-grant-read-acp</code>,
61
+ * <code>x-amz-grant-write-acp</code>, and
62
+ * <code>x-amz-grant-full-control</code> headers. When using these headers,
63
+ * you specify explicit access permissions and grantees (Amazon Web Services accounts or Amazon S3
64
+ * groups) who will receive the permission. If you use these ACL-specific
65
+ * headers, you cannot use <code>x-amz-acl</code> header to set a canned ACL.
66
+ * These parameters map to the set of permissions that Amazon S3 supports in an ACL.
67
+ * For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/acl-overview.html">Access Control List (ACL)
68
+ * Overview</a>.</p>
69
+ * <p>You specify each grantee as a type=value pair, where the type is one of
70
+ * the following:</p>
68
71
  * <ul>
69
72
  * <li>
70
73
  * <p>
71
- * <code>id</code> – if the value specified is the canonical user ID of an
72
- * Amazon Web Services account</p>
74
+ * <code>id</code> – if the value specified is the canonical user ID
75
+ * of an Amazon Web Services account</p>
73
76
  * </li>
74
77
  * <li>
75
78
  * <p>
@@ -78,8 +81,8 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
78
81
  * </li>
79
82
  * <li>
80
83
  * <p>
81
- * <code>emailAddress</code> – if the value specified is the email address of
82
- * an Amazon Web Services account</p>
84
+ * <code>emailAddress</code> – if the value specified is the email
85
+ * address of an Amazon Web Services account</p>
83
86
  * <note>
84
87
  * <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
85
88
  * <ul>
@@ -112,29 +115,29 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
112
115
  * </note>
113
116
  * </li>
114
117
  * </ul>
115
- * <p>For example, the following <code>x-amz-grant-read</code> header grants list
116
- * objects permission to the two Amazon Web Services accounts identified by their email
118
+ * <p>For example, the following <code>x-amz-grant-read</code> header grants
119
+ * list objects permission to the two Amazon Web Services accounts identified by their email
117
120
  * addresses.</p>
118
121
  * <p>
119
122
  * <code>x-amz-grant-read: emailAddress="xyz@amazon.com",
120
- * emailAddress="abc@amazon.com" </code>
123
+ * emailAddress="abc@amazon.com" </code>
121
124
  * </p>
122
125
  * </li>
123
126
  * </ul>
124
- * <p>You can use either a canned ACL or specify access permissions explicitly. You cannot do
125
- * both.</p>
127
+ * <p>You can use either a canned ACL or specify access permissions explicitly. You
128
+ * cannot do both.</p>
126
129
  * </dd>
127
130
  * <dt>Grantee Values</dt>
128
131
  * <dd>
129
- * <p>You can specify the person (grantee) to whom you're assigning access rights (using
130
- * request elements) in the following ways:</p>
132
+ * <p>You can specify the person (grantee) to whom you're assigning access rights
133
+ * (using request elements) in the following ways:</p>
131
134
  * <ul>
132
135
  * <li>
133
136
  * <p>By the person's ID:</p>
134
137
  * <p>
135
138
  * <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
136
- * xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
137
- * </Grantee></code>
139
+ * xsi:type="CanonicalUser"><ID><>ID<></ID><DisplayName><>GranteesEmail<></DisplayName>
140
+ * </Grantee></code>
138
141
  * </p>
139
142
  * <p>DisplayName is optional and ignored in the request.</p>
140
143
  * </li>
@@ -142,17 +145,17 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
142
145
  * <p>By URI:</p>
143
146
  * <p>
144
147
  * <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
145
- * xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
148
+ * xsi:type="Group"><URI><>http://acs.amazonaws.com/groups/global/AuthenticatedUsers<></URI></Grantee></code>
146
149
  * </p>
147
150
  * </li>
148
151
  * <li>
149
152
  * <p>By Email address:</p>
150
153
  * <p>
151
154
  * <code><Grantee xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
152
- * xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress>lt;/Grantee></code>
155
+ * xsi:type="AmazonCustomerByEmail"><EmailAddress><>Grantees@email.com<></EmailAddress>lt;/Grantee></code>
153
156
  * </p>
154
- * <p>The grantee is resolved to the CanonicalUser and, in a response to a GET Object
155
- * acl request, appears as the CanonicalUser.</p>
157
+ * <p>The grantee is resolved to the CanonicalUser and, in a response to a GET
158
+ * Object acl request, appears as the CanonicalUser.</p>
156
159
  * <note>
157
160
  * <p>Using email addresses to specify a grantee is only supported in the following Amazon Web Services Regions: </p>
158
161
  * <ul>
@@ -188,9 +191,9 @@ export interface PutObjectAclCommandOutput extends PutObjectAclOutput, __Metadat
188
191
  * </dd>
189
192
  * <dt>Versioning</dt>
190
193
  * <dd>
191
- * <p>The ACL of an object is set at the object version level. By default, PUT sets the ACL of
192
- * the current version of an object. To set the ACL of a different version, use the
193
- * <code>versionId</code> subresource.</p>
194
+ * <p>The ACL of an object is set at the object version level. By default, PUT sets
195
+ * the ACL of the current version of an object. To set the ACL of a different
196
+ * version, use the <code>versionId</code> subresource.</p>
194
197
  * </dd>
195
198
  * </dl>
196
199
  * <p>The following operations are related to <code>PutObjectAcl</code>:</p>
@@ -23,10 +23,11 @@ export interface PutObjectTaggingCommandOutput extends PutObjectTaggingOutput, _
23
23
  }
24
24
  /**
25
25
  * @public
26
- * <p>Sets the supplied tag-set to an object that already exists in a bucket.</p>
27
- * <p>A tag is a key-value pair. You can associate tags with an object by sending a PUT
28
- * request against the tagging subresource that is associated with the object. You can
29
- * retrieve tags by sending a GET request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html">GetObjectTagging</a>.</p>
26
+ * <p>Sets the supplied tag-set to an object that already exists in a bucket. A tag is a
27
+ * key-value pair. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object Tagging</a>.</p>
28
+ * <p>You can associate tags with an object by sending a PUT request against the tagging
29
+ * subresource that is associated with the object. You can retrieve tags by sending a GET
30
+ * request. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_GetObjectTagging.html">GetObjectTagging</a>.</p>
30
31
  * <p>For tagging-related restrictions related to characters and encodings, see <a href="https://docs.aws.amazon.com/awsaccountbilling/latest/aboutv2/allocation-tag-restrictions.html">Tag
31
32
  * Restrictions</a>. Note that Amazon S3 limits the maximum number of tags to 10 tags per
32
33
  * object.</p>
@@ -35,69 +36,31 @@ export interface PutObjectTaggingCommandOutput extends PutObjectTaggingOutput, _
35
36
  * permission and can grant this permission to others.</p>
36
37
  * <p>To put tags of any other version, use the <code>versionId</code> query parameter. You
37
38
  * also need permission for the <code>s3:PutObjectVersionTagging</code> action.</p>
38
- * <p>For information about the Amazon S3 object tagging feature, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html">Object Tagging</a>.</p>
39
39
  * <p>
40
- * <code>PutObjectTagging</code> has the following special errors:</p>
40
+ * <code>PutObjectTagging</code> has the following special errors. For more Amazon S3 errors
41
+ * see, <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html">Error
42
+ * Responses</a>.</p>
41
43
  * <ul>
42
44
  * <li>
43
- * <ul>
44
- * <li>
45
- * <p>
46
- * <i>Code: InvalidTagError </i>
47
- * </p>
48
- * </li>
49
- * <li>
50
- * <p>
51
- * <i>Cause: The tag provided was not a valid tag. This error can occur
52
- * if the tag did not pass input validation. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/object-tagging.html">Object
53
- * Tagging</a>.</i>
54
- * </p>
55
- * </li>
56
- * </ul>
45
+ * <p>
46
+ * <code>InvalidTag</code> - The tag provided was not a valid tag. This error
47
+ * can occur if the tag did not pass input validation. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/object-tagging.html">Object
48
+ * Tagging</a>.</p>
57
49
  * </li>
58
50
  * <li>
59
- * <ul>
60
- * <li>
61
- * <p>
62
- * <i>Code: MalformedXMLError </i>
63
- * </p>
64
- * </li>
65
- * <li>
66
- * <p>
67
- * <i>Cause: The XML provided does not match the schema.</i>
68
- * </p>
69
- * </li>
70
- * </ul>
51
+ * <p>
52
+ * <code>MalformedXML</code> - The XML provided does not match the
53
+ * schema.</p>
71
54
  * </li>
72
55
  * <li>
73
- * <ul>
74
- * <li>
75
- * <p>
76
- * <i>Code: OperationAbortedError </i>
77
- * </p>
78
- * </li>
79
- * <li>
80
- * <p>
81
- * <i>Cause: A conflicting conditional action is currently in progress
82
- * against this resource. Please try again.</i>
83
- * </p>
84
- * </li>
85
- * </ul>
56
+ * <p>
57
+ * <code>OperationAborted</code> - A conflicting conditional action is
58
+ * currently in progress against this resource. Please try again.</p>
86
59
  * </li>
87
60
  * <li>
88
- * <ul>
89
- * <li>
90
- * <p>
91
- * <i>Code: InternalError</i>
92
- * </p>
93
- * </li>
94
- * <li>
95
- * <p>
96
- * <i>Cause: The service was unable to apply the provided tag to the
97
- * object.</i>
98
- * </p>
99
- * </li>
100
- * </ul>
61
+ * <p>
62
+ * <code>InternalError</code> - The service was unable to apply the provided
63
+ * tag to the object.</p>
101
64
  * </li>
102
65
  * </ul>
103
66
  * <p>The following operations are related to <code>PutObjectTagging</code>:</p>
@@ -32,7 +32,7 @@ export interface PutPublicAccessBlockCommandOutput extends __MetadataBearer {
32
32
  * an object, it checks the <code>PublicAccessBlock</code> configuration for both the
33
33
  * bucket (or the bucket that contains the object) and the bucket owner's account. If the
34
34
  * <code>PublicAccessBlock</code> configurations are different between the bucket and
35
- * the account, Amazon S3 uses the most restrictive combination of the bucket-level and
35
+ * the account, S3 uses the most restrictive combination of the bucket-level and
36
36
  * account-level settings.</p>
37
37
  * </important>
38
38
  * <p>For more information about when Amazon S3 considers a bucket or an object public, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/dev/access-control-block-public-access.html#access-control-block-public-access-policy-status">The Meaning of "Public"</a>.</p>