翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

CreateMountTarget

ファイルシステムのマウントターゲットを作成します。その後、マウントターゲットを使用して、ファイルシステムをEC2インスタンスにマウントできます。

のアベイラビリティーゾーンごとに 1 つのマウントターゲットを作成できますVPC。特定のアベイラビリティーゾーンVPC内の 内のすべてのEC2インスタンスは、特定のファイルシステムの 1 つのマウントターゲットを共有します。アベイラビリティーゾーンに複数のサブネットがある場合、サブネットの 1 つにマウントターゲットを作成します。EC2 インスタンスがファイルシステムにアクセスするために、マウントターゲットと同じサブネットに存在する必要はありません。

1 ゾーンファイルシステムに対して作成できるマウントターゲットは 1 つだけです。このマウントターゲットは、ファイルシステムがあるのと同じアベイラビリティーゾーンで作成する必要があります。この情報を得るには、DescribeFileSystems レスポンスオブジェクトの AvailabilityZoneName と AvailabiltyZoneId のプロパティを使用します。マウントターゲットの作成時に、ファイルシステムのアベイラビリティーゾーンに関連付けられた subnetId を使用します。

詳細については、「Amazon EFS: の仕組み」を参照してください。

ファイルシステムのマウントターゲットを作成するには、ファイルシステムのライフサイクル状態が available である必要があります。詳細については、「DescribeFileSystems」を参照してください。

リクエストで、以下を指定します。

マウントターゲットを作成すると、Amazon は MountTargetIdと を含むレスポンスEFSを返しますIpAddress。この IP アドレスは、ファイルシステムをEC2インスタンスにマウントするときに使用します。ファイルシステムをマウントするときに、マウントターゲットDNSの名前を使用することもできます。マウントターゲットを使用してファイルシステムをマウントするEC2インスタンスは、マウントターゲットDNSの名前を IP アドレスに解決できます。詳細については、「仕組み: 実装の概要」を参照してください。

ファイルシステムのマウントターゲットは 1 つの にのみ作成できVPC、アベイラビリティーゾーンごとに 1 つのマウントターゲットしか作成できないことに注意してください。つまり、ファイルシステムにすでに 1 つ以上のマウントターゲットが作成されている場合、別のマウントターゲットを追加するリクエストで指定されたサブネットは、次の要件を満たす必要があります。

リクエストが要件を満たしている場合、Amazon EFSは以下を実行します。

各アベイラビリティーゾーンにマウントターゲットを作成することをお勧めします。別のアベイラビリティーゾーンで作成されたマウントターゲットを使用して、アベイラビリティーゾーンにファイルシステムを使用する場合は、コストを考慮する必要があります。詳細については、「Amazon EFS」を参照してください。さらに、インスタンスのアベイラビリティーゾーンにローカルなマウントターゲットを常に使用することで、部分的な障害の発生を避けられます。マウントターゲットが作成されているアベイラビリティーゾーンが停止した場合、そのマウントターゲットを介してファイルシステムにアクセスすることはできません。

このオペレーションには、ファイルシステムに対する次のアクションに対するアクセス許可が必要です。

このオペレーションには、次の Amazon EC2アクションに対するアクセス許可も必要です。

リクエストの構文

POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json

{
   "FileSystemId": "string",
   "IpAddress": "string",
   "SecurityGroups": [ "string" ],
   "SubnetId": "string"
}

URI リクエストパラメータ

リクエストはURIパラメータを使用しません。

リクエスト本文

リクエストは、 JSON形式の次のデータを受け入れます。

レスポンスの構文

HTTP/1.1 200
Content-type: application/json

{
   "AvailabilityZoneId": "string",
   "AvailabilityZoneName": "string",
   "FileSystemId": "string",
   "IpAddress": "string",
   "LifeCycleState": "string",
   "MountTargetId": "string",
   "NetworkInterfaceId": "string",
   "OwnerId": "string",
   "SubnetId": "string",
   "VpcId": "string"
}

レスポンス要素

アクションが成功すると、サービスは 200 HTTP レスポンスを返します。

次のデータは、 サービスによって JSON 形式で返されます。

エラー

例

ファイルシステムへのマウントターゲットの追加

次のリクエストは、ファイルシステムのマウントターゲットを作成します。リクエストでは、必要な FileSystemId と SubnetId のパラメーターのみの値を指定します。このリクエストでは、オプションの IpAddress と SecurityGroups のパラメータが提供されていません。IpAddress の場合、オペレーションは、指定されたサブネットで使用可能な IP アドレスの 1 つを使用します。また、 オペレーションでは、 の VPC に関連付けられたデフォルトのセキュリティグループを使用しますSecurityGroups。

リクエスト例

POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{"SubnetId": "subnet-748c5d03", "FileSystemId": "fs-01234567"}

レスポンス例

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
    "MountTargetId": "fsmt-55a4413c",
    "NetworkInterfaceId": "eni-01234567",
    "FileSystemId": "fs-01234567",
    "LifeCycleState": "available",
    "SubnetId": "subnet-01234567",
    "OwnerId": "231243201240",
    "IpAddress": "172.31.22.183"
}

ファイルシステムへのマウントターゲットの追加

次のリクエストは、マウントターゲットを作成するためのすべてのリクエストパラメータを指定します。

リクエスト例

POST /2015-02-01/mount-targets HTTP/1.1 
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140620T221118Z
Authorization: <...>
Content-Type: application/json
Content-Length: 160

{
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-01234567",
   "IpAddress":"10.0.2.42",
   "SecurityGroups":[
      "sg-01234567"
   ]
}

レスポンス例

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 252

{
   "OwnerId":"251839141158",
   "MountTargetId":"fsmt-9a13661e",
   "FileSystemId":"fs-01234567",
   "SubnetId":"subnet-fd04ff94",
   "LifeCycleState":"available",
   "IpAddress":"10.0.2.42",
   "NetworkInterfaceId":"eni-1bcb7772"
}

以下の資料も参照してください。

言語固有の のいずれかAPIでこれを使用する方法の詳細については AWS SDKs、以下を参照してください。