Menu
AWS CloudFormation
User Guide (API Version 2010-05-15)

AWS::EFS::FileSystem

The AWS::EFS::FileSystem resource creates a new, empty file system in Amazon Elastic File System (Amazon EFS). You must create a mount target (AWS::EFS::MountTarget) to mount your Amazon EFS file system on an Amazon Elastic Compute Cloud (Amazon EC2) instance. For more information, see the CreateFileSystem API in the Amazon Elastic File System User Guide.

Syntax

To declare this entity in your AWS CloudFormation template, use the following syntax:

JSON

Copy
{ "Type" : "AWS::EFS::FileSystem", "Properties" : { "FileSystemTags" : [ FileSystemTags, ... ], "PerformanceMode" : String } }

YAML

Copy
Type: "AWS::EFS::FileSystem" Properties: FileSystemTags: - FileSystemTags PerformanceMode: String

Properties

FileSystemTags

Tags to associate with the file system.

Required: No

Type: Amazon Elastic File System FileSystem FileSystemTags

Update requires: No interruption

PerformanceMode

The performance mode of the file system. For valid values, see the PerformanceMode parameter for the CreateFileSystem action in the Amazon Elastic File System User Guide.

For more information about performance modes, see Amazon EFS Performance in the Amazon Elastic File System User Guide.

Required: No

Type: String

Update requires: Replacement

Return Value

Ref

When the logical ID of this resource is provided to the Ref intrinsic function, Ref returns the resource ID, such as fs-47a2c22e.

For more information about using the Ref function, see Ref.

Example

The following example declares a file system with a tag key Name and tag value TestFileSystem:

JSON

Copy
"WebServerFileSystem" : { "Type" : "AWS::EFS::FileSystem", "Properties" : { "FileSystemTags" : [ { "Key" : "Name", "Value" : "TestFileSystem" } ] } }

YAML

Copy
WebServerFileSystem: Type: "AWS::EFS::FileSystem" Properties: FileSystemTags: - Key: "Name" Value: "TestFileSystem"

Additional Resources

For a complete sample template, see Amazon Elastic File System Sample Template.