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 {	object	true	-	当前存储控制器的列表
`Metrics.@odata.id`	string	true	-	指定存储控制器的访问路径
}
Status {	object	true	-	指定存储控制器的状态，包括： ● State：存储控制器使能状态 ● Health：存储控制器健康状态 ● Severity：存储控制器的自定义健康状态 ● FaultDetails：指定存储控制器的故障信息
Status.Health	string	true	-	指定存储资源的健康状态，包括： ● OK：正常 ● Warning：警告 ● Critical：严重 ● null
Status.Oem {	object	true	-	自定义属性
Status.Oem.Public {	object	false	-	自定义属性
Status.Oem.Public.FaultDetails	string	true	-	自定义状态信息
Status.Oem.Public.Severity	string	false	-	自定义状态信息
}
}
Status.State	string	true	-	指定存储的状态 ● Offline：离线 ● Partiallydegraded：部分降级 ● Degraded：降级 ● Optimal：正常 ● Failed：故障 ● Not Configured：未配置 ● Interimrecovery：临时恢复 ● Readyfor recovery：准备恢复 ● Recovering：恢复中 ● Wrongdrive replaced：错误硬盘被替换 ● Driveimproperly connected：硬盘连接不正确 ● Expanding：扩容中 ● Not available：不可用 ● Queuedfor expansion：排队等待扩容 ● Disabledfrom SCSIconflict：SCSI冲突禁用 ● Ejected：已弹出 ● Erasein progress：擦除进行中 ● Unused：未使用 ● Readyto performpredictive sparerebuild：准备执行预测性热备重建 ● RPIin progress：RPI进行中 ● RPI queued：RPI排队中 ● Encryptedwithoutkey：加密但无密钥 ● Encryptionmigration：加密迁移中 ● Encrypted & re-keying：加密且正在重新密钥 ● Encryptedwith encryptionoff：加密但加密已关闭 ● Volumeencode requested：请求卷编码 ● Encryptedwithre-key request：加密且有重新密钥请求 ● Unsupported：不支持 ● Not Formatted：未格式化 ● Formatting：格式化中 ● Sanitizing：安全擦除中
}
SpeedGbps	number	true	-	指定存储控制器的接口速率
SerialNumber	string	true	-	指定存储控制器的序列号
FirmwareVersion	string	true	-	指定存储控制器的固件版本
SupportedDeviceProtocols[ ]	array	true	-	指定存储控制器支持的协议类型 ● SPI：串行外设接口 ● PCIe：高速外设部件互连标准 ● AHCI：高级主机控制器接口 ● UHCI：通用主机控制器接口 ● SAS：串行连接SCSI ● SATA：串行高级技术附件 ● USB：通用串行总线 ● NVMe：非易失性内存主机控制器接口规范 ● FC：光纤通道接口 ● iSCSI：互联网小型计算机系统接口 ● FCoE：以太网光纤通道协议 ● NVMeOverFabrics：织物网络上的NVMe ● SMB：服务器消息块协议 ● NFSv3：网络文件系统第3版 ● NFSv4：网络文件系统第4版 ● HTTP：超文本传输协议 ● HTTPS：安全超文本传输协议 ● FTP：文件传输协议 ● SFTP：安全文件传输协议
Manufacturer	string	true	-	指定存储控制器生产厂商
Model	string	true	-	指定存储控制器型号
CacheSummary {	object	true	-	指定存储控制器缓存概要信息
CacheSummary.TotalCacheSizeMiB	number	true	-	指定存储控制器缓存大小
}
SupportedRAIDTypes[ ]	array	true	-	指定存储控制器支持的RAID级别 ● RAID0：条带化存储 ● RAID1：镜像存储 ● RAID5：带分布式校验的条带化 ● RAID6：带双重分布式校验的条带化 ● RAID10：镜像阵列条带化 ● RAID50：分布式校验条带化组合 ● RAID60：双重校验条带化组合 ● RAID1(ADM)：高级数据镜像 ● RAID10(ADM)：高级数据镜像条带化 ● RAID1Triple：三重镜像 ● RAID10Triple：三重镜像条带化
Oem {	object	true	-	自定义属性
Oem.Public {	object	false	-	自定义属性
Oem.Public.AssociatedCard {	object	true	-	指定存储控制器所关联的卡的资源导航
`Oem.Public.AssociatedCard.@odata.id`	string	true	-	指定存储控制器的访问路径
}
Oem.Public.Mode	string	true	-	指定存储控制器的模式 ● RAID：磁盘阵列 ● HBA：主机总线适配器 ● JBOD：磁盘机组 ● Mixed：混合模式
Oem.Public.CachePinnedState	boolean	true	-	指定存储驱动Cache Pinned使能状态
Oem.Public.SupportedRAIDLevels[ ]	array	true	-	指定存储控制器支持的RAID级别 ● RAID0：条带化存储 ● RAID1：镜像存储 ● RAID5：带分布式校验的条带化 ● RAID6：带双重分布式校验的条带化 ● RAID10：镜像阵列条带化 ● RAID50：分布式校验条带化组合 ● RAID60：双重校验条带化组合 ● RAID1(ADM)：高级数据镜像 ● RAID10(ADM)：高级数据镜像条带化 ● RAID1Triple：三重镜像 ● RAID10Triple：三重镜像条带化
Oem.Public.VolumeSupported	boolean	true	-	指定存储控制器是否支持组逻辑盘
Oem.Public.ReadPolicy {	object	true	-	指定存储控制器组逻辑盘时读策略选项
Oem.Public.ReadPolicy.Configurable	boolean	true	-	指定策略是否支持自定义
Oem.Public.ReadPolicy.SupportedPolicy[ ]	array	true	-	指定策略的自定义选项
}
Oem.Public.WritePolicy {	object	true	-	指定存储控制器组逻辑盘时写策略选项
Oem.Public.WritePolicy.Configurable	boolean	true	-	指定策略是否支持自定义
Oem.Public.WritePolicy.SupportedPolicy[ ]	array	true	-	指定策略的自定义选项
}
Oem.Public.CachePolicy {	object	true	-	指定存储控制器组逻辑盘时IO策略选项
Oem.Public.CachePolicy.Configurable	boolean	true	-	指定策略是否支持自定义
Oem.Public.CachePolicy.SupportedPolicy[ ]	array	true	-	指定策略的自定义选项
}
Oem.Public.AccessPolicy {	object	true	-	指定存储控制器组逻辑盘时访问策略选项
Oem.Public.AccessPolicy.Configurable	boolean	true	-	指定策略是否支持自定义
Oem.Public.AccessPolicy.SupportedPolicy[ ]	array	true	-	指定策略的自定义选项
}
Oem.Public.DriveCachePolicy {	object	true	-	指定存储控制器组逻辑盘时物理盘缓存策略选项
Oem.Public.DriveCachePolicy.Configurable	boolean	true	-	指定策略是否支持自定义
Oem.Public.DriveCachePolicy.SupportedPolicy[ ]	array	true	-	指定策略的自定义选项
}
Oem.Public.Type	string	true	-	指定存储控制器的类型
Oem.Public.JbodStateSupported	boolean	true	-	指定控制器是否支持JBOD模式
Oem.Public.EpdSupported	boolean	true	-	指定控制器是否支持EPD模式
Oem.Public.SASAddress	string	true	-	指定存储控制器地址
Oem.Public.ConfigurationVersion	string	true	-	指定存储控制器配置版本
Oem.Public.PCIeLinkWidth	string	true	-	PCIe带宽
Oem.Public.ReadCachePercent	number	true	-	读缓存比例百分比
Oem.Public.SpareActivationMode	string	true	-	热备激活模式 ● Failure：硬盘故障时激活热备盘 ● Predictive：硬盘预故障时激活热备盘
Oem.Public.NoBatteryWriteCacheEnabled	boolean	true	-	无电池写缓存使能状态
Oem.Public.BootDevices[ ]	array	true	-	指定存储器启动盘的资源ID。长度为2的固定数组，每个成员分别对应第一、第二优先级的存储器启动盘资源ID，对应优先级未设置时值为“None”
Oem.Public.WriteCachePolicy	object	true	-	硬盘写缓存策略
Oem.Public.MemorySizeMiB	number	true	-	指定存储控制器内存容量
Oem.Public.MaintainPDFailHistory	boolean	true	-	指定存储驱动器故障记录功能的使能状态
Oem.Public.CopyBackState	boolean	true	-	指定存储控制器回拷功能使能状态
Oem.Public.SmarterCopyBackState	boolean	true	-	指定存储控制器SMART错误回拷功能的使能状态
Oem.Public.JBODState	boolean	true	-	驱动器直通功能的使能状态
Oem.Public.VolumeConsistencyCheckConfig {	object	true	-	卷一致性检查配置信息
Oem.Public.VolumeConsistencyCheckConfig.Enabled	boolean	true	-	一致性检验功能使能状态
Oem.Public.VolumeConsistencyCheckConfig.PeriodOfHours	number	true	-	一致性校验周期（单位：小时）
Oem.Public.VolumeConsistencyCheckConfig.Rate	string	true	-	一致性校验速率，包括： ● Low：低 ● Medium：中 ● High：高
Oem.Public.VolumeConsistencyCheckConfig.AutoRepairEnabled	boolean	true	-	一致性校验自动修复功能使能状态
Oem.Public.VolumeConsistencyCheckConfig.RunningStatus	string	true	-	一致性校验功能运行状态
Oem.Public.VolumeConsistencyCheckConfig.TotalVolumeCounts	number	true	-	需要进行一致性校验的逻辑盘总数
Oem.Public.VolumeConsistencyCheckConfig.CompletedVolumeCounts	number	true	-	已完成一致性校验的逻辑盘总数
Oem.Public.VolumeConsistencyCheckConfig.DelayToStart	number	true	-	本次一致性校验推迟多长时间启动（单位：小时）
}
Oem.Public.OOBSupport	boolean	true	-	控制器是否支持带外管理
Oem.Public.CapacitanceName	string	true	-	指定存储控制器BBU名称
Oem.Public.CapacitanceStatus {	object	true	-	指定存储控制器电容 (BBU)状态，包括： ● Health：存储控制器健康状态 ● State：存储控制器使能状态 ● Severity：存储控制器的自定义健康状态 ● FaultDetails：存储控制器电容故障信息
Oem.Public.CapacitanceStatus.FaultDetails	null	true	-	自定义状态信息
Oem.Public.CapacitanceStatus.Health	string	true	-	指定存储资源的健康状态，包括： ● OK：正常 ● Warning：警告 ● Critical：严重 ● null
Oem.Public.CapacitanceStatus.Severity	string	true	-	错误严重级别，包括： ● OK：正常 ● Warning：警告 ● Critical：严重
Oem.Public.CapacitanceStatus.State	string	true	-	省、州
}
Oem.Public.DDRECCCount	number	true	-	指定存储控制器内存可纠错的错误计数
Oem.Public.MinStripeSizeBytes	number	true	-	控制器支持最小条带值
Oem.Public.MaxStripeSizeBytes	number	true	-	控制器支持最大条带值
Oem.Public.DriverInfo {	object	true	-	驱动信息
Oem.Public.DriverInfo.DriverName	string	true	-	指定控制器驱动名称
Oem.Public.DriverInfo.DriverVersion	string	true	-	指定控制器驱动版本
}
Oem.Public.PHYStatus [ {	array	true	-	指定控制器物理层误码状态
Oem.Public.PHYStatus[].PhyId	number	true	-	PHY索引编号
Oem.Public.PHYStatus[].InvalidDwordCount	number	true	-	无效DWORD数
Oem.Public.PHYStatus[].LossDwordSyncCount	number	true	-	丢失DWORD同步数
Oem.Public.PHYStatus[].PhyResetProblemCount	number	true	-	PHY重启问题数
Oem.Public.PHYStatus[].RunningDisparityErrorCount	number	true	-	连续不均衡性错误数
} ]
Oem.Public.BDF	string	true	-	BDF值： ● Bus：总线 ● Device：设备 ● Function：功能 ● null
Oem.Public.VenderID	string	true	-	厂商ID
Oem.Public.DeviceID	string	true	-	设备ID
Oem.Public.SubsystemVenderID	string	true	-	厂商子ID
Oem.Public.SubsystemDeviceID	string	true	-	设备子ID
Oem.Public.DeviceName	string	true	-	设备名称
Oem.Public.Position	string	true	-	设备位置
}
}
ConfiguredDrive	string	true	-	RAID/Mixed模式下RAID组成员盘的写缓存策略 Default：将硬盘的写缓存保持为默认状态 Enabled：打开硬盘的写缓存功能 Disabled：关闭硬盘的写缓存功能说明：
HBADrive	string	true	-	HBA模式下硬盘的写缓存策略 Default：将硬盘的写缓存保持为默认状态 Enabled：打开硬盘的写缓存功能 Disabled：关闭硬盘的写缓存功能
UnconfiguredDrive	string	true	-	RAID/Mixed模式下非RAID组成员盘的写缓存策略 Default：将硬盘的写缓存保持为默认状态 Enabled：打开硬盘的写缓存功能 Disabled：关闭硬盘的写缓存功能

supported_methods

HTTP methods

GET

命令功能

查询指定存储控制器资源信息

命令格式

URL: https://device_ip/redfish/v1/Systems/system_id/Storage/storage_id/Controllers/storagecontroller_id

请求头:

text


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_id>

X-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": {
"DeviceName": "RAIDCard0",
"Position": "0",
"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

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET