Table
- class aws_cdk.aws_dynamodb.Table(scope, id, *, kinesis_precision_timestamp=None, kinesis_stream=None, table_name=None, billing_mode=None, contributor_insights_enabled=None, contributor_insights_specification=None, deletion_protection=None, encryption=None, encryption_key=None, import_source=None, max_read_request_units=None, max_write_request_units=None, point_in_time_recovery=None, point_in_time_recovery_specification=None, read_capacity=None, removal_policy=None, replica_removal_policy=None, replication_regions=None, replication_timeout=None, resource_policy=None, stream=None, table_class=None, time_to_live_attribute=None, wait_for_replication_to_finish=None, warm_throughput=None, write_capacity=None, partition_key, sort_key=None)
- Bases: - TableBase- Provides a DynamoDB table. - ExampleMetadata:
- infused 
 - Example: - import aws_cdk.aws_lambda_event_sources as eventsources import aws_cdk.aws_dynamodb as dynamodb from aws_cdk.aws_kms import Key # fn: lambda.Function table = dynamodb.Table(self, "Table", partition_key=dynamodb.Attribute( name="id", type=dynamodb.AttributeType.STRING ), stream=dynamodb.StreamViewType.NEW_IMAGE ) # Your self managed KMS key my_key = Key.from_key_arn(self, "SourceBucketEncryptionKey", "arn:aws:kms:us-east-1:123456789012:key/<key-id>") fn.add_event_source(eventsources.DynamoEventSource(table, starting_position=lambda_.StartingPosition.LATEST, filters=[lambda_.FilterCriteria.filter({"event_name": lambda_.FilterRule.is_equal("INSERT")})], filter_encryption=my_key )) - Parameters:
