更新时间:2025-07-25 GMT+08:00
分享

查询服务器硬件详细信息

功能介绍

获取详细硬件信息

调用方法

请参见如何调用API

URI

GET /v1/{project_id}/physicalservers/{id}/hardware-attributes

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

参数解释

项目ID

约束限制

不涉及

取值范围

账号的项目ID

默认取值

不涉及

id

String

参数解释

服务器ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

String

参数解释

调用接口的认证方式分为Token,如果您使用的Token方式,此参数为必填,请填写Token的值

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

响应参数

状态码:200

表3 响应Body参数

参数

参数类型

描述

summary

HardwareSummary object

参数解释

硬件总览信息,包括服务器的制造商、型号、序列号等

约束限制

不涉及

memorys

Array of Memory objects

参数解释

内存详细信息列表

约束限制

不涉及

processors

Array of Processors objects

参数解释

CPU详细信息列表

约束限制

不涉及

network_adapters

Array of NetworkAdapter objects

参数解释

网络适配器详细信息列表

约束限制

不涉及

fans

Array of Fan objects

参数解释

风扇详细信息列表

约束限制

不涉及

powers

Array of Power objects

参数解释

电源详细信息列表

约束限制

不涉及

storage_controllers

Array of StorageController objects

参数解释

存储控制器详细信息列表

约束限制

不涉及

metrics

Array of HardwareMetric objects

参数解释

监控指标信息

约束限制

不涉及

表4 HardwareSummary

参数

参数类型

描述

sn

String

参数解释

serial number

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

manufacturer

String

参数解释

制造商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

model

String

参数解释

型号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

main_board_manufacturer

String

参数解释

主板厂商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表5 Memory

参数

参数类型

描述

name

String

参数解释

内存条名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

capacity_mib

Integer

参数解释

系统的总内存容量(单位:MiB)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

manufacturer

String

参数解释

制造商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

memory_device_type

String

参数解释

内存类型:DDR4/DDR6

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

allowed_speed_mhz

Integer

参数解释

主频(单位:MHz)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

operating_speed_mhz

Integer

参数解释

当前频率(单位:MHz)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

serial_number

String

参数解释

序列号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

health

String

参数解释

健康状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

state

String

参数解释

启用状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

rank_count

String

参数解释

Rank数量

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

data_width_bits

String

参数解释

数据带宽

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

part_number

String

参数解释

部件编号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

min_voltage_millivolt

String

参数解释

最小电压

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

bom_number

String

参数解释

Bom编码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

type_detail

String

参数解释

类型详细信息

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

technology

String

参数解释

技术

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

position

String

参数解释

位置

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表6 Processors

参数

参数类型

描述

name

String

参数解释

处理器名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

manufacturer

String

参数解释

制造商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

model

String

参数解释

处理器型号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

total_cores

Integer

参数解释

处理器的总核数

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

total_enabled_cores

String

参数解释

启用的核心数

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

total_threads

Integer

参数解释

处理器的总线程数

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

total_enabled_threads

String

参数解释

启用的总线程

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

socket

Integer

参数解释

处理器的插槽号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

max_speed_mhz

Integer

参数解释

处理器的最大主频(单位:MHz)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

temperature

Integer

参数解释

处理器的温度

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

l1_cache_kib

Integer

参数解释

一级缓存(单位:KiB)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

l2_cache_kib

Integer

参数解释

二级缓存(单位:KiB)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

l3_cache_kib

Integer

参数解释

三级缓存(单位:KiB)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

frequency_mhz

Integer

参数解释

处理器的主频

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

other_parameters

String

参数解释

其他参数

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

serial_number

String

参数解释

序列号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

health

String

参数解释

健康状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

state

String

参数解释

状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表7 NetworkAdapter

参数

参数类型

描述

name

String

参数解释

网络适配器名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

card_model

String

参数解释

网络适配器的芯片型号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

model

String

参数解释

网络适配器的型号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

manufacturer

String

参数解释

网络适配器的制造商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

card_manufacturer

String

参数解释

网络适配器的芯片制造商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

position

String

参数解释

网络适配器的位置

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

slot_number

Integer

参数解释

网络适配器的卡槽号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

pcb_version

String

参数解释

网络适配器的PCB版本

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

driver_name

String

参数解释

网络适配器的驱动名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

driver_version

String

参数解释

网络适配器的驱动版本

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

associated_resource

String

参数解释

网络适配器的资源归属

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

firmware_version

String

参数解释

网络适配器的固件版本

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

health

String

参数解释

健康状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

network_ports

Array of NetworkPort objects

参数解释

网络端口列表

约束限制

不涉及

表8 NetworkPort

参数

参数类型

描述

physical_port_number

Integer

参数解释

网络端口的物理端口号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

link_status

String

参数解释

网络端口的物理连接状态

约束限制

不涉及

取值范围

  • Up: 已连接

  • Down: 未连接

默认取值

不涉及

associated_network_addresses

String

参数解释

网络端口的网络地址

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

active_link_technology

String

参数解释

网络端口的网络协议

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

port_type

String

参数解释

网络端口的网口类型

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

port_max_speed

String

参数解释

网络端口的最大速率

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

firmware_package_version

String

参数解释

网络端口的固件版本

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

bdf

String

参数解释

网络端口的BDF

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

auto_neg

String

参数解释

协议

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表9 Fan

参数

参数类型

描述

name

String

参数解释

风扇名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

model

String

参数解释

风扇型号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

reading

String

参数解释

风扇转速

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

reading_units

String

参数解释

风扇转速单位

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

part_number

String

参数解释

风扇固件编码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

speed_ratio

String

参数解释

风扇速率比

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

status

Status object

硬件状态

表10 Power

参数

参数类型

描述

name

String

参数解释

电源名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

slot_number

Integer

参数解释

电源槽位

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

model

String

参数解释

电源型号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

manufacturer

String

参数解释

电源厂商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

power_supply_type

String

参数解释

输入模式

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

power_capacity_watts

String

参数解释

额定功率

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

line_input_voltage

Integer

参数解释

输入电压

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

output_voltage

Integer

参数解释

输出电压

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

protocol

String

参数解释

协议

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

active_standby

String

参数解释

主备模式

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

part_number

String

参数解释

部件编号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

serial_number

String

参数解释

序列号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

firmware_version

String

参数解释

固件版本

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

status

Status object

硬件状态总览

表11 StorageController

参数

参数类型

描述

name

String

参数解释

存储控制器名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

model

String

参数解释

存储控制器型号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

manufacturer

String

参数解释

存储控制器制造商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

state

String

参数解释

存储控制器状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

health

String

参数解释

存储控制器健康情况

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

type

String

参数解释

存储控制器类型

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

firmware_version

String

参数解释

固件版本

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

supported_raid_levels

Array of strings

参数解释

支持的raid级别列表

约束限制

不涉及

mode

String

参数解释

存储控制器的模式

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

configuration_version

String

参数解释

存储控制器配置版本

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

sas_address

String

参数解释

SAS地址

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

capacitance_name

String

参数解释

存储控制器BBU名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

capacitance_state

String

参数解释

存储控制器电容(BBU)使能状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

capacitance_health

String

参数解释

存储控制器电容(BBU)健康状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

min_stripe_size_bytes

Long

参数解释

控制器支持最小条带值

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

max_stripe_size_bytes

Long

参数解释

控制器支持最大条带值

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

volumes

Array of Volume objects

参数解释

逻辑盘列表

约束限制

不涉及

drives

Array of strings

参数解释

管理的驱动器列表信息

约束限制

不涉及

表12 Volume

参数

参数类型

描述

name

String

参数解释

逻辑盘名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

volume_raid_level

String

参数解释

RAID级别

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

capacity_bytes

Integer

参数解释

容量(单位:byte)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

optimum_io_size_bytes

Integer

参数解释

逻辑盘的条带大小(单位:byte)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

current_read_policy

String

参数解释

当前的读策略

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

default_read_policy

String

参数解释

默认的读策略

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

current_write_policy

String

参数解释

当前的写策略

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

default_write_policy

String

参数解释

默认的写策略

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

access_policy

String

参数解释

访问策略

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

current_io_policy

String

参数解释

当前IO策略

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

default_io_policy

String

参数解释

默认IO策略

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

drives

Array of Drive objects

参数解释

存储物理盘详细信息

约束限制

不涉及

status

Status object

硬件状态总览

表13 Drive

参数

参数类型

描述

id

String

参数解释

驱动器资源的ID

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

name

String

参数解释

驱动器资源的名称

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

manufacturer

String

参数解释

驱动器的制造商

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

model

String

参数解释

驱动器型号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

serial_number

String

参数解释

驱动器的序列号

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

revision

String

参数解释

驱动器的版本信息

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

media_type

String

参数解释

驱动器的介质类型

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

protocol

String

参数解释

驱动器遵从的协议

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

sas_address

String

参数解释

SAS地址

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

capacity_bytes

Integer

参数解释

容量(单位:byte)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

capable_speed_gbs

Integer

参数解释

驱动器接口的最大速率(单位:Gbps)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

negotiated_speed_gbs

Integer

参数解释

驱动器接口的协商速率(单位:Gbps)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

hotspare_type

String

参数解释

驱动器的热备状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

hours_of_powered_up

Integer

参数解释

驱动器上电运行时间(单位:h)

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

power_state

String

参数解释

驱动器电源状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

patrol_state

String

参数解释

驱动器巡检状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

associated_resource

String

参数解释

驱动器的资源归属

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

predicted_media_life_left_percent

Integer

参数解释

驱动器的剩余寿命百分比

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

health

String

参数解释

驱动器的健康状态

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

表14 Status

参数

参数类型

描述

state

String

参数解释

硬件启用状态

约束限制

不涉及

取值范围

  • Enabled:启用

  • Unenabled:未启用

  • Unknown:未知

默认取值

不涉及

health

String

参数解释

硬件健康状态

约束限制

不涉及

取值范围

  • OK:健康

  • Warning:警告

  • Critical:严重

  • Unknown:未知

默认取值

不涉及

表15 HardwareMetric

参数

参数类型

描述

metric_name

String

参数解释

监控指标名

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

metric_devices

Array of strings

参数解释

监控指标对象

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

状态码:400

表16 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

状态码:401

表17 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

状态码:429

表18 响应Body参数

参数

参数类型

描述

-

String

-

状态码:500

表19 响应Body参数

参数

参数类型

描述

error_code

String

参数解释

错误码

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

error_msg

String

参数解释

错误描述

约束限制

不涉及

取值范围

不涉及

默认取值

不涉及

请求示例

查询服务器硬件详细信息

GET https://{endpoint}/v1/{project_id}/physicalservers/{id}/hardware-attributes

响应示例

状态码:200

硬件详细信息

