本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
CreateMountTarget
创建文件系统的挂载目标。然后,您可以使用挂载目标将文件系统挂载到EC2实例上。
您可以在的每个可用区中创建一个挂载目标VPC。给定可用区VPC内的所有EC2实例共享给定文件系统的单个挂载目标。如果您在一个可用区中有多个子网,则在其中一个子网中创建挂载目标。EC2实例不必与挂载目标位于同一个子网中即可访问其文件系统。
只能为单区文件系统创建一个挂载目标。必须在与文件系统所在的同一可用区中创建该挂载目标。使用 DescribeFileSystems 响应对象中的 AvailabiltyZoneId
和 AvailabilityZoneName
属性来获取此信息。创建挂载目标时,请使用与文件系统的可用区关联的 subnetId
。
有关更多信息,请参阅 AmazonEFS:工作原理。
要为文件系统创建挂载目标,文件系统的生命周期状态必须为 available
。有关更多信息,请参阅 DescribeFileSystems。
在请求中,提供以下内容:
-
为其创建挂载目标的文件系统 ID。
-
子网 ID,用于确定以下内容:
-
Amazon VPC 在其中EFS创建挂载目标的
-
Amazon 在其中EFS创建挂载目标的可用区域
-
Amazon 从EFS中选择挂载目标 IP 地址的 IP 地址范围(如果您未在请求中指定 IP 地址)
-
创建挂载目标后,Amazon EFS 会返回一个响应,其中包含 a MountTargetId
和IpAddress
。在EC2实例中装载文件系统时,您可以使用此 IP 地址。在装载文件系统时,也可以使用挂载目标的DNS名称。使用挂载目标挂载文件系统的EC2实例可以将挂载目标的DNS名称解析为其 IP 地址。有关更多信息,请参阅工作原理:实施概述。
请注意,您只能在一个文件系统中创建挂载目标VPC,并且每个可用区只能有一个挂载目标。也就是说,如果已为文件系统创建一个或多个挂载目标,则在添加另一个挂载目标的请求中指定的子网必须满足以下要求:
-
必须与现有挂载VPC目标的子网属于同一个子网
-
不得与现有挂载目标的任何子网位于同一可用区中
如果请求满足要求,Amazon 将执行以下EFS操作:
-
在指定的子网中创建新的挂载目标。
-
还在子网中创建新的网络接口,如下所示:
-
如果请求提供了
IpAddress
,则 EFS Amazon 会将该 IP 地址分配给网络接口。否则,EFSAmazon 会在子网中分配一个免费地址(就像请求未指定主私有 IP 地址时 Amazon EC2CreateNetworkInterface
调用的方式相同)。 -
如果请求提供
SecurityGroups
,则此网络接口将与这些安全组关联。否则,它属于子网的默认安全组VPC。 -
分配描述
Mount target fsmt-id for file system fs-id
,其中fsmt-id
是挂载目标 ID,fs-id
是FileSystemId
。 -
将网络接口的
requesterManaged
属性设置为true
,并将requesterId
值设置为EFS
。
每个 Amazon EFS 挂载目标都有一个相应的请求者管理的EC2网络接口。创建网络接口后,Amazon EFS 将挂载目标描述中的
NetworkInterfaceId
字段设置为网络接口 ID,将该IpAddress
字段设置为其地址。如果网络接口创建失败,则整个CreateMountTarget
操作将失败。 -
注意
CreateMountTarget
调用仅在创建网络接口后返回,但在挂载目标状态仍为 creating
时,可以通过调用 DescribeMountTargets 操作来检查挂载目标创建状态,除此之外,该操作还将返回挂载目标状态。
我们建议您在每个可用区中分别创建一个挂载目标。通过在一个可用区中创建的挂载目标在另一个可用区中使用文件系统时需要考虑成本。有关更多信息,请参阅 Amazon EFS
此操作需要对文件系统执行以下操作的权限:
-
elasticfilesystem:CreateMountTarget
此操作还需要权限才能执行以下 Amazon EC2 操作:
-
ec2:DescribeSubnets
-
ec2:DescribeNetworkInterfaces
-
ec2:CreateNetworkInterface
请求语法
POST /2015-02-01/mount-targets HTTP/1.1
Content-type: application/json
{
"FileSystemId": "string
",
"IpAddress": "string
",
"SecurityGroups": [ "string
" ],
"SubnetId": "string
"
}
URI请求参数
该请求不使用任何URI参数。
请求正文
该请求接受以下JSON格式的数据。
- FileSystemId
-
要为其创建挂载目标的文件系统的 ID。
类型:字符串
长度限制:最大长度为 128。
模式:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
必需:是
- IpAddress
-
指定子网地址范围内的有效IPv4地址。
类型:字符串
长度限制:最小长度为 7。最大长度为 15。
模式:
^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$
必需:否
- SecurityGroups
-
最多五个VPC安全组IDs,形式为
sg-xxxxxxxx
。它们必须与指定的子网VPC相同。类型:字符串数组
数组成员:最多 100 项。
长度限制:最小长度为 11。最大长度为 43。
模式:
^sg-[0-9a-f]{8,40}
必需:否
- SubnetId
-
要在其中添加挂载目标的子网的 ID。对于单区文件系统,请使用与文件系统的可用区关联的子网。
类型:字符串
长度限制:最小长度为 15。最大长度为 47。
模式:
^subnet-[0-9a-f]{8,40}$
必需:是
响应语法
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"
}
响应元素
如果操作成功,服务将发回 HTTP 200 响应。
以下数据由服务以JSON格式返回。
- AvailabilityZoneId
-
挂载目标所在可用区的唯一且一致的标识符。例如,
use1-az1
是 us-east-1 区域的可用区 ID,并且每个区域的位置都相同。 AWS 账户类型:字符串
- AvailabilityZoneName
-
挂载目标所在的可用区名称。可用区独立映射到每个可用区的名称 AWS 账户。例如,您的可用区
us-east-1a
AWS 账户 可能与其他可用区不同 AWS 账户。us-east-1a
类型:字符串
长度限制:长度下限为 1。长度上限为 64。
模式:
.+
- FileSystemId
-
挂载目标要用于的文件系统 ID。
类型:字符串
长度限制:最大长度为 128。
模式:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
- IpAddress
-
可使用挂载目标挂载文件系统的地址。
类型:字符串
长度限制:最小长度为 7。最大长度为 15。
模式:
^[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}$
- LifeCycleState
-
挂载目标的生命周期状态。
类型:字符串
有效值:
creating | available | updating | deleting | deleted | error
- MountTargetId
-
系统分配的挂载目标 ID。
类型:字符串
长度限制:最小长度为 13。最大长度为 45。
模式:
^fsmt-[0-9a-f]{8,40}$
- NetworkInterfaceId
-
Amazon 在创建挂载目标时EFS创建的网络接口的 ID。
类型:字符串
- OwnerId
-
AWS 账户 拥有资源的 ID。
类型:字符串
长度限制:最大长度为 14。
模式:
^(\d{12})|(\d{4}-\d{4}-\d{4})$
- SubnetId
-
挂载目标子网的 ID。
类型:字符串
长度限制:最小长度为 15。最大长度为 47。
模式:
^subnet-[0-9a-f]{8,40}$
- VpcId
-
配置挂载目标的虚拟私有云 (VPC) ID。
类型:字符串
错误
- AvailabilityZonesMismatch
-
如果为挂载目标指定的可用区与为单区存储指定的可用区不同,则返回此内容。有关更多信息,请参阅区域和单区存储冗余。
HTTP状态码:400
- BadRequest
-
如果请求格式错误或包含错误(例如参数值无效或缺少必填参数),则返回此内容。
HTTP状态码:400
- FileSystemNotFound
-
如果请求者的指定
FileSystemId
值不存在,则返回。 AWS 账户HTTP状态码:404
- IncorrectFileSystemLifeCycleState
-
如果文件系统的生命周期状态不是“可用”,则返回此内容。
HTTP状态码:409
- InternalServerError
-
如果服务器端发生错误,则返回此内容。
HTTP状态码:500
- IpAddressInUse
-
如果请求指定了子网中已在使用的
IpAddress
,则返回此内容。HTTP状态码:409
- MountTargetConflict
-
如果挂载目标违反了基于文件系统现有挂载目标的指定限制之一,则返回此内容。
HTTP状态码:409
- NetworkInterfaceLimitExceeded
-
调用账户已达到特定 AWS 区域弹性网络接口的限制。要么删除一些网络接口,要么请求提高账户配额。有关更多信息,请参阅《亚马逊VPC用户指南》中的 Amazon VPC 配额(参见 “网络接口” 表中的每个区域的网络接口条目)。
HTTP状态码:409
- NoFreeAddressesInSubnet
-
如果请求中未指定
IpAddress
且子网中没有空闲的 IP 地址,则返回此内容。HTTP状态码:409
- SecurityGroupLimitExceeded
-
如果请求中指定的
SecurityGroups
大小大于五,则返回此内容。HTTP状态码:400
- SecurityGroupNotFound
-
如果子网的虚拟私有云 (VPC) 中不存在指定的安全组,则返回。
HTTP状态码:400
- SubnetNotFound
-
如果请求中没有提供 ID 为
SubnetId
的子网,则返回此内容。HTTP状态码:400
- UnsupportedAvailabilityZone
-
如果所请求的 Amazon EFS 功能在指定的可用区域中不可用,则返回。
HTTP状态码:400
示例
向文件系统添加挂载目标
以下请求为文件系统创建挂载目标。该请求仅为必填的 SubnetId
和 FileSystemId
参数指定值。该请求未提供可选的 SecurityGroups
和 IpAddress
参数。对于 IpAddress
,此操作使用指定子网中的一个可用 IP 地址。而且,该操作使用与关联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,请参阅以下内容: