ResourceDefinition
uris
/redfish/v1/Systems/system_id/Storages/storage_id
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|
supported_methods
- GET
- PATCH
- POST
HTTP methods
GET
命令功能
查询指定存储资源信息
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id
请求头:
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| system_id | 系统资源的ID | 参见源文件参数说明 |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
无
使用实例
请求样例:
GET https://device_ip/redfish/v1/Systems/system_id/Storages/storage_idX-Auth-Token: 123456789***********************
请求消息体:无
响应样例:
{
"@odata.context": "/redfish/v1/$metadata#systems/Members/1/Storages/Members/$entity",
"@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0",
"@odata.type": "#Storage.v1_7_0.Storage",
"Id": "RAIDStorage0",
"Name": "RAIDStorage0",
"StorageControllers@odata.count": 1,
"StorageControllers": [
{
"MemberId": "0",
"@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0#/StorageControllers/0",
"@odata.type": "#Storage.v1_7_0.StorageController",
"Name": "RAID Card1 Controller",
"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"
}
}
}
],
"Drives@odata.count": 1,
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk14",
"Id": "HDDPlaneDisk0",
"Name": "Disk0",
"MediaType": "HDD",
"CapacityBytes": 1998998994944,
"Oem": {
"Public": {
"DriveID": "17",
"FirmwareStatus": "Online",
"RelatedArrayInfo": {
"Members": [
"Disk0",
"Disk1"
],
"FreeSpaceMiBPerDrive": 0,
"TotalFreeSpaceMiB": 0,
"FreeBlocksSpaceMib": [
0
],
"NumDrivePerSpan": 2,
"VolumeRaidLevel": "RAID0"
}
}
],
"Volumes": {
"@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes"
},
"Actions": {
"Oem": {
"Public": {
"#Storage.RestoreStorageControllerDefaultSettings": {
"target": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Actions/Oem/Public/Storage.RestoreStorageControllerDefaultSettings",
"@Redfish.ActionInfo": "/redfish/v1/Systems/1/Storages/RAIDStorage0/RestoreStorageControllerDefaultSettingsActionInfo"
},
"#Storage.ImportForeignConfig": {
"target": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Actions/Oem/Public/Storage.ImportForeignConfig",
"@Redfish.ActionInfo": "/redfish/v1/Systems/1/Storages/RAIDStorage0/ ImportForeignConfigActionInfo"
}
}
}
}
}
}
]
}响应码:200
PATCH
命令功能
修改指定控制器资源信息
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id
请求头:
X-Auth-Token: 123456789***********************
Content-Type: header_type
If-Match: ifmatch_value请求消息体:
{
"StorageControllers": [
{
"Oem": {
"Public": {
"CopyBackState": cb_state,
"SmarterCopyBackState": smartcb_state,
"JBODState": jbod_state,
"VolumeConsistencyCheckConfig": {
"Enabled": cc_state,
"PeriodOfHours": cc_period,
"Rate": cc_rate,
"AutoRepairEnabled": cc_autorepair,
"DelayToStart": cc_delay
},
"Mode": mode,
"MaintainPDFailHistory": mt_pdfailhistory,
"BootDevices": [
drive_id,
drive_id
],
"ReadCachePercent": rc_percent,
"NoBatteryWriteCacheEnabled": nbwc_state,
"WriteCachePolicy": {
"ConfiguredDrive": wc_policy,
"UnconfiguredDrive": wc_policy,
"HBADrive": wc_policy
}
}
}
}
]
}URL参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| system_id | 系统资源的ID | ● 针对机架服务器,取值 为1 ● 针对高密服务器,取值 为BladeN(N表示节点 槽位号),例如 “Blade1” ● 针对刀片服务器,取值 可以为BladeN(N表示 计算节点槽位号)或 SwiN(N表示交换模块 槽位号),例如 “Swi1” ● 针对X6800 V5,X6000 V5,G5500,XA320 V2服务器,取值还可以 为Enc,表示计算节点 所在的机框资源 ● 针对设备U位信息,取 值可以为UN(N表示设 备U位号),例如"U1" ● 针对机柜资源,取值为 Rack |
| storage_id | 存储资源的ID | 通过存储集合资源获得。 格式为:RAIDStorage+指 定控制器ID |
请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| CopyBackState | 回拷功能使能状态 | ● true ● false |
| SmarterCopyBackState | SMART错误回拷功能的使 能状态 | ● true ● false 说明:设置为True时要 依赖CopyBackState开 启 |
| JBODState | 驱动器直通功能的使能状 态 | ● true ● false |
| Enabled | 逻辑盘一致性校验功能使 能状态 | ● true ● false 说明:设置为false时, 不能附加其他参数 |
| PeriodOfHours | 逻辑盘一致性校验的周期 | ● 范围为1-1440的整数且 必须为24的倍数 |
| Rate | 逻辑盘一致性校验的速率 | ● Low ● Medium ● High |
| AutoRepairEnabled | 逻辑盘一致性校验过程中 自修复功能的使能状态 | ● true ● false |
| DelayToStart | 逻辑盘一致性校验在多久 后开始 | ● 范围为0-24的整数 说明:设置时需要附加 cc_state为true |
| Mode | 存储控制器的模式 | ● RAID ● JBOD ● HBA ● Mixed 说明 如果RAID控制器类型为 3508/3516/9440-8i/ 9460-8i/9460-16i,并且固 件版本是MR7.9及之后的版 本,需要重启OS设置才能生 效。 |
| MaintainPDFailHistory | 硬盘故障记录功能开闭状 态 | ● true ● false |
| BootDevices | 存储器启动盘的资源ID | ● 逻辑盘资源的ID ● 驱动器资源的ID ● 对应优先级未设置时值 为“None” 说明:二元字符串数组分 别表示第1、2启动优先级 的启动盘资源ID |
| ReadCachePercent | 读缓存百分比 | 范围0~100且必须为5的倍 数 |
| NoBatteryWriteCacheEnabled | 无电池写缓存使能状态 | ● true ● false |
| ConfiguredDrive | 已配置硬盘的写缓存策略 | ● Default:将硬盘的写 缓存保持为默认状态 ● Enabled:打开硬盘的 写缓存功能 ● Disabled:关闭硬盘的 写缓存功能 |
| UnconfiguredDrive | 未配置硬盘的写缓存策略 | ● Default:将硬盘的写 缓存保持为默认状态 ● Enabled:打开硬盘的 写缓存功能 ● Disabled:关闭硬盘的 写缓存功能 |
| HBADrive | HBA硬盘的写缓存策略 | ● Default:将硬盘的写 缓存保持为默认状态 ● Enabled:打开硬盘的 写缓存功能 ● Disabled:关闭硬盘的 写缓存功能 |
使用指南
无
使用实例
请求样例:
PATCH https://device_ip/redfish/v1/Systems/system_id/Storages/storage_idX-Auth-Token: 123456789*********************** Content-Type: header_type If-Match: ifmatch_value
请求消息体:
{
"StorageControllers": [
{
"Oem": {
"Public": {
"CopyBackState": cb_state,
"SmarterCopyBackState": smartcb_state,
"JBODState": jbod_state,
"VolumeConsistencyCheckConfig": {
"Enabled": cc_state,
"PeriodOfHours": cc_period,
"Rate": cc_rate,
"AutoRepairEnabled": cc_autorepair,
"DelayToStart": cc_delay
},
"Mode": mode,
"MaintainPDFailHistory": mt_pdfailhistory,
"BootDevices": [
drive_id,
drive_id
],
"ReadCachePercent": rc_percent,
"NoBatteryWriteCacheEnabled": nbwc_state,
"WriteCachePolicy": {
"ConfiguredDrive": wc_policy,
"UnconfiguredDrive": wc_policy,
"HBADrive": wc_policy
}
}
}
}
]
}响应样例:
{
"@odata.context": "/redfish/v1/$metadata#systems/Members/1/Storages/Members/$entity",
"@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0",
"@odata.type": "#Storage.v1_7_0.Storage",
"Id": "RAIDStorage0",
"Name": "RAIDStorage0",
"StorageControllers@odata.count": 1,
"StorageControllers": [
{
"MemberId": "0",
"@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0#/StorageControllers/0",
"@odata.type": "#Storage.v1_7_0.StorageController",
"Name": "RAID Card1 Controller",
"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"
],
"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",
"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": false,
"SmarterCopyBackState": true,
"JBODState": false,
"OOBSupport": true,
"VolumeConsistencyCheckConfig": {
"Enabled": true,
"PeriodOfHours": 240,
"Rate": "Low",
"AutoRepairEnabled": false,
"RunningStatus": "Off",
"TotalVolumeCounts": 0,
"CompletedVolumeCounts": 255,
"DelayToStart": 1
},
"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"
}
}
}
],
"Drives@odata.count": 1,
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk14",
"Id": "HDDPlaneDisk0",
"Name": "Disk0",
"MediaType": "HDD",
"CapacityBytes": 1998998994944,
"Oem": {
"Public": {
"DriveID": "17",
"FirmwareStatus": "Online",
"RelatedArrayInfo": {
"Members": [
"Disk0",
"Disk1"
],
"FreeSpaceMiBPerDrive": 0,
"TotalFreeSpaceMiB": 0,
"FreeBlocksSpaceMib": [
0
],
"NumDrivePerSpan": 2,
"VolumeRaidLevel": "RAID0"
}
}
}
}
],
"Volumes": {
"@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes"
},
"Actions": {
"Oem": {
"Public": {
"#Storage.RestoreStorageControllerDefaultSettings": {
"target": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Actions/Oem/Public/Storage.RestoreStorageControllerDefaultSettings",
"@Redfish.ActionInfo": "/redfish/v1/Systems/1/Storages/RAIDStorage0/RestoreStorageControllerDefaultSettingsActionInfo"
},
"#Storage.ImportForeignConfig": {
"target": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Actions/Oem/Public/Storage.ImportForeignConfig",
"@Redfish.ActionInfo": "/redfish/v1/Systems/1/Storages/RAIDStorage0/ImportForeignConfigActionInfo"
}
}
}
}
}响应码:200
POST (ACTION)
ImportForeignConfig
命令功能
导入 Foreign 配置
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage.ImportForeignConfig
请求头:
X-Auth-Token: 123456789***********************
Content-Type: header_type请求消息体:
{}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| system_id | 系统资源的ID | ● 针对机架服务器,取值 为1 ● 针对高密服务器,取值 为BladeN(N表示节点 槽位号),例如 “Blade1” ● 针对刀片服务器,取值 可以为BladeN(N表示 计算节点槽位号)或 SwiN(N表示交换模块 槽位号),例如 “Swi1” |
| storage_id | 存储资源的ID | 通过存储集合资源获得。 |
使用指南
无
使用实例
请求样例:
POST https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage. ImportForeignConfigX-Auth-Token: 123456789*********************** Content-Type: header_type
请求消息体:
{}响应样例:
{
"error": {
"code": "Base.1.0.GeneralError",
"message": "A general error has occurred. See ExtendedInfo for more information.",
"@Message.ExtendedInfo": [
{
"@odata.type": "#Message.v1_0_0.Message",
"MessageId": "Base.1.0.Success",
"RelatedProperties": [],
"Message": "Successfully Completed Request",
"MessageArgs": [],
"Severity": "OK",
"Resolution": "None"
}
]
}
}响应码:200
POST (ACTION)
ClearForeignConfig
命令功能
清除 Foreign 配置
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage.ClearForeignConfig
请求头:
X-Auth-Token: 123456789***********************
Content-Type: header_type请求消息体:
{}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| system_id | 系统资源的ID | ● 针对机架服务器,取值 为1 ● 针对高密服务器,取值 为BladeN(N表示节点 槽位号),例如 “Blade1” ● 针对刀片服务器,取值 可以为BladeN(N表示 计算节点槽位号)或 SwiN(N表示交换模块 槽位号),例如 “Swi1” ● 针对X6800 V5,X6000 V5,G5500,XA320 V2服务器,取值还可以 为Enc,表示计算节点 所在的机框资源 ● 针对设备U位信息,取 值可以为UN(N表示设 备U位号),例如"U1" ● 针对机柜资源,取值为 Rack |
| storage_id | 存储资源的ID | 通过存储集合资源获得。 |
使用指南
无
使用实例
请求样例:
POST https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage.ClearForeignConfigX-Auth-Token: 123456789*********************** Content-Type: header_type
请求消息体:
{}响应样例:
{
"error": {
"code": "Base.1.0.GeneralError",
"message": "A general error has occurred. See ExtendedInfo for more information.",
"@Message.ExtendedInfo": [
{
"@odata.type": "#Message.v1_0_0.Message",
"MessageId": "Base.1.0.Success",
"RelatedProperties": [],
"Message": "Successfully Completed Request",
"MessageArgs": [],
"Severity": "OK",
"Resolution": "None"
}
]
}
}响应码:200
POST (ACTION)
RestoreStorageControllerDefaultSettings
命令功能
恢复指定控制器的默认配置
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage.RestoreStorageControllerDefaultSettings
请求头:
X-Auth-Token: 123456789***********************
Content-Type: header_type请求消息体:
{}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| system_id | 系统资源的ID | ● 针对机架服务器,取值 为1 ● 针对高密服务器,取值 为BladeN(N表示节点 槽位号),例如 “Blade1” ● 针对刀片服务器,取值 可以为BladeN(N表示 计算节点槽位号)或 SwiN(N表示交换模块 槽位号),例如 “Swi1” ● 针对X6800 V5,X6000 V5,G5500,XA320 V2服务器,取值还可以 为Enc,表示计算节点 所在的机框资源 ● 针对设备U位信息,取 值可以为UN(N表示设 备U位号),例如"U1" ● 针对机柜资源,取值为 Rack |
| storage_id | 存储资源的ID | 通过存储集合资源获得。 |
使用指南
如果RAID控制器类型为3508/3516/9440-8i/9460-8i/9460-16i,并且固件版本是MR7.9及之后的版本,恢复RAID控制器默认设置,需要重启OS才能生效。
使用实例
请求样例:
POST https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage.RestoreStorageControllerDefaultSettingsX-Auth-Token: 123456789*********************** Content-Type: header_type
请求消息体:
{}响应样例:
{
"error": {
"code": "Base.1.0.GeneralError",
"message": "A general error has occurred. See ExtendedInfo for more information.",
"@Message.ExtendedInfo": [
{
"@odata.type": "#Message.v1_0_0.Message",
"MessageId": "Base.1.0.Success",
"RelatedProperties": [],
"Message": "Successfully Completed Request",
"MessageArgs": [],
"Severity": "OK",
"Resolution": "None"
}
]
}
}响应码:200