Controllers
更新时间： 2026/06/26
在Gitcode上查看源码ResourceDefinition
uris
/redfish/v1/Systems/system_id/Storage/storage_id/Controllers/storagecontroller_id
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 指定存储资源模型的OData描述信息 |
| @odata.id | string | true | - | 指定存储控制器的访问路径 |
| @odata.type | string | true | - | 指定存储控制器的资源类型 |
| Id | string | true | - | 指定控制器标识 |
| Name | string | true | - | 指定存储控制器的名称 |
| Description | string | true | - | 指定存储控制器的描述信息 |
| Metrics | string | true | - | 当前存储控制器的列表 |
| @odata.id | string | true | - | 指定存储控制器的访问路径 |
| Status | object | true | - | 指定存储控制器的状态， 包括： ● State：存储控制器使能状态 ● Health：存储控制器健康状态 ● Severity：存储控制器的自定义健康状态 ● FaultDetails：指定存储控制器的故障信息 |
| SpeedGbps | number | true | - | 指定存储控制器的接口速率 |
| SerialNumber | string | true | - | 指定存储控制器的序列号 |
| FirmwareVersion | string | true | - | 指定存储控制器的固件版本 |
| SupportedDeviceProtocols | array | true | - | 指定存储控制器支持的协议类型 ● SPI ● PCIe ● AHCI ● UHCI ● SAS ● SATA ● USB ● NVMe ● FC ● iSCSI ● FCoE ● NVMeOverFabrics ● SMB ● NFSv3 ● NFSv4 ● HTTP ● HTTPS ● FTP ● SFTP |
| Manufacturer | string | true | - | 指定存储控制器生产厂商 |
| Model | string | true | - | 指定存储控制器型号 |
| CacheSummary | object | true | - | 指定存储控制器缓存概要信息 |
| TotalCacheSizeMiB | number | true | - | 指定存储控制器缓存大小 |
| SupportedRAIDTypes | array | true | - | 指定存储控制器支持的RAID级别 ● RAID0 ● RAID1 ● RAID5 ● RAID6 ● RAID10 ● RAID50 ● RAID60 ● RAID1(ADM) ● RAID10(ADM) ● RAID1Triple ● RAID10Triple |
| AssociatedCard | object | true | - | 指定存储控制器所关联的卡的资源导航 |
| Mode | string | true | - | 指定存储控制器的模式 ● RAID ● HBA ● JBOD ● Mixed |
| CachePinnedState | boolean | true | - | 指定存储驱动Cache Pinned使能状态 |
| SupportedRAIDLevels | array | true | - | 指定存储控制器支持的RAID级别 ● RAID0 ● RAID1 ● RAID5 ● RAID6 ● RAID10 ● RAID50 ● RAID60 ● RAID1(ADM) ● RAID10(ADM) ● RAID1Triple ● RAID10Triple |
| VolumeSupported | boolean | true | - | 指定存储控制器是否支持组逻辑盘 |
| ReadPolicy | object | true | - | 指定存储控制器组逻辑盘时读策略选项 |
| Configurable | boolean | true | - | 指定策略是否支持自定义 |
| SupportedPolicy | array | true | - | 指定策略的自定义选项 |
| WritePolicy | object | true | - | 指定存储控制器组逻辑盘时写策略选项 |
| CachePolicy | object | true | - | 指定存储控制器组逻辑盘时IO策略选项 |
| AccessPolicy | object | true | - | 指定存储控制器组逻辑盘时访问策略选项 |
| DriveCachePolicy | object | true | - | 指定存储控制器组逻辑盘时物理盘缓存策略选项 |
| Type | string | true | - | 指定存储控制器的类型 |
| JbodStateSupported | boolean | true | - | 指定控制器是否支持JBOD模式 |
| EpdSupported | boolean | true | - | 指定控制器是否支持EPD模式 |
| SASAddress | string | true | - | 指定存储控制器地址 |
| ConfigurationVersion | string | true | - | 指定存储控制器配置版本 |
| PCIeLinkWidth | string | true | - | PCIe带宽 |
| ReadCachePercent | number | true | - | 读缓存比例百分比 |
| SpareActivationMode | string | true | - | 热备激活模式 ● Failure：硬盘故障时激活热备盘 ● Predictive：硬盘预故障时激活热备盘 |
| NoBatteryWriteCacheEnabled | boolean | true | - | 无电池写缓存使能状态 |
| BootDevices | array | true | - | 指定存储器启动盘的资源ID。长度为2的固定数组， 每个成员分别对应第一、 第二优先级的存储器启动盘资源ID，对应优先级未设置时值为“None” |
| WriteCachePolicy | object | true | - | 硬盘写缓存策略 |
| ConfiguredDrive | string | true | - | RAID/Mixed模式下RAID组成员盘的写缓存策略 ● Default：将硬盘的写缓存保持为默认状态 ● Enabled：打开硬盘的写缓存功能 ● Disabled：关闭硬盘的写缓存功能 说明 |
| UnconfiguredDrive | string | true | - | RAID/Mixed模式下非RAID组成员盘的写缓存策略 ● Default：将硬盘的写缓存保持为默认状态 ● Enabled：打开硬盘的写缓存功能 ● Disabled：关闭硬盘的写缓存功能 |
| HBADrive | string | true | - | HBA模式下硬盘的写缓存策略 ● Default：将硬盘的写缓存保持为默认状态 ● Enabled：打开硬盘的写缓存功能 ● Disabled：关闭硬盘的写缓存功能 |
| MemorySizeMiB | number | true | - | 指定存储控制器内存容量 |
| MaintainPDFailHistory | boolean | true | - | 指定存储驱动器故障记录功能的使能状态 |
| CopyBackState | boolean | true | - | 指定存储控制器回拷功能使能状态 |
| SmarterCopyBackState | boolean | true | - | 指定存储控制器SMART错误回拷功能的使能状态 |
| JBODState | boolean | true | - | 驱动器直通功能的使能状态 |
| Enabled | boolean | true | - | 一致性检验功能使能状态 |
| PeriodOfHours | number | true | - | 一致性校验周期（单位： 小时） |
| Rate | string | true | - | 一致性校验速率，包括： ● Low ● Medium ● High |
| AutoRepairEnabled | boolean | true | - | 一致性校验自动修复功能使能状态 |
| RunningStatus | string | true | - | 一致性校验功能运行状态 |
| TotalVolumeCounts | number | true | - | 需要进行一致性校验的逻辑盘总数 |
| CompletedVolumeCounts | number | true | - | 已完成一致性校验的逻辑盘总数 |
| DelayToStart | number | true | - | 本次一致性校验推迟多长时间启动（单位：小时） |
| OOBSupport | boolean | true | - | 控制器是否支持带外管理 |
| CapacitanceName | string | true | - | 指定存储控制器BBU名称 |
| CapacitanceStatus | object | true | - | 指定存储控制器电容 (BBU)状态，包括： ● Health：存储控制器健康状态 ● State：存储控制器使能状态 ● Severity：存储控制器的自定义健康状态 ● FaultDetails：存储控制器电容故障信息 |
| DDRECCCount | number | true | - | 指定存储控制器内存可纠错的错误计数 |
| MinStripeSizeBytes | number | true | - | 控制器支持最小条带值 |
| MaxStripeSizeBytes | number | true | - | 控制器支持最大条带值 |
| DriveInfo | object | true | - | 指定控制器驱动信息 |
| DriverName | string | true | - | 指定控制器驱动名称 |
| DriverVersion | string | true | - | 指定控制器驱动版本 |
| PHYStatus | object | true | - | 指定控制器物理层误码状态 |
| PhyId | number | true | - | PHY索引编号 |
| InvalidDwordCount | number | true | - | 无效DWORD数 |
| LossDwordSyncCount | number | true | - | 丢失DWORD同步数 |
| PhyResetProblemCount | number | true | - | PHY重启问题数 |
| RunningDisparityErrorCount | number | true | - | 连续不均衡性错误数 |
| BDF | string | true | - | BDF值： ● Bus ● Device ● Function ● null |
| VenderID | number | true | - | 厂商ID |
| DeviceID | number | true | - | 设备ID |
| SubsystemVenderID | number | true | - | 厂商子ID |
| SubsystemDeviceID | number | true | - | 设备子ID |
supported_methods
- GET
HTTP methods
GET
命令功能
查询指定存储控制器资源信息
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storage/storage_id/Controllers/storagecontroller_id
请求头:
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| system_id | 系统资源的ID | 参见源文件参数说明 |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
无
使用实例
请求样例：
http
GET https://device_ip/redfish/v1/Systems/system_id/Storage/storage_id/Controllers/storagecontroller_idX-Auth-Token: 123456789***********************
请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#StorageController.StorageController",
"@odata.id": "/redfish/v1/Systems/1/Storage/RAIDStorage0/Controllers/0",
"@odata.type": "#StorageController.v1_10_0.StorageController",
"Id": "0",
"Name": "PCIe Card 6 (SAS 3152) Controller",
"Metrics": {
"@odata.id": "/redfish/v1/Systems/1/Storage/RAIDStorage0/Controllers/0/Metrics"
},
"Description": "RAID Controller",
"Status": {
"Health": "OK",
"Oem": {
"Public": {
"Severity": "Informational",
"FaultDetails": "Memory correctable errors"
}
},
"State": "Enabled"
},
"SpeedGbps": 12,
"FirmwareVersion": "5.060.00-2139",
"SupportedDeviceProtocols": [
"SAS"
],
"SerialNumber": "2102313XXFFSN7000454",
"Manufacturer": "LSI",
"Model": ：,
"SAS3508": ,,
"CacheSummary": {
"TotalCacheSizeMiB": 2048
},
"SupportedRAIDTypes": [
"RAID0",
"RAID1",
"RAID5",
"RAID6",
"RAID10",
"RAID50",
"RAID60"
],
"Oem": {
"Public": {
"AssociatedCard": {
"@odata.id": "/redfish/v1/Chassis/1/PCIeDevices/PCIeCard6"
},
"Mode": "RAID",
"CachePinnedState": true,
"SupportedRAIDLevels": [
"RAID0",
"RAID1",
"RAID5",
"RAID6",
"RAID10",
"RAID50",
"RAID60"
],
"VolumeSupported": true,
"ReadPolicy": {
"Configurable": true,
"SupportedPolicy": [
"NoReadAhead",
"ReadAhead"
]
},
"WritePolicy": {
"Configurable": true,
"SupportedPolicy": [
"WriteThrough",
"WriteBackWithBBU",
"WriteBack"
]
},
"CachePolicy": {
"Configurable": true,
"SupportedPolicy": [
"CachedIO",
"DirectIO"
]
},
"AccessPolicy": {
"Configurable": true,
"SupportedPolicy": [
"ReadWrite",
"ReadOnly",
"Blocked"
]
},
"DriveCachePolicy": {
"Configurable": true,
"SupportedPolicy": [
"Unchanged",
"Enabled",
"Disabled"
]
},
"Type": "LSI SAS3508",
"JbodStateSupported": false,
"EpdSupported": true,
"SASAddress": "59c741a5628b4000",
"ConfigurationVersion": "5.0600.03-0012",
"PCIeLinkWidth": "x8",
"ReadCachePercent": null,
"SpareActivationMode": null,
"NoBatteryWriteCacheEnabled": null,
"BootDevices": [
"HDDPlaneDisk14",
"None"
],
"WriteCachePolicy": null,
"MemorySizeMiB": 2048,
"MaintainPDFailHistory": true,
"CopyBackState": true,
"SmarterCopyBackState": true,
"JBODState": false,
"VolumeConsistencyCheckConfig": {
"Enabled": true,
"PeriodOfHours": 240,
"Rate": "Low",
"AutoRepairEnabled": true,
"RunningStatus": "Off",
"TotalVolumeCounts": 0,
"CompletedVolumeCounts": 255,
"DelayToStart": 0
},
"OOBSupport": true,
"CapacitanceName": "CVPM02",
"CapacitanceStatus": {
"Health": "OK",
"Severity": "Informational",
"FaultDetails": null,
"State": "Enabled"
},
"DriverInfo": {
"DriverName": "megaraid_sas",
"DriverVersion": "06.806.08.080"
},
"DDRECCCount": 1,
"MinStripeSizeBytes": 65536,
"MaxStripeSizeBytes": 1048576,
"PHYStatus": [
{
"PhyId": 1,
"InvalidDwordCount": 0,
"LossDwordSyncCount": 0,
"PhyResetProblemCount": 0,
"RunningDisparityErrorCount": 0
}
],
"BDF"："0000:16:02.0",
"VenderID": "0x1000",
"DeviceID": "0x0016",
"SubsystemVenderID": "0x19e5",
"SubsystemDeviceID": "0xd215"
}
}
}响应码：200