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

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

DescribeMountTargets

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

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

请求语法

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

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

HTTP 状态代码：404

BadRequest

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

HTTP 状态代码：400

FileSystemNotFound

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

HTTP 状态代码：404

InternalServerError

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

HTTP 状态代码：500

MountTargetNotFound

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

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 软件开发工具包中使用此 API 的更多信息，请参阅以下内容：