We recommend new projects start with resources from the AWS provider.
aws-native.dynamodb.getTable
Explore with Pulumi AI
We recommend new projects start with resources from the AWS provider.
The AWS::DynamoDB::Table
resource creates a DDB table. For more information, see CreateTable in the API Reference.
You should be aware of the following behaviors when working with DDB tables:
- CFNlong typically creates DDB tables in parallel. However, if your template includes multiple DDB tables with indexes, you must declare dependencies so that the tables are created sequentially. DDBlong limits the number of tables with secondary indexes that are in the creating state. If you create multiple tables with indexes at the same time, DDB returns an error and the stack operation fails. For an example, see DynamoDB Table with a DependsOn Attribute.
Our guidance is to use the latest schema documented for your CFNlong templates. This schema supports the provisioning of all table settings below. When using this schema in your CFNlong templates, please ensure that your Identity and Access Management (IAM) policies are updated with appropriate permissions to allow for the authorization of these setting changes.
Using getTable
Two invocation forms are available. The direct form accepts plain arguments and either blocks until the result value is available, or returns a Promise-wrapped result. The output form accepts Input-wrapped arguments and returns an Output-wrapped result.
function getTable(args: GetTableArgs, opts?: InvokeOptions): Promise<GetTableResult>
function getTableOutput(args: GetTableOutputArgs, opts?: InvokeOptions): Output<GetTableResult>
def get_table(table_name: Optional[str] = None,
opts: Optional[InvokeOptions] = None) -> GetTableResult
def get_table_output(table_name: Optional[pulumi.Input[str]] = None,
opts: Optional[InvokeOptions] = None) -> Output[GetTableResult]
func LookupTable(ctx *Context, args *LookupTableArgs, opts ...InvokeOption) (*LookupTableResult, error)
func LookupTableOutput(ctx *Context, args *LookupTableOutputArgs, opts ...InvokeOption) LookupTableResultOutput
> Note: This function is named LookupTable
in the Go SDK.
public static class GetTable
{
public static Task<GetTableResult> InvokeAsync(GetTableArgs args, InvokeOptions? opts = null)
public static Output<GetTableResult> Invoke(GetTableInvokeArgs args, InvokeOptions? opts = null)
}
public static CompletableFuture<GetTableResult> getTable(GetTableArgs args, InvokeOptions options)
// Output-based functions aren't available in Java yet
fn::invoke:
function: aws-native:dynamodb:getTable
arguments:
# arguments dictionary
The following arguments are supported:
- Table
Name string - A name for the table. If you don't specify a name, CFNlong generates a unique physical ID and uses that ID for the table name. For more information, see Name Type. If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
- Table
Name string - A name for the table. If you don't specify a name, CFNlong generates a unique physical ID and uses that ID for the table name. For more information, see Name Type. If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
- table
Name String - A name for the table. If you don't specify a name, CFNlong generates a unique physical ID and uses that ID for the table name. For more information, see Name Type. If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
- table
Name string - A name for the table. If you don't specify a name, CFNlong generates a unique physical ID and uses that ID for the table name. For more information, see Name Type. If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
- table_
name str - A name for the table. If you don't specify a name, CFNlong generates a unique physical ID and uses that ID for the table name. For more information, see Name Type. If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
- table
Name String - A name for the table. If you don't specify a name, CFNlong generates a unique physical ID and uses that ID for the table name. For more information, see Name Type. If you specify a name, you cannot perform updates that require replacement of this resource. You can perform updates that require no or some interruption. If you must replace the resource, specify a new name.
getTable Result
The following output properties are available:
- Arn string
- The Amazon Resource Name (ARN) of the DynamoDB table, such as
arn:aws:dynamodb:us-east-2:123456789012:table/myDynamoDBTable
. - Attribute
Definitions List<Pulumi.Aws Native. Dynamo Db. Outputs. Table Attribute Definition> - A list of attributes that describe the key schema for the table and indexes. This property is required to create a DDB table. Update requires: Some interruptions. Replacement if you edit an existing AttributeDefinition.
- Billing
Mode string Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:
PROVISIONED
- We recommend usingPROVISIONED
for predictable workloads.PROVISIONED
sets the billing mode to Provisioned Mode.PAY_PER_REQUEST
- We recommend usingPAY_PER_REQUEST
for unpredictable workloads.PAY_PER_REQUEST
sets the billing mode to On-Demand Mode.
If not specified, the default is
PROVISIONED
.- Contributor
Insights Pulumi.Specification Aws Native. Dynamo Db. Outputs. Table Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified table.
- Deletion
Protection boolEnabled - Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see Using deletion protection in the Developer Guide.
- Global
Secondary List<Pulumi.Indexes Aws Native. Dynamo Db. Outputs. Table Global Secondary Index> - Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes.
If you update a table to include a new global secondary index, CFNlong initiates the index creation and then proceeds with the stack update. CFNlong doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is
ACTIVE
. You can track its status by using the DynamoDB DescribeTable command. If you add or delete an index during an update, we recommend that you don't update any other resources. If your stack fails to update and is rolled back while adding a new index, you must manually delete the index. Updates are not supported. The following are exceptions:- If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
- You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.
- Key
Schema List<Pulumi.Aws | objectNative. Dynamo Db. Outputs. Table Key Schema> - Specifies the attributes that make up the primary key for the table. The attributes in the
KeySchema
property must also be defined in theAttributeDefinitions
property. - Kinesis
Stream Pulumi.Specification Aws Native. Dynamo Db. Outputs. Table Kinesis Stream Specification - The Kinesis Data Streams configuration for the specified table.
- Local
Secondary List<Pulumi.Indexes Aws Native. Dynamo Db. Outputs. Table Local Secondary Index> - Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.
- On
Demand Pulumi.Throughput Aws Native. Dynamo Db. Outputs. Table On Demand Throughput - Sets the maximum number of read and write units for the specified on-demand table. If you use this property, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - Point
In Pulumi.Time Recovery Specification Aws Native. Dynamo Db. Outputs. Table Point In Time Recovery Specification - The settings used to enable point in time recovery.
- Provisioned
Throughput Pulumi.Aws Native. Dynamo Db. Outputs. Table Provisioned Throughput - Throughput for the specified table, which consists of values for
ReadCapacityUnits
andWriteCapacityUnits
. For more information about the contents of a provisioned throughput structure, see Amazon DynamoDB Table ProvisionedThroughput. If you setBillingMode
asPROVISIONED
, you must specify this property. If you setBillingMode
asPAY_PER_REQUEST
, you cannot specify this property. - Resource
Policy Pulumi.Aws Native. Dynamo Db. Outputs. Table Resource Policy - A resource-based policy document that contains permissions to add to the specified table. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples. When you attach a resource-based policy while creating a table, the policy creation is strongly consistent. For information about the considerations that you should keep in mind while attaching a resource-based policy, see Resource-based policy considerations.
- Sse
Specification Pulumi.Aws Native. Dynamo Db. Outputs. Table Sse Specification - Specifies the settings to enable server-side encryption.
- Stream
Arn string The ARN of the DynamoDB stream, such as
arn:aws:dynamodb:us-east-1:123456789012:table/testddbstack-myDynamoDBTable-012A1SL7SMP5Q/stream/2015-11-30T20:10:00.000
.You must specify the
StreamSpecification
property to use this attribute.- Stream
Specification Pulumi.Aws Native. Dynamo Db. Outputs. Table Stream Specification - The settings for the DDB table stream, which capture changes to items stored in the table.
- Table
Class string - The table class of the new table. Valid values are
STANDARD
andSTANDARD_INFREQUENT_ACCESS
. - List<Pulumi.
Aws Native. Outputs. Tag> - An array of key-value pairs to apply to this resource. For more information, see Tag.
- Time
To Pulumi.Live Specification Aws Native. Dynamo Db. Outputs. Table Time To Live Specification - Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.
- Warm
Throughput Pulumi.Aws Native. Dynamo Db. Outputs. Table Warm Throughput
- Arn string
- The Amazon Resource Name (ARN) of the DynamoDB table, such as
arn:aws:dynamodb:us-east-2:123456789012:table/myDynamoDBTable
. - Attribute
Definitions []TableAttribute Definition - A list of attributes that describe the key schema for the table and indexes. This property is required to create a DDB table. Update requires: Some interruptions. Replacement if you edit an existing AttributeDefinition.
- Billing
Mode string Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:
PROVISIONED
- We recommend usingPROVISIONED
for predictable workloads.PROVISIONED
sets the billing mode to Provisioned Mode.PAY_PER_REQUEST
- We recommend usingPAY_PER_REQUEST
for unpredictable workloads.PAY_PER_REQUEST
sets the billing mode to On-Demand Mode.
If not specified, the default is
PROVISIONED
.- Contributor
Insights TableSpecification Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified table.
- Deletion
Protection boolEnabled - Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see Using deletion protection in the Developer Guide.
- Global
Secondary []TableIndexes Global Secondary Index - Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes.
If you update a table to include a new global secondary index, CFNlong initiates the index creation and then proceeds with the stack update. CFNlong doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is
ACTIVE
. You can track its status by using the DynamoDB DescribeTable command. If you add or delete an index during an update, we recommend that you don't update any other resources. If your stack fails to update and is rolled back while adding a new index, you must manually delete the index. Updates are not supported. The following are exceptions:- If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
- You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.
- Key
Schema []TableKey | interface{}Schema - Specifies the attributes that make up the primary key for the table. The attributes in the
KeySchema
property must also be defined in theAttributeDefinitions
property. - Kinesis
Stream TableSpecification Kinesis Stream Specification - The Kinesis Data Streams configuration for the specified table.
- Local
Secondary []TableIndexes Local Secondary Index - Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.
- On
Demand TableThroughput On Demand Throughput - Sets the maximum number of read and write units for the specified on-demand table. If you use this property, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - Point
In TableTime Recovery Specification Point In Time Recovery Specification - The settings used to enable point in time recovery.
- Provisioned
Throughput TableProvisioned Throughput - Throughput for the specified table, which consists of values for
ReadCapacityUnits
andWriteCapacityUnits
. For more information about the contents of a provisioned throughput structure, see Amazon DynamoDB Table ProvisionedThroughput. If you setBillingMode
asPROVISIONED
, you must specify this property. If you setBillingMode
asPAY_PER_REQUEST
, you cannot specify this property. - Resource
Policy TableResource Policy - A resource-based policy document that contains permissions to add to the specified table. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples. When you attach a resource-based policy while creating a table, the policy creation is strongly consistent. For information about the considerations that you should keep in mind while attaching a resource-based policy, see Resource-based policy considerations.
- Sse
Specification TableSse Specification - Specifies the settings to enable server-side encryption.
- Stream
Arn string The ARN of the DynamoDB stream, such as
arn:aws:dynamodb:us-east-1:123456789012:table/testddbstack-myDynamoDBTable-012A1SL7SMP5Q/stream/2015-11-30T20:10:00.000
.You must specify the
StreamSpecification
property to use this attribute.- Stream
Specification TableStream Specification - The settings for the DDB table stream, which capture changes to items stored in the table.
- Table
Class string - The table class of the new table. Valid values are
STANDARD
andSTANDARD_INFREQUENT_ACCESS
. - Tag
- An array of key-value pairs to apply to this resource. For more information, see Tag.
- Time
To TableLive Specification Time To Live Specification - Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.
- Warm
Throughput TableWarm Throughput
- arn String
- The Amazon Resource Name (ARN) of the DynamoDB table, such as
arn:aws:dynamodb:us-east-2:123456789012:table/myDynamoDBTable
. - attribute
Definitions List<TableAttribute Definition> - A list of attributes that describe the key schema for the table and indexes. This property is required to create a DDB table. Update requires: Some interruptions. Replacement if you edit an existing AttributeDefinition.
- billing
Mode String Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:
PROVISIONED
- We recommend usingPROVISIONED
for predictable workloads.PROVISIONED
sets the billing mode to Provisioned Mode.PAY_PER_REQUEST
- We recommend usingPAY_PER_REQUEST
for unpredictable workloads.PAY_PER_REQUEST
sets the billing mode to On-Demand Mode.
If not specified, the default is
PROVISIONED
.- contributor
Insights TableSpecification Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified table.
- deletion
Protection BooleanEnabled - Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see Using deletion protection in the Developer Guide.
- global
Secondary List<TableIndexes Global Secondary Index> - Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes.
If you update a table to include a new global secondary index, CFNlong initiates the index creation and then proceeds with the stack update. CFNlong doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is
ACTIVE
. You can track its status by using the DynamoDB DescribeTable command. If you add or delete an index during an update, we recommend that you don't update any other resources. If your stack fails to update and is rolled back while adding a new index, you must manually delete the index. Updates are not supported. The following are exceptions:- If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
- You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.
- key
Schema List<TableKey | ObjectSchema> - Specifies the attributes that make up the primary key for the table. The attributes in the
KeySchema
property must also be defined in theAttributeDefinitions
property. - kinesis
Stream TableSpecification Kinesis Stream Specification - The Kinesis Data Streams configuration for the specified table.
- local
Secondary List<TableIndexes Local Secondary Index> - Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.
- on
Demand TableThroughput On Demand Throughput - Sets the maximum number of read and write units for the specified on-demand table. If you use this property, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - point
In TableTime Recovery Specification Point In Time Recovery Specification - The settings used to enable point in time recovery.
- provisioned
Throughput TableProvisioned Throughput - Throughput for the specified table, which consists of values for
ReadCapacityUnits
andWriteCapacityUnits
. For more information about the contents of a provisioned throughput structure, see Amazon DynamoDB Table ProvisionedThroughput. If you setBillingMode
asPROVISIONED
, you must specify this property. If you setBillingMode
asPAY_PER_REQUEST
, you cannot specify this property. - resource
Policy TableResource Policy - A resource-based policy document that contains permissions to add to the specified table. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples. When you attach a resource-based policy while creating a table, the policy creation is strongly consistent. For information about the considerations that you should keep in mind while attaching a resource-based policy, see Resource-based policy considerations.
- sse
Specification TableSse Specification - Specifies the settings to enable server-side encryption.
- stream
Arn String The ARN of the DynamoDB stream, such as
arn:aws:dynamodb:us-east-1:123456789012:table/testddbstack-myDynamoDBTable-012A1SL7SMP5Q/stream/2015-11-30T20:10:00.000
.You must specify the
StreamSpecification
property to use this attribute.- stream
Specification TableStream Specification - The settings for the DDB table stream, which capture changes to items stored in the table.
- table
Class String - The table class of the new table. Valid values are
STANDARD
andSTANDARD_INFREQUENT_ACCESS
. - List<Tag>
- An array of key-value pairs to apply to this resource. For more information, see Tag.
- time
To TableLive Specification Time To Live Specification - Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.
- warm
Throughput TableWarm Throughput
- arn string
- The Amazon Resource Name (ARN) of the DynamoDB table, such as
arn:aws:dynamodb:us-east-2:123456789012:table/myDynamoDBTable
. - attribute
Definitions TableAttribute Definition[] - A list of attributes that describe the key schema for the table and indexes. This property is required to create a DDB table. Update requires: Some interruptions. Replacement if you edit an existing AttributeDefinition.
- billing
Mode string Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:
PROVISIONED
- We recommend usingPROVISIONED
for predictable workloads.PROVISIONED
sets the billing mode to Provisioned Mode.PAY_PER_REQUEST
- We recommend usingPAY_PER_REQUEST
for unpredictable workloads.PAY_PER_REQUEST
sets the billing mode to On-Demand Mode.
If not specified, the default is
PROVISIONED
.- contributor
Insights TableSpecification Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified table.
- deletion
Protection booleanEnabled - Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see Using deletion protection in the Developer Guide.
- global
Secondary TableIndexes Global Secondary Index[] - Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes.
If you update a table to include a new global secondary index, CFNlong initiates the index creation and then proceeds with the stack update. CFNlong doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is
ACTIVE
. You can track its status by using the DynamoDB DescribeTable command. If you add or delete an index during an update, we recommend that you don't update any other resources. If your stack fails to update and is rolled back while adding a new index, you must manually delete the index. Updates are not supported. The following are exceptions:- If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
- You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.
- key
Schema TableKey | anySchema[] - Specifies the attributes that make up the primary key for the table. The attributes in the
KeySchema
property must also be defined in theAttributeDefinitions
property. - kinesis
Stream TableSpecification Kinesis Stream Specification - The Kinesis Data Streams configuration for the specified table.
- local
Secondary TableIndexes Local Secondary Index[] - Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.
- on
Demand TableThroughput On Demand Throughput - Sets the maximum number of read and write units for the specified on-demand table. If you use this property, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - point
In TableTime Recovery Specification Point In Time Recovery Specification - The settings used to enable point in time recovery.
- provisioned
Throughput TableProvisioned Throughput - Throughput for the specified table, which consists of values for
ReadCapacityUnits
andWriteCapacityUnits
. For more information about the contents of a provisioned throughput structure, see Amazon DynamoDB Table ProvisionedThroughput. If you setBillingMode
asPROVISIONED
, you must specify this property. If you setBillingMode
asPAY_PER_REQUEST
, you cannot specify this property. - resource
Policy TableResource Policy - A resource-based policy document that contains permissions to add to the specified table. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples. When you attach a resource-based policy while creating a table, the policy creation is strongly consistent. For information about the considerations that you should keep in mind while attaching a resource-based policy, see Resource-based policy considerations.
- sse
Specification TableSse Specification - Specifies the settings to enable server-side encryption.
- stream
Arn string The ARN of the DynamoDB stream, such as
arn:aws:dynamodb:us-east-1:123456789012:table/testddbstack-myDynamoDBTable-012A1SL7SMP5Q/stream/2015-11-30T20:10:00.000
.You must specify the
StreamSpecification
property to use this attribute.- stream
Specification TableStream Specification - The settings for the DDB table stream, which capture changes to items stored in the table.
- table
Class string - The table class of the new table. Valid values are
STANDARD
andSTANDARD_INFREQUENT_ACCESS
. - Tag[]
- An array of key-value pairs to apply to this resource. For more information, see Tag.
- time
To TableLive Specification Time To Live Specification - Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.
- warm
Throughput TableWarm Throughput
- arn str
- The Amazon Resource Name (ARN) of the DynamoDB table, such as
arn:aws:dynamodb:us-east-2:123456789012:table/myDynamoDBTable
. - attribute_
definitions Sequence[TableAttribute Definition] - A list of attributes that describe the key schema for the table and indexes. This property is required to create a DDB table. Update requires: Some interruptions. Replacement if you edit an existing AttributeDefinition.
- billing_
mode str Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:
PROVISIONED
- We recommend usingPROVISIONED
for predictable workloads.PROVISIONED
sets the billing mode to Provisioned Mode.PAY_PER_REQUEST
- We recommend usingPAY_PER_REQUEST
for unpredictable workloads.PAY_PER_REQUEST
sets the billing mode to On-Demand Mode.
If not specified, the default is
PROVISIONED
.- contributor_
insights_ Tablespecification Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified table.
- deletion_
protection_ boolenabled - Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see Using deletion protection in the Developer Guide.
- global_
secondary_ Sequence[Tableindexes Global Secondary Index] - Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes.
If you update a table to include a new global secondary index, CFNlong initiates the index creation and then proceeds with the stack update. CFNlong doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is
ACTIVE
. You can track its status by using the DynamoDB DescribeTable command. If you add or delete an index during an update, we recommend that you don't update any other resources. If your stack fails to update and is rolled back while adding a new index, you must manually delete the index. Updates are not supported. The following are exceptions:- If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
- You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.
- key_
schema Sequence[TableKey | AnySchema] - Specifies the attributes that make up the primary key for the table. The attributes in the
KeySchema
property must also be defined in theAttributeDefinitions
property. - kinesis_
stream_ Tablespecification Kinesis Stream Specification - The Kinesis Data Streams configuration for the specified table.
- local_
secondary_ Sequence[Tableindexes Local Secondary Index] - Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.
- on_
demand_ Tablethroughput On Demand Throughput - Sets the maximum number of read and write units for the specified on-demand table. If you use this property, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - point_
in_ Tabletime_ recovery_ specification Point In Time Recovery Specification - The settings used to enable point in time recovery.
- provisioned_
throughput TableProvisioned Throughput - Throughput for the specified table, which consists of values for
ReadCapacityUnits
andWriteCapacityUnits
. For more information about the contents of a provisioned throughput structure, see Amazon DynamoDB Table ProvisionedThroughput. If you setBillingMode
asPROVISIONED
, you must specify this property. If you setBillingMode
asPAY_PER_REQUEST
, you cannot specify this property. - resource_
policy TableResource Policy - A resource-based policy document that contains permissions to add to the specified table. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples. When you attach a resource-based policy while creating a table, the policy creation is strongly consistent. For information about the considerations that you should keep in mind while attaching a resource-based policy, see Resource-based policy considerations.
- sse_
specification TableSse Specification - Specifies the settings to enable server-side encryption.
- stream_
arn str The ARN of the DynamoDB stream, such as
arn:aws:dynamodb:us-east-1:123456789012:table/testddbstack-myDynamoDBTable-012A1SL7SMP5Q/stream/2015-11-30T20:10:00.000
.You must specify the
StreamSpecification
property to use this attribute.- stream_
specification TableStream Specification - The settings for the DDB table stream, which capture changes to items stored in the table.
- table_
class str - The table class of the new table. Valid values are
STANDARD
andSTANDARD_INFREQUENT_ACCESS
. - Sequence[root_Tag]
- An array of key-value pairs to apply to this resource. For more information, see Tag.
- time_
to_ Tablelive_ specification Time To Live Specification - Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.
- warm_
throughput TableWarm Throughput
- arn String
- The Amazon Resource Name (ARN) of the DynamoDB table, such as
arn:aws:dynamodb:us-east-2:123456789012:table/myDynamoDBTable
. - attribute
Definitions List<Property Map> - A list of attributes that describe the key schema for the table and indexes. This property is required to create a DDB table. Update requires: Some interruptions. Replacement if you edit an existing AttributeDefinition.
- billing
Mode String Specify how you are charged for read and write throughput and how you manage capacity. Valid values include:
PROVISIONED
- We recommend usingPROVISIONED
for predictable workloads.PROVISIONED
sets the billing mode to Provisioned Mode.PAY_PER_REQUEST
- We recommend usingPAY_PER_REQUEST
for unpredictable workloads.PAY_PER_REQUEST
sets the billing mode to On-Demand Mode.
If not specified, the default is
PROVISIONED
.- contributor
Insights Property MapSpecification - The settings used to enable or disable CloudWatch Contributor Insights for the specified table.
- deletion
Protection BooleanEnabled - Determines if a table is protected from deletion. When enabled, the table cannot be deleted by any user or process. This setting is disabled by default. For more information, see Using deletion protection in the Developer Guide.
- global
Secondary List<Property Map>Indexes - Global secondary indexes to be created on the table. You can create up to 20 global secondary indexes.
If you update a table to include a new global secondary index, CFNlong initiates the index creation and then proceeds with the stack update. CFNlong doesn't wait for the index to complete creation because the backfilling phase can take a long time, depending on the size of the table. You can't use the index or update the table until the index's status is
ACTIVE
. You can track its status by using the DynamoDB DescribeTable command. If you add or delete an index during an update, we recommend that you don't update any other resources. If your stack fails to update and is rolled back while adding a new index, you must manually delete the index. Updates are not supported. The following are exceptions:- If you update either the contributor insights specification or the provisioned throughput values of global secondary indexes, you can update the table without interruption.
- You can delete or add one global secondary index without interruption. If you do both in the same update (for example, by changing the index's logical ID), the update fails.
- key
Schema List<Property Map> | Any - Specifies the attributes that make up the primary key for the table. The attributes in the
KeySchema
property must also be defined in theAttributeDefinitions
property. - kinesis
Stream Property MapSpecification - The Kinesis Data Streams configuration for the specified table.
- local
Secondary List<Property Map>Indexes - Local secondary indexes to be created on the table. You can create up to 5 local secondary indexes. Each index is scoped to a given hash key value. The size of each hash key can be up to 10 gigabytes.
- on
Demand Property MapThroughput - Sets the maximum number of read and write units for the specified on-demand table. If you use this property, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - point
In Property MapTime Recovery Specification - The settings used to enable point in time recovery.
- provisioned
Throughput Property Map - Throughput for the specified table, which consists of values for
ReadCapacityUnits
andWriteCapacityUnits
. For more information about the contents of a provisioned throughput structure, see Amazon DynamoDB Table ProvisionedThroughput. If you setBillingMode
asPROVISIONED
, you must specify this property. If you setBillingMode
asPAY_PER_REQUEST
, you cannot specify this property. - resource
Policy Property Map - A resource-based policy document that contains permissions to add to the specified table. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples. When you attach a resource-based policy while creating a table, the policy creation is strongly consistent. For information about the considerations that you should keep in mind while attaching a resource-based policy, see Resource-based policy considerations.
- sse
Specification Property Map - Specifies the settings to enable server-side encryption.
- stream
Arn String The ARN of the DynamoDB stream, such as
arn:aws:dynamodb:us-east-1:123456789012:table/testddbstack-myDynamoDBTable-012A1SL7SMP5Q/stream/2015-11-30T20:10:00.000
.You must specify the
StreamSpecification
property to use this attribute.- stream
Specification Property Map - The settings for the DDB table stream, which capture changes to items stored in the table.
- table
Class String - The table class of the new table. Valid values are
STANDARD
andSTANDARD_INFREQUENT_ACCESS
. - List<Property Map>
- An array of key-value pairs to apply to this resource. For more information, see Tag.
- time
To Property MapLive Specification - Specifies the Time to Live (TTL) settings for the table. For detailed information about the limits in DynamoDB, see Limits in Amazon DynamoDB in the Amazon DynamoDB Developer Guide.
- warm
Throughput Property Map
Supporting Types
TableAttributeDefinition
- Attribute
Name string - A name for the attribute.
- Attribute
Type string - The data type for the attribute, where:
S
- the attribute is of type StringN
- the attribute is of type NumberB
- the attribute is of type Binary
- Attribute
Name string - A name for the attribute.
- Attribute
Type string - The data type for the attribute, where:
S
- the attribute is of type StringN
- the attribute is of type NumberB
- the attribute is of type Binary
- attribute
Name String - A name for the attribute.
- attribute
Type String - The data type for the attribute, where:
S
- the attribute is of type StringN
- the attribute is of type NumberB
- the attribute is of type Binary
- attribute
Name string - A name for the attribute.
- attribute
Type string - The data type for the attribute, where:
S
- the attribute is of type StringN
- the attribute is of type NumberB
- the attribute is of type Binary
- attribute_
name str - A name for the attribute.
- attribute_
type str - The data type for the attribute, where:
S
- the attribute is of type StringN
- the attribute is of type NumberB
- the attribute is of type Binary
- attribute
Name String - A name for the attribute.
- attribute
Type String - The data type for the attribute, where:
S
- the attribute is of type StringN
- the attribute is of type NumberB
- the attribute is of type Binary
TableContributorInsightsSpecification
- Enabled bool
- Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).
- Enabled bool
- Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).
- enabled Boolean
- Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).
- enabled boolean
- Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).
- enabled bool
- Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).
- enabled Boolean
- Indicates whether CloudWatch Contributor Insights are to be enabled (true) or disabled (false).
TableGlobalSecondaryIndex
- Index
Name string - The name of the global secondary index. The name must be unique among all other indexes on this table.
- Key
Schema List<Pulumi.Aws Native. Dynamo Db. Inputs. Table Key Schema> The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- Projection
Pulumi.
Aws Native. Dynamo Db. Inputs. Table Projection - Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- Contributor
Insights Pulumi.Specification Aws Native. Dynamo Db. Inputs. Table Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.
- On
Demand Pulumi.Throughput Aws Native. Dynamo Db. Inputs. Table On Demand Throughput - The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - Provisioned
Throughput Pulumi.Aws Native. Dynamo Db. Inputs. Table Provisioned Throughput - Represents the provisioned throughput settings for the specified global secondary index. For current minimum and maximum provisioned throughput values, see Service, Account, and Table Quotas in the Amazon DynamoDB Developer Guide.
- Warm
Throughput Pulumi.Aws Native. Dynamo Db. Inputs. Table Warm Throughput
- Index
Name string - The name of the global secondary index. The name must be unique among all other indexes on this table.
- Key
Schema []TableKey Schema The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- Projection
Table
Projection - Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- Contributor
Insights TableSpecification Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.
- On
Demand TableThroughput On Demand Throughput - The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - Provisioned
Throughput TableProvisioned Throughput - Represents the provisioned throughput settings for the specified global secondary index. For current minimum and maximum provisioned throughput values, see Service, Account, and Table Quotas in the Amazon DynamoDB Developer Guide.
- Warm
Throughput TableWarm Throughput
- index
Name String - The name of the global secondary index. The name must be unique among all other indexes on this table.
- key
Schema List<TableKey Schema> The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- projection
Table
Projection - Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- contributor
Insights TableSpecification Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.
- on
Demand TableThroughput On Demand Throughput - The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - provisioned
Throughput TableProvisioned Throughput - Represents the provisioned throughput settings for the specified global secondary index. For current minimum and maximum provisioned throughput values, see Service, Account, and Table Quotas in the Amazon DynamoDB Developer Guide.
- warm
Throughput TableWarm Throughput
- index
Name string - The name of the global secondary index. The name must be unique among all other indexes on this table.
- key
Schema TableKey Schema[] The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- projection
Table
Projection - Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- contributor
Insights TableSpecification Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.
- on
Demand TableThroughput On Demand Throughput - The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - provisioned
Throughput TableProvisioned Throughput - Represents the provisioned throughput settings for the specified global secondary index. For current minimum and maximum provisioned throughput values, see Service, Account, and Table Quotas in the Amazon DynamoDB Developer Guide.
- warm
Throughput TableWarm Throughput
- index_
name str - The name of the global secondary index. The name must be unique among all other indexes on this table.
- key_
schema Sequence[TableKey Schema] The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- projection
Table
Projection - Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- contributor_
insights_ Tablespecification Contributor Insights Specification - The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.
- on_
demand_ Tablethroughput On Demand Throughput - The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - provisioned_
throughput TableProvisioned Throughput - Represents the provisioned throughput settings for the specified global secondary index. For current minimum and maximum provisioned throughput values, see Service, Account, and Table Quotas in the Amazon DynamoDB Developer Guide.
- warm_
throughput TableWarm Throughput
- index
Name String - The name of the global secondary index. The name must be unique among all other indexes on this table.
- key
Schema List<Property Map> The complete key schema for a global secondary index, which consists of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- projection Property Map
- Represents attributes that are copied (projected) from the table into the global secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- contributor
Insights Property MapSpecification - The settings used to enable or disable CloudWatch Contributor Insights for the specified global secondary index.
- on
Demand Property MapThroughput - The maximum number of read and write units for the specified global secondary index. If you use this parameter, you must specify
MaxReadRequestUnits
,MaxWriteRequestUnits
, or both. - provisioned
Throughput Property Map - Represents the provisioned throughput settings for the specified global secondary index. For current minimum and maximum provisioned throughput values, see Service, Account, and Table Quotas in the Amazon DynamoDB Developer Guide.
- warm
Throughput Property Map
TableKeySchema
- Attribute
Name string - The name of a key attribute.
- Key
Type string The role that this key attribute will assume:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- Attribute
Name string - The name of a key attribute.
- Key
Type string The role that this key attribute will assume:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- attribute
Name String - The name of a key attribute.
- key
Type String The role that this key attribute will assume:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- attribute
Name string - The name of a key attribute.
- key
Type string The role that this key attribute will assume:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- attribute_
name str - The name of a key attribute.
- key_
type str The role that this key attribute will assume:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- attribute
Name String - The name of a key attribute.
- key
Type String The role that this key attribute will assume:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
TableKinesisStreamSpecification
- Stream
Arn string - The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
- Approximate
Creation Pulumi.Date Time Precision Aws Native. Dynamo Db. Table Kinesis Stream Specification Approximate Creation Date Time Precision - The precision for the time and date that the stream was created.
- Stream
Arn string - The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
- Approximate
Creation TableDate Time Precision Kinesis Stream Specification Approximate Creation Date Time Precision - The precision for the time and date that the stream was created.
- stream
Arn String - The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
- approximate
Creation TableDate Time Precision Kinesis Stream Specification Approximate Creation Date Time Precision - The precision for the time and date that the stream was created.
- stream
Arn string - The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
- approximate
Creation TableDate Time Precision Kinesis Stream Specification Approximate Creation Date Time Precision - The precision for the time and date that the stream was created.
- stream_
arn str - The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
- approximate_
creation_ Tabledate_ time_ precision Kinesis Stream Specification Approximate Creation Date Time Precision - The precision for the time and date that the stream was created.
- stream
Arn String - The ARN for a specific Kinesis data stream. Length Constraints: Minimum length of 37. Maximum length of 1024.
- approximate
Creation "MICROSECOND" | "MILLISECOND"Date Time Precision - The precision for the time and date that the stream was created.
TableKinesisStreamSpecificationApproximateCreationDateTimePrecision
TableLocalSecondaryIndex
- Index
Name string - The name of the local secondary index. The name must be unique among all other indexes on this table.
- Key
Schema List<Pulumi.Aws Native. Dynamo Db. Inputs. Table Key Schema> The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- Projection
Pulumi.
Aws Native. Dynamo Db. Inputs. Table Projection - Represents attributes that are copied (projected) from the table into the local secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- Index
Name string - The name of the local secondary index. The name must be unique among all other indexes on this table.
- Key
Schema []TableKey Schema The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- Projection
Table
Projection - Represents attributes that are copied (projected) from the table into the local secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- index
Name String - The name of the local secondary index. The name must be unique among all other indexes on this table.
- key
Schema List<TableKey Schema> The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- projection
Table
Projection - Represents attributes that are copied (projected) from the table into the local secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- index
Name string - The name of the local secondary index. The name must be unique among all other indexes on this table.
- key
Schema TableKey Schema[] The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- projection
Table
Projection - Represents attributes that are copied (projected) from the table into the local secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- index_
name str - The name of the local secondary index. The name must be unique among all other indexes on this table.
- key_
schema Sequence[TableKey Schema] The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- projection
Table
Projection - Represents attributes that are copied (projected) from the table into the local secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
- index
Name String - The name of the local secondary index. The name must be unique among all other indexes on this table.
- key
Schema List<Property Map> The complete key schema for the local secondary index, consisting of one or more pairs of attribute names and key types:
HASH
- partition keyRANGE
- sort key
The partition key of an item is also known as its hash attribute. The term "hash attribute" derives from DynamoDB's usage of an internal hash function to evenly distribute data items across partitions, based on their partition key values. The sort key of an item is also known as its range attribute. The term "range attribute" derives from the way DynamoDB stores items with the same partition key physically close together, in sorted order by the sort key value.
- projection Property Map
- Represents attributes that are copied (projected) from the table into the local secondary index. These are in addition to the primary key attributes and index key attributes, which are automatically projected.
TableOnDemandThroughput
- Max
Read intRequest Units - Maximum number of read request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxReadRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxReadRequestUnits
to -1. - Max
Write intRequest Units - Maximum number of write request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxWriteRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxWriteRequestUnits
to -1.
- Max
Read intRequest Units - Maximum number of read request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxReadRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxReadRequestUnits
to -1. - Max
Write intRequest Units - Maximum number of write request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxWriteRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxWriteRequestUnits
to -1.
- max
Read IntegerRequest Units - Maximum number of read request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxReadRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxReadRequestUnits
to -1. - max
Write IntegerRequest Units - Maximum number of write request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxWriteRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxWriteRequestUnits
to -1.
- max
Read numberRequest Units - Maximum number of read request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxReadRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxReadRequestUnits
to -1. - max
Write numberRequest Units - Maximum number of write request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxWriteRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxWriteRequestUnits
to -1.
- max_
read_ intrequest_ units - Maximum number of read request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxReadRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxReadRequestUnits
to -1. - max_
write_ intrequest_ units - Maximum number of write request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxWriteRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxWriteRequestUnits
to -1.
- max
Read NumberRequest Units - Maximum number of read request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxReadRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxReadRequestUnits
to -1. - max
Write NumberRequest Units - Maximum number of write request units for the specified table.
To specify a maximum
OnDemandThroughput
on your table, set the value ofMaxWriteRequestUnits
as greater than or equal to 1. To remove the maximumOnDemandThroughput
that is currently set on your table, set the value ofMaxWriteRequestUnits
to -1.
TablePointInTimeRecoverySpecification
- Point
In boolTime Recovery Enabled - Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.
- Point
In boolTime Recovery Enabled - Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.
- point
In BooleanTime Recovery Enabled - Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.
- point
In booleanTime Recovery Enabled - Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.
- point_
in_ booltime_ recovery_ enabled - Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.
- point
In BooleanTime Recovery Enabled - Indicates whether point in time recovery is enabled (true) or disabled (false) on the table.
TableProjection
- Non
Key List<string>Attributes - Represents the non-key attribute names which will be projected into the index.
For local secondary indexes, the total count of
NonKeyAttributes
summed across all of the local secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total. - Projection
Type string The set of attributes that are projected into the index:
KEYS_ONLY
- Only the index and primary keys are projected into the index.INCLUDE
- In addition to the attributes described inKEYS_ONLY
, the secondary index will include other non-key attributes that you specify.ALL
- All of the table attributes are projected into the index.
When using the DynamoDB console,
ALL
is selected by default.
- Non
Key []stringAttributes - Represents the non-key attribute names which will be projected into the index.
For local secondary indexes, the total count of
NonKeyAttributes
summed across all of the local secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total. - Projection
Type string The set of attributes that are projected into the index:
KEYS_ONLY
- Only the index and primary keys are projected into the index.INCLUDE
- In addition to the attributes described inKEYS_ONLY
, the secondary index will include other non-key attributes that you specify.ALL
- All of the table attributes are projected into the index.
When using the DynamoDB console,
ALL
is selected by default.
- non
Key List<String>Attributes - Represents the non-key attribute names which will be projected into the index.
For local secondary indexes, the total count of
NonKeyAttributes
summed across all of the local secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total. - projection
Type String The set of attributes that are projected into the index:
KEYS_ONLY
- Only the index and primary keys are projected into the index.INCLUDE
- In addition to the attributes described inKEYS_ONLY
, the secondary index will include other non-key attributes that you specify.ALL
- All of the table attributes are projected into the index.
When using the DynamoDB console,
ALL
is selected by default.
- non
Key string[]Attributes - Represents the non-key attribute names which will be projected into the index.
For local secondary indexes, the total count of
NonKeyAttributes
summed across all of the local secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total. - projection
Type string The set of attributes that are projected into the index:
KEYS_ONLY
- Only the index and primary keys are projected into the index.INCLUDE
- In addition to the attributes described inKEYS_ONLY
, the secondary index will include other non-key attributes that you specify.ALL
- All of the table attributes are projected into the index.
When using the DynamoDB console,
ALL
is selected by default.
- non_
key_ Sequence[str]attributes - Represents the non-key attribute names which will be projected into the index.
For local secondary indexes, the total count of
NonKeyAttributes
summed across all of the local secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total. - projection_
type str The set of attributes that are projected into the index:
KEYS_ONLY
- Only the index and primary keys are projected into the index.INCLUDE
- In addition to the attributes described inKEYS_ONLY
, the secondary index will include other non-key attributes that you specify.ALL
- All of the table attributes are projected into the index.
When using the DynamoDB console,
ALL
is selected by default.
- non
Key List<String>Attributes - Represents the non-key attribute names which will be projected into the index.
For local secondary indexes, the total count of
NonKeyAttributes
summed across all of the local secondary indexes, must not exceed 100. If you project the same attribute into two different indexes, this counts as two distinct attributes when determining the total. - projection
Type String The set of attributes that are projected into the index:
KEYS_ONLY
- Only the index and primary keys are projected into the index.INCLUDE
- In addition to the attributes described inKEYS_ONLY
, the secondary index will include other non-key attributes that you specify.ALL
- All of the table attributes are projected into the index.
When using the DynamoDB console,
ALL
is selected by default.
TableProvisionedThroughput
- Read
Capacity intUnits - The maximum number of strongly consistent reads consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0. - Write
Capacity intUnits - The maximum number of writes consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0.
- Read
Capacity intUnits - The maximum number of strongly consistent reads consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0. - Write
Capacity intUnits - The maximum number of writes consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0.
- read
Capacity IntegerUnits - The maximum number of strongly consistent reads consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0. - write
Capacity IntegerUnits - The maximum number of writes consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0.
- read
Capacity numberUnits - The maximum number of strongly consistent reads consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0. - write
Capacity numberUnits - The maximum number of writes consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0.
- read_
capacity_ intunits - The maximum number of strongly consistent reads consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0. - write_
capacity_ intunits - The maximum number of writes consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0.
- read
Capacity NumberUnits - The maximum number of strongly consistent reads consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0. - write
Capacity NumberUnits - The maximum number of writes consumed per second before DynamoDB returns a
ThrottlingException
. For more information, see Specifying Read and Write Requirements in the Amazon DynamoDB Developer Guide. If read/write capacity mode isPAY_PER_REQUEST
the value is set to 0.
TableResourcePolicy
- Policy
Document object - A resource-based policy document that contains permissions to add to the specified DDB table, index, or both. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- Policy
Document interface{} - A resource-based policy document that contains permissions to add to the specified DDB table, index, or both. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- policy
Document Object - A resource-based policy document that contains permissions to add to the specified DDB table, index, or both. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- policy
Document any - A resource-based policy document that contains permissions to add to the specified DDB table, index, or both. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- policy_
document Any - A resource-based policy document that contains permissions to add to the specified DDB table, index, or both. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- policy
Document Any - A resource-based policy document that contains permissions to add to the specified DDB table, index, or both. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
TableSseSpecification
- Sse
Enabled bool - Indicates whether server-side encryption is done using an AWS managed key or an AWS owned key. If enabled (true), server-side encryption type is set to
KMS
and an AWS managed key is used (KMS charges apply). If disabled (false) or not specified, server-side encryption is set to AWS owned key. - Kms
Master stringKey Id - The KMS key that should be used for the KMS encryption. To specify a key, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. Note that you should only provide this parameter if the key is different from the default DynamoDB key
alias/aws/dynamodb
. - Sse
Type string - Server-side encryption type. The only supported value is:
KMS
- Server-side encryption that uses KMSlong. The key is stored in your account and is managed by KMS (KMS charges apply).
- Sse
Enabled bool - Indicates whether server-side encryption is done using an AWS managed key or an AWS owned key. If enabled (true), server-side encryption type is set to
KMS
and an AWS managed key is used (KMS charges apply). If disabled (false) or not specified, server-side encryption is set to AWS owned key. - Kms
Master stringKey Id - The KMS key that should be used for the KMS encryption. To specify a key, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. Note that you should only provide this parameter if the key is different from the default DynamoDB key
alias/aws/dynamodb
. - Sse
Type string - Server-side encryption type. The only supported value is:
KMS
- Server-side encryption that uses KMSlong. The key is stored in your account and is managed by KMS (KMS charges apply).
- sse
Enabled Boolean - Indicates whether server-side encryption is done using an AWS managed key or an AWS owned key. If enabled (true), server-side encryption type is set to
KMS
and an AWS managed key is used (KMS charges apply). If disabled (false) or not specified, server-side encryption is set to AWS owned key. - kms
Master StringKey Id - The KMS key that should be used for the KMS encryption. To specify a key, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. Note that you should only provide this parameter if the key is different from the default DynamoDB key
alias/aws/dynamodb
. - sse
Type String - Server-side encryption type. The only supported value is:
KMS
- Server-side encryption that uses KMSlong. The key is stored in your account and is managed by KMS (KMS charges apply).
- sse
Enabled boolean - Indicates whether server-side encryption is done using an AWS managed key or an AWS owned key. If enabled (true), server-side encryption type is set to
KMS
and an AWS managed key is used (KMS charges apply). If disabled (false) or not specified, server-side encryption is set to AWS owned key. - kms
Master stringKey Id - The KMS key that should be used for the KMS encryption. To specify a key, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. Note that you should only provide this parameter if the key is different from the default DynamoDB key
alias/aws/dynamodb
. - sse
Type string - Server-side encryption type. The only supported value is:
KMS
- Server-side encryption that uses KMSlong. The key is stored in your account and is managed by KMS (KMS charges apply).
- sse_
enabled bool - Indicates whether server-side encryption is done using an AWS managed key or an AWS owned key. If enabled (true), server-side encryption type is set to
KMS
and an AWS managed key is used (KMS charges apply). If disabled (false) or not specified, server-side encryption is set to AWS owned key. - kms_
master_ strkey_ id - The KMS key that should be used for the KMS encryption. To specify a key, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. Note that you should only provide this parameter if the key is different from the default DynamoDB key
alias/aws/dynamodb
. - sse_
type str - Server-side encryption type. The only supported value is:
KMS
- Server-side encryption that uses KMSlong. The key is stored in your account and is managed by KMS (KMS charges apply).
- sse
Enabled Boolean - Indicates whether server-side encryption is done using an AWS managed key or an AWS owned key. If enabled (true), server-side encryption type is set to
KMS
and an AWS managed key is used (KMS charges apply). If disabled (false) or not specified, server-side encryption is set to AWS owned key. - kms
Master StringKey Id - The KMS key that should be used for the KMS encryption. To specify a key, use its key ID, Amazon Resource Name (ARN), alias name, or alias ARN. Note that you should only provide this parameter if the key is different from the default DynamoDB key
alias/aws/dynamodb
. - sse
Type String - Server-side encryption type. The only supported value is:
KMS
- Server-side encryption that uses KMSlong. The key is stored in your account and is managed by KMS (KMS charges apply).
TableStreamSpecification
- Stream
View stringType - When an item in the table is modified,
StreamViewType
determines what information is written to the stream for this table. Valid values forStreamViewType
are:KEYS_ONLY
- Only the key attributes of the modified item are written to the stream.NEW_IMAGE
- The entire item, as it appears after it was modified, is written to the stream.OLD_IMAGE
- The entire item, as it appeared before it was modified, is written to the stream.NEW_AND_OLD_IMAGES
- Both the new and the old item images of the item are written to the stream.
- Resource
Policy Pulumi.Aws Native. Dynamo Db. Inputs. Table Resource Policy - Creates or updates a resource-based policy document that contains the permissions for DDB resources, such as a table's streams. Resource-based policies let you define access permissions by specifying who has access to each resource, and the actions they are allowed to perform on each resource. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- Stream
View stringType - When an item in the table is modified,
StreamViewType
determines what information is written to the stream for this table. Valid values forStreamViewType
are:KEYS_ONLY
- Only the key attributes of the modified item are written to the stream.NEW_IMAGE
- The entire item, as it appears after it was modified, is written to the stream.OLD_IMAGE
- The entire item, as it appeared before it was modified, is written to the stream.NEW_AND_OLD_IMAGES
- Both the new and the old item images of the item are written to the stream.
- Resource
Policy TableResource Policy - Creates or updates a resource-based policy document that contains the permissions for DDB resources, such as a table's streams. Resource-based policies let you define access permissions by specifying who has access to each resource, and the actions they are allowed to perform on each resource. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- stream
View StringType - When an item in the table is modified,
StreamViewType
determines what information is written to the stream for this table. Valid values forStreamViewType
are:KEYS_ONLY
- Only the key attributes of the modified item are written to the stream.NEW_IMAGE
- The entire item, as it appears after it was modified, is written to the stream.OLD_IMAGE
- The entire item, as it appeared before it was modified, is written to the stream.NEW_AND_OLD_IMAGES
- Both the new and the old item images of the item are written to the stream.
- resource
Policy TableResource Policy - Creates or updates a resource-based policy document that contains the permissions for DDB resources, such as a table's streams. Resource-based policies let you define access permissions by specifying who has access to each resource, and the actions they are allowed to perform on each resource. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- stream
View stringType - When an item in the table is modified,
StreamViewType
determines what information is written to the stream for this table. Valid values forStreamViewType
are:KEYS_ONLY
- Only the key attributes of the modified item are written to the stream.NEW_IMAGE
- The entire item, as it appears after it was modified, is written to the stream.OLD_IMAGE
- The entire item, as it appeared before it was modified, is written to the stream.NEW_AND_OLD_IMAGES
- Both the new and the old item images of the item are written to the stream.
- resource
Policy TableResource Policy - Creates or updates a resource-based policy document that contains the permissions for DDB resources, such as a table's streams. Resource-based policies let you define access permissions by specifying who has access to each resource, and the actions they are allowed to perform on each resource. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- stream_
view_ strtype - When an item in the table is modified,
StreamViewType
determines what information is written to the stream for this table. Valid values forStreamViewType
are:KEYS_ONLY
- Only the key attributes of the modified item are written to the stream.NEW_IMAGE
- The entire item, as it appears after it was modified, is written to the stream.OLD_IMAGE
- The entire item, as it appeared before it was modified, is written to the stream.NEW_AND_OLD_IMAGES
- Both the new and the old item images of the item are written to the stream.
- resource_
policy TableResource Policy - Creates or updates a resource-based policy document that contains the permissions for DDB resources, such as a table's streams. Resource-based policies let you define access permissions by specifying who has access to each resource, and the actions they are allowed to perform on each resource. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
- stream
View StringType - When an item in the table is modified,
StreamViewType
determines what information is written to the stream for this table. Valid values forStreamViewType
are:KEYS_ONLY
- Only the key attributes of the modified item are written to the stream.NEW_IMAGE
- The entire item, as it appears after it was modified, is written to the stream.OLD_IMAGE
- The entire item, as it appeared before it was modified, is written to the stream.NEW_AND_OLD_IMAGES
- Both the new and the old item images of the item are written to the stream.
- resource
Policy Property Map - Creates or updates a resource-based policy document that contains the permissions for DDB resources, such as a table's streams. Resource-based policies let you define access permissions by specifying who has access to each resource, and the actions they are allowed to perform on each resource. In a CFNshort template, you can provide the policy in JSON or YAML format because CFNshort converts YAML to JSON before submitting it to DDB. For more information about resource-based policies, see Using resource-based policies for and Resource-based policy examples.
TableTimeToLiveSpecification
- Enabled bool
- Indicates whether TTL is to be enabled (true) or disabled (false) on the table.
- Attribute
Name string - The name of the TTL attribute used to store the expiration time for items in the table.
- The
AttributeName
property is required when enabling the TTL, or when TTL is already enabled. - To update this property, you must first disable TTL and then enable TTL with the new attribute name.
- The
- Enabled bool
- Indicates whether TTL is to be enabled (true) or disabled (false) on the table.
- Attribute
Name string - The name of the TTL attribute used to store the expiration time for items in the table.
- The
AttributeName
property is required when enabling the TTL, or when TTL is already enabled. - To update this property, you must first disable TTL and then enable TTL with the new attribute name.
- The
- enabled Boolean
- Indicates whether TTL is to be enabled (true) or disabled (false) on the table.
- attribute
Name String - The name of the TTL attribute used to store the expiration time for items in the table.
- The
AttributeName
property is required when enabling the TTL, or when TTL is already enabled. - To update this property, you must first disable TTL and then enable TTL with the new attribute name.
- The
- enabled boolean
- Indicates whether TTL is to be enabled (true) or disabled (false) on the table.
- attribute
Name string - The name of the TTL attribute used to store the expiration time for items in the table.
- The
AttributeName
property is required when enabling the TTL, or when TTL is already enabled. - To update this property, you must first disable TTL and then enable TTL with the new attribute name.
- The
- enabled bool
- Indicates whether TTL is to be enabled (true) or disabled (false) on the table.
- attribute_
name str - The name of the TTL attribute used to store the expiration time for items in the table.
- The
AttributeName
property is required when enabling the TTL, or when TTL is already enabled. - To update this property, you must first disable TTL and then enable TTL with the new attribute name.
- The
- enabled Boolean
- Indicates whether TTL is to be enabled (true) or disabled (false) on the table.
- attribute
Name String - The name of the TTL attribute used to store the expiration time for items in the table.
- The
AttributeName
property is required when enabling the TTL, or when TTL is already enabled. - To update this property, you must first disable TTL and then enable TTL with the new attribute name.
- The
TableWarmThroughput
- read
Units IntegerPer Second - write
Units IntegerPer Second
- read
Units numberPer Second - write
Units numberPer Second
- read
Units NumberPer Second - write
Units NumberPer Second
Tag
Package Details
- Repository
- AWS Native pulumi/pulumi-aws-native
- License
- Apache-2.0
We recommend new projects start with resources from the AWS provider.