文档首页/ 云搜索服务 CSS/ API参考/ API V1/ 集群管理/ 查询集群磁盘使用情况 - ShowClusterVolumeUsage
更新时间：2025-10-31 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询集群磁盘使用情况 - ShowClusterVolumeUsage

功能介绍

查询集群磁盘使用情况。

调用方法

请参见如何调用API。

授权信息

账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。

  • 如果使用角色与策略授权，具体权限要求请参见权限和授权项。
  • 如果使用身份策略授权，当前API调用无需身份策略权限。

URI

GET /v1.0/{project_id}/cluster/{cluster_id}/volume

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：

项目ID。获取方法请参见获取项目ID和名称。

约束限制：

不涉及

取值范围：

获取方法请参见获取项目ID和名称。

默认取值：

不涉及

cluster_id

是

String

参数解释：

指定更新的集群ID，获取方法请参见获取集群ID。

约束限制：

不涉及

取值范围：

获取方法请参见获取集群ID。

默认取值：

不涉及

请求参数

无

响应参数

状态码：200

表2 响应Body参数

参数

参数类型

描述

[数组元素]

Array of DiskInfoListRsp objects
表3 DiskInfoListRsp

参数

参数类型

描述

diskInfoList

Array of DiskInfo objects

参数解释：

各个节点磁盘使用量信息。

取值范围：

不涉及
表4 DiskInfo

参数

参数类型

描述

id

String

参数解释：

节点id。

取值范围：

不涉及

name

String

参数解释：

节点名称。

取值范围：

不涉及

diskCapacity

String

参数解释：

节点存储总量。

取值范围：

不涉及

diskUsed

String

参数解释：

节点已使用存储量。

取值范围：

不涉及

percentage

String

参数解释：

节点存储使用率。

取值范围：

不涉及

请求示例

查询集群中各个节点的磁盘使用情况。

GET https://{Endpoint}/v1.0/{project_id}/cluster/{cluster_id}/volume

响应示例

状态码：200

查询集群中各个节点的磁盘使用情况返回值。

{
  "diskInfoList" : [ {
    "percentage" : "5.16",
    "diskCapacity" : "97.86",
    "diskUsed" : "5.05",
    "id" : "700915c3-15da-455f-9a6e-8b853b8665ac",
    "name" : "css-9062-ess-esn-1-1"
  } ]
}

状态码

状态码

描述

200

查询集群中各个节点的磁盘使用情况返回值。

错误码

请参见错误码。

父主题： 集群管理

相关文档