CfnTableBucketPropsMixin
- class aws_cdk.mixins_preview.aws_s3tables.mixins.CfnTableBucketPropsMixin(props, *, strategy=None)
Bases:
MixinCreates a table bucket.
For more information, see Creating a table bucket in the Amazon Simple Storage Service User Guide .
Permissions - - You must have the
s3tables:CreateTableBucketpermission to use this operation.If you use this operation with the optional
encryptionConfigurationparameter you must have thes3tables:PutTableBucketEncryptionpermission.Cloud Development Kit - To use S3 Tables AWS CDK constructs, add the
@aws-cdk/aws-s3tables-alphadependency with one of the following options:NPM: `npm i
- See:
http://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-s3tables-tablebucket.html
- Aws-cdk:
/aws-s3tables-alpha`
Yarn:
yarn add @aws-cdk/aws-s3tables-alpha
- CloudformationResource:
AWS::S3Tables::TableBucket
- Mixin:
true
- ExampleMetadata:
fixture=_generated
Example:
from aws_cdk import CfnTag # The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview import mixins from aws_cdk.mixins_preview.aws_s3tables import mixins as s3tables_mixins cfn_table_bucket_props_mixin = s3tables_mixins.CfnTableBucketPropsMixin(s3tables_mixins.CfnTableBucketMixinProps( encryption_configuration=s3tables_mixins.CfnTableBucketPropsMixin.EncryptionConfigurationProperty( kms_key_arn="kmsKeyArn", sse_algorithm="sseAlgorithm" ), metrics_configuration=s3tables_mixins.CfnTableBucketPropsMixin.MetricsConfigurationProperty( status="status" ), storage_class_configuration=s3tables_mixins.CfnTableBucketPropsMixin.StorageClassConfigurationProperty( storage_class="storageClass" ), table_bucket_name="tableBucketName", tags=[CfnTag( key="key", value="value" )], unreferenced_file_removal=s3tables_mixins.CfnTableBucketPropsMixin.UnreferencedFileRemovalProperty( noncurrent_days=123, status="status", unreferenced_days=123 ) ), strategy=mixins.PropertyMergeStrategy.OVERRIDE )
Create a mixin to apply properties to
AWS::S3Tables::TableBucket.- Parameters:
props (
Union[CfnTableBucketMixinProps,Dict[str,Any]]) – L1 properties to apply.strategy (
Optional[PropertyMergeStrategy]) – (experimental) Strategy for merging nested properties. Default: - PropertyMergeStrategy.MERGE
Methods
- apply_to(construct)
Apply the mixin properties to the construct.
- Parameters:
construct (
IConstruct)- Return type:
- supports(construct)
Check if this mixin supports the given construct.
- Parameters:
construct (
IConstruct)- Return type:
bool
Attributes
- CFN_PROPERTY_KEYS = ['encryptionConfiguration', 'metricsConfiguration', 'storageClassConfiguration', 'tableBucketName', 'tags', 'unreferencedFileRemoval']
Static Methods
- classmethod is_mixin(x)
(experimental) Checks if
xis a Mixin.- Parameters:
x (
Any) – Any object.- Return type:
bool- Returns:
true if
xis an object created from a class which extendsMixin.- Stability:
experimental
EncryptionConfigurationProperty
- class CfnTableBucketPropsMixin.EncryptionConfigurationProperty(*, kms_key_arn=None, sse_algorithm=None)
Bases:
objectConfiguration specifying how data should be encrypted.
This structure defines the encryption algorithm and optional KMS key to be used for server-side encryption.
- Parameters:
kms_key_arn (
Optional[str]) – The Amazon Resource Name (ARN) of the KMS key to use for encryption. This field is required only whensseAlgorithmis set toaws:kms.sse_algorithm (
Optional[str]) – The server-side encryption algorithm to use. Valid values areAES256for S3-managed encryption keys, oraws:kmsfor AWS KMS-managed encryption keys. If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption .
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_s3tables import mixins as s3tables_mixins encryption_configuration_property = s3tables_mixins.CfnTableBucketPropsMixin.EncryptionConfigurationProperty( kms_key_arn="kmsKeyArn", sse_algorithm="sseAlgorithm" )
Attributes
- kms_key_arn
The Amazon Resource Name (ARN) of the KMS key to use for encryption.
This field is required only when
sseAlgorithmis set toaws:kms.
- sse_algorithm
The server-side encryption algorithm to use.
Valid values are
AES256for S3-managed encryption keys, oraws:kmsfor AWS KMS-managed encryption keys. If you choose SSE-KMS encryption you must grant the S3 Tables maintenance principal access to your KMS key. For more information, see Permissions requirements for S3 Tables SSE-KMS encryption .
MetricsConfigurationProperty
- class CfnTableBucketPropsMixin.MetricsConfigurationProperty(*, status=None)
Bases:
objectSettings governing the Metric configuration for the table bucket.
- Parameters:
status (
Optional[str]) – Indicates whether Metrics are enabled. Default: - “Disabled”- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_s3tables import mixins as s3tables_mixins metrics_configuration_property = s3tables_mixins.CfnTableBucketPropsMixin.MetricsConfigurationProperty( status="status" )
Attributes
- status
Indicates whether Metrics are enabled.
StorageClassConfigurationProperty
- class CfnTableBucketPropsMixin.StorageClassConfigurationProperty(*, storage_class=None)
Bases:
objectThe configuration details for the storage class of tables or table buckets.
This allows you to optimize storage costs by selecting the appropriate storage class based on your access patterns and performance requirements.
- Parameters:
storage_class (
Optional[str]) – The storage class for the table or table bucket. Valid values include storage classes optimized for different access patterns and cost profiles.- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_s3tables import mixins as s3tables_mixins storage_class_configuration_property = s3tables_mixins.CfnTableBucketPropsMixin.StorageClassConfigurationProperty( storage_class="storageClass" )
Attributes
- storage_class
The storage class for the table or table bucket.
Valid values include storage classes optimized for different access patterns and cost profiles.
UnreferencedFileRemovalProperty
- class CfnTableBucketPropsMixin.UnreferencedFileRemovalProperty(*, noncurrent_days=None, status=None, unreferenced_days=None)
Bases:
objectThe unreferenced file removal settings for your table bucket.
Unreferenced file removal identifies and deletes all objects that are not referenced by any table snapshots. For more information, see the *Amazon S3 User Guide* .
- Parameters:
noncurrent_days (
Union[int,float,None]) – The number of days an object can be noncurrent before Amazon S3 deletes it.status (
Optional[str]) – The status of the unreferenced file removal configuration for your table bucket.unreferenced_days (
Union[int,float,None]) – The number of days an object must be unreferenced by your table before Amazon S3 marks the object as noncurrent.
- See:
- ExampleMetadata:
fixture=_generated
Example:
# The code below shows an example of how to instantiate this type. # The values are placeholders you should change. from aws_cdk.mixins_preview.aws_s3tables import mixins as s3tables_mixins unreferenced_file_removal_property = s3tables_mixins.CfnTableBucketPropsMixin.UnreferencedFileRemovalProperty( noncurrent_days=123, status="status", unreferenced_days=123 )
Attributes
- noncurrent_days
The number of days an object can be noncurrent before Amazon S3 deletes it.
- status
The status of the unreferenced file removal configuration for your table bucket.
- unreferenced_days
The number of days an object must be unreferenced by your table before Amazon S3 marks the object as noncurrent.