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

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

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 的更多信息,请参阅以下内容: