本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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 的更多信息,请参阅以下内容: