本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 的更多信息,请参阅以下内容: