部件驱动接口等级定义
意见反馈方法：
方法1——表格登记意见：https://www.kdocs.cn/l/cjkqm2VkmXPm
方法2——回复评论Topic链接：
概述
本文档是《服务器部件管理能力等级定义框架》中**维度一（部件接口管理能力等级）的具体实施落地，针对部件驱动的每个管理接口进行 L1-L4 等级标注。
等级定义参考
| 等级 |
定位 |
设备监控与诊断 |
RAS管理 |
运维 |
| L1 入门级 |
基本被动管理 |
基础传感器（温度/电压/FRU）、分钟级轮询 |
被动故障上报、阈值告警、人工分析 |
仅带内升级、需重启、手动配置 |
| L2 标准级 |
标准主动管理 |
多传感器、属性枚举、设备信息管理、秒级采样 |
主动健康检查、SMART评估、故障分类 |
带外升级、主备分区、半自动发现 |
| L3 高级级 |
高级预测诊断 |
芯片级监控、热插拔感知、SMART健康度 |
故障预测（≥60%）、根因分析、自动隔离 |
热升级、自动回滚、零配置发现 |
| L4 卓越级 |
智能自愈 |
智能编排、业务感知、数字孪生 |
AI预测（≥85%）、自愈决策 |
AI运维、故障自愈、灰度发布 |
部件驱动接口等级定义总表
十二、存储设备详细属性接口
表161. 存储控制器基础接口属性说明（bmc.dev.Storage.Controller）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Id |
U8 |
只读 |
控制器编号，由带外分配 |
L1: 基本静态信息 |
| Name |
String |
只读 |
控制器名称，如MegaRAID 3508-8i |
L1: 基本静态信息 |
| FirmwareType |
U8 |
只读 |
控制器固件类型 0 - MR 1 - iMR 2 - IT |
L1: 基本类型信息 |
| NVDataVersion |
String |
只读 |
控制器配置数据版本 |
L2: 能力/版本枚举 |
| MemorySizeMiB |
U32 |
只读 |
控制器内存大小，0xFFFFFFFF表示未知 |
L1: 基本信息 |
| SASAddress |
String |
只读 |
控制器SAS地址 |
L2: 拓扑/关联枚举 |
| InterfaceType |
U8 |
只读 |
控制器接口类型 0: SPI 1: SAS_3G 2: SATA_1_5G 3: SATA_3G 4: SAS_6G 5: SAS_12G 255：unknown |
L1: 基本类型信息 |
表162. 存储控制器带外管理接口属性说明（bmc.dev.Storage.Controller.OOB）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Supported |
Boolean |
只读 |
控制器是否支持带外管理 |
L2: 能力/版本枚举 |
| Enabled |
Boolean |
读写 |
是否启用带外管理 |
L2: 标准配置管理 |
| Protocol |
U8 |
只读 |
带外管理使用的协议 0 - I2C/SMBus 1 - MCTP over PCIe |
L1: 基本静态信息 |
| TargetChip |
String |
只读 |
关联的拓扑中的芯片对象 |
L1: 基本信息 |
| Address |
U32 |
读写 |
控制器带外管理地址 当Protocol为I2C/SMBus时， bit0:7 - 8bit的I2C地址 bit8:31 - 保留为0 当Protocol为MCTP over PCIe时， bit0:15 - Physical Address bit16:31 - Endpoint Id |
L2: 配置管理 |
| CommunicationLoss |
Boolean |
只读 |
控制器带外通信状态 true - 通信丢失 false - 通信正常 |
L2: 主动健康检查 |
表163. 存储控制器扩展接口属性说明（bmc.dev.Storage.Controller.Capability）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| ROCTemperatureSupported |
Boolean |
只读 |
是否支持获取芯片核温 |
L1: 基本温度读取；L2: 秒级监控 |
| JBODSupported |
Boolean |
只读 |
是否支持以直通方式管理硬盘 |
L2: 能力/版本枚举 |
| SEDEraseSupported |
Boolean |
只读 |
是否支持加密硬盘擦除 |
L2: 能力/版本枚举 |
| EPDSupported |
Boolean |
只读 |
是否支持创建/删除EPD（Enhanced Physical Device） |
L2: 能力/版本枚举 |
| MinStripSizeBytes |
U32 |
只读 |
最小条带大小，单位byte |
L1: 基本静态信息 |
| MaxStripSizeBytes |
U32 |
只读 |
最大条带大小，单位byte |
L1: 基本静态信息 |
表164. 存储控制器读策略接口属性说明（bmc.dev.Storage.Controller.Capability.ReadPolicy）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| SupportedPolicy |
String |
只读 |
创建逻辑盘时支持的读策略，如[“Read Aheaed”, “No Read Ahead”] |
L2: 能力/版本枚举 |
| DefaultPolicy |
String |
只读 |
创建逻辑盘时的默认读策略，必须是SupportedPolicy中的一个 |
L1: 基本信息 |
| Settable |
Boolean |
只读 |
是否支持修改逻辑盘读策略 |
L1: 基本信息 |
表165. 存储控制器写策略接口属性说明（bmc.dev.Storage.Controller.Capability.WritePolicy）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| SupportedPolicy |
String |
只读 |
创建逻辑盘时支持的写策略，如[“Write Through”, “Write Back”, “Always Write Back”] |
L2: 能力/版本枚举 |
| DefaultPolicy |
String |
只读 |
创建逻辑盘时的默认写策略，必须是SupportedPolicy中的一个 |
L1: 基本信息 |
| Settable |
Boolean |
只读 |
是否支持修改逻辑盘写策略 |
L1: 基本信息 |
表166. 存储控制器IO策略接口属性说明（bmc.dev.Storage.Controller.Capability.IOPolicy）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| SupportedPolicy |
String |
只读 |
创建逻辑盘时支持的IO策略，如[“Cached IO”, “Direct IO”] |
L2: 能力/版本枚举 |
| DefaultPolicy |
String |
只读 |
创建逻辑盘时的默认IO策略，必须是SupportedPolicy中的一个 |
L1: 基本信息 |
| Settable |
Boolean |
只读 |
是否支持修改逻辑盘IO策略 |
L1: 基本信息 |
表167. 存储控制器访问策略接口属性说明（bmc.dev.Storage.Controller.Capability.AccessPolicy）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| SupportedPolicy |
String |
只读 |
创建逻辑盘时支持的访问策略，如[“Read Write”, “Read Only”, “Blocked”, “Hidden”] |
L2: 能力/版本枚举 |
| DefaultPolicy |
String |
只读 |
创建逻辑盘时的默认访问策略，必须是SupportedPolicy中的一个 |
L1: 基本信息 |
| Settable |
Boolean |
只读 |
是否支持修改逻辑盘访问策略 |
L1: 基本信息 |
表168. 存储控制器硬盘缓存策略接口属性说明（bmc.dev.Storage.Controller.Capability.DiskCachePolicy）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| SupportedPolicy |
String |
只读 |
创建逻辑盘时支持的物理盘缓存策略，如[“Unchanged”, “Enable”, “Disable”] |
L2: 能力/版本枚举 |
| DefaultPolicy |
String |
只读 |
创建逻辑盘时的默认物理盘缓存策略，必须是SupportedPolicy中的一个 |
L1: 基本信息 |
| Settable |
Boolean |
只读 |
是否支持修改逻辑盘的物理盘缓存策略 |
L1: 基本信息 |
表169. 存储控制器硬盘写缓存策略接口属性说明（bmc.dev.Storage.Controller.Capability.DiskWriteCachePolicy）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| ConfigedDriveWCP |
String |
只读 |
已配置的硬盘写缓存策略，仅PMC的RAID卡涉及，取值范围： Default Eanbled Disabled Invalid |
L1: 基本信息 |
| UnconfigedDriveWCP |
String |
只读 |
未配置的硬盘写缓存策略，仅PMC的RAID卡涉及，取值范围： Default Eanbled Disabled Invalid |
L1: 基本信息 |
| HBADriveWCP |
String |
只读 |
HBA硬盘写缓存策略，仅PMC的RAID卡涉及，取值范围： Default Eanbled Disabled Invalid |
L1: 基本信息 |
| Settable |
Boolean |
只读 |
是否支持修改物料盘写缓存策略，仅PMC的RAID卡涉及 |
L1: 基本信息 |
表170. 存储控制器工作模式接口属性说明（bmc.dev.Storage.Controller.Capability.Mode）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Settable |
Boolean |
只读 |
是否支持修改工作模式 |
L1: 基本信息 |
| RAIDModeSupported |
Boolean |
只读 |
是否支持RAID模式 |
L2: 能力枚举 |
| HBAModeSupported |
Boolean |
只读 |
是否支持HBA模式 |
L2: 能力/版本枚举 |
| MixedModeSupported |
Boolean |
只读 |
是否支持混合模式 |
L2: 能力/版本枚举 |
表171. 存储控制器支持的RAID级别接口属性说明（bmc.dev.Storage.Controller.Capability.RAIDLevel）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| RAID0Supported |
Boolean |
只读 |
是否支持组建RAID0 |
L2: 能力枚举 |
| RAID1Supported |
Boolean |
只读 |
是否支持组建RAID1 |
L2: 能力枚举 |
| RAID5Supported |
Boolean |
只读 |
是否支持组建RAID5 |
L2: 能力枚举 |
| RAID6Supported |
Boolean |
只读 |
是否支持组建RAID6 |
L2: 能力枚举 |
| RAID10Supported |
Boolean |
只读 |
是否支持组建RAID10 |
L2: 能力枚举 |
| RAID50Supported |
Boolean |
只读 |
是否支持组建RAID50 |
L2: 能力枚举 |
| RAID60Supported |
Boolean |
只读 |
是否支持组建RAID60 |
L2: 能力枚举 |
| RAID1AdmSupported |
Boolean |
只读 |
是否支持组建RAID1 ADM，仅PMC RAID卡涉及 |
L2: 能力枚举 |
| RAID10AdmSupported |
Boolean |
只读 |
是否支持组建RAID10 ADM，仅PMC RAID卡涉及 |
L2: 能力枚举 |
| RAID1TrippleSupported |
Boolean |
只读 |
是否支持组建RAID1 Tripple，仅PMC RAID卡涉及 |
L2: 能力枚举 |
| RAID10TrippleSupported |
Boolean |
只读 |
是否支持组建RAID10 Tripple，仅PMC RAID卡涉及 |
L2: 能力枚举 |
| RAID1ESupported |
Boolean |
只读 |
是否支持组建RAID1E，仅Broadcom的RAID卡涉及 |
L2: 能力枚举 |
表172. 存储控制器状态接口属性说明（bmc.dev.Storage.Controller.Status）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Health |
U8 |
只读 |
控制器总体健康状态 0 - 正常 1 - 轻微故障 2 - 严重故障 3 - 紧急故障 |
L2: 主动健康检查 |
| CachePinned |
Boolean |
只读 |
是否发生cache pinned |
L2: 主动健康检查 |
| FatalError |
U8 |
只读 |
芯片管脚输出的严重错误状态 |
L3: 芯片级故障检测 |
| PowerStatus |
U16 |
只读 |
电源健康状态 |
L1: 基本电源状态 |
| MemoryCE |
Boolean |
只读 |
内存是否存在CE |
L3: 芯片级ECC故障检测 |
| MemoryUCE |
Boolean |
只读 |
内存是否存在UCE |
L3: 芯片级ECC故障检测 |
| MemoryECC |
Boolean |
只读 |
内存是否存在ECC |
L3: 芯片级ECC故障检测 |
| NVRamUCE |
Boolean |
只读 |
NVRAM是否存在UCE |
L3: 芯片级ECC故障检测 |
| ReferenceClockFault |
Boolean |
只读 |
参考时钟故障 |
L2: 故障分类 |
| VoltageFault |
Boolean |
只读 |
供电电压故障 |
L2: 故障分类 |
| FlashFault |
Boolean |
只读 |
flash故障 |
L2: 故障分类 |
| LDCCStatus |
U8 |
只读 |
一致性校验运行状态 0 - 暂停 1 - 运行 0xFF - 未知 |
L1: 基本状态信息 |
| LDCCTotalVD |
U16 |
只读 |
一致性校验需要校验的逻辑盘总数，0xFFFF表示未知 |
L1: 基本信息 |
| LDCCCompletedVD |
U16 |
只读 |
一致性校验已完成的逻辑盘数据，0xFFFF表示未知 |
L1: 基本信息 |
| TemperatureCelsius |
U16 |
只读 |
控制器温度，高字节为温度获取状态，低字节为实际的温度值 bit15 - 控制器温度获取结果，1：失败，0：成功 bit14 - 控制器当前状态是否支持获取温度，1：不支持， 0：支持 bit8:13 - 保留位，设置为0 bit0:7 - 控制器温度值，单位为摄氏度（仅当高字节为0时有效） |
L1: 基本温度读取；L2: 秒级监控 |
表173. 存储控制器度量接口属性说明（bmc.dev.Storage.Controller.Metrics）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| LastUpdateTimestamp |
U32 |
只读 |
最近一次更新Metrics的时间戳 |
L2: 秒级监控基准 |
| DDREccCount |
U32 |
只读 |
控制器内存ECC计数 |
L2: 秒级指标监控 |
表174. 存储控制器配置接口属性说明（bmc.dev.Storage.Controller.Settings）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Mode |
U8 |
读写 |
控制器工作模式 0 - RAID 1 - HBA 2 - Mixed 255 - 未知 |
L2: 标准配置管理 |
| MaintPDFailHistory |
U8 |
读写 |
硬盘故障记忆功能使能状态 0 - 禁用 1 - 使能 255 - 未知或不支持 |
L2: 配置管理 |
| CopybackEnabled |
U8 |
读写 |
回拷功能使能状态 0 - 禁用 1 - 使能 255 - 未知或不支持 |
L2: 标准配置管理 |
| SMARTerCopybackEnabled |
U8 |
读写 |
检测到物理盘SMART错误之后自动回拷使能状态 0 - 禁用 1 - 使能 255 - 未知或不支持 |
L3: 高级诊断与预测 |
| JBODEnabled |
U8 |
读写 |
JBOD功能使能状态，表示在RAID模式时是否可以让OS直接识别物理盘 0 - 禁用 1 - 使能 255 - 未知或不支持 |
L2: 标准配置管理 |
| LDCCEnabled |
U8 |
读写 |
一致性校验功能使能状态 0 - 禁用 1 - 使能 255 - 未知或不支持 |
L2: 标准配置管理 |
| LDCCPeriod |
U16 |
读写 |
一致性校验周期，单位：小时，取值范围1~1440，默认值0xFFFF，表示无效 |
L2: 配置管理 |
| LDCCRate |
U8 |
读写 |
一致性校验速率， 0 - Low 1 - Medium 2 - High |
L2: 配置管理 |
| LDCCAutoRepairEnabled |
U8 |
读写 |
一致性校验自修复功能使能状态 0 - 禁用 1 - 使能 255 - 未知或不支持 |
L2: 标准配置管理 |
| LDCCDelay |
U8 |
读写 |
一致性校验延迟启动时间，单位：小时，取值0~24，0xFF表示未知 |
L2: 配置管理 |
| NoBatteryWriteCache |
U8 |
读写 |
无电池写缓存功能使能 0 - 禁用 1 - 使能 255 - 未知或不支持 |
L2: 配置管理 |
| ReadCachePercent |
U8 |
读写 |
读缓存百分比，取值0~100 |
L2: 配置管理 |
| BootDevices |
String |
读写 |
启动盘，逻辑盘名称或物理盘设备名称 |
L2: 标准配置管理 |
表175. 存储控制器配置接口方法说明（bmc.dev.Storage.Controller.Settings）
| 方法名 |
请求参数 |
类型 |
参数说明 |
响应 |
类型 |
响应说明 |
方法说明 |
等级定义 |
| CreateCommonLD |
DriveLists |
U8 |
硬盘列表 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
RAIDType |
U8 |
RAID级别 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
SpanDepth |
U8 |
Span数量 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
Name |
Sring |
创建的逻辑盘名称 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
Capacity |
U32 |
容量 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
CapacityUnit |
U8 |
容量单位 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
StripSize |
U8 |
条带大小 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
ReadPolicy |
U8 |
逻辑盘读策略 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
WritePolicy |
U8 |
逻辑盘写策略 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
IOPolicy |
U8 |
逻辑盘IO策略 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
AccessPolicy |
U8 |
逻辑盘访问策略 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
DiskCachePolicy |
U8 |
硬盘Cache策略 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
InitType |
U8 |
初始化类型 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| CreateCommonLD |
Accelerator |
U8 |
加速方法 |
TaskId |
U32 |
任务Id（用于查询进度） |
在空闲的磁盘上创建逻辑盘 |
L2: 标准配置管理 |
| AddLD |
ArrayId |
U16 |
阵列Id |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
BlockIndex |
U8 |
块索引 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
RAIDType |
U8 |
RAID级别 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
SpanDepth |
U8 |
Span数量 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
Name |
String |
创建的逻辑盘名称 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
Capacity |
U32 |
容量 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
CapacityUnit |
U8 |
容量单位 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
StripSize |
U8 |
条带大小 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
ReadPolicy |
U8 |
逻辑盘读策略 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
WritePolicy |
U8 |
逻辑盘写策略 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
IOPolicy |
U8 |
逻辑盘IO策略 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
AccessPolicy |
U8 |
逻辑盘访问策略 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
DiskCachePolicy |
U8 |
硬盘Cache策略 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
InitType |
U8 |
初始化类型 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| AddLD |
Accelerator |
U8 |
加速方法 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在已有的磁盘阵列上添加逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
DriveLists |
U8 |
硬盘列表 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
RAIDType |
U8 |
RAID级别 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
Name |
String |
逻辑盘名称 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
WritePolicy |
U8 |
逻辑盘写策略 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
ArrayId |
U16 |
阵列Id |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
Capacity |
U32 |
容量 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
CapacityUnit |
U8 |
容量单位 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
AssociatedLd |
U16 |
关联的逻辑盘Id |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| CreateCachecadeLD |
CacheLineSize |
U8 |
缓存行大小 |
TaskId |
U32 |
任务Id（用于查询任务进度） |
在空闲的磁盘上创建cachecade逻辑盘 |
L2: 标准配置管理 |
| DeleteLD |
VolumeId |
U16 |
逻辑盘Id |
TaskId |
U32 |
任务Id（用于查询任务进度） |
删除指定的逻辑盘 |
L2: 标准配置管理 |
| SetDriveWriteCachePolicy |
Type |
String (enum: “ConfiguredDriveWriteCachePolicy”, “UnconfiguredDriveWriteCachePolicy”, “HBADriveWriteCachePolicy”) |
RAID下的硬盘管理类型 |
无 |
|
|
设置硬盘写缓存策略 |
L2: 标准配置管理 |
|
WriteCachePolicy |
String |
写缓存策略 |
无 |
|
|
|
L1: 基本读写操作 |
| SetConsisCheck |
Period |
U16 |
RAID控制器一致性校验周期，单位(小时), 取值范围[1:1440] |
无 |
|
|
设置一致性检查参数，包括周期、比例、延时等 |
L2: 标准配置管理 |
|
Rate |
U8 |
RAID控制器一致性校验速率 |
无 |
|
|
|
L1: 基本操作 |
|
AutoRepairedEnabled |
U8 |
自动修复启用使能 |
无 |
|
|
|
L1: 基本操作 |
| RestoreSettings |
|
请求：无 响应：无 |
|
|
|
|
恢复控制默认设置 |
L2: 标准配置管理 |
表176. 存储控制器外部配置管理能力接口属性说明（bmc.dev.Storage.Controller.ForeignConfigurations）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| ForeignConfigurationsDetected |
Boolean |
只读 |
是否检测到外部配置 |
L1: 基本信息 |
表177. 存储控制器外部配置管理能力接口方法说明（bmc.dev.Storage.Controller.ForeignConfigurations）
| 方法名 |
请求参数 |
类型 |
参数说明 |
响应 |
类型 |
响应说明 |
方法说明 |
等级定义 |
| Import |
无 |
无 |
无 |
无 |
无 |
无 |
导入外部配置 |
L2: 标准配置管理 |
| Clear |
无 |
无 |
无 |
无 |
无 |
无 |
清除外部配置 |
L2: 标准配置管理 |
表178. 存储控制器PHY接口属性说明（bmc.dev.Storage.Controller.PHY）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Id |
U16 |
只读 |
PHY编号 |
L1: 基本静态信息 |
| Type |
U8 |
只读 |
PHY类型， SAS、PCIe、UB |
L1: 基本类型信息 |
| AttachedDeviceType |
U8 |
只读 |
PHY连接的设备类型 |
L1: 基本类型信息 |
表179. 存储控制器PHY度量接口属性说明（bmc.dev.Storage.Controller.PHY.Metrics）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| LastUpdateTimestamp |
U32 |
只读 |
最近一次更新Metrics的时间戳 |
L2: 秒级监控基准 |
| InvalidDwordCount |
U32 |
只读 |
Invalid Dword计数 |
L2: 秒级指标监控 |
| LossDwordSyncCount |
U32 |
只读 |
Loss Dword Sync计数 |
L2: 秒级指标监控 |
| PhyResetProblemCount |
U32 |
只读 |
Phy Reset计数 |
L2: 秒级指标监控 |
| RunningDisparityErrorCount |
U32 |
只读 |
Running Disparity错误计数 |
L2: 秒级指标监控 |
表180. 存储控制器日志收集接口方法说明（bmc.dev.Storage.Controller.LogCollection）
| 方法名 |
请求参数 |
类型 |
请求说明 |
响应 |
类型 |
响应说明 |
方法说明 |
等级定义 |
| DumpLogInfo |
Path |
String |
存储控制器日志存放路径 |
Result |
Boolean |
tue：成功 false：失败 |
收集存储控制器日志 |
L3: 高级日志诊断 |
表181. 存储控制器备用电池单元接口属性说明（bmc.dev.Storage.BBU）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Present |
Boolean |
只读 |
BBU是否在位 |
L1: 基本状态信息 |
| Type |
String |
只读 |
BBU类型 |
L1: 基本类型信息 |
| AttachedControllerId |
U8 |
只读 |
BBU归属的控制器编号 |
L1: 基本关联信息 |
| SerialNumber |
String |
只读 |
BBU序列号 |
L1: 基本静态信息 |
| Manufacturer |
String |
只读 |
BBU生产厂商 |
L1: 基本静态信息 |
| ManufactureDate |
String |
只读 |
BBU生产日期 |
L1: 基本信息 |
| DeviceName |
String |
只读 |
BBU生产日期 |
L1: 基本静态信息 |
| Voltage |
Double |
只读 |
BBU电压 |
L1: 基本信息 |
表182. 存储控制器备用电池单元状态接口属性说明（bmc.dev.Storage.BBU.Status）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Health |
U8 |
只读 |
BBU总体健康状态 0 - 正常 1 - 轻微故障 2 - 严重故障 3 - 紧急故障 |
L2: 主动健康检查 |
| CapacitorFault |
Boolean |
只读 |
BBU电容是否故障 true - 故障 false - 正常 |
L1: 基本信息 |
| PackMissing |
Boolean |
只读 |
BBU是否缺失电容/电池包 true - 缺失 false - 正常 |
L2: 主动健康检查 |
| VoltageLow |
Boolean |
只读 |
BBU是否电压过低 true - 电压低 false - 正常 |
L1: 基本信息 |
| TemperatureHigh |
Boolean |
只读 |
BBU是否温度过高 true - 温度高 false - 正常 |
L1: 基本温度读取；L2: 秒级监控 |
| ReplacePack |
Boolean |
只读 |
是否需要更换电容/电池包 true - 需要更换 false - 不需要更换 |
L1: 基本信息 |
| LearnCycleFailed |
Boolean |
只读 |
BBU Learn Cycle是否失败 true - 失败 false - 正常 |
L1: 基本指示灯状态 |
| LearnCycleTimeout |
Boolean |
只读 |
BBU Learn Cycle是否超时 true - 超时 false - 正常 |
L1: 基本硬件配置 |
| PredictiveFailure |
Boolean |
只读 |
BBU是否预故障 true - 预故障 false - 正常 |
L3: 故障预测 |
| RemainingCapacityLow |
Boolean |
只读 |
BBU电容容量过低 true - 容量过低 false - 正常 |
L1: 基本信息 |
| NoSpaceForCacheOffload |
Boolean |
只读 |
BBU是否无空间可用于缓存数据 true - 是 false - 否 |
L1: 基本信息 |
| TemperatureCelsius |
U16 |
只读 |
BBU温度，高字节为温度获取状态，低字节为实际的温度值 bit15 - BBU温度获取结果，1：失败，0：成功 bit14 - 控制器当前状态是否支持获取温度，1：不支持， 0：支持 bit8:13 - 保留位，设置为0 bit0:7 - BBU温度值，单位为摄氏度（仅当高字节为0时有效） |
L1: 基本温度读取；L2: 秒级监控 |
表183. 逻辑盘基础接口属性说明（bmc.dev.Storage.Volume）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Id |
U16 |
只读 |
逻辑盘编号，仅在同一控制器内保证唯一性 |
L1: 基本静态信息 |
| Name |
String |
读写 |
逻辑盘名称，仅用于管理控制面，并非OS内的盘符名称 |
L1: 基本静态信息 |
| RAIDLevel |
U8 |
只读 |
逻辑盘RAID级别 |
L1: 基本静态信息 |
| StripSizeBytes |
U32 |
只读 |
逻辑盘条带大小，单位byte |
L1: 基本静态信息 |
| CapacityBytes |
U64 |
只读 |
逻辑盘容量，单位byte |
L1: 基本静态信息 |
| State |
U8 |
读写 |
逻辑盘状态 |
L1: 基本状态；L2: 主动健康检查 |
| AttachedControllerId |
U8 |
只读 |
逻辑盘归属的控制器Id |
L1: 基本关联信息 |
| OSDriveName |
String |
只读 |
逻辑盘在OS中的盘符 |
L2: OS视图枚举 |
| SSDCachecadeVolume |
Boolean |
只读 |
逻辑盘是否为cachecade逻辑盘 |
L2: 缓存属性枚举 |
| CacheLineSizeKiB |
U32 |
只读 |
逻辑盘缓存行大小 |
L2: 缓存属性枚举 |
| InitializationMode |
U8 |
只读 |
逻辑盘初始化模式 |
L2: 初始化状态枚举 |
| SpanCount |
U8 |
只读 |
逻辑盘Span个数 |
L2: 拓扑属性枚举 |
| MaxResizableSizeBytes |
U64 |
只读 |
逻辑盘最大可调整的容量 |
L3: 高级容量规划 |
表184. 逻辑盘策略接口属性说明（bmc.dev.Storage.Volume.Policy）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| DefaultReadPolicy |
String |
读写 |
逻辑盘默认读策略 |
L2: 读策略配置 |
| CurrentReadPolicy |
String |
只读 |
逻辑盘实际读策略 |
L2: 读策略枚举 |
| DefaultWritePolicy |
String |
读写 |
逻辑盘默认写策略 |
L2: 写策略配置 |
| CurrentWritePolicy |
String |
只读 |
逻辑盘实际写策略 |
L2: 写策略枚举 |
| DefaultIOPolicy |
String |
读写 |
逻辑盘默认IO策略 |
L2: IO策略配置 |
| CurrentIOPolicy |
String |
只读 |
逻辑盘实际IO策略 |
L2: IO策略枚举 |
| DiskCachePolicy |
String |
读写 |
逻辑盘的物理盘缓存策略 |
L2: 缓存策略配置 |
| AccessPolicy |
String |
读写 |
逻辑盘访问策略 |
L2: 访问策略配置 |
表185. 逻辑盘状态接口属性说明（bmc.dev.Storage.Volume.Status）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| ForegroundInitState |
U8 |
只读 |
逻辑盘是否在FGI（前台初始化） |
L2: 初始化状态监控 |
| ForegroundInitProgress |
U8 |
只读 |
逻辑盘FGI进度（百分比） |
L2: 初始化进度监控 |
| RebuildState |
U8 |
只读 |
逻辑盘重构状态 0 - 未重构 1 - 重构中 255 - 未知 |
L2: 重构状态监控；L3: 重构预测 |
| RebuildProgress |
U8 |
只读 |
逻辑盘重构进度（百分比），取值0~100，255表示未启动重构 |
L2: 重构进度监控 |
| ConsistencyCheck |
Boolean |
只读 |
逻辑盘一致性检查使能状态 true - 使能 false - 禁用 |
L2: 一致性检查枚举；L3: 数据完整性预测 |
表186. 逻辑盘配置接口属性说明（bmc.dev.Storage.Volume.Settings）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| BootEnable |
Boolean |
读写 |
逻辑盘是否为启动盘 |
L2: 启动配置 |
| BootPriority |
U8 |
读写 |
逻辑盘启动优先级 |
L2: 启动优先级配置 |
| BGIEnable |
Boolean |
读写 |
逻辑盘是否使能BGI |
L2: BGI使能配置 |
| SSDCachingEnable |
Boolean |
读写 |
是否使用cachecade逻辑盘做缓存 |
L2: 缓存策略配置 |
| AccelerationMethod |
String |
读写 |
逻辑盘加速方法 |
L3: 高级性能加速配置 |
表187. 逻辑盘关联关系接口属性说明（bmc.dev.Storage.Volume.Association）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| AssociatedCacheCadeVolume |
U16 |
读写 |
使用cachecade逻辑盘做缓存时，关联的cachecade逻辑盘Id |
L2: 关联枚举 |
| AssociatedVolumes |
U16 |
读写 |
当此逻辑盘为cachecade逻辑盘时，关联的普通逻辑盘Id |
L2: 关联枚举 |
| DriveList |
U8 |
只读 |
逻辑盘的物理成员盘列表 |
L1: 基本关联信息 |
| ArrayList |
U16 |
只读 |
逻辑盘关联的磁盘阵列列表 |
L2: 阵列关联枚举 |
| HotSpareDriveList |
U16 |
只读 |
逻辑盘的物理热备盘列表 |
L2: 热备关联枚举 |
表188. 硬盘基础接口属性说明（bmc.dev.Storage.Drive）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Present |
Boolean |
只读 |
物理盘是否在位 0 - 不在位 1 - 在位 |
L1: 基本在位状态 |
| SASPresent |
Boolean |
只读 |
SAS/SATA在位信号 0 - 不在位 1 - 在位 |
L1: 基本在位状态 |
| PCIePresent |
Boolean |
只读 |
PCIe在位信号 0 - 不在位 1 - 在位 |
L1: 基本在位状态 |
| SlotId |
U8 |
只读 |
物理盘在本背板内的槽位号 |
L1: 基本静态信息 |
| Id |
U8 |
只读 |
物理盘Id，根据槽位编号 |
L1: 基本静态信息 |
| Name |
String |
只读 |
物理盘名称，如DISK0 |
L1: 基本静态信息 |
| DeviceName |
String |
只读 |
物理盘设备名称 |
L1: 基本静态信息 |
| OOBSupported |
Boolean |
只读 |
是否支持带外管理 |
L2: OOB能力枚举 |
| AttachedControllerId |
U8 |
只读 |
物理盘归属的控制器编号，由BMC分配，255表示不归属RAID/HBA控制器管理 |
L1: 基本关联信息 |
| AttachedEnclosureDeviceId |
U16 |
只读 |
物理盘归属的背板设备Id，由控制器分配 |
L1: 基本关联信息 |
| SlotNumber |
U8 |
只读 |
物理盘的槽位号（控制器识别的槽位号） |
L1: 基本静态信息 |
| Manufacturer |
String |
只读 |
物理盘厂商 |
L1: 基本静态信息 |
| SerialNumber |
String |
只读 |
物理盘序列号 |
L1: 基本静态信息 |
| PartNumber |
String |
只读 |
物料盘部件号 |
L1: 基本静态信息 |
| CapacityMiB |
U64 |
只读 |
物理盘容量，单位MB |
L1: 基本静态信息 |
| Model |
String |
只读 |
物理盘型号 |
L1: 基本静态信息 |
| MediaType |
U8 |
只读 |
物理盘介质类型 0 - Hdd 1 - SSD 2 - SSM 3~254 - 保留 255 - Unknown |
L1: 基本静态信息 |
| FirmwareRevision |
String |
只读 |
物理盘固件版本 |
L1: 基本静态信息 |
| RotationSpeedRPM |
U16 |
只读 |
物理盘转速，仅HDD涉及 |
L1: 基本静态信息 |
| FormFactor |
U8 |
只读 |
物理盘外形尺寸规格 0 - Unknown 1 - 5.25 inch 2 - 3.5 inch 3 - 2.5 inch 4 - 1.8 inch 5 - Less than 1.8 inch 6 - mSATA 7 - M.2 8 - MicroSSD 9 - CFast 0xff - 无效的外形规格 其它 - Reserved |
L1: 基本静态信息 |
| BlockSizeBytes |
U16 |
只读 |
物理盘块大小，单位byte |
L1: 基本静态信息 |
| SASAddress |
String |
只读 |
物理盘SAS地址，对于双口硬盘可以有多个 |
L2: 地址枚举 |
| BDF |
String |
只读 |
物理盘BDF（bus，device，function），格式: 0000:00:1f.2_1，适用于NVMe盘 |
L2: 拓扑枚举 |
表189. 硬盘物理上下文接口属性说明（bmc.dev.Storage.Drive.PhysicalContext）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Location |
String |
只读 |
物理盘在机框内的位置信息 |
L1: 基本位置信息 |
| DeviceName |
String |
只读 |
物理盘设备名称，带有丝印信息 |
L1: 基本位置信息 |
| Owner |
String |
只读 |
物理盘资源归属，如CPU0，仅对NVMe盘有效 |
L2: 归属枚举 |
| ContainerPhysicalContext |
String |
只读 |
物理盘所在容器（如背板）在机箱中的相对位置，取值有：Front Inner Rear |
L2: 位置枚举 |
表190. 硬盘指示灯接口属性说明（bmc.dev.Storage.Drive.Led）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| ActivationLed |
U8 |
只读 |
物理盘激活状态指示灯 1 - 常亮/闪烁 0 - 熄灭 |
L1: 基本指示灯状态 |
| FaultLed |
U8 |
只读 |
物理盘故障指示灯 1 - 常亮 0 - 熄灭 |
L1: 基本指示灯状态 |
| LocationLed |
U8 |
只读 |
物理盘定位指示灯 1 - 常亮/闪烁 0 - 熄灭 |
L1: 基本指示灯状态 |
表191. 硬盘接口协议属性说明（bmc.dev.Storage.Drive.Interface）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Protocol |
String |
只读 |
物理盘接口协议类型，取值 Unknown parallel SCSI SATA/SAS SATA SAS FC NVMe UB |
L1: 基本接口信息 |
| CapableSpeedGbs |
U8 |
只读 |
物理盘接口最大速率，仅适用于SAS/SATA盘 0 - Undefined 1 - 1.5 Gb/s 2 - 3.0 Gb/s 3 - 6.0 Gb/s 4 - 12.0 Gb/s 5 - 2.5 Gb/s 6 - 5.0 Gb/s 7 - 8.0 Gb/s 8 - 10.0 Gb/s 9 - 16.0 Gb/s 10 - 20.0 Gb/s 11 - 30.0 Gb/s 12 - 32.0 Gb/s 13 - 40.0 Gb/s 14 - 64.0 Gb/s 15 - 80.0 Gb/s 16 - 96.0 Gb/s 17 - 128.0 Gb/s 18 - 160 Gb/s 19 - 256 Gb/s 20 - 22.5 Gb/s 21~254 - 保留 255 - 未知 |
L2: 速率枚举 |
| NegotiatedSpeedGbs |
U8 |
只读 |
物理盘协商速率，仅适用于SAS/SATA盘 |
L2: 速率枚举 |
| PCIeCapableSpeed |
U8 |
只读 |
PCIe最大速率，仅适用于NVMe盘 0 - Undefined 1 - 2.5 GT/s 2 - 5 GT/s 3 - 8 GT/s 4 - 16 GT/s 5 - 32 GT/s 6 - 64 GT/s 7 - 128 GT/s 8 - 256 GT/s 9~254 - 保留 255 - 未知 |
L2: PCIe速率枚举 |
| PCIeLinkSpeed |
U8 |
只读 |
PCIe链接速率，仅适用于NVMe盘 |
L2: PCIe速率枚举 |
表192. 硬盘状态接口属性说明（bmc.dev.Storage.Drive.Status）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Health |
U8 |
只读 |
物理盘总体健康状态 0 - 正常 1 - 轻微故障 2 - 严重故障 3 - 紧急故障 |
L2: 主动健康检查 |
| FirmwareStatus |
U8 |
只读 |
物理盘固件状态 0 - Unconfigured good 1 - Unconfigured bad 2 - Hot spare 3 - Offline 4 - Failed 5 - Rebuild 6 - Online 7 - Copyback 8 - System 9 - UnConfigured - shielded 10 - Hot Spare - shielded 11 - Configured - shielded 12 - EPD 13 - Active（适用于CPU直通硬盘）14 - Standby（适用于CPU直通硬盘）15 - Sleep（适用于CPU直通硬盘）16 - 后台执行DST（适用于CPU直通硬盘）17 - 后台执行SMART离席数据收集（适用于CPU直通硬盘）18 - 后台执行SCT（适用于CPU直通硬盘）19~254 保留 255 - 未知 |
L2: 固件状态枚举 |
| PowerState |
U8 |
只读 |
物理盘电源状态 0 - 已激活（spun up）1 - 休眠（spun down）2 - 转换中 255 - 未知 |
L1: 基本电源状态 |
| FDECapable |
U8 |
只读 |
物理盘是否支持FDE(Full Disk Encryption) 1 - 支持 0 - 不支持 |
L2: 加密能力枚举 |
| LocationIndicatorState |
U8 |
只读 |
定位指示灯状态 0 - off 1 - blinking |
L1: 基本指示灯状态 |
| FaultIndicatorState |
U8 |
只读 |
故障指示灯状态 0 - off 1 - blinking |
L1: 基本指示灯状态 |
| Missing |
U8 |
只读 |
物理是否丢失，主要有两个场景：（1） 启动阶段BMC通过点灯识别建立映射关系，无法识别物理与逻辑的映射关系；（2）运行过程中，RAID卡踢盘 1 - 丢失 0 - 正常 |
L2: 主动健康检查；L3: 丢盘根因诊断 |
| FailedArray |
U8 |
只读 |
是否导致逻辑盘失效 |
L2: 主动健康检查；L3: 故障影响分析 |
| PredictiveFailure |
U8 |
只读 |
是否预故障 |
L3: 故障预测 |
| CapacityError |
U8 |
只读 |
是否存在容量识别错误 0 - 正常 1 - 错误 |
L2: 容量健康检查 |
| FDMFault |
U8 |
读写 |
是否由故障诊断系统检测到故障 0 - 未检测到故障 1 - 检测到故障 |
L3: 智能故障诊断；L4: AI自愈决策 |
| DFPResult |
Double |
读写 |
故障预测结果（故障可能性） |
L3: 故障概率预测；L4: AI寿命预测 |
| PhyError |
U8 |
读写 |
物理盘PHY链路故障标识 0 - 未检测到故障 1 - 与Expander之间的链路故障 2 - 与RAID/HBA控制器之间的链路故障 |
L3: PHY链路诊断 |
| RebuildState |
U8 |
只读 |
物理盘重构状态 0 - 未重构/重构结束 1 - 重构中 255 - 未知 |
L2: 重构状态监控 |
| RebuildProgress |
U8 |
只读 |
物理盘重构进度（百分比），取值0~100，255表示未启动重构 |
L2: 重构进度监控 |
| IntermittentDisconnection |
U8 |
只读 |
是否出现链路闪断，由带内agent上报 |
L3: 高级链路诊断 |
| IntermittentDisconnectionTimestamp |
U32 |
只读 |
闪断发生的时间戳，由带内agent上报 |
L3: 高级链路诊断；L4: AI历史分析 |
| IODegraded |
U8 |
只读 |
IO性能降级，由带内agent上报 |
L3: IO性能诊断；L4: AI IO优化 |
| TemperatureCelsius |
U16 |
只读 |
物理盘温度，高字节为温度获取状态，低字节为实际的温度值 bit15 - 物理盘温度获取结果，1：失败，0：成功 bit14 - 控制器当前状态是否支持获取温度，1：不支持，0：支持 bit8:13 - 保留位，设置为0 bit0:7 - 物理盘温度值，单位为摄氏度（仅当高字节为0时有效） |
L1: 基本温度读取；L2: 秒级监控 |
表193. 硬盘状态接口方法说明（bmc.dev.Storage.Drive.Status Methods）
| 方法名 |
请求参数 |
类型 |
参数说明 |
响应 |
类型 |
响应说明 |
方法说明 |
等级定义 |
| SetFirmwareStatus |
FirmwareStatus |
U8 |
固件状态 |
无 |
无 |
无 |
设置固件状态 |
L2: 标准固件管理 |
| SetLocationIndicatorState |
LocationIndicatorState |
U8 |
定位指示灯状态 |
无 |
无 |
无 |
设置定位指示灯状态 |
L1: 基本运维操作 |
| SetFaultIndicatorState |
FaultIndicatorState |
U8 |
故障指示灯状态 |
无 |
无 |
无 |
设置故障指示灯状态 |
L1: 基本运维操作 |
表194. 硬盘指标接口属性说明（bmc.dev.Storage.Drive.Metrics）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| LastUpdateTimestamp |
U32 |
只读 |
最近一次更新Metrics的时间戳 |
L2: 秒级监控基准 |
| PowerOnHours |
Double |
只读 |
物理盘累计通电时间 |
L2: 寿命基础数据；L3: 寿命预测 |
| PredictedMediaLifeLeftPercent |
U8 |
只读 |
物理盘剩余磨损率，取值方法0~100 |
L3: SMART健康评估；L4: AI寿命预测 |
| PredictedFailCount |
U32 |
只读 |
物理盘预故障错误计数 |
L3: 故障预测 |
| MediaErrorCount |
U32 |
只读 |
物理盘介质错误计数 |
L2: 主动健康检查；L3: 根因诊断 |
| OtherErrorCount |
U32 |
只读 |
物理盘其它错误计数 |
L2: 主动健康检查 |
| SLCSpareBlockPercentage |
U8 |
只读 |
单层电子单元区(SLC)剩余有效冗余块占出厂时冗余块总数的百分比，只对SSD有效，取值0~100， 255 表示未知 |
L3: SMART高级评估；L4: AI寿命预测 |
| TLCSpareBlockPercentage |
U8 |
只读 |
三层电子单元区(TLC)剩余有效冗余块占出厂时冗余块总数的百分比，只对SSD有效，取值0~100， 255 表示未知 |
L3: SMART高级评估；L4: AI寿命预测 |
| EstimatedRemainingLifespan |
U32 |
只读 |
预估剩余可使用天数，只对SSD有效，取值0~1825， 0xFFFFFFFF表示未知 |
L3: 寿命预测；L4: AI全生命周期 |
| ElementsInGrownDefectList |
U32 |
只读 |
GLIST计数 |
L3: 高级介质健康诊断 |
| ElementsInPrimaryDefectList |
U32 |
只读 |
PLIST计数 |
L3: 高级介质健康诊断 |
表195. 硬盘配置接口属性说明（bmc.dev.Storage.Drive.Settings）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Hotspare |
U8 |
只读 |
物理盘热备类型 0 - 无热备 1 - 全局热备 2 - 局部热备 3 - 自动替换热备（热备盘替代故障盘成为成员盘，新更换的盘自动成为热备盘） 255 - 未知 |
L2: 热备配置枚举 |
| BootPriority |
U8 |
只读 |
物理盘启动优先级 0 - 无 1 - 主启动设备 |
L2: 启动配置 |
| PatrolState |
U8 |
只读 |
物理盘巡检状态 0 - 未巡检/巡检结束 1 - 巡检中 255 - 未知 |
L2: 巡检状态监控 |
表196. 硬盘配置接口方法说明（bmc.dev.Storage.Drive.Settings Methods）
| 方法名 |
请求参数 |
类型 |
参数说明 |
响应 |
类型 |
响应说明 |
方法说明 |
等级定义 |
| SetHotspare |
HotspareType |
U8 |
驱动器的热备状态 0 = None 1 = Global 2 = Dedicated 3 = Auto |
无 |
无 |
无 |
设置热备类型 |
L2: 标准热备管理 |
|
VolumeId |
U16 |
逻辑盘Id |
|
|
|
|
L2: 标准热备管理 |
| SetBootPriority |
BootPriority |
U8 |
启动优先级 |
无 |
无 |
无 |
设置启动优先级 |
L2: 标准启动管理 |
| SetPatrolState |
PatrolState |
U8 |
巡检状态 |
无 |
无 |
无 |
设置物理盘的巡检状态 |
L2: 标准巡检管理 |
| CryptoErase |
无 |
无 |
无 |
无 |
无 |
无 |
擦除加密盘 |
L3: 高级安全管理 |
表197. 硬盘关联关系接口属性说明（bmc.dev.Storage.Drive.Association）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Component |
String |
只读 |
物理盘关联的Component定义 |
L2: 关联枚举 |
| Entity |
String |
只读 |
物理盘关联的Entity定义 |
L2: 关联枚举 |
| VolumeList |
U16 |
只读 |
物理盘关联的逻辑盘列表 |
L2: 关联枚举 |
| ArrayList |
U16 |
只读 |
物理盘关联的磁盘阵列列表 |
L2: 关联枚举 |
表198. 硬盘阵列接口属性说明（bmc.dev.Storage.DiskArray）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Id |
U16 |
只读 |
磁盘阵列编号，控制器内唯一 |
L1: 基本静态信息 |
| AttachedControllerId |
U8 |
只读 |
磁盘阵列归属的控制器编号 |
L1: 基本关联信息 |
| UsedSpaceMiB |
U32 |
只读 |
磁盘阵列已使用的空间（MB） |
L2: 容量监控 |
| TotalFreeSpaceMiB |
U32 |
只读 |
磁盘阵列总的空闲空间（MB） |
L2: 容量监控 |
| FreeBlocksSpaceMiB |
U32 |
只读 |
磁盘阵列空闲块列表（MB） |
L2: 容量详情枚举 |
| AverageDriveFreeSpaceMiB |
U32 |
只读 |
组建阵列可用硬盘的平均剩余容量 |
L3: 容量规划预测 |
| DriveNumPerSpan |
U8 |
只读 |
每个span的物理盘数量 |
L2: 拓扑枚举 |
| RAIDLevel |
String |
只读 |
阵列中逻辑盘的RAID级别 |
L1: 基本静态信息 |
表199. 硬盘阵列关联关系接口属性说明（bmc.dev.Storage.DiskArray.Association）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| VolumeList |
U16 |
只读 |
磁盘阵列关联的逻辑盘列表 |
L2: 关联枚举 |
| DriveList |
U8 |
只读 |
磁盘阵列关联的物理盘列表 |
L2: 关联枚举 |
表200. Expander接口属性说明（bmc.dev.Storage.Expander）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Id |
U8 |
只读 |
Expander芯片编号（BMC软件分配） |
L1: 基本静态信息 |
| Protocol |
String |
只读 |
Expander芯片协议类型 SAS/SATA NVMe UB |
L1: 基本协议信息 |
表201. Expander物理上下文接口属性说明（bmc.dev.Storage.Expander.PhysicalContext）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| FruType |
String |
只读 |
Expander芯片所属的FRU类型（如硬盘背板） |
L1: 基本位置信息 |
| FruName |
String |
只读 |
Expander芯片所属的FRU名称 |
L1: 基本位置信息 |
| UpstreamDeviceType |
String |
只读 |
上行PHY连接的FRU类型（RAID控制器/Expander） |
L2: 拓扑枚举 |
| UpstreamDeviceName |
String |
只读 |
上行PHY连接的设备名称 |
L2: 拓扑枚举 |
| UpstreamDeviceId |
String |
只读 |
上行PHY连接的设备Id |
L2: 拓扑枚举 |
表202. Expander状态接口属性说明（bmc.dev.Storage.Expander.Status）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Health |
U8 |
只读 |
Expander芯片总体健康状态（正常/轻微/严重/紧急） |
L1: 基本健康状态；L2: 主动健康检查 |
| PhyError |
U8 |
读写 |
Expander芯片PHY链路故障标识 |
L3: PHY链路诊断；L4: AI链路自愈 |
| CommunicationError |
U8 |
只读 |
RAID/HBA控制器与Expander通信错误 |
L2: 通信健康检查；L3: 通信故障诊断 |
表203. Expander的PHY接口属性说明（bmc.dev.Storage.Expander.PHY）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Id |
U16 |
只读 |
PHY编号 |
L2: PHY枚举 |
| Type |
U8 |
只读 |
PHY类型（SAS/PCIe/UB） |
L2: PHY类型枚举 |
| AttachedDeviceType |
U8 |
只读 |
PHY连接的设备类型 |
L2: 拓扑枚举；L3: 链路诊断 |
表204. Expander的PHY统计指标接口属性说明（bmc.dev.Storage.Expander.PHY.Metrics）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| LastUpdateTimestamp |
U32 |
只读 |
最近一次更新Metrics的时间戳 |
L2: 秒级监控基准 |
| InvalidDwordCount |
U32 |
只读 |
Invalid Dword计数 |
L2: 秒级指标监控 |
| LossDwordSyncCount |
U32 |
只读 |
Loss Dword Sync计数 |
L2: 秒级指标监控 |
| PhyResetProblemCount |
U32 |
只读 |
Phy Reset计数 |
L2: 秒级指标监控 |
| RunningDisparityErrorCount |
U32 |
只读 |
Running Disparity错误计数 |
L2: 秒级指标监控 |
十三、NVMe盘接口
表205. NVMe盘基本属性接口属性说明（bmc.dev.NVMe）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Slot |
U8 |
只读 |
槽位号 |
L1: 基本静态信息 |
| MediaType |
U8 |
只读 |
介质类型 |
L1: 基本静态信息 |
| Protocol |
U8 |
只读 |
接口类型 |
L1: 基本静态信息 |
| NegotiatedSpeedGbs |
U8 |
只读 |
协商速率 |
L2: 速率枚举 |
| PredictedMediaLifeLeftPercent |
U8 |
只读 |
剩余磨损率 |
L3: SMART健康评估；L4: AI寿命预测 |
| SpareBlockPercentage |
U8 |
只读 |
空闲块百分比 |
L3: SMART健康评估；L4: AI寿命预测 |
表206. NVMe盘管理配置接口属性说明（bmc.dev.NVMe.Management）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| NvmeProtocol |
U8 |
只读 |
NVMe盘使用的协议（NVMe-MI/SSD Form Factor） |
L2: 协议枚举 |
| SupportedMctpOverPcie |
Boolean |
只读 |
是否支持MCTP Over PCIe |
L2: MCTP能力枚举；L3: 带外管理 |
| SupportedVendorSpecificSmart |
U8 |
只读 |
是否支持厂商自定义SMART信息 |
L4: 厂商扩展能力枚举 |
| VPDChip |
String |
只读 |
读取VPD数据的芯片引用对象 |
L1: 基本FRU关联 |
| SSDChip |
String |
只读 |
读取基础管理数据的芯片引用对象 |
L2: 基础管理关联 |
| RefComponent |
String |
只读 |
硬盘关联的部件对象 |
L2: 部件关联枚举 |
表207. NVMe盘产品信息接口属性说明（bmc.dev.NVMe.ProductInfo）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Model |
String |
只读 |
型号 |
L1: 基本静态信息（VPD读取）；L2: 标准协议枚举（NVMe-MI） |
| SerialNumber |
String |
只读 |
序列号 |
L1: 基本静态信息（VPD读取）；L2: 标准协议枚举（NVMe-MI） |
| Manufacturer |
String |
只读 |
厂商 |
L1: 基本静态信息（VPD读取）；L2: 标准协议枚举（NVMe-MI） |
| ManufacturerId |
String |
只读 |
厂商Id |
L1: 基本静态信息（VPD读取）；L2: 标准协议枚举（NVMe-MI） |
表208. NVMe盘多记录信息接口属性说明（bmc.dev.NVMe.MultiRecord）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Revision |
String |
只读 |
固件版本 |
L2: 标准属性枚举；L3: 升级管理预测 |
| CapacityMiB |
U32 |
只读 |
硬盘容量，以MiB为单位 |
L2: 标准属性枚举；L3: 容量趋势分析 |
| CapableSpeedGbs |
U8 |
只读 |
接口速率（最大速率） |
L2: 标准属性枚举；L3: 性能优化预测 |
表209. NVMe盘状态信息接口属性说明（bmc.dev.NVMe.Status）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Failure |
U8 |
只读 |
故障状态 |
L2: 主动健康检查；L3: 故障预测 |
| PredictiveFailure |
U8 |
只读 |
预故障状态 |
L2: 主动健康检查；L3: 故障预测 |
| MediaErrorCount |
U8 |
只读 |
媒介错误统计 |
L2: 主动健康检查；L3: 根因诊断 |
表210. NVMe盘基础管理接口属性说明（bmc.dev.NVMe.BasicManagement）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Port0PCIeLinkActive |
U8 |
只读 |
端口0的PCIe连接激活状态 |
L2: 秒级监控；L3: 链路诊断 |
| Port1PCIeLinkActive |
U8 |
只读 |
端口1的PCIe连接激活状态 |
L2: 秒级监控；L3: 链路诊断 |
| ResetNotRequired |
U8 |
只读 |
故障恢复是否需要重置 |
L2: 标准恢复；L3: 智能隔离 |
| DriveFunctional |
U8 |
只读 |
硬盘功能性 |
L2: 健康评估；L3: 预测故障 |
| DriveNotReady |
U8 |
只读 |
硬盘未准备完成 |
L2: 健康评估；L3: 预测故障 |
| SMARTWarnings |
U8 |
只读 |
SMART告警 |
L2: 健康评估；L3: 预测故障 |
| PercentageDriveLifeUsed |
U8 |
只读 |
硬盘使用寿命百分比 |
L2: 健康评估；L3: 寿命预测 |
表211. NVMe-MI管理接口方法说明（bmc.dev.NVMe.NVMeMI）
| 方法名 |
请求参数 |
类型 |
参数说明 |
响应 |
类型 |
响应说明 |
方法说明 |
等级定义 |
| GetSmartInfo |
Vendor |
U16 |
指定smart信息为标准协议还是自定义,标准格式传0,自定义传厂商自定义标识 |
MessageResponse |
U8 |
响应报文, 小端字节序排列 |
通过标准NVMe-MI协议获取SMART/Health Information |
L3: 高级带外管理与诊断；L4: AI增强日志 |
| SendNvmeMICommand |
Opcode |
U8 |
该字段指定要处理的 NVMe-MI 命令的操作码 |
Status |
U8 |
该字段为命令的响应码 |
按照标准NVMe-MI协议发送NVMe-MI Command格式命令,请求参数可以参照协议第5章Management Interface Command Set的请求报文填充 |
L3: 高级带外管理与诊断；L4: AI增强日志 |
|
Dword0 |
U32 |
该字段为特定命令的 Dword 0 |
NVMeResponse |
U32 |
该字段为特定命令响应 |
|
L3: 高级带外管理与诊断 |
|
Dword1 |
U32 |
该段为特定命令的 Dword 1 |
|
|
|
|
L3: 高级带外管理与诊断 |
|
RequestData |
U8 |
预留请求字节, 小端字节序排列 |
ResponseData |
U8 |
预留响应字节, 小端字节序排列 |
|
L3: 高级带外管理与诊断 |
| GetTelemetryData |
DataType |
String |
指定收集硬盘host或controller的日志,取值范围：Host/Controller |
Result |
Boolean |
true成功/false失败 |
通过标准NVMe-MI协议获取Telemetry Host/Controller-initiated |
L3: 高级带外管理与诊断；L4: AI增强日志 |
| GetIdentifyData |
CNSValue |
U8 |
指定Controller or Namespace Structure决定该命令返回的数据结构,参考协议的Identify – CNS Values图表定义 |
MessageResponse |
U8 |
响应报文, 小端字节序排列 |
通过标准NVMe-MI协议获取Identify command信息 |
L3: 高级带外管理与诊断；L4: AI增强日志 |
表212. NVMe盘日志收集接口方法说明（bmc.dev.NVMe.LogCollection）
| 方法名 |
请求参数 |
类型 |
参数说明 |
响应 |
类型 |
响应说明 |
方法说明 |
等级定义 |
| DumpErrorInfo |
Path |
String |
NVMe盘错误日志存放路径 |
Result |
Boolean |
true成功/false失败 |
收集NVMe盘错误日志 |
L3: 高级日志诊断；L4: AI自动化收集 |
| DumpSmartInfo |
Path |
String |
NVMe盘Smart日志存放路径 |
Result |
Boolean |
true成功/false失败 |
收集NVMe盘的Smart日志 |
L3: 高级日志诊断；L4: AI自动化收集 |
| DumpSupportedLogPages |
Path |
String |
NVMe盘支持的日志类型存放路径 |
Result |
Boolean |
true成功/false失败 |
收集NVMe盘支持的日志类型 |
L3: 高级日志诊断；L4: AI自动化收集 |
| DumpFirmwareSlotInfo |
Path |
String |
NVMe盘固件插槽信息存放路径 |
Result |
Boolean |
true成功/false失败 |
收集NVMe盘的固件插槽信息 |
L3: 高级日志诊断；L4: AI自动化收集 |
| DumpFeatureIdentifiersLog |
Path |
String |
NVMe盘支持的特性标识存放路径 |
Result |
Boolean |
true成功/false失败 |
收集NVMe盘支持的特性标识日志 |
L3: 高级日志诊断；L4: AI自动化收集 |
| DumpControllerHealthStatus |
Path |
String |
NVMe盘控制器健康状态存放路径 |
Result |
Boolean |
true成功/false失败 |
收集NVMe盘的控制器健康状态 |
L3: 高级日志诊断；L4: AI自动化收集 |
| DumpSubsystemHealthStatus |
Path |
String |
NVMe盘子系统健康状态存放路径 |
Result |
Boolean |
true成功/false失败 |
收集NVMe盘的子系统健康状态 |
L3: 高级日志诊断；L4: AI自动化收集 |
| DumpSubsystemInfo |
Path |
String |
NVMe盘子系统信息存放路径 |
Result |
Boolean |
true成功/false失败 |
收集NVMe盘的子系统信息 |
L3: 高级日志诊断；L4: AI自动化收集 |
表213. NVMe盘SMART信息接口属性说明（bmc.dev.NVMe.Smart）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| Status |
U8 |
只读 |
SMART告警状态 |
L3: 高级健康评估与预测；L4: AI全生命周期 |
| AvailableSpare |
U8 |
只读 |
驱动器可用冗余空间的百分比（0到100） |
L3: 高级健康评估与预测；L4: AI全生命周期 |
| CriticalWarning |
U8 |
只读 |
控制器状态的重要的告警,bit0:表示冗余空间小于设定的阈值,bit1:表示温度超过或低于一个重要的阈值,bit2:表示由于重要的media错误，器件的可靠性已经降低,bit3:该介质已经被置为只读模式,bit4:表示控制器的易失性器件fail，该域仅在控制器内部存在易失性器件时有效,bit5-7:保留 |
L3: 高级健康评估与预测；L4: AI全生命周期 |
| UsedPercentage |
U8 |
只读 |
用户实际使用和厂家设定的器件寿命的百分比（0到100） |
L3: 高级健康评估与预测；L4: AI全生命周期 |
| TLCSpareBlockPercentage |
U8 |
只读 |
用户区剩余冗余块百分比 |
L3: 高级健康评估与预测；L4: AI全生命周期 |
| PowerOnHours |
Double |
只读 |
硬盘通电时间 |
L3: 高级健康评估与预测；L4: AI全生命周期 |
表214. NVMe盘厂商自定义Smart接口属性说明（bmc.dev.NVMe.VendorSpecificSmart）
| 属性名 |
类型 |
可读写 |
描述 |
等级定义 |
| TlcTotalSpareBlock |
U32 |
只读 |
用户区出厂时冗余块总数 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| SlcTotalSpareBlock |
U32 |
只读 |
非用户区出厂时冗余块总数 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| TlcValidSpareBlock |
U32 |
只读 |
用户区当前有效冗余块个数 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| SlcValidSpareBlock |
U32 |
只读 |
非用户区当前有效冗余块个数 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| TlcUsedLifespan |
U32 |
只读 |
用户区根据P/E情况评估的已使用寿命 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| SlcUsedLifespan |
U32 |
只读 |
非用户区根据P/E情况评估的已使用寿命 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| TlcNandWriteLow |
U32 |
只读 |
用户区nand flash写入量低位 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| TlcNandWriteHigh |
U32 |
只读 |
用户区nand flash写入量高位 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| TlcPeCycle |
U32 |
只读 |
用户区擦除次数规格值 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| SlcPeCycle |
U32 |
只读 |
非用户区擦除次数规格值 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| TlcEraseCount |
U32 |
只读 |
用户区擦除次数(最大,最小,平均) |
L4: 扩展厂商自定义监控与AI寿命预测 |
| SlcEraseCount |
U32 |
只读 |
非用户区擦除次数(最大,最小,平均) |
L4: 扩展厂商自定义监控与AI寿命预测 |
| TlcWearout |
U32 |
只读 |
用户区剩余磨损 |
L4: 扩展厂商自定义监控与AI寿命预测 |
| SlcWearout |
U32 |
只读 |
非用户区剩余磨损 |
L4: 扩展厂商自定义监控与AI寿命预测 |