GET – Storage controller properties
Use the GET method to retrieve the properties of storage resource for a server.
Request URL
GET https://<BMC_IPADDR>/redfish/v1/Systems/1/Storage/{Id}
Response body
Field | Type | Description | ||||
---|---|---|---|---|---|---|
Drives | Array | Drives connected to selected controller. | ||||
Drives[N] | Object | Link to Drives. | ||||
Description | String | This resource is used to represent a storage for a Redfish implementation. | ||||
Volumes | Array | The volumes created by the controller. | ||||
Id | String | The identifier of this resource. | ||||
HotspareActivationPolicy | String | The policy under which hot spare drives in this storage domain will activate. | ||||
Links | Object | The links to other resources that are related to this resource. | ||||
Name | String | The name of this resource. | ||||
Status | Object | Expanded. | ||||
State | String | Enabled | ||||
Health | String | Overall health info of this storage, including the controller, drive and volume. | ||||
HealthRollup | String | This represents the overall health state from the view of this resource. | ||||
StoragePools | Link | Link to the storage pool collection. Note If the storage is a raid storage controller, this object will be displayed. | ||||
StorageControllers | Array | Controller info of the selected storage | ||||
StorageControllers[N] | Object | Expanded. | ||||
MemberId | String | This is the identifier for the member within the collection. | ||||
SupportedRAIDTypes | Array | The set of RAID types supported by the storage controller. | ||||
SupportedRAIDTypes[N] | String | Expanded. | ||||
FirmwareVersion | String | Controller’s firmware info. Note If the storage is direct attached storage, this property will be hidden. | ||||
Identifiers | Array | Items: the durable names of the storage controller. Item count: 1 Note If the storage is a direct attached storage, this array will be hidden. | ||||
Identifiers[N] | Object | Expanded. | ||||
DurableNameFormat | String | “UUID” Note If the storage is a direct attached storage, this object will be hidden. | ||||
DurableName | String | The UUID of this storage controller. Note If the storage is a direct attached storage, this object will be hidden. | ||||
Manufacturer | String | The manufacturer of this storage controller. | ||||
Model | String | This is the model number for the storage controller | ||||
Name | String | The name of the Storage Controller. | ||||
CacheSummary | Object | The cache memory of the storage controller in general detail. Note If the storage is M.2/7mm or NVMe storage, this object will be hidden. | ||||
TotalCacheSizeMiB | Integer | The total configured cache memory, measured in MiB. | ||||
PersistentCacheSizeMiB | Integer | The portion of the cache memory that is persistent, measured in MiB. | ||||
Status | Object | The status for the cache summary of this storage controller. | ||||
State | String | The state for the cache summary of this storage controller. Possible values are “Enabled” and “Disabled”. | ||||
Health | String | The health for the cache summary of this storage controller. | ||||
ControllerRates | Object | This property describes the various controller rates used for processes such as volume rebuild or consistency checks. | ||||
ConsistencyCheckRatePercent | Integer | The percentage of controller resources used for performing a data consistency check on volumes. | ||||
RebuildRatePercent | Integer | The percentage of controller resources used for rebuilding/repairing volumes. | ||||
TransformationRatePercent | Integer | The percentage of controller resources used for transforming volumes from one configuration to another. | ||||
PCIeInterface | Object | Expanded. Note If the storage is Host Bus Adapter or 7mm, this object will be displayed. | ||||
LanesInUse | Integer | The number of PCIe lanes in use. | ||||
MaxLanes | Integer | The number of PCIe lanes supported. | ||||
MaxPCIeType | Integer | The highest version of the PCIe specification supported. | ||||
PCIeType | Integer | The version of the PCIe specification in use. | ||||
PartNumber | String | The part number for this storage controller. Note If the storage is direct attached storage, this property will be hidden. | ||||
SKU | String | The SKU for this storage controller. Note If the storage is direct attached storage, this property will be hidden. | ||||
SerialNumber | String | The serial number for this storage controller. Note If the storage is direct attached storage, this property will be hidden. | ||||
Status | Object | The status for this storage controller. | ||||
State | String | The state for this storage controller. | ||||
SupportedControllerProtocols | Array | Expanded. | ||||
SupportedControllerProtocols[N] | String | The supported set of protocols for communicating to this storage controller. | ||||
SupportedDeviceProtocols | Array | The protocols that the storage controller can use to communicate with attached devices. | ||||
SupportedDeviceProtocols[N] | String | Possible values are “SAS/SATA/NVMe”. | ||||
Location | Object | The location of the storage controller. Note If the storage is direct attached storage, this object will be hidden. | ||||
PartLocation | Object | The part location within the placement. | ||||
LocationOrdinalValue | Integer | The number that represents the location of this storage controller. | ||||
LocationType | String | “Slot” | ||||
ServiceLabel | String | The service label of this storage controller. |
Status code
HTTP Status Code | Error Message ID |
---|---|
500 | InternalError |
Example
The following example JSON response is returned:
{
"@odata.context": "/redfish/v1/$metadata#Storage.Storages",
"@odata.etag": "\"D3601548\"",
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8",
"@odata.type": "#Storage.v1_15_0.Storage",
"Actions": {
"Oem": {
...
}
}
},
"Description": "This resource is used to represent a storage for a Redfish implementation.",
"Drives": [
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_7"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_5"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_6"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_3"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_0"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_1"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_2"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_4"
}
],
"Drives@odata.count": 8,
"Id": "controller_slot8",
"Name": "ThinkSystem RAID 940-8i 4GB Flash PCIe Gen4 12Gb Adapter",
"Status": {
"Health": "Warning",
"HealthRollup": "Warning",
"State": "Enabled"
},
"StorageControllers": [
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8#/StorageControllers/0",
"CacheSummary": {
"PersistentCacheSizeMiB": 3142,
"Status": {
"Health": "OK",
"State": "Enabled"
},
"TotalCacheSizeMiB": 4096
},
"FirmwareVersion": "52.32.0-5785",
"Identifiers": [
{
"DurableName": "BE2F1F5977264864A926E98498C466A2",
"DurableNameFormat": "UUID"
}
],
"Location": {
"PartLocation": {
"LocationOrdinalValue": 8,
"LocationType": "Slot",
"ServiceLabel": "Slot=8"
}
},
"Manufacturer": "Lenovo",
"MemberId": "0",
"Model": "SAS3916",
"Name": "ThinkSystem RAID 940-8i 4GB Flash PCIe Gen4 12Gb Adapter",
"Oem": {
...
}
},
"PCIeInterface": {
"LanesInUse": 8,
"MaxLanes": 8,
"MaxPCIeType": "Gen4",
"PCIeType": "Gen4"
},
"PartNumber": "SR17A32432",
"SKU": "01PE816",
"SerialNumber": "L1FM192SA63",
"Status": {
"Health": "Warning",
"State": "Enabled"
},
"SupportedControllerProtocols": [
"PCIe"
],
"SupportedDeviceProtocols": [
"SAS",
"SATA",
"NVMe"
],
"SupportedRAIDTypes": [
"RAID0",
"RAID1",
"RAID00",
"RAID10"
]
}
],
"StorageControllers@odata.count": 1,
"StoragePools": {
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/StoragePools"
},
"Volumes": {
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Volumes"
}
}