- scope ( - Construct)
- id ( - str)
- kinesis_precision_timestamp ( - Optional[- ApproximateCreationDateTimePrecision]) – Kinesis Data Stream approximate creation timestamp precision. Default: ApproximateCreationDateTimePrecision.MICROSECOND
- kinesis_stream ( - Optional[- IStream]) – Kinesis Data Stream to capture item-level changes for the table. Default: - no Kinesis Data Stream
- table_name ( - Optional[- str]) – Enforces a particular physical table name. Default:
- billing_mode ( - Optional[- BillingMode]) – Specify how you are charged for read and write throughput and how you manage capacity. Default: PROVISIONED if- replicationRegionsis not specified, PAY_PER_REQUEST otherwise
- contributor_insights_enabled ( - Optional[- bool]) – (deprecated) Whether CloudWatch contributor insights is enabled. Default: false
- contributor_insights_specification ( - Union[- ContributorInsightsSpecification,- Dict[- str,- Any],- None]) – Whether CloudWatch contributor insights is enabled and what mode is selected. Default: - contributor insights is not enabled
- deletion_protection ( - Optional[- bool]) – Enables deletion protection for the table. Default: false
- encryption ( - Optional[- TableEncryption]) – Whether server-side encryption with an AWS managed customer master key is enabled. This property cannot be set if- serverSideEncryptionis set. .. epigraph:: NOTE: if you set this to- CUSTOMER_MANAGEDand- encryptionKeyis not specified, the key that the Tablet generates for you will be created with default permissions. If you are using CDKv2, these permissions will be sufficient to enable the key for use with DynamoDB tables. If you are using CDKv1, make sure the feature flag- @aws-cdk/aws-kms:defaultKeyPoliciesis set to- truein your- cdk.json. Default: - The table is encrypted with an encryption key managed by DynamoDB, and you are not charged any fee for using it.
- encryption_key ( - Optional[- IKey]) – External KMS key to use for table encryption. This property can only be set if- encryptionis set to- TableEncryption.CUSTOMER_MANAGED. Default: - If- encryptionis set to- TableEncryption.CUSTOMER_MANAGEDand this property is undefined, a new KMS key will be created and associated with this table. If- encryptionand this property are both undefined, then the table is encrypted with an encryption key managed by DynamoDB, and you are not charged any fee for using it.
- import_source ( - Union[- ImportSourceSpecification,- Dict[- str,- Any],- None]) – The properties of data being imported from the S3 bucket source to the table. Default: - no data import from the S3 bucket
- max_read_request_units ( - Union[- int,- float,- None]) – The maximum read request units for the table. Careful if you add Global Secondary Indexes, as those will share the table’s maximum on-demand throughput. Can only be provided if billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
- max_write_request_units ( - Union[- int,- float,- None]) – The write request units for the table. Careful if you add Global Secondary Indexes, as those will share the table’s maximum on-demand throughput. Can only be provided if billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
- point_in_time_recovery ( - Optional[- bool]) – (deprecated) Whether point-in-time recovery is enabled. Default: false - point in time recovery is not enabled.
- point_in_time_recovery_specification ( - Union[- PointInTimeRecoverySpecification,- Dict[- str,- Any],- None]) – Whether point-in-time recovery is enabled and recoveryPeriodInDays is set. Default: - point in time recovery is not enabled.
- read_capacity ( - Union[- int,- float,- None]) – The read capacity for the table. Careful if you add Global Secondary Indexes, as those will share the table’s provisioned throughput. Can only be provided if billingMode is Provisioned. Default: 5
- removal_policy ( - Optional[- RemovalPolicy]) – The removal policy to apply to the DynamoDB Table. Default: RemovalPolicy.RETAIN
- replica_removal_policy ( - Optional[- RemovalPolicy]) – The removal policy to apply to the DynamoDB replica tables. Default: undefined - use DynamoDB Table’s removal policy
- replication_regions ( - Optional[- Sequence[- str]]) – Regions where replica tables will be created. Default: - no replica tables are created
- replication_timeout ( - Optional[- Duration]) – The timeout for a table replication operation in a single region. Default: Duration.minutes(30)
- resource_policy ( - Optional[- PolicyDocument]) – Resource policy to assign to table. Default: - No resource policy statement
- stream ( - Optional[- StreamViewType]) – When an item in the table is modified, StreamViewType determines what information is written to the stream for this table. Default: - streams are disabled unless- replicationRegionsis specified
- table_class ( - Optional[- TableClass]) – Specify the table class. Default: STANDARD
- time_to_live_attribute ( - Optional[- str]) – The name of TTL attribute. Default: - TTL is disabled
- wait_for_replication_to_finish ( - Optional[- bool]) – [WARNING: Use this flag with caution, misusing this flag may cause deleting existing replicas, refer to the detailed documentation for more information] Indicates whether CloudFormation stack waits for replication to finish. If set to false, the CloudFormation resource will mark the resource as created and replication will be completed asynchronously. This property is ignored if replicationRegions property is not set. WARNING: DO NOT UNSET this property if adding/removing multiple replicationRegions in one deployment, as CloudFormation only supports one region replication at a time. CDK overcomes this limitation by waiting for replication to finish before starting new replicationRegion. If the custom resource which handles replication has a physical resource ID with the format- regioninstead of- tablename-region(this would happen if the custom resource hasn’t received an event since v1.91.0), DO NOT SET this property to false without making a change to the table name. This will cause the existing replicas to be deleted. Default: true
- warm_throughput ( - Union[- WarmThroughput,- Dict[- str,- Any],- None]) – Specify values to pre-warm you DynamoDB Table Warm Throughput feature is not available for Global Table replicas using the- Tableconstruct. To enable Warm Throughput, use the- TableV2construct instead. Default: - warm throughput is not configured
- write_capacity ( - Union[- int,- float,- None]) – The write capacity for the table. Careful if you add Global Secondary Indexes, as those will share the table’s provisioned throughput. Can only be provided if billingMode is Provisioned. Default: 5
- partition_key ( - Union[- Attribute,- Dict[- str,- Any]]) – Partition key attribute definition.
- sort_key ( - Union[- Attribute,- Dict[- str,- Any],- None]) – Sort key attribute definition. Default: no sort key
 
 - Methods - add_global_secondary_index(*, contributor_insights_enabled=None, contributor_insights_specification=None, max_read_request_units=None, max_write_request_units=None, read_capacity=None, warm_throughput=None, write_capacity=None, index_name, non_key_attributes=None, projection_type=None, partition_key, sort_key=None)
