feat(dynamodb): allow setting TableClass for a Table

packages/@aws-cdk/aws-dynamodb/README.md

@@ -58,6 +58,23 @@ const table = new dynamodb.Table(this, 'Table', {
 Further reading:
 https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.ReadWriteCapacityMode.
 
+## Table Class
+
+DynamoDB supports two table classes:
+
+* STANDARD - the default mode, and is recommended for the vast majority of workloads.
+* STANDARD_INFREQUENT_ACCESS - optimized for tables where storage is the dominant cost.
+
+```ts
+const table = new dynamodb.Table(this, 'Table', {
+  partitionKey: { name: 'id', type: dynamodb.AttributeType.STRING },
+  tableClass: dynamodb.TableClass.STANDARD_INFREQUENT_ACCESS,
+});
+```
+
+Further reading:
+https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.TableClasses.html
+
 ## Configure AutoScaling for your table
 
 You can have DynamoDB automatically raise and lower the read and write capacities

packages/@aws-cdk/aws-dynamodb/lib/table.ts

@@ -193,6 +193,12 @@ export interface TableOptions extends SchemaOptions {
    */
   readonly serverSideEncryption?: boolean;
 
+  /**
+   * Specifiy the table class.
+   * @default STANDARD else STANDARD_INFREQUENT_ACCESS
+   */
+  readonly tableClass?: TableClass;
+
   /**
    * Whether server-side encryption with an AWS managed customer master key is enabled.
    *
@@ -1169,6 +1175,7 @@ export class Table extends TableBase {
       },
       sseSpecification,
       streamSpecification,
+      tableClass: props.tableClass ? props.tableClass : undefined,
       timeToLiveSpecification: props.timeToLiveAttribute ? { attributeName: props.timeToLiveAttribute, enabled: true } : undefined,
       contributorInsightsSpecification: props.contributorInsightsEnabled !== undefined ? { enabled: props.contributorInsightsEnabled } : undefined,
       kinesisStreamSpecification: props.kinesisStream ? { streamArn: props.kinesisStream.streamArn } : undefined,
@@ -1760,6 +1767,19 @@ export enum StreamViewType {
   KEYS_ONLY = 'KEYS_ONLY'
 }
 
+/**
+ * DynamoDB's table class.
+ *
+ * @see https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/HowItWorks.TableClasses.html
+ */
+export enum TableClass {
+  /** Default table class for DynamoDB */
+  STANDARD = 'STANDARD',
+
+  /** table class for DynamoDB that reduces storage costs compared to existing DynamoDB Standard tables */
+  STANDARD_INFREQUENT_ACCESS = 'STANDARD_INFREQUENT_ACCESS',
+}
+
 /**
  * Just a convenient way to keep track of both attributes
  */

packages/@aws-cdk/aws-dynamodb/test/dynamodb.test.ts

@@ -17,6 +17,7 @@ import {
   ProjectionType,
   StreamViewType,
   Table,
+  TableClass,
   TableEncryption,
   Operation,
   CfnTable,
@@ -334,6 +335,7 @@ testDeprecated('when specifying every property', () => {
     sortKey: TABLE_SORT_KEY,
     contributorInsightsEnabled: true,
     kinesisStream: stream,
+    tableClass: TableClass.STANDARD,
   });
   Tags.of(table).add('Environment', 'Production');
 
@@ -719,6 +721,70 @@ test('if an encryption key is included, encrypt/decrypt permissions are added to
   });
 });
 
+test('when specifying STANDARD_INFREQUENT_ACCESS table class', () => {
+  const stack = new Stack();
+  new Table(stack, CONSTRUCT_NAME, {
+    tableName: TABLE_NAME,
+    partitionKey: TABLE_PARTITION_KEY,
+    tableClass: TableClass.STANDARD_INFREQUENT_ACCESS,
+  });
+
+  Template.fromStack(stack).hasResourceProperties('AWS::DynamoDB::Table',
+    {
+      KeySchema: [
+        { AttributeName: 'hashKey', KeyType: 'HASH' },
+      ],
+      TableClass: 'STANDARD_INFREQUENT_ACCESS',
+      AttributeDefinitions: [
+        { AttributeName: 'hashKey', AttributeType: 'S' },
+      ],
+      TableName: 'MyTable',
+    },
+  );
+});
+
+test('when specifying STANDARD table class', () => {
+  const stack = new Stack();
+  new Table(stack, CONSTRUCT_NAME, {
+    tableName: TABLE_NAME,
+    partitionKey: TABLE_PARTITION_KEY,
+    tableClass: TableClass.STANDARD,
+  });
+
+  Template.fromStack(stack).hasResourceProperties('AWS::DynamoDB::Table',
+    {
+      KeySchema: [
+        { AttributeName: 'hashKey', KeyType: 'HASH' },
+      ],
+      TableClass: 'STANDARD',
+      AttributeDefinitions: [
+        { AttributeName: 'hashKey', AttributeType: 'S' },
+      ],
+      TableName: 'MyTable',
+    },
+  );
+});
+
+test('when specifying no table class', () => {
+  const stack = new Stack();
+  new Table(stack, CONSTRUCT_NAME, {
+    tableName: TABLE_NAME,
+    partitionKey: TABLE_PARTITION_KEY,
+  });
+
+  Template.fromStack(stack).hasResourceProperties('AWS::DynamoDB::Table',
+    {
+      KeySchema: [
+        { AttributeName: 'hashKey', KeyType: 'HASH' },
+      ],
+      AttributeDefinitions: [
+        { AttributeName: 'hashKey', AttributeType: 'S' },
+      ],
+      TableName: 'MyTable',
+    },
+  );
+});
+
 test('when specifying PAY_PER_REQUEST billing mode', () => {
   const stack = new Stack();
   new Table(stack, CONSTRUCT_NAME, {