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

AWS::EFS::MountTarget

AWS::EFS::MountTarget 资源为 Amazon Elastic File System (Amazon EFS) 文件系统 (AWS::EFS::FileSystem) 创建挂载目标。使用挂载目标在 Amazon Elastic Compute Cloud (Amazon EC2) 实例上挂载文件系统。

有关为文件系统创建挂载目标的更多信息,请参阅 Amazon Elastic File System 用户指南 中的 CreateMountTarget。有关部署与 Amazon EFS 文件系统关联的 EC2 实例的详细概述,请参阅 Amazon Elastic File System 示例模板

注意

EC2 实例及其连接到的挂载目标必须位于已启用 DNS 的 VPC 中。

语法

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

JSON

{ "Type" : "AWS::EFS::MountTarget", "Properties" : { "FileSystemId" : String, "IpAddress" : String, "SecurityGroups" : [ String, ... ], "SubnetId" : String } }

YAML

Type: "AWS::EFS::MountTarget" Properties: FileSystemId: String IpAddress: String SecurityGroups: [ String, ... ] SubnetId: String

属性

FileSystemId

您希望用于创建挂载目标的文件系统的 ID。

Required: Yes

Type: String

更新要求替换

更新此属性之前,请停止正在使用此挂载目标的 EC2 实例,然后在更新完成之后重新启动这些实例。这允许实例在替换挂载目标之前卸载文件系统。如果未停止并重新启动实例,则正在使用挂载的实例或应用程序可能会在删除挂载目标后中断(未提交的写入可能会丢失)。

IpAddress

IPv4 地址,该地址位于在 SubnetId 属性中指定的子网的地址范围内。如果您未指定 IP 地址,则 Amazon EFS 会自动分配位于子网范围内的地址。

Required: No

Type: String

更新要求替换

更新此属性之前,请停止正在使用此挂载目标的 EC2 实例,然后在更新完成之后重新启动这些实例。这允许实例在替换挂载目标之前卸载文件系统。如果未停止并重新启动实例,则正在使用挂载的实例或应用程序可能会在删除挂载目标后中断(未提交的写入可能会丢失)。

SecurityGroups

最多 5 个 VPC 安全组 ID,这些 ID 位于与在 SubnetId 属性中指定的子网相同的 VPC 中。有关安全组和挂载目标的更多信息,请参阅 Amazon Elastic File System 用户指南 中的安全性

Required: Yes

Type: List of String values

更新要求无需中断

SubnetId

您要在其中添加挂载目标的子网的 ID。

注意

对于每个文件系统,每个可用区 (AZ) 只能创建一个挂载目标。AZ 中的所有 EC2 实例共享文件系统的一个挂载目标。如果为一个文件系统创建多个挂载目标,请勿指定属于已有一个挂载目标与相同文件系统关联的 AZ 的子网。

Required: Yes

Type: String

更新要求替换

更新此属性之前,请停止正在使用此挂载目标的 EC2 实例,然后在更新完成之后重新启动这些实例。这样,实例可在替换挂载目标之前卸载文件系统。如果未停止并重新启动实例,则正在使用挂载的实例或应用程序可能会在删除挂载目标后中断(未提交的写入可能会丢失)。

返回值

Ref

当向 Ref 内部函数提供此资源的逻辑 ID 时,Ref 将返回此资源 ID,如 fsmt-55a4413c

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

模板示例

下面的示例声明与文件系统、子网和安全组(全部已在相同模板中声明)关联的挂载目标。与挂载目标位于相同 AZ 中的 EC2 实例可使用挂载目标来连接到关联的文件系统。有关在 EC2 实例上挂载文件系统的信息,请参阅 Amazon Elastic File System 用户指南 中的挂载文件系统

JSON

"MountTarget": { "Type": "AWS::EFS::MountTarget", "Properties": { "FileSystemId": { "Ref": "FileSystem" }, "SubnetId": { "Ref": "Subnet" }, "SecurityGroups": [ { "Ref": "MountTargetSecurityGroup" } ] } }

YAML

MountTarget: Type: "AWS::EFS::MountTarget" Properties: FileSystemId: Ref: "FileSystem" SubnetId: Ref: "Subnet" SecurityGroups: - Ref: "MountTargetSecurityGroup"

其他资源

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