CreateMountTarget - Amazon Elastic File System
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

CreateMountTarget

创建文件系统的挂载目标。然后,您可通过使用挂载目标在 EC2 实例上挂载文件系统。

可以在 VPC 中的每个可用区内创建一个挂载目标。给定可用区内的 VPC 中的所有 EC2 实例共享给定文件系统的单个挂载目标。如果您在一个可用区中有多个子网,则在其中一个子网中创建挂载目标。EC2 实例不需要与挂载目标位于同一子网中,以便访问其文件系统。

只能为单区文件系统创建一个挂载目标。必须在与文件系统所在的同一可用区中创建该挂载目标。使用 DescribeFileSystems 响应对象中的 AvailabiltyZoneIdAvailabilityZoneName 属性来获取此信息。创建挂载目标时,请使用与文件系统的可用区关联的 subnetId

有关更多信息,请参阅 Amazon EFS:工作原理

要为文件系统创建挂载目标,文件系统的生命周期状态必须为 available。有关更多信息,请参阅DescribeFileSystems

在请求中,提供以下内容:

  • 为其创建挂载目标的文件系统 ID。

  • 子网 ID,用于确定以下内容:

    • Amazon EFS 在其中创建挂载目标的 VPC

    • Amazon EFS 在其中创建挂载目标的可用区

    • Amazon EFS 从中选择挂载目标 IP 地址的 IP 地址范围(如果未在请求中指定 IP 地址)

创建挂载目标后,Amazon EFS 将返回一个响应,其中包括一个 MountTargetId 和一个 IpAddress。在 EC2 实例中挂载文件系统时,可使用此 IP 地址。您还可以在挂载文件系统时使用挂载目标的 DNS 名称。您使用挂载目标在其中挂载文件系统的 EC2 实例可以将挂载目标的 DNS 名称解析为其 IP 地址。有关更多信息,请参阅工作原理:实施概述

请注意,您只能在一个 VPC 中为文件系统创建挂载目标,而且每个可用区只能有一个挂载目标。也就是说,如果已为文件系统创建一个或多个挂载目标,则在添加另一个挂载目标的请求中指定的子网必须满足以下要求:

  • 必须与现有挂载目标的子网属于同一 VPC

  • 不得与现有挂载目标的任何子网位于同一可用区中

如果请求满足要求,则 Amazon EFS 将执行以下操作:

  • 在指定的子网中创建新的挂载目标。

  • 还在子网中创建新的网络接口,如下所示:

    • 如果请求提供 IpAddress,则 Amazon EFS 将向网络接口分配该 IP 地址。否则,Amazon EFS 会在子网中分配一个空闲地址(与请求未指定主要私有 IP 地址时 Amazon EC2 CreateNetworkInterface 调用所采用的方式相同)。

    • 如果请求提供 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

最多 5 个 sg-xxxxxxxx 形式的 VPC 安全组 ID。它们必须用于与指定子网相同的 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 区域的 AZ ID,它在每个 Amazon Web Services 账户中的位置均相同。

类型:字符串

AvailabilityZoneName

挂载目标所在的可用区名称。可用区独立映射到每个 Amazon Web Services 账户名称。例如,您 Amazon Web Services 账户的可用区 us-east-1a 可能与另一 Amazon Web Services 账户的 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

拥有资源的 Amazon Web Services 账户 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

如果请求者的 Amazon Web Services 账户中不存在指定的 FileSystemId 值,则返回此内容。

HTTP 状态代码:404

IncorrectFileSystemLifeCycleState

如果文件系统的生命周期状态不是“可用”,则返回此内容。

HTTP 状态代码:409

InternalServerError

如果服务器端发生错误,则返回此内容。

HTTP 状态代码:500

IpAddressInUse

如果请求指定了子网中已在使用的 IpAddress,则返回此内容。

HTTP 状态代码:409

MountTargetConflict

如果挂载目标违反了基于文件系统现有挂载目标的指定限制之一,则返回此内容。

HTTP 状态代码:409

NetworkInterfaceLimitExceeded

调用账户已达到特定 Amazon Web Services 区域弹性网络接口的限制。要么删除一些网络接口,要么请求提高账户配额。有关更多信息,请参阅《Amazon 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

示例

向文件系统添加挂载目标

以下请求为文件系统创建挂载目标。该请求仅为必填的 SubnetIdFileSystemId 参数指定值。该请求未提供可选的 SecurityGroupsIpAddress 参数。对于 IpAddress,此操作使用指定子网中的一个可用 IP 地址。此操作还使用与 SecurityGroups 的 VPC 关联的默认安全组。

示例请求

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" }

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息,请参阅以下内容: