Queries mounted clients.

Description

This operation returns the clients that have accessed the specified file system within the last minute. If the file system is mounted on a client but the client did not access the file system within the last minute, the client is not included in the returned information.

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 DescribeMountedClients

The operation that you want to perform.

Set the value to DescribeMountedClients.
RegionId String Yes cn-hangzhou

The ID of the region.

PageSize Integer No 10

The number of IP addresses to return on each page.

Valid values: 1 to 100.

Default value: 10.
FileSystemId String Yes 31a8e4****

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.
ClientIP String No 10.10.10.1

The IP addresses of the client.

  • If you specify an IP address, the operation checks whether the client list includes this IP address. If the client list includes the IP address, the operation returns the IP address. If the client list does not include the IP address, the operation returns an empty list.
  • If you do not specify an IP address, the operation returns the IP addresses of all clients that have accessed the specified NAS file system within the last minute.
MountTargetDomain String Yes 1111222****95.cn-hangzhou.nas.aliyuncs.com

The mount target.

PageNumber Integer No 1

The number of the page to return.

Pages start from page 1. Default value: 1.

Response parameters

Parameter Type Example Description
TotalCount Integer 10

The total number of IP addresses.

RequestId String A70BEE5D-76D3-49FB-B58F-1F398211****

The ID of the request.

PageSize Integer 10

The number of IP addresses returned per page.

PageNumber Integer 1

The page number of the returned page.

Clients Array of Client

The list of clients.

Client
ClientIP String 10.10.10.1

The IP addresses of the client.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeMountedClients
&FileSystemId=109c****66
&MountTargetDomain=1111222****95.cn-hangzhou.nas.aliyuncs.com
&RegionId=cn-hangzhou
&<Common request parameters>

Sample success responses

XML format

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

<DescribeMountedClientsResponse>
    <TotalCount>10</TotalCount>
    <PageSize>10</PageSize>
    <RequestId>A70BEE5D-76D3-49FB-B58F-1F398211****</RequestId>
    <PageNumber>1</PageNumber>
    <Clients>
        <Client>
            <ClientIP>10.10.10.1</ClientIP>
        </Client>
    </Clients>
</DescribeMountedClientsResponse>

JSON format

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

{
  "TotalCount" : 10,
  "PageSize" : 10,
  "RequestId" : "A70BEE5D-76D3-49FB-B58F-1F398211****",
  "PageNumber" : 1,
  "Clients" : {
    "Client" : [ {
      "ClientIP" : "10.10.10.1"
    } ]
  }
}

Error codes

For a list of error codes, see Service error codes.