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

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

DescribeAccessPoints

返回特定 Amazon EFS 接入点的描述,如果AccessPointId已提供。如果你提供 EFSFileSystemId,它返回该文件系统的所有接入点的描述。你可以提供AccessPointId或者FileSystemId在请求中,但不是两者兼而有。

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