DescribeAccessPoints - Amazon Elastic File System
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅
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 的更多信息，请参阅以下内容：