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

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

DescribeMountTargets

返回文件系统的所有当前挂载目标或特定挂载目标的描述。请求所有当前挂载目标时，未指定响应中返回的挂载目标顺序。

此操作需要对您在 FileSystemId 中指定的文件系统 ID，或您在 MountTargetId 中指定的挂载目标的文件系统拥有 elasticfilesystem:DescribeMountTargets 操作权限。

请求语法

GET /2015-02-01/mount-targets?AccessPointId=AccessPointId&FileSystemId=FileSystemId&Marker=Marker&MaxItems=MaxItems&MountTargetId=MountTargetId HTTP/1.1

URI 请求参数

请求使用以下 URI 参数。

AccessPointId

（可选）要列出其挂载目标的接入点 ID。如果请求中未包含 FileSystemId 或 MountTargetId，则必须将其包含在请求中。接受接入点 ID 或 ARN 作为输入。

长度限制：最大长度为 128。

模式：^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:access-point/fsap-[0-9a-f]{8,40}|fsap-[0-9a-f]{8,40})$

FileSystemId

（可选）要列出其挂载目标的文件系统 ID（字符串）。如果请求中未包含 AccessPointId 或 MountTargetId，则必须将其包含在请求中。接受文件系统 ID 或 ARN 作为输入。

长度限制：最大长度为 128。

模式：^(arn:aws[-a-z]*:elasticfilesystem:[0-9a-z-:]+:file-system/fs-[0-9a-f]{8,40}|fs-[0-9a-f]{8,40})$

Marker

（可选）从以前的 DescribeMountTargets 操作返回的不透明分页标记（字符串）。如果存在，则它指定从上一个返回的调用中断的位置继续列表。

长度约束：最小长度为 1。长度上限为 128。

模式：.+

MaxItems

（可选）要在响应中返回的挂载目标的最大数量。当前，此数字自动设置为 10，其他值被忽略。如果挂载目标超过 100 个，则响应按每页 100 项进行分页。

有效范围：最小值为 1。

MountTargetId

（可选）您要描述的挂载目标 ID（字符串）。如果请求中未包含 FileSystemId，则必须将其包含在请求中。接受挂载目标 ID 或 ARN 作为输入。

长度限制：最小长度为 13。最大长度为 45。

模式：^fsmt-[0-9a-f]{8,40}$

请求正文

该请求没有请求体。

响应语法

HTTP/1.1 200
Content-type: application/json

{
   "Marker": "string",
   "MountTargets": [ 
      { 
         "AvailabilityZoneId": "string",
         "AvailabilityZoneName": "string",
         "FileSystemId": "string",
         "IpAddress": "string",
         "LifeCycleState": "string",
         "MountTargetId": "string",
         "NetworkInterfaceId": "string",
         "OwnerId": "string",
         "SubnetId": "string",
         "VpcId": "string"
      }
   ],
   "NextMarker": "string"
}

响应元素

如果此操作成功，则该服务将会发送回 HTTP 200 响应。

服务以 JSON 格式返回以下数据。

Marker

如果请求包含 Marker，则响应会在此字段中返回该值。

类型：字符串

长度约束：最小长度为 1。长度上限为 128。

模式：.+

MountTargets

以 MountTargetDescription 对象数组的形式返回文件系统的挂载目标。

类型：MountTargetDescription 对象数组

NextMarker

如果存在值，则会返回更多挂载目标。在后续请求中，可以在请求中提供具有此值的 Marker 以检索下一组挂载目标。

类型：字符串

长度约束：最小长度为 1。长度上限为 128。

模式：.+

错误

AccessPointNotFound

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

HTTP 状态代码：404

BadRequest

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

HTTP 状态代码：400

FileSystemNotFound

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

HTTP 状态代码：404

InternalServerError

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

HTTP 状态代码：500

MountTargetNotFound

如果在调用者的 Amazon Web Services 账户中未找到具有指定 ID 的挂载目标，则返回此内容。

HTTP 状态代码：404

示例

检索为文件系统创建的挂载目标的描述

以下请求检索为指定文件系统创建的挂载目标的描述。

示例请求

GET /2015-02-01/mount-targets?FileSystemId=fs-01234567 HTTP/1.1
Host: elasticfilesystem.us-west-2.amazonaws.com
x-amz-date: 20140622T191252Z
Authorization: <...>

示例响应

HTTP/1.1 200 OK
x-amzn-RequestId: 01234567-89ab-cdef-0123-456789abcdef
Content-Type: application/json
Content-Length: 357

{
   "MountTargets":[
      {
         "OwnerId":"251839141158",
         "MountTargetId":"fsmt-01234567",
         "FileSystemId":"fs-01234567",
         "SubnetId":"subnet-01234567",
         "LifeCycleState":"added",
         "IpAddress":"10.0.2.42",
         "NetworkInterfaceId":"eni-1bcb7772"
      }
   ]
}

另请参阅

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