{"id":20973,"library":"aws-cdk-aws-fsx","title":"AWS CDK FSx Construct Library","description":"AWS CDK L1 constructs for Amazon FSx (AWS::FSx CloudFormation resource). Version 1.204.0 is for CDK v1 (now in maintenance mode). AWS CDK v2 replaces this with the `aws-cdk-lib/aws-fsx` module. Release cadence: tied to AWS CDK releases (weekly).","status":"maintenance","version":"1.204.0","language":"python","source_language":"en","source_url":"https://github.com/aws/aws-cdk","tags":["aws","cdk","fsx","cloudformation","infrastructure"],"install":[{"cmd":"pip install aws-cdk-aws-fsx","lang":"bash","label":"Install for CDK v1"}],"dependencies":[{"reason":"CDK v2 uses aws-cdk-lib instead of individual packages; no longer needed.","package":"aws-cdk-lib","optional":false},{"reason":"Peer dependency for CDK constructs.","package":"constructs","optional":false}],"imports":[{"note":"CDK v2 uses different class names; also, high-level constructs exist in separate modules.","wrong":"from aws_cdk.aws_fsx import FileSystem","symbol":"CfnFileSystem","correct":"from aws_cdk.aws_fsx import CfnFileSystem"},{"note":"Ensure correct Cfn prefix for L1 constructs.","wrong":"from aws_cdk.aws_fsx import StorageVirtualMachine","symbol":"CfnStorageVirtualMachine","correct":"from aws_cdk.aws_fsx import CfnStorageVirtualMachine"}],"quickstart":{"code":"from aws_cdk import core\nfrom aws_cdk.aws_fsx import CfnFileSystem\n\napp = core.App()\nstack = core.Stack(app, \"MyStack\")\n\nfs = CfnFileSystem(stack, \"MyFsx\",\n    file_system_type=\"LUSTRE\",\n    subnet_ids=[\"subnet-12345678\"],\n    storage_capacity=1200\n)\n\napp.synth()","lang":"python","description":"Minimal CDK v1 stack creating an FSx for Lustre file system."},"warnings":[{"fix":"Migrate to CDK v2: replace 'aws-cdk-aws-fsx' with 'aws-cdk-lib' and update imports to 'from aws_cdk.aws_fsx import ...'.","message":"aws-cdk-aws-fsx is part of CDK v1, which entered maintenance mode on June 1, 2022 and will end support on June 1, 2025. Use CDK v2 with aws-cdk-lib/aws-fsx instead.","severity":"deprecated","affected_versions":"<=1.204.0"},{"fix":"Install both: pip install aws-cdk.core aws-cdk-aws-fsx.","message":"CDK v1 uses separate packages for each service. If you install only aws-cdk-aws-fsx, the core CDK library (aws-cdk.core) must also be installed explicitly.","severity":"gotcha","affected_versions":"<=1.204.0"},{"fix":"Use camelCase property names for CDK v1 >=1.19.0. Example: 'lustreConfiguration' instead of 'lustre_configuration'.","message":"CDK v2 removed the 'Cfn' prefix from L1 constructs? Actually, CDK v2 retains 'Cfn' prefix. Breaking change: release 1.19.0 renamed some properties (e.g., 'lustre_configuration' -> 'lustreConfiguration').","severity":"breaking","affected_versions":"<=1.19.0"}],"env_vars":null,"last_verified":"2026-04-27T00:00:00.000Z","next_check":"2026-07-26T00:00:00.000Z","problems":[{"fix":"For CDK v1: pip install aws-cdk-aws-fsx. For CDK v2: install aws-cdk-lib and use 'from aws_cdk.aws_fsx import ...' (no separate package).","cause":"Missing aws-cdk-aws-fsx installation or wrong CDK version (v2 needs aws-cdk-lib).","error":"ModuleNotFoundError: No module named 'aws_cdk.aws_fsx'"},{"fix":"Use camelCase: 'lustreConfiguration' instead of 'lustre_configuration'.","cause":"CDK v1 >=1.19.0 switched to camelCase property names.","error":"AttributeError: 'CfnFileSystem' object has no attribute 'lustre_configuration'"},{"fix":"Ensure all required properties are provided. For example, for LUSTRE: file_system_type='LUSTRE', subnet_ids=[...], storage_capacity=1200.","cause":"Missing required property like 'subnet_ids' or 'storage_capacity' when creating CfnFileSystem.","error":"jsii.errors.JSIIError: Expected an object, got undefined"}],"ecosystem":"pypi","meta_description":null,"install_score":null,"install_tag":null,"quickstart_score":null,"quickstart_tag":null}