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

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

DescribeMountTargets

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

此操作需要elasticfilesystem:DescribeMountTargets操作,针对您在中指定的文件系统 IDFileSystemId,或者在中指定的装载目标的文件系统上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 的更多信息,请参阅以下内容: