software.amazon.awscdk.services.efs

Class FileSystem

java.lang.Object

software.amazon.jsii.JsiiObject

software.constructs.Construct

software.amazon.awscdk.Resource

software.amazon.awscdk.services.efs.FileSystem

All Implemented Interfaces:

IResource, IConnectable, IFileSystem, software.amazon.jsii.JsiiSerializable, software.constructs.IConstruct, software.constructs.IDependable

@Generated(value="jsii-pacmak/1.63.2 (build a8a8833)",
           date="2022-08-08T20:48:13.083Z")
 @Stability(value=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:

https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/aws-resource-efs-filesystem.html

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	FileSystem.Builder A fluent builder for FileSystem.

Nested classes/interfaces inherited from class software.amazon.jsii.JsiiObject

software.amazon.jsii.JsiiObject.InitializationMode

Nested classes/interfaces inherited from interface software.amazon.awscdk.services.efs.IFileSystem

IFileSystem.Jsii$Default, IFileSystem.Jsii$Proxy

Field Summary

Fields

Modifier and Type	Field and Description
static Number	DEFAULT_PORT The default port File System listens on.

Constructor Summary

Constructors

Modifier	Constructor and Description
	FileSystem(software.constructs.Construct scope, String id, FileSystemProps props) Constructor for creating a new EFS FileSystem.
protected	FileSystem(software.amazon.jsii.JsiiObject.InitializationMode initializationMode)
protected	FileSystem(software.amazon.jsii.JsiiObjectRef objRef)

Method Summary

Modifier and Type	Method and Description
AccessPoint	addAccessPoint(String id) create access point from this filesystem.
AccessPoint	addAccessPoint(String id, AccessPointOptions accessPointOptions) create access point from this filesystem.
static IFileSystem	fromFileSystemAttributes(software.constructs.Construct scope, String id, FileSystemAttributes attrs) Import an existing File System from the given properties.
Connections	getConnections() The security groups/rules used to allow network connections to the file system.
String	getFileSystemArn() The ARN of the file system.
String	getFileSystemId() The ID of the file system, assigned by Amazon EFS.
software.constructs.IDependable	getMountTargetsAvailable() Dependable that can be depended upon to ensure the mount targets of the filesystem are ready.
Grant	grant(IGrantable grantee, String... actions) Grant the actions defined in actions to the given grantee on this File System resource.

Methods inherited from class software.amazon.awscdk.Resource

applyRemovalPolicy, generatePhysicalName, getEnv, getPhysicalName, getResourceArnAttribute, getResourceNameAttribute, getStack, isOwnedResource, isResource

Methods inherited from class software.constructs.Construct

getNode, isConstruct, toString

Methods inherited from class software.amazon.jsii.JsiiObject

jsiiAsyncCall, jsiiAsyncCall, jsiiCall, jsiiCall, jsiiGet, jsiiGet, jsiiSet, jsiiStaticCall, jsiiStaticCall, jsiiStaticGet, jsiiStaticGet, jsiiStaticSet, jsiiStaticSet

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface software.amazon.awscdk.IResource

applyRemovalPolicy, getEnv, getStack

Methods inherited from interface software.constructs.IConstruct

getNode

Methods inherited from interface software.amazon.jsii.JsiiSerializable

$jsii$toJson

Field Detail

DEFAULT_PORT

@Stability(value=Stable)
public static final Number DEFAULT_PORT

The default port File System listens on.

Constructor Detail

FileSystem

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

FileSystem

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

FileSystem

@Stability(value=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 Detail

fromFileSystemAttributes

@Stability(value=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(value=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(value=Stable)
 @NotNull
public AccessPoint addAccessPoint(@NotNull
                                                                     String id)

create access point from this filesystem.

Parameters:

id - This parameter is required.

grant

@Stability(value=Stable)
 @NotNull
public Grant grant(@NotNull
                                                      IGrantable grantee,
                                                      @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(value=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(value=Stable)
 @NotNull
public String getFileSystemArn()

The ARN of the file system.

Specified by:

getFileSystemArn in interface IFileSystem

getFileSystemId

@Stability(value=Stable)
 @NotNull
public String getFileSystemId()

The ID of the file system, assigned by Amazon EFS.

Specified by:

getFileSystemId in interface IFileSystem

getMountTargetsAvailable

@Stability(value=Stable)
 @NotNull
public software.constructs.IDependable getMountTargetsAvailable()

Dependable that can be depended upon to ensure the mount targets of the filesystem are ready.

Specified by:

getMountTargetsAvailable in interface IFileSystem