@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.
- package/dist-cjs/runtimeExtensions.js +3 -0
- package/dist-es/runtimeExtensions.js +3 -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 +63 -37
- 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/DeleteObjectsCommand.d.ts +2 -1
- 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/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/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/extensionConfiguration.d.ts +2 -1
- package/dist-types/models/models_0.d.ts +173 -110
- package/dist-types/models/models_1.d.ts +25 -13
- package/dist-types/ts3.4/extensionConfiguration.d.ts +3 -1
- 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
|
|
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
|
|
@@ -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
|
|
51
|
-
* a set of predefined ACLs, known as canned ACLs. Each canned ACL has
|
|
52
|
-
* of grantees and permissions. Specify the canned ACL name as
|
|
53
|
-
* <code>x-amz-ac</code>l. If you use this header, you cannot use
|
|
54
|
-
* control-specific headers in your request. For more information,
|
|
55
|
-
*
|
|
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
|
|
59
|
-
*
|
|
60
|
-
*
|
|
61
|
-
*
|
|
62
|
-
*
|
|
63
|
-
*
|
|
64
|
-
*
|
|
65
|
-
*
|
|
66
|
-
*
|
|
67
|
-
*
|
|
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
|
|
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
|
|
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
|
|
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
|
-
*
|
|
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
|
|
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
|
|
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
|
-
*
|
|
137
|
-
*
|
|
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
|
-
*
|
|
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
|
-
*
|
|
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
|
|
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
|
|
192
|
-
* the current version of an object. To set the ACL of a different
|
|
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
|
|
27
|
-
*
|
|
28
|
-
*
|
|
29
|
-
*
|
|
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
|
|
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
|
-
* <
|
|
44
|
-
* <
|
|
45
|
-
*
|
|
46
|
-
*
|
|
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
|
-
* <
|
|
60
|
-
* <
|
|
61
|
-
*
|
|
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
|
-
* <
|
|
74
|
-
* <
|
|
75
|
-
*
|
|
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
|
-
* <
|
|
89
|
-
* <
|
|
90
|
-
*
|
|
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,
|
|
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>
|