- Add a global secondary index of table. - Parameters:
- contributor_insights_enabled ( - Optional[- bool]) – (deprecated) Whether CloudWatch contributor insights is enabled for the specified global secondary index. Default: false
- contributor_insights_specification ( - Union[- ContributorInsightsSpecification,- Dict[- str,- Any],- None]) – Whether CloudWatch contributor insights is enabled and what mode is selected. Default: - contributor insights is not enabled
- max_read_request_units ( - Union[- int,- float,- None]) – The maximum read request units for the global secondary index. Can only be provided if table billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
- max_write_request_units ( - Union[- int,- float,- None]) – The maximum write request units for the global secondary index. Can only be provided if table billingMode is PAY_PER_REQUEST. Default: - on-demand throughput is disabled
- read_capacity ( - Union[- int,- float,- None]) – The read capacity for the global secondary index. Can only be provided if table billingMode is Provisioned or undefined. Default: 5
- warm_throughput ( - Union[- WarmThroughput,- Dict[- str,- Any],- None]) – The warm throughput configuration for the global secondary index. Default: - no warm throughput is configured
- write_capacity ( - Union[- int,- float,- None]) – The write capacity for the global secondary index. Can only be provided if table billingMode is Provisioned or undefined. Default: 5
- index_name ( - str) – The name of the secondary index.
- non_key_attributes ( - Optional[- Sequence[- str]]) – The non-key attributes that are projected into the secondary index. Default: - No additional attributes
- projection_type ( - Optional[- ProjectionType]) – The set of attributes that are projected into the secondary index. Default: ALL
- partition_key ( - Union[- Attribute,- Dict[- str,- Any]]) – Partition key attribute definition.
- sort_key ( - Union[- Attribute,- Dict[- str,- Any],- None]) – Sort key attribute definition. Default: no sort key
 
- Return type:
- None
 
 - add_local_secondary_index(*, sort_key, index_name, non_key_attributes=None, projection_type=None)
- Add a local secondary index of table. - Parameters:
- sort_key ( - Union[- Attribute,- Dict[- str,- Any]]) – The attribute of a sort key for the local secondary index.
- index_name ( - str) – The name of the secondary index.
- non_key_attributes ( - Optional[- Sequence[- str]]) – The non-key attributes that are projected into the secondary index. Default: - No additional attributes
- projection_type ( - Optional[- ProjectionType]) – The set of attributes that are projected into the secondary index. Default: ALL
 
- Return type:
- None
 
 - add_to_resource_policy(statement)
- Adds a statement to the resource policy associated with this file system. - A resource policy will be automatically created upon the first call to - addToResourcePolicy.- Note that this does not work with imported file systems. - Parameters:
- statement ( - PolicyStatement) – The policy statement to add.
- Return type:
 
 - apply_removal_policy(policy)
- Apply the given removal policy to this resource. - The Removal Policy controls what happens to this resource when it stops being managed by CloudFormation, either because you’ve removed it from the CDK application or because you’ve made a change that requires the resource to be replaced. - The resource can be deleted ( - RemovalPolicy.DESTROY), or left in your AWS account for data recovery and cleanup later (- RemovalPolicy.RETAIN).- Parameters:
- policy ( - RemovalPolicy)
- Return type:
- None
 
 - auto_scale_global_secondary_index_read_capacity(index_name, *, max_capacity, min_capacity)
- Enable read capacity scaling for the given GSI. - Parameters:
- index_name ( - str)
- max_capacity ( - Union[- int,- float]) – Maximum capacity to scale to.
- min_capacity ( - Union[- int,- float]) – Minimum capacity to scale to.
 
- Return type:
- Returns:
- An object to configure additional AutoScaling settings for this attribute 
 
 - auto_scale_global_secondary_index_write_capacity(index_name, *, max_capacity, min_capacity)
- Enable write capacity scaling for the given GSI. - Parameters:
- index_name ( - str)
- max_capacity ( - Union[- int,- float]) – Maximum capacity to scale to.
- min_capacity ( - Union[- int,- float]) – Minimum capacity to scale to.
 
- Return type:
- Returns:
- An object to configure additional AutoScaling settings for this attribute 
 
 - auto_scale_read_capacity(*, max_capacity, min_capacity)
- Enable read capacity scaling for this table. - Parameters:
- max_capacity ( - Union[- int,- float]) – Maximum capacity to scale to.
- min_capacity ( - Union[- int,- float]) – Minimum capacity to scale to.
 
- Return type:
- Returns:
- An object to configure additional AutoScaling settings 
 
 - auto_scale_write_capacity(*, max_capacity, min_capacity)
- Enable write capacity scaling for this table. - Parameters:
- max_capacity ( - Union[- int,- float]) – Maximum capacity to scale to.
- min_capacity ( - Union[- int,- float]) – Minimum capacity to scale to.
 
