メニュー
AWS CloudFormation
ユーザーガイド (API Version 2010-05-15)

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

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

YAML

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

プロパティ

FileSystemId

マウントターゲットを作成するファイルシステムの ID。

Required: Yes

Type: String

更新に伴う要件: 置換

このプロパティを更新する前に、このマウントターゲットを使用する EC2 インスタンスを停止して、更新が完了してから再起動します。これにより、マウントターゲットを置き換える前にインスタンスがファイルシステムをアンマウントできるようになります。EC2 インスタンスを停止および再起動しなかった場合、それらのマウントを使用するインスタンスまたはアプリケーションは、マウントターゲットが削除される際に中断される可能性があります (コミットされていない書き込みは失われる可能性があります)。

IpAddress

SubnetId プロパティで指定されたサブネットのアドレス範囲内にある IPv4 アドレス。IP アドレスを指定しなかった場合、Amazon EFS は自動的にサブネットの範囲内のアドレスを割り当てます。

Required: No

Type: String

更新に伴う要件: 置換

このプロパティを更新する前に、このマウントターゲットを使用する EC2 インスタンスを停止して、更新が完了してから再起動します。これにより、マウントターゲットを置き換える前にインスタンスがファイルシステムをアンマウントできるようになります。EC2 インスタンスを停止および再起動しなかった場合、それらのマウントを使用するインスタンスまたはアプリケーションは、マウントターゲットが削除される際に中断される可能性があります (コミットされていない書き込みは失われる可能性があります)。

SecurityGroups

SubnetId プロパティで指定されたサブネットと同じ VPC 内に存在する、最大 5 つの VPC セキュリティグループ ID。セキュリティグループとマウントターゲットの詳細については、Amazon Elastic File System ユーザーガイドの「セキュリティ」を参照してください。

Required: Yes

Type: List of String values

更新に伴う要件: 中断はありません。

SubnetId

マウントターゲットを追加するサブネットの ID。

注記

各ファイルシステムについては、アベイラビリティーゾーン (AZ) ごとに 1 つのみのマウント ターゲットを作成できます。AZ のすべての EC2 インスタンスではファイルシステムに対して 1 つのマウントターゲットを共有します。1 つのファイルシステムに複数のマウントターゲットを作成する場合は、既に同じファイルシステムに関連付けられているマウントターゲットを含む AZ であるサブネットを指定しないでください。

Required: Yes

Type: String

更新に伴う要件: 置換

このプロパティを更新する前に、このマウントターゲットを使用する EC2 インスタンスを停止して、更新が完了してから再起動します。これにより、マウントターゲットを置き換える前にインスタンスがファイルシステムをアンマウントできるようになります。EC2 インスタンスを停止および再起動しなかった場合、それらのマウントを使用するインスタンスまたはアプリケーションは、マウントターゲットが削除される際に中断される可能性があります (コミットされていない書き込みは失われる可能性があります)。

戻り値

参照番号

このリソースの論理 ID が Ref 組み込み関数に提供されると、Ref により fsmt-55a4413c のようなリソース ID が返されます。

Ref 関数の使用方法の詳細については、「Ref」を参照してください。

テンプレートの例

次の例では、ファイルシステム、サブネット、セキュリティグループに関連付けられるマウントターゲットを宣言します。これらはすべて同じテンプレートで宣言されます。マウントターゲットが関連ファイルシステムへの接続に使用できる AZ と同じ AZ 内にある EC2 インスタンス。EC2 インスタンスへのファイルシステムのマウントについては、Amazon Elastic File System ユーザーガイドの「ファイルシステムのマウント」を参照してください。

JSON

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

YAML

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

その他のリソース

完全なサンプルテンプレートについては、「Amazon Elastic File System サンプルテンプレート」を参照してください。