Factories to allow creation of individual resources
Project description
aws-constructs-factories module
---All classes are under active development and subject to non-backward compatible changes or removal in any future version. These are not subject to the Semantic Versioning model. This means that while you may use them, you may need to update your source code when upgrading to a newer version of this package.
Reference Documentation: | https://docs.aws.amazon.com/solutions/latest/constructs/ |
---|
Language | Package |
---|---|
Python | aws_solutions_constructs.aws_constructs_factories |
Typescript | @aws-solutions-constructs/aws-constructs-factories |
Java | software.amazon.awsconstructs.services.constructsfactories |
Overview
This AWS Solutions Construct exposes the same code used to create our underlying resources as factories, so clients can create individual resources that are well-architected.
S3 Buckets
Create fully well-architected S3 buckets with as little as one function call. Here is a minimal deployable pattern definition:
Typescript
import { Construct } from 'constructs';
import { Stack, StackProps } from 'aws-cdk-lib';
import { ConstructsFactories } from '@aws-solutions-constructs/aws-constructs-factories';
const factories = new ConstructsFactories(this, 'MyFactories');
factories.s3BucketFactory('GoodBucket', {});
Python
from aws_cdk import (
Stack,
)
from constructs import Construct
from aws_solutions_constructs import (
aws_constructs_factories as cf
)
factories = cf.ConstructsFactories(self, 'MyFactories')
factories.s3_bucket_factory('GoodBucket')
Java
import software.constructs.Construct;
import software.amazon.awscdk.Stack;
import software.amazon.awscdk.StackProps;
import software.amazon.awsconstructs.services.constructsfactories.ConstructsFactories;
import software.amazon.awsconstructs.services.constructsfactories.S3BucketFactoryProps;
final ConstructsFactories factories = new ConstructsFactories(this, "MyFactories");
factories.s3BucketFactory("GoodBucket",
new S3BucketFactoryProps.Builder().build());
S3BucketFactory Function Signature
s3BucketFactory(id: string, props: S3BucketFactoryProps): S3BucketFactoryResponse
S3BucketFactoryProps
Name | Type | Description |
---|---|---|
bucketProps? | s3.BucketProps |
Optional user provided props to override the default props for the S3 Bucket. |
logS3AccessLogs? | boolean |
Whether to turn on Access Logging for the S3 bucket. Creates an S3 bucket with associated storage costs for the logs. Enabling Access Logging is a best practice. default - true |
loggingBucketProps? | s3.BucketProps |
Optional user provided props to override the default props for the S3 Logging Bucket. |
S3BucketFactoryResponse
Name | Type | Description |
---|---|---|
s3Bucket | s3.Bucket |
The s3.Bucket created by the factory. |
s3LoggingBucket? | s3.Bucket |
The s3.Bucket created by the construct as the logging bucket for the primary bucket. If the logS3AccessLogs property is false, this value will be undefined. |
Default settings
Out of the box implementation of the Construct without any override will set the following defaults:
-
An S3 Content Bucket
- AWS managed Server Side Encryption (AES256)
- Lifecycle rule to transition objects to Glacier storage class in 90 days
- Access Logging enabled
- All Public access blocked
- Versioning enabled
- UpdateReplacePolicy is delete
- Deletion policy is delete
- Bucket policy requiring SecureTransport
-
An S3 Bucket for Access Logs
- AWS managed Server Side Encryption (AES256)
- All public access blocked
- Versioning enabled
- UpdateReplacePolicy is delete
- Deletion policy is delete
- Bucket policy requiring SecureTransport
- Bucket policy granting PutObject privileges to the S3 logging service, from the content bucket in the content bucket account.
- cfn_nag suppression of access logging finding (not logging access to the access log bucket)
Architecture
© Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for aws-solutions-constructs.aws-constructs-factories-2.57.0.tar.gz
Algorithm | Hash digest | |
---|---|---|
SHA256 | be88c6afc22dd0a46311ba6e869a11176e21ab78c4ec817847f837105bddf7b4 |
|
MD5 | 6465924628ce7ef80140e88ee7b66b9c |
|
BLAKE2b-256 | a497a5a6596c66aa87f3565231185c3714679b0c3ddb0b784123465947bc2809 |
Hashes for aws_solutions_constructs.aws_constructs_factories-2.57.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a1a6a6dd1e365651c763a559bf48e1e53eb021892a501e4419c8eb776d0cd58d |
|
MD5 | 63e7d57b1ba90f42015a4fe87262d40f |
|
BLAKE2b-256 | fb38def9d15bb7e8a2e2a249f2fba1be7d83404ed19792a0bca4c9db305ab30d |