最近更新时间：2025-03-06 17:57:08
本接口（DescribeFileSystemClientInfo）用于查询特定文件系统的客户端挂载信息。
GET
请求参数包含公共请求参数和接口请求参数。其中，公共请求参数是每个接口都会用到的请求参数，具体参见公共参数及签名机制；接口请求参数是各个接口所特有的，具体参见下方说明：
请求头
名称 | 是否必须 | 值 |
|---|---|---|
Accept | 是 | application/json |
请求体
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
FileSystemId | string | 是 | 文件系统的实例ID。 |
HostNamePrefix | string | 否 | 客户端对应的主机名称前缀。 |
PageSize | number | 否 | 页码。默认为1。 |
PageNum | number | 否 | 分页大小。默认为10。 |
Action | string | 是 | 该参数为公共参数，取值：DescribeFileSystemClientInfo。 |
Version | string | 是 | 该参数为公共参数，取值：2024-09-30。 |
名称 | 类型 | 描述 |
|---|---|---|
RequestId | string | 唯一请求ID，每次请求都会返回。 |
Data | object[] | 客户端数据信息。 |
— HostName | string | 客户端所在主机名。仅容量Ⅰ型、容量Ⅱ型、标准型返回。 |
— Ip | string | 客户端所在主机IP。 |
— MountPoint | string | 客户端挂载点。仅容量Ⅰ型、容量Ⅱ型、标准型返回。 |
— Version | string | 客户端版本。仅容量Ⅰ型、容量Ⅱ型、标准型返回。 |
— FileHandles | number | 客户端文件句柄数。仅容量Ⅰ型、容量Ⅱ型、标准型返回。 |
— RunningTime | number | 客户端运行时间，单位：s。仅容量Ⅰ型、容量Ⅱ型、标准型返回。 |
— CacheGroup | string | 客户端所在缓存组。仅容量Ⅰ型、容量Ⅱ型、标准型返回。 |
— ClientId | string | 客户端ID。仅性能Ⅰ型返回。 |
PageNum | number | 分页大小。 |
PageSize | number | 页码。 |
TotalCount | number | 文件系统的客户端总数量。 |
请求示例
http://kpfs.api.ksyun.com?FileSystemId=301c1d57a1b14aadbb34ffccbf25369e&HostNamePrefix=vm&PageNum=1&PageSize=5&Action=DescribeFileSystemClientInfo&Version=2024-09-30返回示例
{
"RequestId": "ea82d72e-0169-4970-8beb-92d3a10964d7",
"Data": [
{
"HostName": "vm10-0-0-84",
"Ip": "10.241.102.240",
"MountPoint": "/train-data1",
"FileHandles": 0,
"Version": "5.0.21",
"CacheGroup":"my-group",
"RunningTime": 710
},
{
"HostName": "vm10-0-0-85",
"Ip": "10.241.102.241",
"MountPoint": "/train-data2",
"FileHandles": 0,
"Version": "5.0.21",
"CacheGroup":"my-group",
"RunningTime": 810
}
],
"PageSize":5,
"PageNum":1,
"TotalCount":2
}纯净模式
