代码仓
中
Storages
更新时间: 2026/08/06
在AtomGit上查看源码

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创建会话时获得

使用指南

无

使用实例

请求样例:

http
GET https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id

X-Auth-Token: 123456789***********************

请求消息体:无

响应样例:

json
{
  "@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

请求消息体:

json
{
  "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
SmarterCopyBackStateSMART错误回拷功能的使 能状态● 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:关闭硬盘的 写缓存功能
HBADriveHBA硬盘的写缓存策略● Default:将硬盘的写 缓存保持为默认状态
● Enabled:打开硬盘的 写缓存功能
● Disabled:关闭硬盘的 写缓存功能

使用指南

无

使用实例

请求样例:

http
PATCH https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id

X-Auth-Token: 123456789*********************** Content-Type: header_type If-Match: ifmatch_value

请求消息体:

json
{
  "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
          }
        }
      }
    }
  ]
}

响应样例:

json
{
  "@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

请求消息体:

json
{}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
system_id系统资源的ID● 针对机架服务器,取值 为1
● 针对高密服务器,取值 为BladeN(N表示节点 槽位号),例如 “Blade1”
● 针对刀片服务器,取值 可以为BladeN(N表示 计算节点槽位号)或 SwiN(N表示交换模块 槽位号),例如 “Swi1”
storage_id存储资源的ID通过存储集合资源获得。

使用指南

无

使用实例

请求样例:

http
POST https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage. ImportForeignConfig

X-Auth-Token: 123456789*********************** Content-Type: header_type

请求消息体:

json
{}

响应样例:

json
{
  "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

请求消息体:

json
{}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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通过存储集合资源获得。

使用指南

无

使用实例

请求样例:

http
POST https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage.ClearForeignConfig

X-Auth-Token: 123456789*********************** Content-Type: header_type

请求消息体:

json
{}

响应样例:

json
{
  "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

请求消息体:

json
{}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
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才能生效。

使用实例

请求样例:

http
POST https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Actions/Oem/Public/Storage.RestoreStorageControllerDefaultSettings

X-Auth-Token: 123456789*********************** Content-Type: header_type

请求消息体:

json
{}

响应样例:

json
{
  "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