All Products
Search
Document Center

Apsara File Storage NAS:DescribeMountTargets

Last Updated:Mar 14, 2024

Queries mount targets.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer.

Authorization information

There is currently no authorization information disclosed in the API.

Request parameters

ParameterTypeRequiredDescriptionExample
FileSystemIdstringYes

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-, for example, extreme-0015****.
  • The IDs of Cloud Parallel File Storage (CPFS) file systems must start with cpfs-, for example, cpfs-125487****.
Note CPFS file systems are available only on the China site (aliyun.com).
1ca404****
MountTargetDomainstringNo

The domain name of the mount target.

1ca404a666-x****.cn-hangzhou.nas.aliyuncs.com
PageSizeintegerNo

The number of entries per page.

Valid values: 1 to 100.

Default value: 10.

1
PageNumberintegerNo

The page number.

Pages start from page 1. Default value: 1.

1
DualStackMountTargetDomainstringNo

The dual-stack (IPv4 and IPv6) domain name of the mount target.

Note Only Extreme NAS file systems that reside in the Chinese mainland support IPv6.
174494b666-x****.dualstack.cn-hangzhou.nas.aliyuncs.com

Response parameters

ParameterTypeDescriptionExample
object
TotalCountinteger

The total number of mount targets.

1
RequestIdstring

The request ID.

3BAB90FD-B4A0-48DA-9F09-2B963510****
PageSizeinteger

The number of entries per page.

1
PageNumberinteger

The page number.

1
MountTargetsobject []

The information about mount targets.

VpcIdstring

The ID of the virtual private cloud (VPC).

vpc-2zesj9afh3y518k9o****
Statusstring

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 when the mount target of the file system is in the Active state.
Active
ClientMasterNodesobject []

The information about client management nodes.

EcsIdstring

The ID of the ECS instance on the client management node.

i-hp3i3odi5ory1buo****
DefaultPasswdstring

The default logon password of the ECS instance.

12****
EcsIpstring

The IP address of the ECS instance on the client management node.

192.168.1.0
MountTargetDomainstring

The IPv4 domain name of the mount target.

1ca404a666-w****.cn-hangzhou.nas.aliyuncs.com
AccessGroupstring

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

DEFAULT_VPC_GROUP_NAME
DualStackMountTargetDomainstring

The dual-stack (IPv4 and IPv6) domain name of the mount target.

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

The ID of the vSwitch.

vsw-2zevmwkwyztjuoffg****
NetworkTypestring

The network type. Valid value: Vpc.

Vpc
IPVersionstring

The type of the mount target.

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

Examples

Sample success responses

JSONformat

{
  "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

HTTP status codeError codeError messageDescription
400InvalidFileSystem.NotsupportedIPv6The file system does not support IPv6.The file system does not support IPv6.
404InvalidMountTarget.NotFoundThe specified mount target does not exist.The specified mount target does not exist.
404InvalidFileSystem.NotFoundThe specified file system does not exist.The specified file system does not exist.

For a list of error codes, visit the Service error codes.

Change history

Change timeSummary of changesOperation
2023-04-17The Error code has changedsee changesets
Change itemChange content
Error CodesThe Error code has changed.
    delete Error Codes: 400
    delete Error Codes: 404