DescribeAccessPoints - Amazon Elastic File System
请求语法URI 请求参数请求正文响应语法响应元素错误另请参阅
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

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

DescribeAccessPoints

返回特定 Amazon EFS 接入点的描述（如果提供 AccessPointId）。如果提供 EFS FileSystemId，它将返回该文件系统的所有接入点描述。可以在请求中提供 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

如果请求者的 Amazon Web Services 账户中不存在指定的 AccessPointId 值，则返回此内容。

HTTP 状态代码：404

BadRequest

如果请求格式错误或包含错误（例如参数值无效或缺少必填参数），则返回此内容。

HTTP 状态代码：400

FileSystemNotFound

如果请求者的 Amazon Web Services 账户中不存在指定的 FileSystemId 值，则返回此内容。

HTTP 状态代码：404

InternalServerError

如果服务器端发生错误，则返回此内容。

HTTP 状态代码：500

另请参阅

有关在特定语言的 Amazon SDK 中使用此 API 的更多信息，请参阅以下内容：