CreateMountTarget - Amazon Elastic File System

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

CreateMountTarget

创建文件系统的挂载目标。然后,您可以使用挂载目标将文件系统挂载到EC2实例上。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    • 如果请求提供了IpAddress,则 EFS Amazon 会将该 IP 地址分配给网络接口。否则,EFSAmazon 会在子网中分配一个免费地址(就像请求未指定主私有 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

最多五个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

示例

向文件系统添加挂载目标

以下请求为文件系统创建挂载目标。该请求仅为必填的 SubnetIdFileSystemId 参数指定值。该请求未提供可选的 SecurityGroupsIpAddress 参数。对于 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,请参阅以下内容: