Package software.amazon.awscdk.services.efs

Class FileSystem

java.lang.Object
software.amazon.jsii.JsiiObject
software.constructs.Construct
software.amazon.awscdk.core.Construct
software.amazon.awscdk.core.Resource
software.amazon.awscdk.services.efs.FileSystem
All Implemented Interfaces:
IConstruct, IDependable, IResource, IConnectable, IFileSystem, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct
@Generated(value="jsii-pacmak/1.84.0 (build 5404dcf)", date="2023-06-19T16:30:40.134Z") @Stability(Stable) public class FileSystem extends Resource implements IFileSystem
The Elastic File System implementation of IFileSystem.

It creates a new, empty file system in Amazon Elastic File System (Amazon EFS). It also creates mount target (AWS::EFS::MountTarget) implicitly to mount the EFS file system on an Amazon Elastic Compute Cloud (Amazon EC2) instance or another resource.

Example: 

 FileSystem fileSystem = FileSystem.Builder.create(this, "MyEfsFileSystem")
         .vpc(new Vpc(this, "VPC"))
         .lifecyclePolicy(LifecyclePolicy.AFTER_14_DAYS) // files are not transitioned to infrequent access (IA) storage by default
         .performanceMode(PerformanceMode.GENERAL_PURPOSE) // default
         .outOfInfrequentAccessPolicy(OutOfInfrequentAccessPolicy.AFTER_1_ACCESS)
         .build();

See Also:

  • Field Details

    • DEFAULT_PORT

      @Stability(Stable) public static final Number DEFAULT_PORT
      The default port File System listens on.

  • Constructor Details

    • FileSystem

      protected FileSystem(software.amazon.jsii.JsiiObjectRef objRef)

    • FileSystem

      protected FileSystem(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)

    • FileSystem

      @Stability(Stable) public FileSystem(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull FileSystemProps props)
      Constructor for creating a new EFS FileSystem.

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      props - This parameter is required.

  • Method Details

    • fromFileSystemAttributes

      @Stability(Stable) @NotNull public static IFileSystem fromFileSystemAttributes(@NotNull software.constructs.Construct scope, @NotNull String id, @NotNull FileSystemAttributes attrs)
      Import an existing File System from the given properties.

      Parameters:
      scope - This parameter is required.
      id - This parameter is required.
      attrs - This parameter is required.

    • addAccessPoint

      @Stability(Stable) @NotNull public AccessPoint addAccessPoint(@NotNull String id, @Nullable AccessPointOptions accessPointOptions)
      create access point from this filesystem.

      Parameters:
      id - This parameter is required.
      accessPointOptions -

    • addAccessPoint

      @Stability(Stable) @NotNull public AccessPoint addAccessPoint(@NotNull String id)
      create access point from this filesystem.

      Parameters:
      id - This parameter is required.

    • grant

      @Stability(Stable) @NotNull public Grant grant(@NotNull IGrantable grantee, @NotNull @NotNull String... actions)
      Grant the actions defined in actions to the given grantee on this File System resource.

      Specified by:
      grant in interface IFileSystem
      Parameters:
      grantee - Principal to grant right to. This parameter is required.
      actions - The actions to grant. This parameter is required.

    • getConnections

      @Stability(Stable) @NotNull public Connections getConnections()
      The security groups/rules used to allow network connections to the file system.
      Specified by:
      getConnections in interface IConnectable

    • getFileSystemArn

      @Stability(Stable) @NotNull public String getFileSystemArn()
      The ARN of the file system.
      Specified by:
      getFileSystemArn in interface IFileSystem

    • getFileSystemId

      @Stability(Stable) @NotNull public String getFileSystemId()
      The ID of the file system, assigned by Amazon EFS.
      Specified by:
      getFileSystemId in interface IFileSystem

    • getMountTargetsAvailable

      @Stability(Stable) @NotNull public IDependable getMountTargetsAvailable()
      Dependable that can be depended upon to ensure the mount targets of the filesystem are ready.
      Specified by:
      getMountTargetsAvailable in interface IFileSystem