DescribeMountTargets -

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 Cloud Parallel File Storage (CPFS) file systems must start with `cpfs-`. Example: cpfs-125487. Note** The value is available only on the Alibaba Cloud China site (aliyun.com).
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. Pages start from page 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 information about 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. Hibernating: The mount target is being hibernated. Hibernated: The mount target is hibernated. 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 information about client management nodes.
ClientMasterNode
EcsId	String	i-hp3i3odi5ory1buo****	The ID of the Elastic Compute Service (ECS) instance on the client management node.
DefaultPasswd	String	12****	The default logon password of the ECS instance.
EcsIp	String	192.168.1.0	The IP address of the ECS instance on the client 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 (IPv4 and IPv6) 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>
        <MountTarget>
            <VpcId>vpc-2zesj9afh3y518k9o****</VpcId>
            <Status>Active</Status>
            <ClientMasterNodes>
                <ClientMasterNode>
                    <EcsId>i-hp3i3odi5ory1buo****</EcsId>
                    <DefaultPasswd>12****</DefaultPasswd>
                    <EcsIp>192.168.1.0</EcsIp>
                </ClientMasterNode>
            </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>
        </MountTarget>
    </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" : {
    "MountTarget" : [ {
      "VpcId" : "vpc-2zesj9afh3y518k9o****",
      "Status" : "Active",
      "ClientMasterNodes" : {
        "ClientMasterNode" : [ {
          "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 Error Center.