Package software.amazon.awscdk.services.dynamodb

Interface GlobalSecondaryIndexPropsV2

All Superinterfaces:

software.amazon.jsii.JsiiSerializable, SecondaryIndexProps

All Known Implementing Classes:

GlobalSecondaryIndexPropsV2.Jsii$Proxy

@Generated(value="jsii-pacmak/1.119.0 (build 1634eac)",
           date="2025-11-13T16:10:02.693Z")
@Stability(Stable)
public interface GlobalSecondaryIndexPropsV2
extends software.amazon.jsii.JsiiSerializable, SecondaryIndexProps

Properties used to configure a global secondary index.

Example:

 TableV2 table = TableV2.Builder.create(this, "Table")
         .partitionKey(Attribute.builder().name("pk").type(AttributeType.STRING).build())
         .globalSecondaryIndexes(List.of(GlobalSecondaryIndexPropsV2.builder()
                 .indexName("gsi1")
                 .partitionKey(Attribute.builder().name("pk").type(AttributeType.STRING).build())
                 .build()))
         .build();
 table.addGlobalSecondaryIndex(GlobalSecondaryIndexPropsV2.builder()
         .indexName("gsi2")
         .partitionKey(Attribute.builder().name("pk").type(AttributeType.STRING).build())
         .build());
 

Nested Class Summary

Nested Classes

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

Method Summary

Modifier and Type	Method	Description
static GlobalSecondaryIndexPropsV2.Builder	builder()
default Number	getMaxReadRequestUnits()	The maximum read request units.
default Number	getMaxWriteRequestUnits()	The maximum write request units.
Attribute	getPartitionKey()	Partition key attribute definition.
default Capacity	getReadCapacity()	The read capacity.
default Attribute	getSortKey()	Sort key attribute definition.
default WarmThroughput	getWarmThroughput()	The warm throughput configuration for the global secondary index.
default Capacity	getWriteCapacity()	The write capacity.

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Methods inherited from interface software.amazon.awscdk.services.dynamodb.SecondaryIndexProps

getIndexName, getNonKeyAttributes, getProjectionType

Method Details

getPartitionKey

@Stability(Stable)
@NotNull
Attribute getPartitionKey()

Partition key attribute definition.

getMaxReadRequestUnits

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

The maximum read request units.

Note: This can only be configured if the primary table billing is PAY_PER_REQUEST.

Default: - inherited from the primary table.

getMaxWriteRequestUnits

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

The maximum write request units.

Note: This can only be configured if the primary table billing is PAY_PER_REQUEST.

Default: - inherited from the primary table.

getReadCapacity

@Stability(Stable)
@Nullable
default Capacity getReadCapacity()

The read capacity.

Note: This can only be configured if the primary table billing is provisioned.

Default: - inherited from the primary table.

getSortKey

@Stability(Stable)
@Nullable
default Attribute getSortKey()

Sort key attribute definition.

Default: - no sort key

getWarmThroughput

@Stability(Stable)
@Nullable
default WarmThroughput getWarmThroughput()

The warm throughput configuration for the global secondary index.

Default: - no warm throughput is configured

getWriteCapacity

@Stability(Stable)
@Nullable
default Capacity getWriteCapacity()

The write capacity.

Note: This can only be configured if the primary table billing is provisioned.

Default: - inherited from the primary table.

builder

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

Returns:

a GlobalSecondaryIndexPropsV2.Builder of GlobalSecondaryIndexPropsV2