software.amazon.awscdk.services.dynamodb

Class TableProps.Builder

java.lang.Object

software.amazon.awscdk.services.dynamodb.TableProps.Builder

All Implemented Interfaces:

software.amazon.jsii.Builder<TableProps>

Enclosing interface:

TableProps

@Stability(value=Stable)
public static final class TableProps.Builder
extends Object
implements software.amazon.jsii.Builder<TableProps>

A builder for TableProps

Constructor Summary

Constructors

Constructor and Description
Builder()

Method Summary

Modifier and Type	Method and Description
TableProps.Builder	billingMode(BillingMode billingMode) Sets the value of TableOptions.getBillingMode()
TableProps	build() Builds the configured instance.
TableProps.Builder	contributorInsightsEnabled(Boolean contributorInsightsEnabled) Sets the value of TableOptions.getContributorInsightsEnabled()
TableProps.Builder	encryption(TableEncryption encryption) Sets the value of TableOptions.getEncryption()
TableProps.Builder	encryptionKey(IKey encryptionKey) Sets the value of TableOptions.getEncryptionKey()
TableProps.Builder	kinesisStream(IStream kinesisStream) Sets the value of TableProps.getKinesisStream()
TableProps.Builder	partitionKey(Attribute partitionKey) Sets the value of SchemaOptions.getPartitionKey()
TableProps.Builder	pointInTimeRecovery(Boolean pointInTimeRecovery) Sets the value of TableOptions.getPointInTimeRecovery()
TableProps.Builder	readCapacity(Number readCapacity) Sets the value of TableOptions.getReadCapacity()
TableProps.Builder	removalPolicy(RemovalPolicy removalPolicy) Sets the value of TableOptions.getRemovalPolicy()
TableProps.Builder	replicationRegions(List<String> replicationRegions) Sets the value of TableOptions.getReplicationRegions()
TableProps.Builder	replicationTimeout(Duration replicationTimeout) Sets the value of TableOptions.getReplicationTimeout()
TableProps.Builder	sortKey(Attribute sortKey) Sets the value of SchemaOptions.getSortKey()
TableProps.Builder	stream(StreamViewType stream) Sets the value of TableOptions.getStream()
TableProps.Builder	tableClass(TableClass tableClass) Sets the value of TableOptions.getTableClass()
TableProps.Builder	tableName(String tableName) Sets the value of TableProps.getTableName()
TableProps.Builder	timeToLiveAttribute(String timeToLiveAttribute) Sets the value of TableOptions.getTimeToLiveAttribute()
TableProps.Builder	waitForReplicationToFinish(Boolean waitForReplicationToFinish) Sets the value of TableOptions.getWaitForReplicationToFinish()
TableProps.Builder	writeCapacity(Number writeCapacity) Sets the value of TableOptions.getWriteCapacity()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

Builder

public Builder()

Method Detail

kinesisStream

@Stability(value=Stable)
public TableProps.Builder kinesisStream(IStream kinesisStream)

Sets the value of TableProps.getKinesisStream()

Parameters:

kinesisStream - Kinesis Data Stream to capture item-level changes for the table.

Returns:

this

tableName

@Stability(value=Stable)
public TableProps.Builder tableName(String tableName)

Sets the value of TableProps.getTableName()

Parameters:

tableName - Enforces a particular physical table name.

Returns:

this

billingMode

@Stability(value=Stable)
public TableProps.Builder billingMode(BillingMode billingMode)

Sets the value of TableOptions.getBillingMode()

Parameters:

billingMode - Specify how you are charged for read and write throughput and how you manage capacity.

Returns:

this

contributorInsightsEnabled

@Stability(value=Stable)
public TableProps.Builder contributorInsightsEnabled(Boolean contributorInsightsEnabled)

Sets the value of TableOptions.getContributorInsightsEnabled()

Parameters:

contributorInsightsEnabled - Whether CloudWatch contributor insights is enabled.

Returns:

this

encryption

@Stability(value=Stable)
public TableProps.Builder encryption(TableEncryption encryption)

Sets the value of TableOptions.getEncryption()

Parameters:

encryption - Whether server-side encryption with an AWS managed customer master key is enabled. This property cannot be set if serverSideEncryption is set.

NOTE: if you set this to CUSTOMER_MANAGED and encryptionKey is not specified, the key that the Tablet generates for you will be created with default permissions. If you are using CDKv2, these permissions will be sufficient to enable the key for use with DynamoDB tables. If you are using CDKv1, make sure the feature flag @aws-cdk/aws-kms:defaultKeyPolicies is set to true in your cdk.json.

