此操作用来查询指定服务器。

请求语法

GET /rest/v1/system/server/serverId HTTP/1.1
Date: date
Host: ip:port
Authorization: authorization

请求参数

参数	类型	描述	是否必须
serverId	String	要查询的服务器ID。如果未指定服务器ID，则查询所有服务器。	否

参数

类型

描述

是否必须

serverId

String

要查询的服务器ID。

如果未指定服务器ID，则查询所有服务器。

否

响应结果

名称	类型	描述
serverName	String	服务器名称。
serverId	String	服务器ID。
status	String	服务器状态： Connected：已连接。 Disconnected：未连接。 Removing：移除中。
version	String	服务器上的HBlock版本。
isMasterServer	Boolean	该服务器是否为Master节点： true：是。 false：否。
isBaseServer	Boolean	该服务器是否为基础节点： true：是。 false：否。
publicAddress.ip	String	业务网络的IP。
publicAddress.port	Integer	业务网络端口号。
clusterAddress.ip	String	集群网络的IP。
clusterAddress.port	Integer	集群网络端口号。
targetPortalIP.ips	Array of targetPortalIP.ip	iSCSI目标门户IP属性集合，详见“表1 响应参数targetPortalIP.ip说明”。
targetPortalIP.status	String	iSCSI目标门户IP状态： Enabled：启用状态。 Disabled：停用状态。
diskPaths	Array of diskPath	HBlock数据目录信息集合，详见“表2 响应参数diskPath说明”。
defaultPath	String	默认的数据目录（仅单机版支持）。
recentStartTime	Long	HBlock服务在该节点上最近一次成功启动的时间。服务器未连接时，不返回此项。
ports	Array of port	HBlock端口的集合，详见“表3 响应参数port说明”。
portRange	String	端口范围。
iSCSIPort	Integer	iSCSI端口。
storagePorts	Array of storagePort	存储服务端口集合（仅集群版支持），详见“表4 响应参数storagePort说明”。
nodeName	String	节点名称（仅集群版支持）。
parentName	String	父节点名称（仅集群版支持）。
description	String	节点描述（仅集群版支持）。
baseServices	Array of baseService	基础服务属性的集合（仅集群版基础服务器支持），详见“表5 响应参数baseService说明”。
maxMemoryRatio	Double	HBlock可使用的内存占用系统总内存的比例上限。
maxMemorySize	Long	HBlock可使用的内存的最大值，单位是bytes。

表1 响应参数targetPortalIP.ip说明

名称	类型	描述
ip	String	iSCSI目标门户IP。
port	Integer	iSCSI目标门户端口号。

表2 响应参数diskPath说明

名称	类型	描述
path	String	HBlock数据目录。
storagePool	String	数据目录所属存储池（仅集群版支持）。
totalCapacity	Long	当前HBlock数据目录对应分区的总容量，单位是bytes。
usedCapacity	Long	服务器上HBlock数据目录对应分区的已用容量，单位是bytes。
usedCapacityQuota	Long	HBlock在该数据目录的已写入量，即已用容量配额。单位是bytes。
capacityQuota	Long	数据目录的容量配额。单位是bytes。 0表示禁止写入。不输出，表示没有限制。
managementStatus	String	数据目录管理状态： Added：数据目录已添加至系统中。 Removing：数据目录正在移除中。
subStatus.stage	String	移除数据目录所处的阶段： Reconfiguration：重置中。 CheckingData：检查数据。在该阶段，会同时显示下列字段的信息totalFD、healthyFD、warningFD、errorFD、safeData、reconstructionWaitData、availFDWaitData、singleCopyLUNData、corruptedData、具体告警信息（availFDWaitWarning、singleCopyLUNWarning或者corruptedWarning）。 Executing：执行移除数据目录
subStatus.totalFD	Integer	总的故障域个数。
subStatus.healthyFD	Integer	状态为Healthy的故障域个数。
subStatus.warningFD	Integer	状态为Warning的故障域个数。
subStatus.errorFD	Integer	状态为Error的故障域个数。
subStatus.safeData	Double	安全数据百分比，单位是%。
subStatus.reconstructionWaitData	Double	需要重建的数据百分比，单位是%。
subStatus.availFDWaitData	Double	移除磁盘或者服务器时，数据重建需要的故障域个数不足，因此引发的无法重建的数据百分比。
subStatus.singleCopyLUNData	Double	单副本数据百分比，单位是%。
subStatus.corruptedData	Double	已经损坏的数据百分比，单位是%。
subStatus.availFDWaitWarning	String	告警信息。根据状态不同，显示的告警信息不同： availFDWaitWarning：移除磁盘或者服务器时，数据重建需要的故障域个数不足。 singleCopyLUNWarning：单副本卷数据所在磁盘或者服务器被移除。 corruptedWarning：故障域异常导致数据损坏。
subStatus.singleCopyLUNWarning	String
subStatus.corruptedWarning	String
healthStatus	String	数据目录健康状态： Healthy：数据目录处于健康状态，可正常读写，且数据目录所在磁盘使用率未超过阈值（系统默认值为95%）。 Warning：数据目录处于警告状态，可读，但存在以下情况的任意一种：慢盘；数据目录所在磁盘使用率超过阈值（系统默认值为95%）；磁盘剩余空间不足1GiB；HBlock对这个目录停写；数据目录配额使用率超过阈值（系统默认值为95%）；数据目录配额为0。 Error：数据目录错误状态，无法访问，原因可能是：所在磁盘出现I/O错误导致无法读写，数据目录未正确挂载等。
healthDetail	Array of string	数据目录健康状态详情：如果健康状态为Healthy，此字段为空。如果健康状态为Warning或Error，显示警告或错误的详细信息。
dsId	String	数据目录对应的ds进程（仅集群版支持）。说明数据目录加入存储池后才会展示ds进程。

表3 响应参数port说明

名称	类型	描述
portName	String	HBlock端口名称。
port	Integer	HBlock在当前服务器上使用的端口号。

表4 响应参数storagePort说明

名称	类型	描述
portN	Integer	存储服务端口。
diskpath	String	存储服务的数据目录。
pathId	String	数据目录ID。

表5 响应参数baseService说明

名称	类型	描述
name	String	基础服务名称： mdm：元数据管理服务。 ls：日志服务。 cs：协调服务。
status	String	基础服务的状态： Up：可用。 Down：不可用。 Migrating：正在迁移。 Unkown：未知。
metaDir	String	存储基础服务数据的数据目录。

名称

类型

描述

name

String

基础服务名称：

mdm：元数据管理服务。
ls：日志服务。
cs：协调服务。

status

String

基础服务的状态：

Up：可用。
Down：不可用。
Migrating：正在迁移。
Unkown：未知。

metaDir

String

存储基础服务数据的数据目录。

请求示例1

单机版：查询服务器ID为hblock_1的信息。

GET /rest/v1/system/server/hblock_1 HTTP/1.1
Date: Sun, 04 Jan 2026 03:32:34 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.66:1443

响应示例1

HTTP/1.1 200 OK 
x-hblock-request-id: 5a8e4a8d99f742379829435b56692a09
Connection: keep-alive
Content-Length: 851
Date: Sun, 04 Jan 2026 03:32:34 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "serverName": "songt-005",
        "serverId": "hblock_1",
        "status": "Connected",
        "version": "4.0.0",
        "publicAddress": {
            "ip": "192.168.0.66",
            "port": 3260
        },
        "clusterAddress": {
            "ip": "192.168.0.66",
            "port": 20001
        },
        "diskPaths": [
            {
                "path": "/mnt/stor01",
                "usedCapacity": 2528108544,
                "totalCapacity": 100169342976,
                "usedCapacityQuota": 1096309995,
                "managementStatus": "Added",
                "healthStatus": "Healthy",
                "healthDetail": []
            }
        ],
        "defaultPath": "/mnt/stor01",
        "recentStartTime": 1767492674311,
        "ports": [
            {
                "portName": "apiPort",
                "port": 1443
            },
            {
                "portName": "webPort",
                "port": 2443
            },
            {
                "portName": "managementPort1",
                "port": 20001
            },
            {
                "portName": "managementPort2",
                "port": 20003
            },
            {
                "portName": "managementPort3",
                "port": 20000
            },
            {
                "portName": "managementPort4",
                "port": 20004
            },
            {
                "portName": "managementPort6",
                "port": 20002
            }
        ],
        "portRange": "20000-20500",
        "iSCSIPort": 3260,
        "maxMemoryRatio": 0.9,
        "maxMemorySize": 9223372036854775807
    }
}

请求示例2

集群版：查询服务器ID为hblock_1的信息。

GET /rest/v1/system/server/hblock_1 HTTP/1.1
Date: Thu, 05 Mar 2026 01:51:44 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.65:1443

响应示例2

 HTTP/1.1 200 OK 
x-hblock-request-id: 942ae9373c644438b176b3b8a2376134
Connection: keep-alive
Content-Length: 1905
Date: Thu, 05 Mar 2026 01:51:44 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "serverName": "songt-0004",
        "serverId": "hblock_1",
        "status": "Connected",
        "version": "4.0.0",
        "isMasterServer": true,
        "isBaseServer": true,
        "publicAddress": {
            "ip": "192.168.0.65",
            "port": 3260
        },
        "clusterAddress": {
            "ip": "192.168.0.65",
            "port": 20005
        },
        "targetPortalIP": {
            "ips": [
                {
                    "ip": "10.0.0.3",
                    "port": 3261
                }
            ],
            "status": "Enabled"
        },
        "diskPaths": [
            {
                "path": "/mnt/stor01",
                "storagePool": "default",
                "usedCapacity": 43635916800,
                "totalCapacity": 99703775232,
                "usedCapacityQuota": 43627483478,
                "managementStatus": "Added",
                "healthStatus": "Healthy",
                "healthDetail": [],
                "dsId": "ds-1"
            }
        ],
        "recentStartTime": 1772608577246,
        "ports": [
            {
                "portName": "apiPort",
                "port": 1443
            },
            {
                "portName": "webPort",
                "port": 2443
            },
            {
                "portName": "managementPort1",
                "port": 20005
            },
            {
                "portName": "managementPort2",
                "port": 20013
            },
            {
                "portName": "managementPort3",
                "port": 20002
            },
            {
                "portName": "managementPort4",
                "port": 20016
            },
            {
                "portName": "managementPort5",
                "port": 20003
            },
            {
                "portName": "managementPort6",
                "port": 20006
            },
            {
                "portName": "managementPort7",
                "port": 20007
            },
            {
                "portName": "dataPort1",
                "port": 20014
            },
            {
                "portName": "metadataPort1",
                "port": 20008
            },
            {
                "portName": "metadataPort2",
                "port": 20004
            },
            {
                "portName": "metadataPort3",
                "port": 20011
            },
            {
                "portName": "metadataPort4",
                "port": 20012
            },
            {
                "portName": "metadataPort5",
                "port": 20000
            },
            {
                "portName": "metadataPort6",
                "port": 20015
            },
            {
                "portName": "metadataPort7",
                "port": 20009
            },
            {
                "portName": "metadataPort8",
                "port": 20001
            },
            {
                "portName": "metadataPort9",
                "port": 20010
            }
        ],
        "portRange": "20000-20500",
        "iSCSIPort": 3260,
        "storagePorts": [
            {
                "port1": 20017,
                "port2": 20019,
                "port3": 20018,
                "diskpath": "/mnt/stor01",
                "pathId": "1"
            }
        ],
        "nodeName": "default:hblock_1",
        "parentName": "default",
        "baseServices": [
            {
                "name": "mdm",
                "status": "Up",
                "metaDir": "/mnt/storage01/CTYUN_HBlock_Plus_4.0.0_x64"
            },
            {
                "name": "ls",
                "status": "Up",
                "metaDir": "/mnt/storage01/CTYUN_HBlock_Plus_4.0.0_x64"
            },
            {
                "name": "cs",
                "status": "Up",
                "metaDir": "/mnt/storage01/CTYUN_HBlock_Plus_4.0.0_x64"
            }
        ],
        "maxMemoryRatio": 0.95,
        "maxMemorySize": 9223372036854775807
    }
}

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

存储资源盘活系统

存储资源盘活系统

请求语法

请求参数

响应结果

请求示例1

响应示例1

请求示例2

响应示例2

活动

息壤智算

应用商城

定价

合作伙伴

开发者

支持与服务

了解天翼云

存储资源盘活系统

存储资源盘活系统

请求语法

请求参数

响应结果

请求示例1

响应示例1

请求示例2

响应示例2