- Return type:
- Returns:
- An object to configure additional AutoScaling settings for this attribute 
 
 - grant(grantee, *actions)
- Adds an IAM policy statement associated with this table to an IAM principal’s policy. - If - encryptionKeyis present, appropriate grants to the key needs to be added separately using the- table.encryptionKey.grant*methods.- Parameters:
- grantee ( - IGrantable) – The principal (no-op if undefined).
- actions ( - str) – The set of actions to allow (i.e. “dynamodb:PutItem”, “dynamodb:GetItem”, …).
 
- Return type:
 
 - grant_full_access(grantee)
- Permits all DynamoDB operations (“dynamodb:*”) to an IAM principal. - Appropriate grants will also be added to the customer-managed KMS key if one was configured. - Parameters:
- grantee ( - IGrantable) – The principal to grant access to.
- Return type:
 
 - grant_read_data(grantee)
- Permits an IAM principal all data read operations from this table: BatchGetItem, GetRecords, GetShardIterator, Query, GetItem, Scan, DescribeTable. - Appropriate grants will also be added to the customer-managed KMS key if one was configured. - Parameters:
- grantee ( - IGrantable) – The principal to grant access to.
- Return type:
 
 - grant_read_write_data(grantee)
- Permits an IAM principal to all data read/write operations to this table. - BatchGetItem, GetRecords, GetShardIterator, Query, GetItem, Scan, BatchWriteItem, PutItem, UpdateItem, DeleteItem, DescribeTable - Appropriate grants will also be added to the customer-managed KMS key if one was configured. - Parameters:
- grantee ( - IGrantable) – The principal to grant access to.
- Return type:
 
 - grant_stream(grantee, *actions)
- Adds an IAM policy statement associated with this table’s stream to an IAM principal’s policy. - If - encryptionKeyis present, appropriate grants to the key needs to be added separately using the- table.encryptionKey.grant*methods.- Parameters:
- grantee ( - IGrantable) – The principal (no-op if undefined).
- actions ( - str) – The set of actions to allow (i.e. “dynamodb:DescribeStream”, “dynamodb:GetRecords”, …).
 
- Return type:
 
 - grant_stream_read(grantee)
- Permits an IAM principal all stream data read operations for this table’s stream: DescribeStream, GetRecords, GetShardIterator, ListStreams. - Appropriate grants will also be added to the customer-managed KMS key if one was configured. - Parameters:
- grantee ( - IGrantable) – The principal to grant access to.
- Return type:
 
 - grant_table_list_streams(grantee)
- Permits an IAM Principal to list streams attached to current dynamodb table. - Parameters:
- grantee ( - IGrantable) – The principal (no-op if undefined).
- Return type:
 
 - grant_write_data(grantee)