{
  "summary" : {
    "sn" : "2102314JLR10NA100021",
    "manufacturer" : "Huawei",
    "model" : "NV602x1x99x3",
    "main_board_manufacturer" : "Huawei"
  },
  "memorys" : [ {
    "name" : "mainboardDIMM000",
    "manufacturer" : "Samsung",
    "capacity_mib" : 32768,
    "memory_device_type" : "DDR4",
    "allowed_speed_mhz" : 2933,
    "serial_number" : "136BF0FB",
    "data_width_bits" : 72,
    "rank_count" : 2,
    "part_number" : "M393A4K40CB2-CVF",
    "min_voltage_millivolt" : 1200,
    "position" : "mainboard",
    "bom_number" : "",
    "type_detail" : "Synchronous| Registered (Buffered)",
    "technology" : "DRAM",
    "operating_speed_mhz" : 2933,
    "state" : "Enabled",
    "health" : ""
  } ],
  "processors" : [ {
    "name" : "CPU1",
    "manufacturer" : "CPU1",
    "total_enabled_cores" : 0,
    "health" : "",
    "state" : "Enabled",
    "other_parameters" : "64-bit Capable| Multi-Core| Hardware Thread| Execute Protection| Enhanced Virtualization| Power/Performance Control",
    "serial_number" : "21B4118D798F0112",
    "total_enabled_threads" : 0,
    "total_cores" : 26,
    "total_threads" : 52,
    "model" : "Intel(R) Xeon(R) Gold 6278C CPU @ 2.60GHz",
    "max_speed_mhz" : 2600,
    "l1_cache_kib" : 1664,
    "l2_cache_kib" : 26624,
    "l3_cache_kib" : 36608,
    "socket" : 0,
    "temperature" : 0,
    "part_number" : "41020773",
    "frequency_mhz" : 2600
  } ],
  "network_adapters" : [ {
    "name" : "LOM",
    "card_model" : "2*10GE+2*GE",
    "model" : "X722",
    "manufacturer" : "Intel",
    "card_manufacturer" : "Huawei",
    "position" : "",
    "slot_number" : 0,
    "pcb_version" : ".B",
    "driver_name" : "",
    "driver_version" : "",
    "associated_resource" : "CPU1",
    "firmware_version" : "",
    "health" : "OK",
    "network_ports" : [ {
      "physical_port_number" : "1",
      "link_status" : "Down",
      "associated_network_addresses" : "C8:A7:76:82:30:3E",
      "active_link_technology" : "Ethernet",
      "port_type" : "",
      "auto_neg" : "",
      "port_max_speed" : "10GE",
      "firmware_package_version" : "",
      "bdf" : "0000:1a:00.0"
    } ]
  } ],
  "fans" : [ {
    "name" : "Fan1",
    "model" : "02311VSF 8038+",
    "reading" : 0,
    "reading_units" : "RPM",
    "part_number" : "02311VSF",
    "speed_ratio" : 0,
    "status" : {
      "state" : "Enabled",
      "health" : "OK"
    }
  } ],
  "storage_controllers" : [ {
    "name" : "RAIDStorage0",
    "type" : "SAS3508",
    "model" : "",
    "manufacturer" : "Broadcom",
    "state" : "Enabled",
    "health" : "",
    "min_stripe_size_bytes" : 0,
    "max_stripe_size_bytes" : 0,
    "firmware_version" : "",
    "supported_raid_levels" : [ "RAID0", "RAID1", "RAID5", "RAID6", "RAID10", "RAID50", "RAID60" ],
    "mode" : "N/A",
    "configuration_version" : "",
    "sas_address" : "",
    "capacitance_name" : "",
    "capacitance_state" : "Enabled",
    "capacitance_health" : "OK",
    "volumes" : null,
    "drives" : [ "HDDPlaneDisk0", "HDDPlaneDisk1" ]
  } ],
  "powers" : [ {
    "name" : "PSU1",
    "slot_number" : 1,
    "model" : "PAC1500S12-BE",
    "manufacturer" : "HUAWEI",
    "power_supply_type" : "AC",
    "power_capacity_watts" : 1500,
    "line_input_voltage" : 228,
    "output_voltage" : 7,
    "protocol" : "",
    "active_standby" : "Active",
    "part_number" : "02312DAE",
    "serial_number" : "2102312DAEHVK4001029",
    "firmware_version" : "DC:107 PFC:107",
    "status" : {
      "state" : "Enabled",
      "health" : "OK"
    }
  } ],
  "metrics" : [ {
    "metric_name" : "cpu_health",
    "metric_devices" : [ "CPU1" ]
  } ]
}

状态码

状态码

描述

200

硬件详细信息

400

请求参数错误,请求失败

401

请求未鉴权

429

请求过载

500

服务端内部错误

错误码

请参见错误码

相关文档