Returns:

this

encryptionKey

@Stability(value=Stable)
public TableProps.Builder encryptionKey(IKey encryptionKey)

Sets the value of TableOptions.getEncryptionKey()

Parameters:

encryptionKey - External KMS key to use for table encryption. This property can only be set if encryption is set to TableEncryption.CUSTOMER_MANAGED.

Returns:

this

pointInTimeRecovery

@Stability(value=Stable)
public TableProps.Builder pointInTimeRecovery(Boolean pointInTimeRecovery)

Sets the value of TableOptions.getPointInTimeRecovery()

Parameters:

pointInTimeRecovery - Whether point-in-time recovery is enabled.

Returns:

this

readCapacity

@Stability(value=Stable)
public TableProps.Builder readCapacity(Number readCapacity)

Sets the value of TableOptions.getReadCapacity()

Parameters:

readCapacity - The read capacity for the table. Careful if you add Global Secondary Indexes, as those will share the table's provisioned throughput.

Can only be provided if billingMode is Provisioned.

Returns:

this

removalPolicy

@Stability(value=Stable)
public TableProps.Builder removalPolicy(RemovalPolicy removalPolicy)

Sets the value of TableOptions.getRemovalPolicy()

Parameters:

removalPolicy - The removal policy to apply to the DynamoDB Table.

Returns:

this

replicationRegions

@Stability(value=Stable)
public TableProps.Builder replicationRegions(List<String> replicationRegions)

Sets the value of TableOptions.getReplicationRegions()

Parameters:

replicationRegions - Regions where replica tables will be created.

Returns:

this

replicationTimeout

@Stability(value=Stable)
public TableProps.Builder replicationTimeout(Duration replicationTimeout)

Sets the value of TableOptions.getReplicationTimeout()

Parameters:

replicationTimeout - The timeout for a table replication operation in a single region.

Returns:

this

stream

@Stability(value=Stable)
public TableProps.Builder stream(StreamViewType stream)

Sets the value of TableOptions.getStream()

Parameters:

stream - When an item in the table is modified, StreamViewType determines what information is written to the stream for this table.

Returns:

this

tableClass

@Stability(value=Stable)
public TableProps.Builder tableClass(TableClass tableClass)

Sets the value of TableOptions.getTableClass()

Parameters:

tableClass - Specify the table class.

Returns:

this

timeToLiveAttribute

@Stability(value=Stable)
public TableProps.Builder timeToLiveAttribute(String timeToLiveAttribute)

Sets the value of TableOptions.getTimeToLiveAttribute()

Parameters:

timeToLiveAttribute - The name of TTL attribute.

Returns:

this

waitForReplicationToFinish

@Stability(value=Stable)
public TableProps.Builder waitForReplicationToFinish(Boolean waitForReplicationToFinish)

Sets the value of TableOptions.getWaitForReplicationToFinish()

Parameters:

waitForReplicationToFinish - Indicates whether CloudFormation stack waits for replication to finish. If set to false, the CloudFormation resource will mark the resource as created and replication will be completed asynchronously. This property is ignored if replicationRegions property is not set.

DO NOT UNSET this property if adding/removing multiple replicationRegions in one deployment, as CloudFormation only supports one region replication at a time. CDK overcomes this limitation by waiting for replication to finish before starting new replicationRegion.

Returns:

this

writeCapacity

@Stability(value=Stable)
public TableProps.Builder writeCapacity(Number writeCapacity)

Sets the value of TableOptions.getWriteCapacity()

Parameters:

writeCapacity - The write capacity for the table. Careful if you add Global Secondary Indexes, as those will share the table's provisioned throughput.

Can only be provided if billingMode is Provisioned.

Returns:

this

partitionKey

@Stability(value=Stable)
public TableProps.Builder partitionKey(Attribute partitionKey)

Sets the value of SchemaOptions.getPartitionKey()

Parameters:

partitionKey - Partition key attribute definition. This parameter is required.

Returns:

this

sortKey

@Stability(value=Stable)
public TableProps.Builder sortKey(Attribute sortKey)

Sets the value of SchemaOptions.getSortKey()

Parameters:

sortKey - Sort key attribute definition.

Returns:

this

build

@Stability(value=Stable)
public TableProps build()

Builds the configured instance.

Specified by:

build in interface software.amazon.jsii.Builder<TableProps>

Returns:

a new instance of TableProps

Throws:

NullPointerException - if any required attribute was not provided