Package software.amazon.awscdk.services.dynamodb

Interface AutoscaledCapacityOptions

All Superinterfaces:

software.amazon.jsii.JsiiSerializable

All Known Implementing Classes:

AutoscaledCapacityOptions.Jsii$Proxy

@Generated(value="jsii-pacmak/1.121.0 (build d7af9b9)",
           date="2025-12-18T18:20:08.465Z")
@Stability(Stable)
public interface AutoscaledCapacityOptions
extends software.amazon.jsii.JsiiSerializable

Options used to configure autoscaled capacity.

Example:

 import software.amazon.awscdk.*;
 App app = new App();
 Stack stack = Stack.Builder.create(app, "Stack").env(Environment.builder().region("us-west-2").build()).build();
 TableV2 globalTable = TableV2.Builder.create(stack, "GlobalTable")
         .partitionKey(Attribute.builder().name("pk").type(AttributeType.STRING).build())
         .billing(Billing.provisioned(ThroughputProps.builder()
                 .readCapacity(Capacity.fixed(10))
                 .writeCapacity(Capacity.autoscaled(AutoscaledCapacityOptions.builder().maxCapacity(15).build()))
                 .build()))
         .replicas(List.of(ReplicaTableProps.builder()
                 .region("us-east-1")
                 .build(), ReplicaTableProps.builder()
                 .region("us-east-2")
                 .readCapacity(Capacity.autoscaled(AutoscaledCapacityOptions.builder().maxCapacity(20).targetUtilizationPercent(50).build()))
                 .build()))
         .build();
 

Nested Class Summary

Nested Classes

Modifier and Type	Interface	Description
static final class	AutoscaledCapacityOptions.Builder	A builder for AutoscaledCapacityOptions
static final class	AutoscaledCapacityOptions.Jsii$Proxy	An implementation for AutoscaledCapacityOptions

Method Summary

Modifier and Type	Method	Description
static AutoscaledCapacityOptions.Builder	builder()
Number	getMaxCapacity()	The maximum allowable capacity.
default Number	getMinCapacity()	The minimum allowable capacity.
default Number	getSeedCapacity()	If you want to switch a table's billing mode from on-demand to provisioned or from provisioned to on-demand, you must specify a value for this property for each autoscaled resource.
default Number	getTargetUtilizationPercent()	The ratio of consumed capacity units to provisioned capacity units.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Method Details

getMaxCapacity

@Stability(Stable)
@NotNull
Number getMaxCapacity()

The maximum allowable capacity.

getMinCapacity

@Stability(Stable)
@Nullable
default Number getMinCapacity()

The minimum allowable capacity.

Default: 1

getSeedCapacity

@Stability(Stable)
@Nullable
default Number getSeedCapacity()

If you want to switch a table's billing mode from on-demand to provisioned or from provisioned to on-demand, you must specify a value for this property for each autoscaled resource.

Default: no seed capacity

getTargetUtilizationPercent

@Stability(Stable)
@Nullable
default Number getTargetUtilizationPercent()

The ratio of consumed capacity units to provisioned capacity units.

Note: Target utilization percent cannot be less than 20 and cannot be greater than 90.

Default: 70

builder

@Stability(Stable)
static AutoscaledCapacityOptions.Builder builder()

Returns:

a AutoscaledCapacityOptions.Builder of AutoscaledCapacityOptions