获取磁盘分区信息（容量、使用率、inode、文件系统类型）

获取服务器磁盘分区信息。自动过滤 /boot、/dev/shm、/proc、Docker overlay、snap 等非核心分区。

POST

https://your-panel.example.com:8888/system

更新于 2026年7月10日查看 Markdown

Request bodyX-WWW-FORM-URLENCODEDrequired

request_timestringrequired
Unix 时间戳。
request_tokenstringrequired
按 API 概览生成的签名。
actionGetDiskInforequired
具体操作名称。

Returns

default

接口响应，业务状态见下方详细说明。

JSON

pathoptionalstring
挂载路径，如 /、/www
sizeoptionalstring
[总大小, 已用, 可用, 使用率%, 已用(inode), 剩余]
filesystemoptionalstring
设备名，如 /dev/sda1
typeoptionalstring
文件系统类型，如 ext4、xfs
inodesoptionalstring
[总inode数, 已用, 剩余, 使用率%]
byte_sizeoptionalstring
[总字节, 已用字节, 剩余字节]
d_sizeoptionalstring
物理磁盘大小，云环境可能为 None

各操作详细说明

GetDiskInfoaction=GetDiskInfo获取磁盘分区信息（容量、使用率、inode、文件系统类型）

获取服务器磁盘分区信息。自动过滤 /boot、/dev/shm、/proc、Docker overlay、snap 等非核心分区。

路由：POST /system
action：GetDiskInfo

输入参数

除公共参数外无需额外参数。

参数名称	必选	类型	描述
action	是	String	固定值 `GetDiskInfo`

输出参数

返回磁盘分区数组，每项包含：

参数名称	类型	描述
path	String	挂载路径，如 `/`、`/www`
size	Array[String]	`[总大小, 已用, 可用, 使用率%, 已用(inode), 剩余]`
filesystem	String	设备名，如 `/dev/sda1`
type	String	文件系统类型，如 `ext4`、`xfs`
inodes	Array[String]	`[总inode数, 已用, 剩余, 使用率%]`
byte_size	Array[Integer]	`[总字节, 已用字节, 剩余字节]`
d_size	String	物理磁盘大小，云环境可能为 `None`

示例

请求

POST /system HTTP/1.1
Host: 192.168.168.213:8888
Content-Type: application/x-www-form-urlencoded

request_time=1700000000&request_token=xxx&action=GetDiskInfo

响应

[{
    "path": "/",
    "size": ["19.5 GB", "4.8 GB", "13.8 GB", "26.00%", "859.4 MB", "4.8"],
    "filesystem": "/dev/sda1",
    "type": "ext4",
    "inodes": [1302528, 107216, 1195312, "8.23 %"],
    "byte_size": [20922114048, 5204590592, 14816325632],
    "d_size": "None"
}]

curl --request POST \ --url "https://your-panel.example.com:8888/system" \ --header "Content-Type: application/x-www-form-urlencoded" \ --data-urlencode "request_time=<Unix时间戳>" \ --data-urlencode "request_token=<按 API 概览生成的签名>" \ --data-urlencode "action=GetDiskInfo"

[ { "path": "/", "size": [ "19.5 GB", "4.8 GB", "13.8 GB", "26.00%", "859.4 MB", "4.8" ], "filesystem": "/dev/sda1", "type": "ext4", "inodes": [ 1302528, 107216, 1195312, "8.23 %" ], "byte_size": [ 20922114048, 5204590592, 14816325632 ], "d_size": "None" } ]