- Permits an IAM principal all data write operations to this table: BatchWriteItem, PutItem, UpdateItem, DeleteItem, DescribeTable. - Appropriate grants will also be added to the customer-managed KMS key if one was configured. - Parameters:
- grantee ( - IGrantable) – The principal to grant access to.
- Return type:
 
 - metric(metric_name, *, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- Return the given named metric for this Table. - By default, the metric will be calculated as a sum over a period of 5 minutes. You can customize this by using the - statisticand- periodproperties.- Parameters:
- metric_name ( - str)
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) – Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - metric_conditional_check_failed_requests(*, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- Metric for the conditional check failed requests this table. - By default, the metric will be calculated as a sum over a period of 5 minutes. You can customize this by using the - statisticand- periodproperties.- Parameters:
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - metric_consumed_read_capacity_units(*, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- Metric for the consumed read capacity units this table. - By default, the metric will be calculated as a sum over a period of 5 minutes. You can customize this by using the - statisticand- periodproperties.- Parameters:
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - metric_consumed_write_capacity_units(*, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- Metric for the consumed write capacity units this table. - By default, the metric will be calculated as a sum over a period of 5 minutes. You can customize this by using the - statisticand- periodproperties.- Parameters:
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - metric_successful_request_latency(*, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- Metric for the successful request latency this table. - By default, the metric will be calculated as an average over a period of 5 minutes. You can customize this by using the - statisticand- periodproperties.- Parameters:
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - metric_system_errors(*, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- (deprecated) Metric for the system errors this table. - Parameters:
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Deprecated:
- use - metricSystemErrorsForOperations.
- Stability:
- deprecated 
- Return type:
 
 - metric_system_errors_for_operations(*, operations=None, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- Metric for the system errors this table. - This will sum errors across all possible operations. Note that by default, each individual metric will be calculated as a sum over a period of 5 minutes. You can customize this by using the - statisticand- periodproperties.- Parameters:
- operations ( - Optional[- Sequence[- Operation]]) – The operations to apply the metric to. Default: - All operations available by DynamoDB tables will be considered.
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - metric_throttled_requests(*, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- (deprecated) How many requests are throttled on this table. - Default: sum over 5 minutes - Parameters:
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Deprecated:
- Do not use this function. It returns an invalid metric. Use - metricThrottledRequestsForOperationinstead.
- Stability:
- deprecated 
- Return type:
 
 - metric_throttled_requests_for_operation(operation, *, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- How many requests are throttled on this table, for the given operation. - Default: sum over 5 minutes - Parameters:
- operation ( - str)
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - metric_throttled_requests_for_operations(*, operations=None, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- How many requests are throttled on this table. - This will sum errors across all possible operations. Note that by default, each individual metric will be calculated as a sum over a period of 5 minutes. You can customize this by using the - statisticand- periodproperties.- Parameters:
- operations ( - Optional[- Sequence[- Operation]]) – The operations to apply the metric to. Default: - All operations available by DynamoDB tables will be considered.
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - metric_user_errors(*, account=None, color=None, dimensions_map=None, id=None, label=None, period=None, region=None, stack_account=None, stack_region=None, statistic=None, unit=None, visible=None)
- Metric for the user errors. - Note that this metric reports user errors across all the tables in the account and region the table resides in. - By default, the metric will be calculated as a sum over a period of 5 minutes. You can customize this by using the - statisticand- periodproperties.- Parameters:
- account ( - Optional[- str]) – Account which this metric comes from. Default: - Deployment account.
- color ( - Optional[- str]) – The hex color code, prefixed with ‘#’ (e.g. ‘#00ff00’), to use when this metric is rendered on a graph. The- Colorclass has a set of standard colors that can be used here. Default: - Automatic color
- dimensions_map ( - Optional[- Mapping[- str,- str]]) – Dimensions of the metric. Default: - No dimensions.
- id ( - Optional[- str]) – Unique identifier for this metric when used in dashboard widgets. The id can be used as a variable to represent this metric in math expressions. Valid characters are letters, numbers, and underscore. The first character must be a lowercase letter. Default: - No ID
- label ( - Optional[- str]) –- Label for this metric when added to a Graph in a Dashboard. You can use dynamic labels to show summary information about the entire displayed time series in the legend. For example, if you use:: [max: ${MAX}] MyMetric As the metric label, the maximum value in the visible range will be shown next to the time series name in the graph’s legend. Default: - No label 
- period ( - Optional[- Duration]) – The period over which the specified statistic is applied. Default: Duration.minutes(5)
- region ( - Optional[- str]) – Region which this metric comes from. Default: - Deployment region.
- stack_account ( - Optional[- str]) – Account of the stack this metric is attached to. Default: - Deployment account.
- stack_region ( - Optional[- str]) – Region of the stack this metric is attached to. Default: - Deployment region.
- statistic ( - Optional[- str]) – What function to use for aggregating. Use the- aws_cloudwatch.Statshelper class to construct valid input strings. Can be one of the following: - “Minimum” | “min” - “Maximum” | “max” - “Average” | “avg” - “Sum” | “sum” - “SampleCount | “n” - “pNN.NN” - “tmNN.NN” | “tm(NN.NN%:NN.NN%)” - “iqm” - “wmNN.NN” | “wm(NN.NN%:NN.NN%)” - “tcNN.NN” | “tc(NN.NN%:NN.NN%)” - “tsNN.NN” | “ts(NN.NN%:NN.NN%)” Default: Average
- unit ( - Optional[- Unit]) – Unit used to filter the metric stream. Only refer to datums emitted to the metric stream with the given unit and ignore all others. Only useful when datums are being emitted to the same metric stream under different units. The default is to use all matric datums in the stream, regardless of unit, which is recommended in nearly all cases. CloudWatch does not honor this property for graphs. Default: - All metric datums in the given metric stream
- visible ( - Optional[- bool]) – Whether this metric should be visible in dashboard graphs. Setting this to false is useful when you want to hide raw metrics that are used in math expressions, and show only the expression results. Default: true
 
- Return type:
 
 - schema(index_name=None)
- Get schema attributes of table or index. - Parameters:
- index_name ( - Optional[- str])
- Return type:
- Returns:
- Schema of table or index. 
 
 - to_string()
- Returns a string representation of this construct. - Return type:
- str
 
 - Attributes - PROPERTY_INJECTION_ID = 'aws-cdk-lib.aws-dynamodb.Table'
 - encryption_key
- KMS encryption key, if this table uses a customer-managed encryption key. 
 - env
- The environment this resource belongs to. - For resources that are created and managed by the CDK (generally, those created by creating new class instances like Role, Bucket, etc.), this is always the same as the environment of the stack they belong to; however, for imported resources (those obtained from static methods like fromRoleArn, fromBucketName, etc.), that might be different than the stack they were imported into. 
 - node
- The tree node. 
 - resource_policy
- Resource policy to assign to DynamoDB Table. - Default:
- No resource policy statements are added to the created table. 
 
- See:
 
 - stack
- The stack in which this resource is defined. 
 - table_arn
- Arn of the dynamodb table. - Attribute:
- true 
 
 - table_name
- Table name of the dynamodb table. - Attribute:
- true 
 
 - table_stream_arn
- ARN of the table’s stream, if there is one. - Attribute:
- true 
 
 - Static Methods - classmethod from_table_arn(scope, id, table_arn)
- Creates a Table construct that represents an external table via table arn. 
 - classmethod from_table_attributes(scope, id, *, encryption_key=None, global_indexes=None, grant_index_permissions=None, local_indexes=None, table_arn=None, table_name=None, table_stream_arn=None)
- Creates a Table construct that represents an external table. - Parameters:
- scope ( - Construct) – The parent creating construct (usually- this).
- id ( - str) – The construct’s name.
- encryption_key ( - Optional[- IKey]) – KMS encryption key, if this table uses a customer-managed encryption key. Default: - no key
- global_indexes ( - Optional[- Sequence[- str]]) – The name of the global indexes set for this Table. Note that you need to set either this property, or- localIndexes, if you want methods like grantReadData() to grant permissions for indexes as well as the table itself. Default: - no global indexes
- grant_index_permissions ( - Optional[- bool]) – If set to true, grant methods always grant permissions for all indexes. If false is provided, grant methods grant the permissions only when- globalIndexesor- localIndexesis specified. Default: - false
- local_indexes ( - Optional[- Sequence[- str]]) – The name of the local indexes set for this Table. Note that you need to set either this property, or- globalIndexes, if you want methods like grantReadData() to grant permissions for indexes as well as the table itself. Default: - no local indexes
- table_arn ( - Optional[- str]) – The ARN of the dynamodb table. One of this, or- tableName, is required. Default: - no table arn
- table_name ( - Optional[- str]) – The table name of the dynamodb table. One of this, or- tableArn, is required. Default: - no table name
- table_stream_arn ( - Optional[- str]) – The ARN of the table’s stream. Default: - no table stream
 
- Return type:
 
 - classmethod from_table_name(scope, id, table_name)
- Creates a Table construct that represents an external table via table name. 
 - classmethod is_construct(x)
- Checks if - xis a construct.- Use this method instead of - instanceofto properly detect- Constructinstances, even when the construct library is symlinked.- Explanation: in JavaScript, multiple copies of the - constructslibrary on disk are seen as independent, completely different libraries. As a consequence, the class- Constructin each copy of the- constructslibrary is seen as a different class, and an instance of one class will not test as- instanceofthe other class.- npm installwill not create installations like this, but users may manually symlink construct libraries together or use a monorepo tool: in those cases, multiple copies of the- constructslibrary can be accidentally installed, and- instanceofwill behave unpredictably. It is safest to avoid using- instanceof, and using this type-testing method instead.- Parameters:
- x ( - Any) – Any object.
- Return type:
- bool
- Returns:
- true if - xis an object created from a class which extends- Construct.
 
 - classmethod is_owned_resource(construct)
- Returns true if the construct was created by CDK, and false otherwise. - Parameters:
- construct ( - IConstruct)
- Return type:
- bool
 
 - classmethod is_resource(construct)
- Check whether the given construct is a Resource. - Parameters:
- construct ( - IConstruct)
- Return type:
- bool