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

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

CreateAccessPoint

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

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

请求语法

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 用于确保幂等创建。

类型: String

长度约束:最小长度为 1。最大长度为 64。

模式:.+

:必需 是

FileSystemId

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

类型: String

长度约束:长度上限为 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 客户端公开。使用访问点的客户端只能访问根目录及以下目录。如果RootDirectory >Path指定的不存在,EFS 会创建它并应用CreationInfo客户端连接到接入点时的设置。当指定RootDirectory,您需要提供Path,以及CreationInfo.

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

类型:RootDirectory 对象

:必需 否

Tags

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

类型: 数组Tagobjects

:必需 否

响应语法

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)。

类型: String

长度约束:长度上限为 128。

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

AccessPointId

Amazon EFS 分配的访问点的 ID。

类型: String

长度约束:长度上限为 128。

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

ClientToken

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

类型: String

长度约束:最小长度为 1。最大长度为 64。

模式:.+

FileSystemId

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

类型: String

长度约束:长度上限为 128。

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

LifeCycleState

标识接入点的生命周期阶段。

类型: String

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

Name

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

类型: String

OwnerId

已识别Amazon Web Services 账户拥有访问点资源。

类型: String

长度约束:长度上限为 14。

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

PosixUser

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

类型:PosixUser 对象

RootDirectory

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

类型:RootDirectory 对象

Tags

与接入点关联的标签,以标签对象的数组形式显示。

类型: 数组Tagobjects

Errors

AccessPointAlreadyExists

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

HTTP 状态代码:409

AccessPointLimitExceeded

寄回,如果Amazon Web Services 账户已创建了每个文件系统允许的最大访问点数。

HTTP 状态代码:403

BadRequest

如果请求格式不正确或包含错误,例如无效的参数值或缺少必需参数,则返回此选项。

HTTP 状态代码:400

FileSystemNotFound

返回指定的FileSystemId请求者中不存在该值Amazon Web Services 账户.

HTTP 状态代码:404

IncorrectFileSystemLifeCycleState

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

HTTP 状态代码:409

InternalServerError

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

HTTP 状态代码:500

另请参阅

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