Skip to content

Commit a873777

Browse files
author
awstools
committed
feat(client-s3-control): Add support for S3 Storage Lens Advanced Performance Metrics, Expanded Prefixes metrics report, and export to S3 Tables.
1 parent 1e20b0f commit a873777

File tree

93 files changed

+995
-1364
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

93 files changed

+995
-1364
lines changed

clients/client-s3-control/src/commands/AssociateAccessGrantsIdentityCenterCommand.ts

Lines changed: 3 additions & 13 deletions
Original file line numberDiff line numberDiff line change
@@ -29,27 +29,17 @@ export interface AssociateAccessGrantsIdentityCenterCommandInput extends Associa
2929
export interface AssociateAccessGrantsIdentityCenterCommandOutput extends __MetadataBearer {}
3030

3131
/**
32-
* <p>Associate your S3 Access Grants instance with an Amazon Web Services IAM Identity Center instance. Use this
33-
* action if you want to create access grants for users or groups from your corporate identity
34-
* directory. First, you must add your corporate identity directory to Amazon Web Services IAM Identity
35-
* Center. Then, you can associate this IAM Identity Center instance with your S3 Access Grants
36-
* instance.</p>
32+
* <p>Associate your S3 Access Grants instance with an Amazon Web Services IAM Identity Center instance. Use this action if you want to create access grants for users or groups from your corporate identity directory. First, you must add your corporate identity directory to Amazon Web Services IAM Identity Center. Then, you can associate this IAM Identity Center instance with your S3 Access Grants instance.</p>
3733
* <dl>
3834
* <dt>Permissions</dt>
3935
* <dd>
40-
* <p>You must have the <code>s3:AssociateAccessGrantsIdentityCenter</code>
41-
* permission to use this operation. </p>
36+
* <p>You must have the <code>s3:AssociateAccessGrantsIdentityCenter</code> permission to use this operation. </p>
4237
* </dd>
4338
* <dt>Additional Permissions</dt>
4439
* <dd>
45-
* <p>You must also have the following permissions:
46-
* <code>sso:CreateApplication</code>, <code>sso:PutApplicationGrant</code>, and
47-
* <code>sso:PutApplicationAuthenticationMethod</code>. </p>
40+
* <p>You must also have the following permissions: <code>sso:CreateApplication</code>, <code>sso:PutApplicationGrant</code>, and <code>sso:PutApplicationAuthenticationMethod</code>. </p>
4841
* </dd>
4942
* </dl>
50-
* <important>
51-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
52-
* </important>
5343
* @example
5444
* Use a bare-bones client and the command you need to make an API call.
5545
* ```javascript

clients/client-s3-control/src/commands/CreateAccessGrantCommand.ts

Lines changed: 3 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -29,31 +29,22 @@ export interface CreateAccessGrantCommandInput extends CreateAccessGrantRequest
2929
export interface CreateAccessGrantCommandOutput extends CreateAccessGrantResult, __MetadataBearer {}
3030

3131
/**
32-
* <p>Creates an access grant that gives a grantee access to your S3 data. The grantee can be
33-
* an IAM user or role or a directory user, or group. Before you can create a grant, you
34-
* must have an S3 Access Grants instance in the same Region as the S3 data. You can create an S3 Access Grants
35-
* instance using the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessGrantsInstance.html">CreateAccessGrantsInstance</a>. You must also have registered at least one S3 data
36-
* location in your S3 Access Grants instance using <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessGrantsLocation.html">CreateAccessGrantsLocation</a>. </p>
32+
* <p>Creates an access grant that gives a grantee access to your S3 data. The grantee can be an IAM user or role or a directory user, or group. Before you can create a grant, you must have an S3 Access Grants instance in the same Region as the S3 data. You can create an S3 Access Grants instance using the <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessGrantsInstance.html">CreateAccessGrantsInstance</a>. You must also have registered at least one S3 data location in your S3 Access Grants instance using <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/API_control_CreateAccessGrantsLocation.html">CreateAccessGrantsLocation</a>. </p>
3733
* <dl>
3834
* <dt>Permissions</dt>
3935
* <dd>
40-
* <p>You must have the <code>s3:CreateAccessGrant</code> permission to use this
41-
* operation. </p>
36+
* <p>You must have the <code>s3:CreateAccessGrant</code> permission to use this operation. </p>
4237
* </dd>
4338
* <dt>Additional Permissions</dt>
4439
* <dd>
45-
* <p>For any directory identity - <code>sso:DescribeInstance</code> and
46-
* <code>sso:DescribeApplication</code>
40+
* <p>For any directory identity - <code>sso:DescribeInstance</code> and <code>sso:DescribeApplication</code>
4741
* </p>
4842
* <p>For directory users - <code>identitystore:DescribeUser</code>
4943
* </p>
5044
* <p>For directory groups - <code>identitystore:DescribeGroup</code>
5145
* </p>
5246
* </dd>
5347
* </dl>
54-
* <important>
55-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
56-
* </important>
5748
* @example
5849
* Use a bare-bones client and the command you need to make an API call.
5950
* ```javascript

clients/client-s3-control/src/commands/CreateAccessGrantsInstanceCommand.ts

Lines changed: 3 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -29,25 +29,17 @@ export interface CreateAccessGrantsInstanceCommandInput extends CreateAccessGran
2929
export interface CreateAccessGrantsInstanceCommandOutput extends CreateAccessGrantsInstanceResult, __MetadataBearer {}
3030

3131
/**
32-
* <p>Creates an S3 Access Grants instance, which serves as a logical grouping for access grants. You
33-
* can create one S3 Access Grants instance per Region per account. </p>
32+
* <p>Creates an S3 Access Grants instance, which serves as a logical grouping for access grants. You can create one S3 Access Grants instance per Region per account. </p>
3433
* <dl>
3534
* <dt>Permissions</dt>
3635
* <dd>
37-
* <p>You must have the <code>s3:CreateAccessGrantsInstance</code> permission to use
38-
* this operation. </p>
36+
* <p>You must have the <code>s3:CreateAccessGrantsInstance</code> permission to use this operation. </p>
3937
* </dd>
4038
* <dt>Additional Permissions</dt>
4139
* <dd>
42-
* <p>To associate an IAM Identity Center instance with your S3 Access Grants instance, you
43-
* must also have the <code>sso:DescribeInstance</code>,
44-
* <code>sso:CreateApplication</code>, <code>sso:PutApplicationGrant</code>, and
45-
* <code>sso:PutApplicationAuthenticationMethod</code> permissions. </p>
40+
* <p>To associate an IAM Identity Center instance with your S3 Access Grants instance, you must also have the <code>sso:DescribeInstance</code>, <code>sso:CreateApplication</code>, <code>sso:PutApplicationGrant</code>, and <code>sso:PutApplicationAuthenticationMethod</code> permissions. </p>
4641
* </dd>
4742
* </dl>
48-
* <important>
49-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
50-
* </important>
5143
* @example
5244
* Use a bare-bones client and the command you need to make an API call.
5345
* ```javascript

clients/client-s3-control/src/commands/CreateAccessGrantsLocationCommand.ts

Lines changed: 4 additions & 14 deletions
Original file line numberDiff line numberDiff line change
@@ -29,9 +29,7 @@ export interface CreateAccessGrantsLocationCommandInput extends CreateAccessGran
2929
export interface CreateAccessGrantsLocationCommandOutput extends CreateAccessGrantsLocationResult, __MetadataBearer {}
3030

3131
/**
32-
* <p>The S3 data location that you would like to register in your S3 Access Grants instance. Your S3
33-
* data must be in the same Region as your S3 Access Grants instance. The location can be one of the
34-
* following: </p>
32+
* <p>The S3 data location that you would like to register in your S3 Access Grants instance. Your S3 data must be in the same Region as your S3 Access Grants instance. The location can be one of the following: </p>
3533
* <ul>
3634
* <li>
3735
* <p>The default S3 location <code>s3://</code>
@@ -46,26 +44,18 @@ export interface CreateAccessGrantsLocationCommandOutput extends CreateAccessGra
4644
* </p>
4745
* </li>
4846
* </ul>
49-
* <p>When you register a location, you must include the IAM role that has permission to
50-
* manage the S3 location that you are registering. Give S3 Access Grants permission to assume this role
51-
* <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-location.html">using a policy</a>. S3 Access Grants assumes this role to manage access to the location and
52-
* to vend temporary credentials to grantees or client applications. </p>
47+
* <p>When you register a location, you must include the IAM role that has permission to manage the S3 location that you are registering. Give S3 Access Grants permission to assume this role <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-grants-location.html">using a policy</a>. S3 Access Grants assumes this role to manage access to the location and to vend temporary credentials to grantees or client applications. </p>
5348
* <dl>
5449
* <dt>Permissions</dt>
5550
* <dd>
56-
* <p>You must have the <code>s3:CreateAccessGrantsLocation</code> permission to use
57-
* this operation. </p>
51+
* <p>You must have the <code>s3:CreateAccessGrantsLocation</code> permission to use this operation. </p>
5852
* </dd>
5953
* <dt>Additional Permissions</dt>
6054
* <dd>
61-
* <p>You must also have the following permission for the specified IAM role:
62-
* <code>iam:PassRole</code>
55+
* <p>You must also have the following permission for the specified IAM role: <code>iam:PassRole</code>
6356
* </p>
6457
* </dd>
6558
* </dl>
66-
* <important>
67-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
68-
* </important>
6959
* @example
7060
* Use a bare-bones client and the command you need to make an API call.
7161
* ```javascript

clients/client-s3-control/src/commands/CreateAccessPointCommand.ts

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -67,9 +67,6 @@ export interface CreateAccessPointCommandOutput extends CreateAccessPointResult,
6767
* </p>
6868
* </li>
6969
* </ul>
70-
* <important>
71-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
72-
* </important>
7370
* @example
7471
* Use a bare-bones client and the command you need to make an API call.
7572
* ```javascript

clients/client-s3-control/src/commands/CreateAccessPointForObjectLambdaCommand.ts

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,9 +54,6 @@ export interface CreateAccessPointForObjectLambdaCommandOutput
5454
* </p>
5555
* </li>
5656
* </ul>
57-
* <important>
58-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
59-
* </important>
6057
* @example
6158
* Use a bare-bones client and the command you need to make an API call.
6259
* ```javascript

clients/client-s3-control/src/commands/CreateJobCommand.ts

Lines changed: 2 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -35,9 +35,8 @@ export interface CreateJobCommandOutput extends CreateJobResult, __MetadataBeare
3535
* <dl>
3636
* <dt>Permissions</dt>
3737
* <dd>
38-
* <p>For information about permissions required to use the Batch Operations, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/batch-ops-iam-role-policies.html">Granting
39-
* permissions for S3 Batch Operations</a> in the <i>Amazon S3 User
40-
* Guide</i>.</p>
38+
* <p>For information about permissions required to use the Batch Operations, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/batch-ops-iam-role-policies.html">Granting permissions for S3 Batch Operations</a> in the <i>Amazon S3
39+
* User Guide</i>.</p>
4140
* </dd>
4241
* </dl>
4342
* <p></p>
@@ -69,9 +68,6 @@ export interface CreateJobCommandOutput extends CreateJobResult, __MetadataBeare
6968
* </p>
7069
* </li>
7170
* </ul>
72-
* <important>
73-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
74-
* </important>
7571
* @example
7672
* Use a bare-bones client and the command you need to make an API call.
7773
* ```javascript

clients/client-s3-control/src/commands/CreateMultiRegionAccessPointCommand.ts

Lines changed: 1 addition & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -35,8 +35,7 @@ export interface CreateMultiRegionAccessPointCommandOutput
3535
* <p>This operation is not supported by directory buckets.</p>
3636
* </note>
3737
* <p>Creates a Multi-Region Access Point and associates it with the specified buckets. For more information
38-
* about creating Multi-Region Access Points, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html">Creating
39-
* Multi-Region Access Points</a> in the <i>Amazon S3 User Guide</i>.</p>
38+
* about creating Multi-Region Access Points, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingMultiRegionAccessPoints.html">Creating Multi-Region Access Points</a> in the <i>Amazon S3 User Guide</i>.</p>
4039
* <p>This action will always be routed to the US West (Oregon) Region. For more information
4140
* about the restrictions around working with Multi-Region Access Points, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/MultiRegionAccessPointRestrictions.html">Multi-Region Access Point
4241
* restrictions and limitations</a> in the <i>Amazon S3 User Guide</i>.</p>
@@ -67,9 +66,6 @@ export interface CreateMultiRegionAccessPointCommandOutput
6766
* </p>
6867
* </li>
6968
* </ul>
70-
* <important>
71-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
72-
* </important>
7369
* @example
7470
* Use a bare-bones client and the command you need to make an API call.
7571
* ```javascript

clients/client-s3-control/src/commands/CreateStorageLensGroupCommand.ts

Lines changed: 0 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -41,9 +41,6 @@ export interface CreateStorageLensGroupCommandOutput extends __MetadataBearer {}
4141
* Groups permissions, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/storage_lens_iam_permissions.html#storage_lens_groups_permissions">Setting account permissions to use S3 Storage Lens groups</a>.</p>
4242
* <p>For information about Storage Lens groups errors, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/ErrorResponses.html#S3LensErrorCodeList">List of Amazon S3 Storage
4343
* Lens error codes</a>.</p>
44-
* <important>
45-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
46-
* </important>
4744
* @example
4845
* Use a bare-bones client and the command you need to make an API call.
4946
* ```javascript

clients/client-s3-control/src/commands/DeleteAccessGrantCommand.ts

Lines changed: 2 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -29,18 +29,13 @@ export interface DeleteAccessGrantCommandInput extends DeleteAccessGrantRequest
2929
export interface DeleteAccessGrantCommandOutput extends __MetadataBearer {}
3030

3131
/**
32-
* <p>Deletes the access grant from the S3 Access Grants instance. You cannot undo an access grant
33-
* deletion and the grantee will no longer have access to the S3 data.</p>
32+
* <p>Deletes the access grant from the S3 Access Grants instance. You cannot undo an access grant deletion and the grantee will no longer have access to the S3 data.</p>
3433
* <dl>
3534
* <dt>Permissions</dt>
3635
* <dd>
37-
* <p>You must have the <code>s3:DeleteAccessGrant</code> permission to use this
38-
* operation. </p>
36+
* <p>You must have the <code>s3:DeleteAccessGrant</code> permission to use this operation. </p>
3937
* </dd>
4038
* </dl>
41-
* <important>
42-
* <p>You must URL encode any signed header values that contain spaces. For example, if your header value is <code>my file.txt</code>, containing two spaces after <code>my</code>, you must URL encode this value to <code>my%20%20file.txt</code>.</p>
43-
* </important>
4439
* @example
4540
* Use a bare-bones client and the command you need to make an API call.
4641
* ```javascript

0 commit comments

Comments
 (0)