v1

latestOpenAPI 3.0.0Apache 2.0 License2026-07-1430147146.7 KB

Returns the descriptions of all the current mount targets, or a specific mount target, for a file system. When requesting all of the current mount targets, the order of mount targets returned in the response is unspecified.

This operation requires permissions for the elasticfilesystem:DescribeMountTargets action, on either the file system ID that you specify in FileSystemId, or on the file system of the mount target that you specify in MountTargetId.

get/2015-02-01/mount-targets

Query parameters

MaxItemsinteger

(Optional) Maximum number of mount targets to return in the response. Currently, this number is automatically set to 10, and other values are ignored. The response is paginated at 100 per page if you have more than 100 mount targets.

Markerstring

(Optional) Opaque pagination token returned from a previous <code>DescribeMountTargets</code> operation (String). If present, it specifies to continue the list from where the previous returning call left off.

FileSystemIdstring

(Optional) ID of the file system whose mount targets you want to list (String). It must be included in your request if an <code>AccessPointId</code> or <code>MountTargetId</code> is not included. Accepts either a file system ID or ARN as input.

MountTargetIdstring

(Optional) ID of the mount target that you want to have described (String). It must be included in your request if <code>FileSystemId</code> is not included. Accepts either a mount target ID or ARN as input.

AccessPointIdstring

(Optional) The ID of the access point whose mount targets that you want to list. It must be included in your request if a <code>FileSystemId</code> or <code>MountTargetId</code> is not included in your request. Accepts either an access point ID or ARN as input.

Response

Success

Markerstring

If the request included the <code>Marker</code>, the response returns that value in this field.

NextMarkerstring

If a value is present, there are more mount targets to return. In a subsequent request, you can provide <code>Marker</code> in your request with this value to retrieve the next set of mount targets.

Example response

{
  "MountTargets": [
    {
      "FileSystemId": "fs-01234567",
      "IpAddress": "192.0.0.2",
      "LifeCycleState": "available",
      "MountTargetId": "fsmt-12340abc",
      "NetworkInterfaceId": "eni-cedf6789",
      "OwnerId": 12345678912,
      "SubnetId": "subnet-1234abcd"
    }
  ]
}