AWS CloudFormation
User Guide (API Version 2010-05-15)
AWS 服务或AWS文档中描述的功能,可能因地区/位置而异。请点击 Amazon AWS 入门,可查看中国地区的具体差异

AWS::EFS::FileSystem

AWS::EFS::FileSystem 资源在 Amazon Elastic File System (Amazon EFS) 中创建新的空文件系统。您必须创建挂载目标 (AWS::EFS::MountTarget) 才能在 Amazon Elastic Compute Cloud (Amazon EC2) 实例上挂载您的 Amazon EFS 文件系统。有关更多信息,请参阅 Amazon Elastic File System 用户指南 中的 CreateFileSystem API。

语法

要在 AWS CloudFormation 模板中声明此实体,请使用以下语法:

JSON

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

YAML

Type: "AWS::EFS::FileSystem" Properties: Encrypted: Boolean FileSystemTags: - FileSystemTags KmsKeyId: String PerformanceMode: String

属性

FileSystemTags

与文件系统关联的标签。

Required: No

类型Amazon Elastic File System FileSystem FileSystemTags

更新要求无需中断

Encrypted

一种布尔值,如果为 true,则创建一个加密文件系统。有关更多信息,请参阅 Amazon Elastic File System 用户指南 中的 CreateFileSystem

Required: No

Type: Boolean

更新要求替换

KmsKeyId

用于保护加密文件系统的 AWS KMS 客户主密钥 (CMK) 的 ID。仅当您想使用非默认 CMK 时,此参数才是必需的。有关更多信息,请参阅 Amazon Elastic File System 用户指南 中的 CreateFileSystem

Required: Conditional。仅当您使用非默认 CMK 时,此参数才是必需的。

Type: String

更新要求替换

PerformanceMode

文件系统的性能模式。对于有效值,请参阅 Amazon Elastic File System 用户指南 中的 CreateFileSystem 操作的 PerformanceMode 参数。

有关性能模式的更多信息,请参阅 Amazon Elastic File System 用户指南 中的 Amazon EFS 性能

Required: No

Type: String

更新要求替换

返回值

Ref

当向 Ref 内部函数提供此资源的逻辑 ID 时,Ref 将返回此资源 ID,如 fs-47a2c22e

有关使用 Ref 功能的更多信息,请参阅参考

示例

以下示例声明一个加密文件系统:

JSON

{ "Resources": { "filesystem": { "Type": "AWS::EFS::FileSystem", "Properties": { "Encrypted": true, "KmsKeyId": { "Fn::GetAtt": [ "key", "Arn" ] } } }, "key": { "Type": "AWS::KMS::Key", "Properties": { "KeyPolicy": { "Version": "2012-10-17", "Id": "key-default-1", "Statement": [ { "Sid": "Allow administration of the key", "Effect": "Allow", "Principal": { "AWS": { "Fn::Join": [ "", [ "arn:aws:iam::", { "Ref": "AWS::AccountId" }, ":root" ] ] } }, "Action": [ "kms:*" ], "Resource": "*" } ] } } } }, "Outputs": { "KeyId": { "Value": { "Fn::GetAtt": [ "key", "Arn" ] } } } }

YAML

Resources: filesystem: Type: 'AWS::EFS::FileSystem' Properties: Encrypted: true KmsKeyId: !GetAtt - key - Arn key: Type: 'AWS::KMS::Key' Properties: KeyPolicy: Version: 2012-10-17 Id: key-default-1 Statement: - Sid: Allow administration of the key Effect: Allow Principal: AWS: !Join - '' - - 'arn:aws:iam::' - !Ref 'AWS::AccountId' - ':root' Action: - 'kms:*' Resource: '*' Outputs: KeyId: Value: !GetAtt - key - Arn

其他资源

有关完整示例模板,请参阅 Amazon Elastic File System 示例模板