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

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

CreateAccessPoint

创建 EFS 访问点。访问点是 EFS 文件系统特定于应用程序的视图,将操作系统用户和组以及文件系统路径应用到通过该访问点发出的任何文件系统请求。操作系统用户和组覆盖 NFS 客户端提供的任何身份信息。文件系统路径作为访问点的根目录公开。使用该访问点的应用程序应用程序只能对访问点的应用程序的目录及任何子目录中的数据进行访问。要了解更多信息,请参阅使用 EFS 访问点挂载文件系统

注意

如果快速连续发送多个在同一个文件系统上创建接入点的请求,并且文件系统接近 1,000 个接入点的限制,则这些请求的响应可能会受到限制。这是为了确保文件系统不超过规定的接入点限制。

此操作需要 elasticfilesystem:CreateAccessPoint 操作的权限。

接入点可以在创建时标记。如果在创建操作中指定了标签,则 IAM 会对elasticfilesystem:TagResource操作执行额外的授权,以验证用户是否具备创建标签的权限。因此,您必须授予使用该访问的显式elasticfilesystem:TagResource权限。有关更多信息,请参阅在创建期间授予标记资源的权限

请求语法

POST /2015-02-01/access-points HTTP/1.1 Content-type: application/json { "ClientToken": "string", "FileSystemId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] }

URI 请求参数

该请求不使用任何 URI 参数。

请求正文

请求接受采用 JSON 格式的以下数据。

ClientToken

最多 64 个 ASCII 字符的字符串,Amazon EFS 使用该字符来确保创建等数。

类型:字符串

长度限制:最小长度为 1。最大长度为 64。

模式:.+

必需:是

FileSystemId

访问点提供的 EFS 文件系统的 ID。

类型:字符串

长度约束:最大长度为 128。

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

必需:是

PosixUser

操作系统用户和组应用于使用接入点发出的所有文件系统请求。

类型:PosixUser 对象

必需:否

RootDirectory

指定 Amazon EFS 文件系统上的目录,访问点将其作为您根目录,向使用该访问点的 NFS 客户端公开。使用该访问点的客户端客户端只能对根目录及之下目录的客户端进行访问。如果Path指定的 RootDirectory > 不存在,当客户端连接到访问点时,EFS 会创建它并在客户端连接到访问点时应用CreationInfo设置。指定时RootDirectory,必须提供Path、和CreationInfo

只有在您提供CreationInfo:OwnUid、OwnGID 以及相关目录权限的情况下,Amazon EFS 才会创建根目录。如果您不提供此信息,Amazon EFS 不会创建根目录。如果根目录不存在,则使用接入点进行挂载的尝试将失败。

类型:RootDirectory 对象

必需:否

Tags

创建与访问点关联的标签。每个标签都是一个键值对,每个键都必须是唯一的。有关标签的更多信息,请参阅《Amazon 一般参考指南》中的标记 Amazon 资源

类型:Tag 对象数组

必需:否

响应语法

HTTP/1.1 200 Content-type: application/json { "AccessPointArn": "string", "AccessPointId": "string", "ClientToken": "string", "FileSystemId": "string", "LifeCycleState": "string", "Name": "string", "OwnerId": "string", "PosixUser": { "Gid": number, "SecondaryGids": [ number ], "Uid": number }, "RootDirectory": { "CreationInfo": { "OwnerGid": number, "OwnerUid": number, "Permissions": "string" }, "Path": "string" }, "Tags": [ { "Key": "string", "Value": "string" } ] }

响应元素

如果此操作成功,则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回的以下数据。

AccessPointArn

与访问点关联的 Amazon 资源名称(ARN)

类型:字符串

长度约束:最大长度为 128。

模式:^arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}$

AccessPointId

接入点的 ID,由亚马逊 EFS 分配。

类型:字符串

长度约束:最大长度为 128。

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

ClientToken

请求中指定的不透明字符串,以确保幂等创建。

类型:字符串

长度限制:最小长度为 1。最大长度为 64。

模式:.+

FileSystemId

访问点应用到的 EFS 文件系统的 ID。

类型:字符串

长度约束:最大长度为 128。

模式:^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

LifeCycleState

确定接入点的生命周期阶段。

类型:字符串

有效值:creating | available | updating | deleting | deleted | error

Name

该访问点的名称。这是Name标签的值。

类型:字符串

OwnerId

标识拥有Amazon Web Services 账户该访问点资源的

类型:字符串

长度约束:最大长度为 14。

模式:^(\d{12})|(\d{4}-\d{4}-\d{4})$

PosixUser

访问点上的完整 POSIX 身份,包括用户 ID、组 ID 和辅助组 ID,由使用访问点的 NFS 客户端用于所有文件操作。

类型:PosixUser 对象

RootDirectory

Amazon EFS 文件系统上的目录,访问点将其作为根目录,向使用访问点的 NFS 客户端公开。

类型:RootDirectory 对象

Tags

与接入点相关的标签,以标签对象数组的形式呈现。

类型:Tag 对象数组

错误

AccessPointAlreadyExists

如果您尝试创建的接入点已经存在,且使用您在请求中提供的创建令牌,则返回。

HTTP 状态代码:409

AccessPointLimitExceeded

如果Amazon Web Services 账户已经创建了每个文件系统允许的最大访问点的数量,有关更多信息,请参阅https://docs.amazonaws.cn/efs/latest/ug/limits.html#limits-efs-resources-per-account-per-region

HTTP 状态代码:403

BadRequest

如果请求格式错误或包含错误,例如参数值无效或缺少必需参数,则返回。

HTTP 状态代码:400

FileSystemNotFound

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

HTTP 状态代码:404

IncorrectFileSystemLifeCycleState

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

HTTP 状态代码:409

InternalServerError

如果服务器端出现错误,则返回。

HTTP 状态代码:500

ThrottlingException

当调CreateAccessPoint用 API 操作的速度过快且文件系统上的接入点数量接近 120 的限制时返回。

HTTP 状态代码:429

另请参阅

有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: