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

请求语法

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 响应参数diskPaths说明”。
defaultPath	String	默认的数据目录（仅单机版支持）。
recentStartTime	Long	HBlock服务在该节点上最近一次成功启动的时间。服务器未连接时，不返回此项。
ports	Array of port	HBlock端口的集合，详见“表3 响应参数ports说明”。
portRange	String	端口范围。
iSCSIPort	Integer	iSCSI端口。
storagePorts	Array of storagePort	存储服务端口集合（仅集群版支持），详见“表4 响应参数storagePorts说明”。
nodeName	String	节点名称（仅集群版支持）。
parentName	String	父节点名称（仅集群版支持）。
description	String	节点描述（仅集群版支持）。
baseServices	Array of baseService	基础服务属性的集合（仅集群版基础服务器支持），详见“表5 响应参数baseService说明”。

表1 响应参数targetPortalIP.ip说明

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

表2 响应参数diskPaths说明

名称	类型	描述
path	String	HBlock数据目录。
totalCapacity	Long	当前HBlock数据目录对应分区的总容量，单位是字节。
usedCapacity	Long	服务器上HBlock数据目录对应分区的已用容量，单位是字节。
usedCapacityQuota	Long	HBlock在该数据目录的已写入量，即已用容量配额。单位是字节。
capacityQuota	Long	数据目录的容量配额。单位是字节。 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对这个目录停写。 Error：数据目录错误状态，无法访问，原因可能是：所在磁盘出现I/O错误导致无法读写，数据目录未正确挂载等。
healthDetail	String	数据目录健康状态详情：如果健康状态为Healthy，此字段为空。如果健康状态为Warning或Error，显示警告或错误的详细信息。

表3 响应参数ports说明

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

表4 响应参数storagePorts说明

名称	类型	描述
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: Tue, 14 Jan 2025 08:45:46 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.32:1443

响应示例1

HTTP/1.1 200 OK 
x-hblock-request-id: 1bc58ab26322494fb2d2e6a5837f6193
Connection: keep-alive
Content-Length: 794
Date: Tue, 14 Jan 2025 08:45:46 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "serverName": "ecs-9689-0915127",
        "serverId": "hblock_1",
        "status": "Connected",
        "version": "3.8.0",
        "publicAddress": {
            "ip": "192.168.0.32",
            "port": 3260
        },
        "clusterAddress": {
            "ip": "192.168.0.32",
            "port": 20004
        },
        "diskPaths": [
            {
                "path": "/mnt/stor",
                "usedCapacity": 35861303296,
                "totalCapacity": 100169342976,
                "usedCapacityQuota": 356576,
                "managementStatus": "Added",
                "healthStatus": "Healthy",
                "healthDetail": []
            }
        ],
        "defaultPath": "/mnt/stor",
        "recentStartTime": 1735873608983,
        "ports": [
            {
                "portName": "apiPort",
                "port": 1443
            },
            {
                "portName": "webPort",
                "port": 2443
            },
            {
                "portName": "managementPort1",
                "port": 20004
            },
            {
                "portName": "managementPort2",
                "port": 20000
            },
            {
                "portName": "managementPort3",
                "port": 20002
            },
            {
                "portName": "managementPort4",
                "port": 20003
            },
            {
                "portName": "managementPort6",
                "port": 20001
            }
        ],
        "portRange": "20000-20500",
        "iSCSIPort": 3260
    }
}

请求示例2

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

GET /rest/v1/system/server/hblock_2 HTTP/1.1
Date: Mon, 25 Nov 2024 09:29:43 GMT
Authorization: HBlock userName:signature
Host: 192.168.0.117:1443

响应示例2

HTTP/1.1 200 OK 
x-hblock-request-id: 23faa39b4637441194e988a0b40cf266
Connection: keep-alive
Content-Length: 1414
Date: Mon, 25 Nov 2024 09:29:43 GMT
Content-Type: application/json;charset=utf-8
Server: HBlock

{
    "data": {
        "serverName": "ecs-9689-0915142",
        "serverId": "hblock_2",
        "status": "Connected",
        "version": "3.8.0",
        "isMasterServer": false,
        "isBaseServer": true,
        "publicAddress": {
            "ip": "192.168.0.117",
            "port": 3260
        },
        "clusterAddress": {
            "ip": "192.168.0.117",
            "port": 20008
        },
        "diskPaths": [
            {
                "path": "/mnt/storage02",
                "storagePool": "default",
                "usedCapacity": 18030116864,
                "totalCapacity": 35963482112,
                "usedCapacityQuota": 69632,
                "managementStatus": "Added",
                "healthStatus": "Healthy",
                "healthDetail": []
            }
        ],
        "recentStartTime": 1732519209900,
        "ports": [
            {
                "portName": "apiPort",
                "port": 1443
            },
            {
                "portName": "webPort",
                "port": 2443
            },
            {
                "portName": "managementPort1",
                "port": 20008
            },
            {
                "portName": "managementPort2",
                "port": 20013
            },
            {
                "portName": "managementPort3",
                "port": 20004
            },
            {
                "portName": "managementPort4",
                "port": 20011
            },
            {
                "portName": "managementPort5",
                "port": 20000
            },
            {
                "portName": "managementPort6",
                "port": 20010
            },
            {
                "portName": "dataPort1",
                "port": 20002
            },
            {
                "portName": "metadataPort4",
                "port": 20005
            },
            {
                "portName": "metadataPort5",
                "port": 20001
            },
            {
                "portName": "metadataPort6",
                "port": 20006
            },
            {
                "portName": "metadataPort7",
                "port": 20012
            },
            {
                "portName": "metadataPort8",
                "port": 20007
            }
        ],
        "portRange": "20000-20500",
        "iSCSIPort": 3260,
        "storagePorts": [
            {
                "port1": 20003,
                "port2": 20014,
                "port3": 20009,
                "diskpath": "/mnt/storage02",
                "pathId": "1"
            }
        ],
        "nodeName": "default:hblock_2",
        "parentName": "default",
        "baseServices": [
            {
                "name": "ls",
                "status": "Up",
                "metaDir": "/mnt/storage02"
            },
            {
                "name": "cs",
                "status": "Up",
                "metaDir": "/mnt/storage02"
            }
        ]
    }
}

智算服务

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

查看所有产品

存储资源盘活系统

存储资源盘活系统

请求语法

请求参数

响应结果

请求示例1

响应示例1

请求示例2

响应示例2

活动

智算服务

应用商城

合作伙伴

开发者

支持与服务

了解天翼云

查看所有产品

存储资源盘活系统

存储资源盘活系统

请求语法

请求参数

响应结果

请求示例1

响应示例1

请求示例2

响应示例2