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	null	true	-	读缓存比例百分比
Oem.Public.SpareActivationMode	null	true	-	热备激活模式 ● Failure：硬盘故障时激活热备盘 ● Predictive：硬盘预故障时激活热备盘
Oem.Public.NoBatteryWriteCacheEnabled	null	true	-	无电池写缓存使能状态
Oem.Public.BootDevices[ ]	array	true	-	指定存储器启动盘的资源ID。长度为2的固定数组，每个成员分别对应第一、第二优先级的存储器启动盘资源ID，对应优先级未设置时值为“None”
Oem.Public.WriteCachePolicy	null	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	-	设备位置
}
}

supported_methods

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