最近更新时间：2025-01-03 14:01:31
本接口用于查询特定文件系统的监控数据。
GET
请求参数包含公共请求参数和接口请求参数。其中，公共请求参数是每个接口都会用到的请求参数，具体参见公共参数及签名机制；接口请求参数是各个接口所特有的，具体参见下方说明：
请求头
名称 | 是否必须 | 值 |
|---|---|---|
Accept | 是 | application/json |
请求体
名称 | 类型 | 是否必须 | 描述 |
|---|---|---|---|
FileSystemId | string | 是 | 文件系统的实例ID。 |
StartTime | string | 是 | 监控数据开始时间。格式为：时间戳，如：1732204800。 |
EndTime | string | 是 | 监控数据截止时间。格式为：时间戳，如：1734797100。 |
Interval | string | 是 | 监控数据统计颗粒度。有效值：1m、5m、10m、1h、1d。 （EndTime-StartTime）/ Interval 必须 ≤ 6000，否则接口会拦截报错。 |
ClientNm | string | 否 | 客户端挂载信息。拼接规则为：HostName:MountPoint，如：vm10-0-0-116:/datapoint。请参见查询文件系统客户端信息。 |
Action | string | 是 | 该参数为公共参数，本接口取值如下： 文件系统级统计项：
客户端级统计项：根据ClientNm筛选，若未传入ClientNm，则返回文件系统级数据。
|
Version | string | 是 | 该参数为公共参数，取值：2024-09-30。 |
名称 | 类型 | 是否必返回 | 描述 |
|---|---|---|---|
RequestId | string | 是 | 唯一请求ID，每次请求都会返回。 |
Data | object[] | 是 | 监控数据信息。 |
— Time | number | 是 | 时间戳。如：1732204800。 |
— Value | number | 是 | 数据值。返回null代表该时间点无数据。 |
请求示例（以查询文件系统使用量情况为例）
http://kpfs.api.ksyun.com?FileSystemId=301c1d57a1b14aadbb34ffccbf25369e&StartTime=1732204800&EndTime=1734797100&Interval=1m&Action=GetTotalSize&Version=2024-09-30返回示例
{
"RequestId": "ea82d72e-0169-4970-8beb-92d3a10964d7",
"Data": [
{
"Time": 1732204800,
"Value": 1,
},
{
"Time": 1734796860,
"Value": 2,
},
{
"Time": 1734796920,
"Value": 3,
},
{
"Time": 1734796980,
"Value": 4,
},
{
"Time": 1734797040,
"Value": 5,
},
{
"Time": 1734797100,
"Value": 5,
}
]
}纯净模式
