Queries the information of mount targets.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeMountTargets

The operation that you want to perform.

Set the value to DescribeMountTargets.

FileSystemId String Yes 1ca404****

The ID of the file system.

  • Sample ID of a General-purpose NAS file system: 31a8e4****.
  • The IDs of Extreme NAS file systems must start with extreme-. Example: extreme-0015****.
  • The IDs of CPFS file systems must start with cpfs-. Example: cpfs-125487****.
MountTargetDomain String No 1ca404a666-x****.cn-hangzhou.nas.aliyuncs.com

The domain name of the mount target.

PageSize Integer No 1

The number of entries to return on each page.

Valid values: 1 to 100.

Default value: 10.

PageNumber Integer No 1

The number of the page to return.

Minimum value: 1. Default value: 1.

DualStackMountTargetDomain String No 174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com

The dual-stack domain name of the mount target.

Note Only Extreme NAS file systems that reside in the Chinese mainland support IPv6.

Response parameters

Parameter Type Example Description
TotalCount Integer 1

The total number of mount targets.

RequestId String 3BAB90FD-B4A0-48DA-9F09-2B963510****

The ID of the request.

PageSize Integer 1

The number of entries returned per page.

PageNumber Integer 1

The page number of the returned page.

MountTargets Array of MountTarget

The list of mount targets.

MountTarget
VpcId String vpc-2zesj9afh3y518k9o****

The ID of the virtual private cloud (VPC).

Status String Active

The status of the mount target.

Valid values:

  • Active: The mount target is available.
  • Inactive: The mount target is unavailable.
  • Pending: The mount target is being created or modified.
  • Deleting: The mount target is being deleted.
Note You can mount a file system only if the mount target of the file system is in the Active state.
ClientMasterNodes Array of ClientMasterNode

The list of clients in the management node.

ClientMasterNode
EcsId String i-hp3i3odi5ory1buo****

The ID of the ECS instance in the management node.

DefaultPasswd String 12****

The default logon password of the ECS instance in the management node.

EcsIp String 192.168.1.0

The IP address of the ECS instance in the management node.

MountTargetDomain String 1ca404a666-w****.cn-hangzhou.nas.aliyuncs.com

The IPv4 domain name of the mount target.

AccessGroup String DEFAULT_VPC_GROUP_NAME

The name of the permission group that is attached to the mount target.

DualStackMountTargetDomain String 174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com

The dual-stack domain name of the mount target.

VswId String vsw-2zevmwkwyztjuoffg****

The ID of the vSwitch.

NetworkType String Vpc

The network type.

Valid values:

  • Vpc: VPC
  • Classic: the classic network
IPVersion String IPv4

The type of the mount target.

  • IPv4: an IPv4 mount target
  • DualStack: a dual-stack mount target

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeMountTargets
&FileSystemId=1ca404****
&MountTargetDomain=1ca404a666-x****.cn-hangzhou.nas.aliyuncs.com
&PageSize=1
&PageNumber=1
&DualStackMountTargetDomain=174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com
&Common request parameters

Sample success responses

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeMountTargetsResponse>
    <TotalCount>1</TotalCount>
    <RequestId>3BAB90FD-B4A0-48DA-9F09-2B963510****</RequestId>
    <PageSize>1</PageSize>
    <PageNumber>1</PageNumber>
    <MountTargets>
        <VpcId>vpc-2zesj9afh3y518k9o****</VpcId>
        <Status>Active</Status>
        <ClientMasterNodes>
            <EcsId>i-hp3i3odi5ory1buo****</EcsId>
            <DefaultPasswd>12****</DefaultPasswd>
            <EcsIp>192.168.1.0</EcsIp>
        </ClientMasterNodes>
        <MountTargetDomain>1ca404a666-w****.cn-hangzhou.nas.aliyuncs.com</MountTargetDomain>
        <AccessGroup>DEFAULT_VPC_GROUP_NAME</AccessGroup>
        <DualStackMountTargetDomain>174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com</DualStackMountTargetDomain>
        <VswId>vsw-2zevmwkwyztjuoffg****</VswId>
        <NetworkType>Vpc</NetworkType>
        <IPVersion>IPv4</IPVersion>
    </MountTargets>
</DescribeMountTargetsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "TotalCount" : 1,
  "RequestId" : "3BAB90FD-B4A0-48DA-9F09-2B963510****",
  "PageSize" : 1,
  "PageNumber" : 1,
  "MountTargets" : [ {
    "VpcId" : "vpc-2zesj9afh3y518k9o****",
    "Status" : "Active",
    "ClientMasterNodes" : [ {
      "EcsId" : "i-hp3i3odi5ory1buo****",
      "DefaultPasswd" : "12****",
      "EcsIp" : "192.168.1.0"
    } ],
    "MountTargetDomain" : "1ca404a666-w****.cn-hangzhou.nas.aliyuncs.com",
    "AccessGroup" : "DEFAULT_VPC_GROUP_NAME",
    "DualStackMountTargetDomain" : "174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com",
    "VswId" : "vsw-2zevmwkwyztjuoffg****",
    "NetworkType" : "Vpc",
    "IPVersion" : "IPv4"
  } ]
}

Error codes

HttpCode Error code Error message Description
400 InvalidFileSystem.NotsupportedIPv6 The file system does not support IPv6. The error message returned because the file system does not support IPv6.
404 InvalidMountTarget.NotFound The specified mount target does not exist. The error message returned because the specified mount target does not exist.
404 InvalidFileSystem.NotFound The specified file system does not exist. The error message returned because the specified file system does not exist.

For a list of error codes, visit the API Error Center.