本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
-
如果请求者的指定
AccessPointId
值不存在,则返回。 AWS 账户HTTP状态码:404
- BadRequest
-
如果请求格式错误或包含错误(例如参数值无效或缺少必填参数),则返回此内容。
HTTP状态码:400
- FileSystemNotFound
-
如果请求者的指定
FileSystemId
值不存在,则返回。 AWS 账户HTTP状态码:404
- InternalServerError
-
如果服务器端发生错误,则返回此内容。
HTTP状态码:500
- MountTargetNotFound
-
如果在调用者的 AWS 账户中未找到具有指定 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"
}
]
}
另请参阅
有关在特定语言API中使用它的更多信息 AWS SDKs,请参阅以下内容: