本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
DescribeAccessPoints
返回特定 Amazon EFS 接入点的描述(AccessPointId
如果提供)。如果您提供 EFSFileSystemId
,它将返回该文件系统的所有接入点的描述。您可以在请求FileSystemId
中提供 aAccessPointId
或 a,但不能同时提供两者。
此操作需要 elasticfilesystem:DescribeAccessPoints
操作的权限。
请求语法
GET /2015-02-01/access-points?AccessPointId=AccessPointId
&FileSystemId=FileSystemId
&MaxResults=MaxResults
&NextToken=NextToken
HTTP/1.1
URI 请求参数
请求使用以下 URI 参数。
- AccessPointId
-
(可选)指定要在响应中描述的 EFS 接入点;与互不相容
FileSystemId
。长度约束:最大长度为 128。
模式:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$
- FileSystemId
-
(可选)如果您提供
FileSystemId
,则 EFS 将返回该文件系统的所有接入点;互不相容AccessPointId
。长度约束:最大长度为 128。
模式:
^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$
- MaxResults
-
(可选)在检索文件系统的所有访问点时,您可以选择指定
MaxItems
参数以限制响应中返回的对象数量。默认值为 100。有效范围:最小值为 1。
- NextToken
-
NextToken
如果对响应进行了分页,则存在。您可以在后续请求NextMarker
中使用来提取下一页接入点描述。长度限制:最小长度为 1。最大长度为 128。
模式:
.+
请求正文
该请求没有请求体。
响应语法
HTTP/1.1 200
Content-type: application/json
{
"AccessPoints": [
{
"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"
}
]
}
],
"NextToken": "string"
}
响应元素
如果此操作成功,则该服务将会发送回 HTTP 200 响应。
服务以 JSON 格式返回的以下数据。
- AccessPoints
-
一系列接入点描述。
类型:AccessPointDescription 对象数组
- NextToken
-
如果接入点多于响应中返回的接入点,则显示。您可以在后续请求 NextMarker 中使用来提取其他描述。
类型:字符串
长度限制:最小长度为 1。最大长度为 128。
模式:
.+
错误
- AccessPointNotFound
-
如果请求者的指定
AccessPointId
值不存在,则返回Amazon Web Services 账户。HTTP 状态代码:404
- BadRequest
-
如果请求格式错误或包含错误(例如参数值无效或缺少必需参数),则返回。
HTTP 状态代码:400
- FileSystemNotFound
-
如果请求者的指定
FileSystemId
值不存在,则返回Amazon Web Services 账户。HTTP 状态代码:404
- InternalServerError
-
如果服务器端发生错误,则返回。
HTTP 状态代码:500
另请参阅
有关在特定语言的 Amazon 软件开发工具包中使用此 API 的更多信息,请参阅以下内容: