Skip to content

Commit 7d53fdd

Browse files
author
awstools
committed
feat(client-s3tables): You can now use the CreateTable API operation to create tables with schemas by adding an optional metadata argument.
1 parent ebb8c7d commit 7d53fdd

29 files changed

+444
-80
lines changed

clients/client-s3tables/src/commands/CreateNamespaceCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface CreateNamespaceCommandInput extends CreateNamespaceRequest {}
2828
export interface CreateNamespaceCommandOutput extends CreateNamespaceResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Creates a namespace. A namespace is a logical grouping of tables within your table bucket, which you can use to organize tables. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html">Table namespaces</a>. </p>
31+
* <p>Creates a namespace. A namespace is a logical grouping of tables within your table bucket, which you can use to organize tables. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-create.html">Create a namespace</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:CreateNamespace</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

clients/client-s3tables/src/commands/CreateTableBucketCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface CreateTableBucketCommandInput extends CreateTableBucketRequest
2828
export interface CreateTableBucketCommandOutput extends CreateTableBucketResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Creates a table bucket.</p>
31+
* <p>Creates a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-create.html">Creating a table bucket</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:CreateTableBucket</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

clients/client-s3tables/src/commands/CreateTableCommand.ts

Lines changed: 23 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,16 @@ export interface CreateTableCommandInput extends CreateTableRequest {}
2828
export interface CreateTableCommandOutput extends CreateTableResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Creates a new table associated with the given namespace in a table bucket.</p>
31+
* <p>Creates a new table associated with the given namespace in a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-create.html">Creating an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:CreateTable</code> permission to use this operation. </p>
36+
* <note>
37+
* <p>Additionally, you must have the <code>s3tables:PutTableData</code> permission to use this operation with the optional <code>metadata</code> request parameter. </p>
38+
* </note>
39+
* </dd>
40+
* </dl>
3241
* @example
3342
* Use a bare-bones client and the command you need to make an API call.
3443
* ```javascript
@@ -40,6 +49,19 @@ export interface CreateTableCommandOutput extends CreateTableResponse, __Metadat
4049
* namespace: "STRING_VALUE", // required
4150
* name: "STRING_VALUE", // required
4251
* format: "ICEBERG", // required
52+
* metadata: { // TableMetadata Union: only one key present
53+
* iceberg: { // IcebergMetadata
54+
* schema: { // IcebergSchema
55+
* fields: [ // SchemaFieldList // required
56+
* { // SchemaField
57+
* name: "STRING_VALUE", // required
58+
* type: "STRING_VALUE", // required
59+
* required: true || false,
60+
* },
61+
* ],
62+
* },
63+
* },
64+
* },
4365
* };
4466
* const command = new CreateTableCommand(input);
4567
* const response = await client.send(command);

clients/client-s3tables/src/commands/DeleteNamespaceCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface DeleteNamespaceCommandInput extends DeleteNamespaceRequest {}
2828
export interface DeleteNamespaceCommandOutput extends __MetadataBearer {}
2929

3030
/**
31-
* <p>Deletes a namespace.</p>
31+
* <p>Deletes a namespace. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace-delete.html">Delete a namespace</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:DeleteNamespace</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

clients/client-s3tables/src/commands/DeleteTableBucketCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface DeleteTableBucketCommandInput extends DeleteTableBucketRequest
2828
export interface DeleteTableBucketCommandOutput extends __MetadataBearer {}
2929

3030
/**
31-
* <p>Deletes a table bucket.</p>
31+
* <p>Deletes a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-delete.html">Deleting a table bucket</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:DeleteTableBucket</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

clients/client-s3tables/src/commands/DeleteTableBucketPolicyCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface DeleteTableBucketPolicyCommandInput extends DeleteTableBucketPo
2828
export interface DeleteTableBucketPolicyCommandOutput extends __MetadataBearer {}
2929

3030
/**
31-
* <p>Deletes a table bucket policy.</p>
31+
* <p>Deletes a table bucket policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-bucket-policy.html#table-bucket-policy-delete">Deleting a table bucket policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:DeleteTableBucketPolicy</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

clients/client-s3tables/src/commands/DeleteTableCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface DeleteTableCommandInput extends DeleteTableRequest {}
2828
export interface DeleteTableCommandOutput extends __MetadataBearer {}
2929

3030
/**
31-
* <p>Deletes a table.</p>
31+
* <p>Deletes a table. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-delete.html">Deleting an Amazon S3 table</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:DeleteTable</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

clients/client-s3tables/src/commands/DeleteTablePolicyCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface DeleteTablePolicyCommandInput extends DeleteTablePolicyRequest
2828
export interface DeleteTablePolicyCommandOutput extends __MetadataBearer {}
2929

3030
/**
31-
* <p>Deletes a table policy.</p>
31+
* <p>Deletes a table policy. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-table-policy.html#table-policy-delete">Deleting a table policy</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:DeleteTablePolicy</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

clients/client-s3tables/src/commands/GetNamespaceCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface GetNamespaceCommandInput extends GetNamespaceRequest {}
2828
export interface GetNamespaceCommandOutput extends GetNamespaceResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Gets details about a namespace.</p>
31+
* <p>Gets details about a namespace. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-namespace.html">Table namespaces</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:GetNamespace</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

clients/client-s3tables/src/commands/GetTableBucketCommand.ts

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -28,7 +28,13 @@ export interface GetTableBucketCommandInput extends GetTableBucketRequest {}
2828
export interface GetTableBucketCommandOutput extends GetTableBucketResponse, __MetadataBearer {}
2929

3030
/**
31-
* <p>Gets details on a table bucket.</p>
31+
* <p>Gets details on a table bucket. For more information, see <a href="https://docs.aws.amazon.com/AmazonS3/latest/userguide/s3-tables-buckets-details.html">Viewing details about an Amazon S3 table bucket</a> in the <i>Amazon Simple Storage Service User Guide</i>.</p>
32+
* <dl>
33+
* <dt>Permissions</dt>
34+
* <dd>
35+
* <p>You must have the <code>s3tables:GetTableBucket</code> permission to use this operation. </p>
36+
* </dd>
37+
* </dl>
3238
* @example
3339
* Use a bare-bones client and the command you need to make an API call.
3440
* ```javascript

0 commit comments

Comments
 (0)