文档中心
Drives
更新时间： 2026/06/26
在Gitcode上查看源码

ResourceDefinition ​

uris ​

  • /redfish/v1/Chassis/chassis_id/Drives/drives_id

properties ​

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-指定驱动器资源模型的OData描述信息
@odata.idstringtrue-指定驱动器资源的访问路径
@odata.typestringtrue-指定驱动器资源的类型
Idstringtrue-指定驱动器资源的ID
Namestringtrue-指定驱动器资源的名称
Modelstringtrue-指定驱动器型号
Revisionstringtrue-指定驱动器的版本信息
Statusobjecttrue-指定驱动器的状态，包括：
● State：驱动器使能状态
● Health：驱动器健康状态
● Severity：驱动器的自定义健康状态
CapacityBytesnumbertrue-指定驱动器容量，单位为字节
BlockSizeBytesnumbertrue-指定驱动器块大小，单位为字节 说明 不支持NVMe硬盘
FailurePredictedbooleantrue-指定驱动器是否检测到预故障，包括：
● true
● false
Protocolstringtrue-指定驱动器遵从的协议
● SPI
● PCIe
● AHCI
● UHCI
● SAS
● SATA
● USB
● NVMe
● FC
● iSCSI
● FCoE
● NVMeOverFabrics
● SMB
● NFSv3
● NFSv4
● HTTP
● HTTPS
● FTP
● SFTP
MediaTypestringtrue-指定驱动器的介质类型
● HDD
● SSD
● SMR
Manufacturerstringtrue-指定驱动器的制造商
SerialNumberstringtrue-指定驱动器的序列号
CapableSpeedGbsnumbertrue-指定驱动器接口的最大速率
NegotiatedSpeedGbsnumbertrue-指定驱动器接口的协商速率
PredictedMediaLifeLeftPercentnumbertrue-指定驱动器的剩余寿命百分比
IndicatorLEDstringtrue-指定驱动器的定位指示灯状态，包括：
● Off
● Blinking
HotspareTypestringtrue-指定驱动器的热备状态， 包括：
● None
● Global
● Dedicated
● Auto Replace
StatusIndicatorstringtrue-指定驱动器的指示灯状态，包括
● OK
● Fail
● Rebuild
● PredictiveFailureAnalysis
● Hotspare
● InAFailedArray
● InACriticalArray
PartNumberstringtrue-硬盘资产部件编号 说明 BMC500 5.13.0及以上版本支持。
LocationIndicatorActivebooleantrue-硬盘定位状态，包括：
● true
● false 说明 BMC500 5.13.0及以上版本支持。
DriveFormFactorstringtrue-硬盘尺寸，取值范围：
● Drive3_5
● Drive2_5
● M2
● OEM 说明 BMC500 5.13.0及以上版本支持。
Metricsobjecttrue-指向与此驱动器关联的硬件诊断信息的URI链接， 包括：
● "@odata.id": URI链接 说明 BMC500 5.13.0及以上版本支持。
Assemblyobjecttrue-指向与此驱动器关联的装配体资源的URI链接，包括：
● "@odata.id": URI链接 说明 BMC500 5.13.0及以上版本支持。
PhysicalLocationobjecttrue-阵列中硬盘的相对位置， 包括：
● "Info": 只读字符串，此属性应表示资源的位置。
● "InfoFormat": 只读字符串，该属性应表示Info属性的格式。
● "PartLocationContext" : 可读字符串，用于区分同一外壳内不同部件的PartLocation值，这些值可能包含该部件的父级PartLocation值的层次信息。 说明 BMC500 5.13.0及以上版本支持。
Location指定驱动器丝印true-
Infostringtrue-指定驱动器丝印信息
InfoFormatstringtrue-指定驱动器丝印格式
RotationSpeedRPMnumbertrue-指定驱动器的转速
Oem.Public自定义属性true-
DriveIDnumbertrue-创建逻辑盘时指定的驱动器的ID
RebuildStatestringtrue-指定驱动器数据重建状态，包括：
● DoneOrNotRebuilt
● Rebuilding
AssociatedResourcestringtrue-指定驱动器的资源归属
RebuildProgressstringtrue-指定驱动器数据重建进度
PatrolStatestringtrue-指定驱动器巡检状态，包括：
● DoneOrNotPatrolled
● Patrolling
TemperatureCelsiusnumbertrue-指定驱动器当前温度。 说明 已屏蔽该属性值频繁变化导致的事件上报
FirmwareStatusstringtrue-指定驱动器的状态，包括：
● UnconfiguredGood
● UnconfigureBad
● HotSpareDrive
● Offline
● Failed
● Online
● GettingCopied
● JBOD
● UnconfiguredShieded
● HotSpareShielded
● ConfiguredShielded
● Foreign
● Active
● Standby
● Sleep
● DSTInProgress
● SMARTOfflineDataCollection
● SCTCommand
● Rebuilding
● Raw
● Ready
● NotSupported
● PredictiveFailure
● EraseInProgress
IsEPDbooleantrue-是否为加强型物理硬盘
SpareforLogicalDrivesarraytrue-指定驱动器是局部热备盘时所属逻辑盘列表
SASAddressarraytrue-指定驱动器SAS地址
PowerStatestringtrue-物理盘的节能休眠状态
● Spun Up
● Spun Down
● Transition
SlotPowerStatestringtrue-指定物理盘槽位的电源状态
● On
● Off 说明 BMC300 5.13.0.1及以上版本支持
Typestringtrue-驱动器类型，包括
● Disk
● SDCard
● PCIe SSD Card
Positionstringtrue-指定驱动器容器
EstimatedRemainingLifespannumbertrue-指定驱动器预估剩余寿命
HoursOfPoweredUpnumbertrue-指定驱动器上电运行时间 说明 已屏蔽该属性值频繁变化导致的事件上报
SATASmartInformationSATA接口SMART信息true-
SASSmartInformationSAS接口SMART信息true-
MediaErrorCountnumbertrue-介质错误数
PrefailErrorCountnumbertrue-预测故障错误数
OtherErrorCountnumbertrue-其它错误数
HealthStatusstringtrue-健康状态
DiskTemperatureCelsiusnumbertrue-驱动器温度(摄氏度)
DiskStripeTemperatureCelsiusnumbertrue-驱动器条带温度(摄氏度)
ElementsInGrownDefectListnumbertrue-增长缺陷列表(G表)中的元素
ElementsInPrimaryDefectListnumbertrue-主缺陷列表(P表)中的元素
WeekAndYearOfManufacturestringtrue-生产日期
BlocksSentToInitiatornumbertrue-发送到启动器的块
BlocksReceivedFromInitiatornumbertrue-从启动器收到的块
NumberOfMinutesUntilNextSMARTTestnumbertrue-距下一次内部SMART测试的时长(分钟)
SequenceNumberOfLastPredFailEventnumbertrue-最后一次预测故障事件的序列号
NVMeSmartInformationPCIe接口SMART信息true-
MediaErrorCountnumbertrue-介质错误数
BDFstringtrue-BDF值：
● Bus
● Device
● Function
● null
CryptoEraseSupportedbooleantrue-指定驱动器是否支持加密盘数据擦除
RelatedArrayInfoobjecttrue-指定驱动器上的驱动器阵列信息
Membersarraytrue-指定驱动器阵列的成员
FreeSpaceMiBPerDrivenumbertrue-指定驱动器阵列中每个驱动器的剩余容量（单位： MB）
TotalFreeSpaceMiBnumbertrue-指定驱动器阵列中总的剩余容量（单位：MB）
FreeBlocksSpaceMibarraytrue-指定驱动器阵列中的剩余容量（单位：MB）
NumDrivePerSpannumbertrue-指定驱动器阵列中每个Span的成员的个数
VolumeRaidLevelstringtrue-指定驱动器阵列组成的虚拟磁盘的级别
SlotNumbernumbertrue-物理盘所在背板的槽位号
EnclosureDeviceIdnumbertrue-物理盘所在背板的设备ID，由RAID控制器固件生成
BootPrioritystringtrue-启动优先级
● Primary
● Secondary
● All
● None
BootEnablebooleantrue-是否为启动盘
FormFactorstringtrue-硬盘尺寸
● Unknown
● 5.25 inch
● 3.5 inch
● 2.5 inch
● 1.8 inch
● Lessthan 1.8 inch
● mSATA
● M.2
● MicroSSD
● CFast
Links驱动器关联的资源true-
Volumesarraytrue-指定驱动器所属逻辑盘列表
@odata.idstringtrue-指定驱动器所属逻辑盘的访问路径
ActionsRedfish允许的指定驱动器资源可执行操作true-
#Drive.Reset"objecttrue-重启指定物理盘操作 说明 BMC300 5.13.0.1及以上版本支持
targetstringtrue-重启指定物理盘操作的访问路径
@Redfish.ActionInfostringtrue-重启指定物理盘操作ActionInfo的访问路径
Oem.Public自定义属性true-
#Drive.CryptoEraseobjecttrue-加密盘的数据安全擦除操作
targetstringtrue-加密盘的数据安全擦除操作的访问路径
@Redfish.ActionInfostringtrue-加密盘的数据安全擦除操作ActionInfo的访问路径
@odata.contextstringtrue-指定驱动器资源模型的OData描述信息
@odata.idstringtrue-指定驱动器资源的访问路径
@odata.typestringtrue-指定驱动器资源的类型
Idstringtrue-指定驱动器资源的ID
Namestringtrue-指定驱动器资源的名称
Modelstringtrue-指定驱动器型号
Revisionstringtrue-指定驱动器的版本信息
Statusobjecttrue-指定驱动器的状态，包括：
● State：驱动器使能状态
● Health：驱动器健康状态
● Severity：驱动器的自定义健康状态
CapacityBytesnumbertrue-指定驱动器容量，单位为字节
BlockSizeBytesnumbertrue-指定驱动器块大小，单位为字节 说明 不支持NVMe硬盘
FailurePredictedbooleantrue-指定驱动器是否检测到预故障，包括：
● true
● false
Protocolstringtrue-指定驱动器遵从的协议
● SPI
● PCIe
● AHCI
● UHCI
● SAS
● SATA
● USB
● NVMe
● FC
● iSCSI
● FCoE
● NVMeOverFabrics
● SMB
● NFSv3
● NFSv4
● HTTP
● HTTPS
● FTP
● SFTP
MediaTypestringtrue-指定驱动器的介质类型
● HDD
● SSD
● SMR
Manufacturerstringtrue-指定驱动器的制造商
SerialNumberstringtrue-指定驱动器的序列号
CapableSpeedGbsnumbertrue-指定驱动器接口的最大速率
NegotiatedSpeedGbsnumbertrue-指定驱动器接口的协商速率
PredictedMediaLifeLeftPercentnumbertrue-指定驱动器的剩余寿命百分比
IndicatorLEDstringtrue-指定驱动器的定位指示灯状态，包括：
● Off
● Blinking
HotspareTypestringtrue-指定驱动器的热备状态， 包括：
● None
● Global
● Dedicated
● Auto Replace
StatusIndicatorstringtrue-指定驱动器的指示灯状态，包括
● OK
● Fail
● Rebuild
● PredictiveFailureAnalysis
● Hotspare
● InAFailedArray
● InACriticalArray
PartNumberstringtrue-硬盘资产部件编号 说明 BMC500 5.13.0及以上版本支持。
LocationIndicatorActivebooleantrue-硬盘定位状态，包括：
● true
● false 说明 BMC500 5.13.0及以上版本支持。
DriveFormFactorstringtrue-硬盘尺寸，取值范围：
● Drive3_5
● Drive2_5
● M2
● OEM 说明 BMC500 5.13.0及以上版本支持。
Metricsobjecttrue-指向与此驱动器关联的硬件诊断信息的URI链接， 包括：
● "@odata.id": URI链接 说明 BMC500 5.13.0及以上版本支持。
Assemblyobjecttrue-指向与此驱动器关联的装配体资源的URI链接，包括：
● "@odata.id": URI链接 说明 BMC500 5.13.0及以上版本支持。
PhysicalLocationobjecttrue-阵列中硬盘的相对位置， 包括：
● "Info": 只读字符串，此属性应表示资源的位置。
● "InfoFormat": 只读字符串，该属性应表示Info属性的格式。
● "PartLocationContext" : 可读字符串，用于区分同一外壳内不同部件的PartLocation值，这些值可能包含该部件的父级PartLocation值的层次信息。 说明 BMC500 5.13.0及以上版本支持。
Location指定驱动器丝印true-
Infostringtrue-丝印信息
InfoFormatstringtrue-丝印格式
RotationSpeedRPMnumbertrue-指定驱动器的转速
Oem.Public自定义属性true-
DriveIDnumbertrue-创建逻辑盘时指定的驱动器的ID
RebuildStatestringtrue-指定驱动器数据重建状态，包括：
● DoneOrNotRebuilt
● Rebuilding
AssociatedResourcestringtrue-指定驱动器的资源归属
RebuildProgressstringtrue-指定驱动器数据重建进度
PatrolStatestringtrue-指定驱动器巡检状态，包括：
● DoneOrNotPatrolled
● Patrolling
TemperatureCelsiusnumbertrue-指定驱动器当前温度 说明 已屏蔽该属性值频繁变化导致的事件上报
FirmwareStatusstringtrue-指定驱动器的状态，包括：
● UnconfiguredGood
● UnconfigureBad
● HotSpareDrive
● Offline
● Failed
● Online
● GettingCopied
● JBOD
● UnconfiguredShieded
● HotSpareShielded
● ConfiguredShielded
● Foreign
● Active
● Standby
● Sleep
● DSTInProgress
● SMARTOfflineDataCollection
● SCTCommand
● Rebuilding
● Raw
● Ready
● NotSupported
● PredictiveFailure
● EraseInProgress
SpareforLogicalDrivesarraytrue-指定局部热备盘所属逻辑盘列表
SASAddressarraytrue-指定驱动器SAS地址
SlotPowerStatestringtrue-指定物理盘槽位的电源状态
● On
● Off 说明 BMC300 5.13.0.1及以上版本支持
Typestringtrue-驱动器类型，包括：
● Disk
● SDCard
● PCIe SSD Card
Positionstringtrue-驱动器容器
HoursOfPoweredUpnumbertrue-指定驱动器上电运行时间 说明 已屏蔽该属性值频繁变化导致的事件上报
SATASmartInformationSATA接口SMART信息true-
AttributeRevisionstringtrue-SMART属性版本号
AttributeRevisionNumbernumbertrue-SMART属性数量
AttributeItemListarraytrue-SMART属性列表
RawValuenumbertrue-SMART属性物理值(通常对应于计数或物理单位， 如扇区个数，摄氏度或秒)
UpdateModestringtrue-SMART属性的更新模式
AttributeNamestringtrue-SMART属性名称
NormalizedValuenumbertrue-SMART属性标准值
Flagstringtrue-SMART属性标识
WorstValuenumbertrue-SMART属性历史最差值
FaultStatusstringtrue-SMART属性失效状态
Thresholdnumbertrue-SMART属性阈值
FaultWarningModestringtrue-SMART属性故障类型
SmartAttributeIDnumbertrue-SMART属性ID
CryptoEraseSupportedbooleantrue-指定驱动器是否支持加密盘数据擦除
RelatedArrayInfoobjecttrue-指定驱动器上的驱动器阵列信息
Membersarraytrue-指定驱动器阵列的成员
FreeSpaceMiBPerDrivenumbertrue-指定驱动器阵列中每个驱动器的剩余容量（单位： MB）
TotalFreeSpaceMiBnumbertrue-指定驱动器阵列中总的剩余容量（单位：MB）
FreeBlocksSpaceMibarraytrue-指定驱动器阵列中的剩余容量（单位：MB）
NumDrivePerSpannumbertrue-指定驱动器阵列中每个Span的成员的个数
VolumeRaidLevelstringtrue-指定驱动器阵列组成的虚拟磁盘的级别
SlotNumbernumbertrue-物理盘所在背板的槽位号
EnclosureDeviceIdnumbertrue-物理盘所在背板的设备ID，由RAID控制器固件生成
BootPrioritystringtrue-启动优先级
● Primary
● Secondary
● All
● None
BootEnablebooleantrue-是否为启动盘
Links驱动器关联的资源true-
Volumesarraytrue-所属逻辑盘列表
@odata.idstringtrue-所属逻辑盘的访问路径
ActionsRedfish允许的指定驱动器资源可执行操作true-
#Drive.Reset"objecttrue-重启指定物理盘操作 说明 BMC300 5.13.0.1及以上版本支持
targetstringtrue-重启指定物理盘操作的访问路径
@Redfish.ActionInfostringtrue-重启指定物理盘操作ActionInfo的访问路径
Oem.Public自定义属性true-
#Drive.CryptoEraseobjecttrue-加密盘的数据安全擦除操作
targetstringtrue-加密盘的数据安全擦除操作的访问路径
@odata.contextstringtrue-指定SD驱动器资源模型的OData描述信息
@odata.idstringtrue-指定SD驱动器资源的访问路径
@odata.typestringtrue-指定SD驱动器资源的类型
Idstringtrue-指定SD驱动器资源的Id
Namestringtrue-指定SD驱动器资源的名称
Modelstringtrue-指定SD驱动器型号
Revisionstringtrue-指定SD驱动器的版本信息
Statusobjecttrue-指定SD驱动器的状态，包括：
● State：SD驱动器使能状态
● Health：SD驱动器健康状态
● Severity：SD驱动器的自定义健康状态
CapacityBytesnumbertrue-指定SD驱动器容量，单位为字节
BlockSizeBytesnumbertrue-指定驱动器块大小，单位为字节 说明 不支持NVMe硬盘
FailurePredictedbooleantrue-指定SD驱动器是否检测到预故障，包括：
● true
● false
Protocolstringtrue-指定SD驱动器遵从的协议
● SPI
● PCIe
● AHCI
● UHCI
● SAS
● SATA
● USB
● NVMe
● FC
● iSCSI
● FCoE
● NVMeOverFabrics
● SMB
● NFSv3
● NFSv4
● HTTP
● HTTPS
● FTP
● SFTP
MediaTypestringtrue-指定SD驱动器的介质类型
● HDD
● SSD
● SMR
Manufacturerstringtrue-指定SD驱动器的制造商
SerialNumberstringtrue-指定SD驱动器的序列号
CapableSpeedGbsnumbertrue-指定SD驱动器接口的最大速率
NegotiatedSpeedGbsnumbertrue-指定SD驱动器接口的协商速率
PredictedMediaLifeLeftPercentnumbertrue-指定SD驱动器的剩余寿命百分比
IndicatorLEDstringtrue-指定SD驱动器的定位指示灯状态，包括：
● Off
● Blinking
HotspareTypestringtrue-指定SD驱动器的热备状态，包括：
● None
● Global
● Dedicated
StatusIndicatorstringtrue-指定SD驱动器的指示灯状态，包括
● OK
● Fail
● Rebuild
● PredictiveFailureAnalysis
● Hotspare
● InAFailedArray
● InACriticalArray
PartNumberstringtrue-硬盘资产部件编号 说明 BMC500 5.13.0及以上版本支持。
LocationIndicatorActivebooleantrue-硬盘定位状态，包括：
● true
● false 说明 BMC500 5.13.0及以上版本支持。
DriveFormFactorstringtrue-硬盘尺寸，取值范围：
● Drive3_5
● Drive2_5
● M2
● OEM 说明 BMC500 5.13.0及以上版本支持。
Metricsobjecttrue-指向与此驱动器关联的硬件诊断信息的URI链接， 包括：
● "@odata.id": URI链接 说明 BMC500 5.13.0及以上版本支持。
Assemblyobjecttrue-指向与此驱动器关联的装配体资源的URI链接，包括：
● "@odata.id": URI链接 说明 BMC500 5.13.0及以上版本支持。
PhysicalLocationobjecttrue-阵列中硬盘的相对位置， 包括：
● "Info": 只读字符串，此属性应表示资源的位置。
● "InfoFormat": 只读字符串，该属性应表示Info属性的格式。
● "PartLocationContext" : 可读字符串，用于区分同一外壳内不同部件的PartLocation值，这些值可能包含该部件的父级PartLocation值的层次信息。 说明 BMC500 5.13.0及以上版本支持。
Location驱动器丝印true-
RotationSpeedRPMnumbertrue-指定驱动器的转速
Oem.Public自定义属性true-
SlotPowerStatestringtrue-指定物理盘槽位的电源状态
● On
● Off 说明 BMC300 5.13.0.1及以上版本支持
Typestringtrue-驱动器类型，包括：
● Disk
● SDCard
● PCIe SSD Card
RebuildStatestringtrue-指定SD驱动器数据重建状态，包括：
● DoneOrNotRebuilt
● Rebuilding
Links驱动器关联的资源true-
Volumesarraytrue-指定SD驱动器所属逻辑盘列表
ActionsRedfish允许的指定驱动器 资源可执行操作true-
#Drive.Reset"objecttrue-重启指定物理盘操作 说明 BMC300 5.13.0.1及以上版本支持
targetstringtrue-重启指定物理盘操作的访问路径
@Redfish.ActionInfostringtrue-重启指定物理盘操作ActionInfo的访问路径
@odata.contextstringtrue-指定驱动器资源模型的OData描述信息
@odata.idstringtrue-指定驱动器资源的访问路径
@odata.typestringtrue-指定驱动器资源的类型
Idstringtrue-指定PCIe SSD驱动器资源的ID
Namestringtrue-指定PCIe SSD驱动器资源的名称
Modelstringtrue-指定PCIe SSD驱动器型号
Revisionstringtrue-指定PCIe SSD驱动器的版本信息
Statusobjecttrue-指定PCIe SSD驱动器的状态，包括：
● Health：PCIe SSD驱动器健康状态
● State：PCIe SSD驱动器使能状态
● Severity：PCIe SSD驱动器的自定义健康状态
CapacityBytesnumbertrue-指定PCIe SSD驱动器容量，单位为字节
FailurePredictedbooleantrue-指定PCIe SSD驱动器是否检测到预故障，包括：
● true
● false
Protocolstringtrue-指定PCIe SSD驱动器遵从的协议
● SPI
● PCIe
● AHCI
● UHCI
● SAS
● SATA
● USB
● NVMe
● FC
● iSCSI
● FCoE
● NVMeOverFabrics
● SMB
● NFSv3
● NFSv4
● HTTP
● HTTPS
● FTP
● SFTP
MediaTypestringtrue-指定PCIe SSD驱动器的介质类型，包括：
● HDD
● SSD
● SMR
Manufacturerstringtrue-指定PCIe SSD驱动器的制造商
SerialNumberstringtrue-指定PCIe SSD驱动器的序列号
CapableSpeedGbsnumbertrue-指定PCIe SSD驱动器接口的最大速率
NegotiatedSpeedGbsnumbertrue-指定PCIe SSD驱动器接口的协商速率
PredictedMediaLifeLeftPercentnumbertrue-指定PCIe SSD驱动器的剩余寿命百分比
IndicatorLEDstringtrue-指定PCIe SSD驱动器的定位指示灯状态，包括：
● Off
● Blinking
HotspareTypestringtrue-指定PCIe SSD驱动器的热备状态，包括：
● None
● Global
● Dedicated
StatusIndicatorstringtrue-指定PCIe SSD驱动器的指示灯状态
● OK
● Fail
● Rebuild
● PredictiveFailureAnalysis
● Hotspare
● InAFailedArray
● InACriticalArray
PartNumberstringtrue-硬盘资产部件编号 说明 BMC500 5.13.0及以上版本支持。
LocationIndicatorActivebooleantrue-硬盘定位状态，包括：
● true
● false 说明 BMC500 5.13.0及以上版本支持。
DriveFormFactorstringtrue-硬盘尺寸，取值范围：
● Drive3_5
● Drive2_5
● M2
● OEM 说明 BMC500 5.13.0及以上版本支持。
Metricsobjecttrue-指向与此驱动器关联的硬件诊断信息的URI链接， 包括：
● "@odata.id": URI链接 说明 BMC500 5.13.0及以上版本支持。
Assemblyobjecttrue-指向与此驱动器关联的装配体资源的URI链接，包括：
● "@odata.id": URI链接 说明 BMC500 5.13.0及以上版本支持。
PhysicalLocationobjecttrue-阵列中硬盘的相对位置， 包括：
● "Info": 只读字符串，此属性应表示资源的位置。
● "InfoFormat": 只读字符串，该属性应表示Info属性的格式。
● "PartLocationContext" : 可读字符串，用于区分同一外壳内不同部件的PartLocation值，这些值可能包含该部件的父级PartLocation值的层次信息。 说明 BMC500 5.13.0及以上版本支持。
Location指定PCIe SSD驱动器丝印true-
Infostringtrue-丝印信息
InfoFormatstringtrue-丝印格式
RotationSpeedRPMnumbertrue-指定驱动器的转速
Oem.Public自定义属性true-
DriveIDnumbertrue-指定PCIe SSD驱动器ID。
RebuildStatestringtrue-指定PCIe SSD驱动器数据重建状态，包括：
● DoneOrNotRebuilt
● Rebuilding
AssociatedResourcestringtrue-指定驱动器的资源归属
RebuildProgressstringtrue-指定PCIe SSD驱动器数据重建进度
PatrolStatestringtrue-指定PCIe SSD驱动器巡检状态，包括：
● DoneOrNotPatrolled
● Patrolling
TemperatureCelsiusnumbertrue-指定PCIe SSD驱动器当前温度 说明 已屏蔽该属性值频繁变化导致的事件上报
FirmwareStatusstringtrue-指定PCIe SSD驱动器的状态
SpareforLogicalDrivesarraytrue-指定局部热备盘所属逻辑盘列表
SASAddressarraytrue-指定PCIe SSD驱动器SAS地址
SlotPowerStatestringtrue-指定物理盘槽位的电源状态
● On
● Off 说明 BMC300 5.13.0.1及以上版本支持
Typestringtrue-驱动器类型，包括：
● Disk
● SDCard
● PCIe SSD Card
Positionstringtrue-指定PCIe SSD驱动器容器
HoursOfPoweredUpnumbertrue-指定PCIe SSD驱动器上电运行时间 说明 已屏蔽该属性值频繁变化导致的事件上报
SATASmartInformationobjecttrue-SATA接口SMART信息
SATASmartInformationobjecttrue-SAS接口SMART信息
Links指定PCIe SSD驱动器关联的资源true-
Volumesarraytrue-指定PCIe SSD驱动器所属逻辑盘列表
ActionsRedfish允许的指定驱动器 资源可执行操作true-
#Drive.Reset"objecttrue-重启指定物理盘操作 说明 BMC300 5.13.0.1及以上版本支持
targetstringtrue-重启指定物理盘操作的访问路径
@Redfish.ActionInfostringtrue-重启指定物理盘操作ActionInfo的访问路径
@odata.contextstringtrue-指定驱动器资源模型的OData描述信息
@odata.idstringtrue-指定驱动器资源的访问路径
@odata.typestringtrue-指定驱动器资源的类型
Idstringtrue-指定驱动器资源的ID
Namestringtrue-指定驱动器资源的名称
Modelstringtrue-指定驱动器型号
Revisionstringtrue-指定驱动器的版本信息
Statusobjecttrue-指定驱动器的状态，包括：
● State：驱动器使能状态
● Health：驱动器健康状态
● Severity：驱动器的自定义健康状态
CapacityBytesnumbertrue-指定驱动器容量，单位为字节
BlockSizeBytesnumbertrue-指定驱动器块大小，单位为字节 说明 不支持NVMe硬盘
FailurePredictedbooleantrue-指定驱动器是否检测到预故障，包括：
● true
● false
Protocolstringtrue-指定驱动器遵从的协议
● SPI
● PCIe
● AHCI
● UHCI
● SAS
● SATA
● USB
● NVMe
● FC
● iSCSI
● FCoE
● NVMeOverFabrics
● SMB
● NFSv3
● NFSv4
● HTTP
● HTTPS
● FTP
● SFTP
MediaTypestringtrue-指定驱动器的介质类型
● HDD
● SSD
● SMR
Manufacturerstringtrue-指定驱动器的制造商
SerialNumberstringtrue-指定驱动器的序列号
CapableSpeedGbsnumbertrue-指定驱动器接口的最大速率
NegotiatedSpeedGbsnumbertrue-指定驱动器接口的协商速率
PredictedMediaLifeLeftPercentnumbertrue-指定驱动器的剩余寿命百分比
IndicatorLEDstringtrue-指定驱动器的定位指示灯状态，包括：
● Off
● Blinking
HotspareTypestringtrue-指定驱动器的热备状态， 包括：
● None
● Global
● Dedicated
● Auto Replace
StatusIndicatorstringtrue-指定驱动器的指示灯状态，包括
● OK
● Fail
● Rebuild
● PredictiveFailureAnalysis
● Hotspare
● InAFailedArray
● InACriticalArray
PartNumberstringtrue-硬盘资产部件编号 说明 BMC500 5.13.0及以上版本支持。
LocationIndicatorActivebooleantrue-硬盘定位状态，包括：
● true
● false
说明
BMC500 5.13.0及以上版本支持。
DriveFormFactorstringtrue-硬盘尺寸，取值范围：
● Drive3_5
● Drive2_5
● M2
● OEM
说明
BMC500 5.13.0及以上版本支持。
Metricsobjecttrue-指向与此驱动器关联的硬件诊断信息的URI链接， 包括：
● "@odata.id": URI链接
说明
BMC500 5.13.0及以上版本支持。
Assemblyobjecttrue-指向与此驱动器关联的装配体资源的URI链接，包括：
● "@odata.id": URI链接
说明
BMC500 5.13.0及以上版本支持。
PhysicalLocationobjecttrue-阵列中硬盘的相对位置， 包括：
● "Info": 只读字符串，此属性应表示资源的位置。
● "InfoFormat": 只读字符串，该属性应表示Info属性的格式。
● "PartLocationContext" : 可读字符串，用于区分同一外壳内不同部件的PartLocation值，这些值可能包含该部件的父级PartLocation值的层次信息。
说明
BMC500 5.13.0及以上版本支持。
Location指定驱动器丝印true-
Infostringtrue-丝印信息
InfoFormatstringtrue-丝印格式
RotationSpeedRPMnumbertrue-指定驱动器的转速
Oem.Public自定义属性true-
DriveIDnumbertrue-创建逻辑盘时指定的驱动器的ID
RebuildStatestringtrue-指定驱动器数据重建状态，包括：
● DoneOrNotRebuilt
● Rebuilding
AssociatedResourcestringtrue-指定驱动器的资源归属
RebuildProgressstringtrue-指定驱动器数据重建进度
PatrolStatestringtrue-指定驱动器巡检状态，包括：
● DoneOrNotPatrolled
● Patrolling
TemperatureCelsiusnumbertrue-指定驱动器当前温度 说明 已屏蔽该属性值频繁变化导致的事件上报
FirmwareStatusstringtrue-指定驱动器的状态，包括：
● UnconfiguredGood
● UnconfigureBad
● HotSpareDrive
● Offline
● Failed
● Online
● GettingCopied
● JBOD
● UnconfiguredShieded
● HotSpareShielded
● ConfiguredShielded
● Foreign
● Active
● Standby
● Sleep
● DSTInProgress
● SMARTOfflineDataCollection
● SCTCommand
● Rebuilding
● Raw
● Ready
● NotSupported
● PredictiveFailure
● EraseInProgress
SpareforLogicalDrivesarraytrue-指定局部热备盘所属逻辑盘列表
SASAddressarraytrue-指定驱动器SAS地址
SlotPowerStatestringtrue-指定物理盘槽位的电源状态
● On
● Off
说明
BMC300 5.13.0.1及以上版本支持
Typestringtrue-驱动器类型，包括：
● Disk
● SDCard
● PCIe SSD Card
Positionstringtrue-驱动器容器
HoursOfPoweredUpnumbertrue-指定驱动器上电运行时间
说明已屏蔽该属性值频繁变化导致的事件上报
SATASmartInformationSATA接口SMART信息true-
AttributeRevisionstringtrue-SMART属性版本号
AttributeRevisionNumbernumbertrue-SMART属性数量
AttributeItemListarraytrue-SMART属性列表
RawValuenumbertrue-SMART属性物理值(通常对应于计数或物理单位， 如扇区个数，摄氏度或秒)
UpdateModestringtrue-SMART属性的更新模式
AttributeNamestringtrue-SMART属性名称
NormalizedValuenumbertrue-SMART属性标准值
Flagstringtrue-SMART属性标识
WorstValuenumbertrue-SMART属性历史最差值
FaultStatusstringtrue-SMART属性失效状态
Thresholdnumbertrue-SMART属性阈值
FaultWarningModestringtrue-SMART属性故障类型
SmartAttributeIDnumbertrue-SMART属性ID
CryptoEraseSupportedbooleantrue-指定驱动器是否支持加密盘数据擦除
RelatedArrayInfoobjecttrue-指定驱动器上的驱动器阵列信息
Membersarraytrue-指定驱动器阵列的成员
FreeSpaceMiBPerDrivenumbertrue-指定驱动器阵列中每个驱动器的剩余容量（单位： MB）
TotalFreeSpaceMiBnumbertrue-指定驱动器阵列中总的剩余容量（单位：MB）
FreeBlocksSpaceMibarraytrue-指定驱动器阵列中的剩余容量（单位：MB）
NumDrivePerSpannumbertrue-指定驱动器阵列中每个Span的成员的个数
VolumeRaidLevelstringtrue-指定驱动器阵列组成的虚拟磁盘的级别
SlotNumbernumbertrue-物理盘所在背板的槽位号
EnclosureDeviceIdnumbertrue-物理盘所在背板的设备ID，由RAID控制器固件生成
BootPrioritystringtrue-启动优先级
● Primary
● Secondary
● All
● None
BootEnablebooleantrue-是否为启动盘
Links驱动器关联的资源true-
Volumesarraytrue-所属逻辑盘列表
@odata.idstringtrue-所属逻辑盘的访问路径
ActionsRedfish允许的指定驱动器资源可执行操作true-
#Drive.Reset"objecttrue-重启指定物理盘操作
说明
BMC300 5.13.0.1及以上版本支持
targetstringtrue-重启指定物理盘操作的访问路径
@Redfish.ActionInfostringtrue-重启指定物理盘操作ActionInfo的访问路径
Oem.Public自定义属性true-
#Drive.CryptoEraseobjecttrue-加密盘的数据安全擦除操作
targetstringtrue-加密盘的数据安全擦除操作的访问路径
@odata.contextstringtrue-指定SD驱动器资源模型的OData描述信息
@odata.idstringtrue-指定SD驱动器资源的访问路径
@odata.typestringtrue-指定SD驱动器资源的类型
Idstringtrue-指定SD驱动器资源的Id
Namestringtrue-指定SD驱动器资源的名称
Modelstringtrue-指定SD驱动器型号
Revisionstringtrue-指定SD驱动器的版本信息
Statusobjecttrue-指定SD驱动器的状态，包括：
● State：SD驱动器使能状态
● Health：SD驱动器健康状态
● Severity：SD驱动器的自定义健康状态
CapacityBytesnumbertrue-指定SD驱动器容量，单位为字节
BlockSizeBytesnumbertrue-指定驱动器块大小，单位为字节
说明：不支持NVMe硬盘
FailurePredictedbooleantrue-指定SD驱动器是否检测到预故障，包括：
● true
● false
Protocolstringtrue-指定SD驱动器遵从的协议
● SPI
● PCIe
● AHCI
● UHCI
● SAS
● SATA
● USB
● NVMe
● FC
● iSCSI
● FCoE
● NVMeOverFabrics
● SMB
● NFSv3
● NFSv4
● HTTP
● HTTPS
● FTP
● SFTP
MediaTypestringtrue-指定SD驱动器的介质类型
● HDD
● SSD
● SMR
Manufacturerstringtrue-指定SD驱动器的制造商
SerialNumberstringtrue-指定SD驱动器的序列号
CapableSpeedGbsnumbertrue-指定SD驱动器接口的最大速率
NegotiatedSpeedGbsnumbertrue-指定SD驱动器接口的协商速率
PredictedMediaLifeLeftPercentnumbertrue-指定SD驱动器的剩余寿命百分比
IndicatorLEDstringtrue-指定SD驱动器的定位指示灯状态，包括：
● Off
● Blinking
HotspareTypestringtrue-指定SD驱动器的热备状态，包括：
● None
● Global
● Dedicated
StatusIndicatorstringtrue-指定SD驱动器的指示灯状态，包括
● OK
● Fail
● Rebuild
● PredictiveFailureAnalysis
● Hotspare
● InAFailedArray
● InACriticalArray
PartNumberstringtrue-硬盘资产部件编号
说明：BMC500 5.13.0及以上版本支持
LocationIndicatorActivebooleantrue-硬盘定位状态，包括：
● true
● false
说明：BMC500 5.13.0及以上版本支持
DriveFormFactorstringtrue-硬盘尺寸，取值范围：
● Drive3_5
● Drive2_5
● M2
● OEM
说明：BMC500 5.13.0及以上版本支持
Metricsobjecttrue-指向与此驱动器关联的硬件诊断信息的URI链接，包括：
● "@odata.id": URI链接
说明：BMC500 5.13.0及以上版本支持
Assemblyobjecttrue-指向与此驱动器关联的装配体资源的URI链接，包括：
● "@odata.id": URI链接
说明：BMC500 5.13.0及以上版本支持
PhysicalLocationobjecttrue-阵列中硬盘的相对位置，包括：
● "Info": 只读字符串，此属性应表示资源的位置
● "InfoFormat": 只读字符串，该属性应表示Info属性的格式
● "PartLocationContext": 可读字符串，用于区分同一外壳内不同部件的PartLocation值，这些值可能包含该部件的父级PartLocation值的层次信息
说明：BMC500 5.13.0及以上版本支持
Locationstringtrue-驱动器丝印
RotationSpeedRPMnumbertrue-指定驱动器的转速
Oem.Public自定义属性true-自定义属性
SlotPowerStatestringtrue-指定物理盘槽位的电源状态
● On
● Off
说明：BMC300 5.13.0.1及以上版本支持
Typestringtrue-驱动器类型，包括：
● Disk
● SDCard
● PCIe SSD Card
RebuildStatestringtrue-指定SD驱动器数据重建状态，包括：
● DoneOrNotRebuilt
● Rebuilding
Links-true-驱动器关联的资源
Volumesarraytrue-指定SD驱动器所属逻辑盘列表
Actions-true-Redfish允许的指定驱动器资源可执行操作
#Drive.Resetobjecttrue-重启指定物理盘操作
说明：BMC300 5.13.0.1及以上版本支持
targetstringtrue-重启指定物理盘操作的访问路径
@Redfish.ActionInfostringtrue-重启指定物理盘操作ActionInfo的访问路径
@odata.contextstringtrue-指定驱动器资源模型的OData描述信息
@odata.idstringtrue-指定驱动器资源的访问路径
@odata.typestringtrue-指定驱动器资源的类型
Idstringtrue-指定PCIe SSD驱动器资源的ID
Namestringtrue-指定PCIe SSD驱动器资源的名称
Modelstringtrue-指定PCIe SSD驱动器型号
Revisionstringtrue-指定PCIe SSD驱动器的版本信息
Statusobjecttrue-指定PCIe SSD驱动器的状态，包括：
● Health：PCIe SSD驱动器健康状态
● State：PCIe SSD驱动器使能状态
● Severity：PCIe SSD驱动器的自定义健康状态
CapacityBytesnumbertrue-指定PCIe SSD驱动器容量，单位为字节
FailurePredictedbooleantrue-指定PCIe SSD驱动器是否检测到预故障，包括：
● true
● false
Protocolstringtrue-指定PCIe SSD驱动器遵从的协议
● SPI
● PCIe
● AHCI
● UHCI
● SAS
● SATA
● USB
● NVMe
● FC
● iSCSI
● FCoE
● NVMeOverFabrics
● SMB
● NFSv3
● NFSv4
● HTTP
● HTTPS
● FTP
● SFTP
MediaTypestringtrue-指定PCIe SSD驱动器的介质类型，包括：
● HDD
● SSD
● SMR
Manufacturerstringtrue-指定PCIe SSD驱动器的制造商
SerialNumberstringtrue-指定PCIe SSD驱动器的序列号
CapableSpeedGbsnumbertrue-指定PCIe SSD驱动器接口的最大速率
NegotiatedSpeedGbsnumbertrue-指定PCIe SSD驱动器接口的协商速率
PredictedMediaLifeLeftPercentnumbertrue-指定PCIe SSD驱动器的剩余寿命百分比
IndicatorLEDstringtrue-指定PCIe SSD驱动器的定位指示灯状态，包括：
● Off
● Blinking
HotspareTypestringtrue-指定PCIe SSD驱动器的热备状态，包括：
● None
● Global
● Dedicated
StatusIndicatorstringtrue-指定PCIe SSD驱动器的指示灯状态
● OK
● Fail
● Rebuild
● PredictiveFailureAnalysis
● Hotspare
● InAFailedArray
● InACriticalArray
PartNumberstringtrue-硬盘资产部件编号
说明：BMC500 5.13.0及以上版本支持
LocationIndicatorActivebooleantrue-硬盘定位状态，包括：
● true
● false
说明：BMC500 5.13.0及以上版本支持
DriveFormFactorstringtrue-硬盘尺寸，取值范围：
● Drive3_5
● Drive2_5
● M2
● OEM
说明：BMC500 5.13.0及以上版本支持
Metricsobjecttrue-指向与此驱动器关联的硬件诊断信息的URI链接，包括：
● "@odata.id": URI链接
说明：BMC500 5.13.0及以上版本支持
Assemblyobjecttrue-指向与此驱动器关联的装配体资源的URI链接，包括：
● "@odata.id": URI链接
说明：BMC500 5.13.0及以上版本支持
PhysicalLocationobjecttrue-阵列中硬盘的相对位置，包括：
● "Info": 只读字符串，此属性应表示资源的位置
● "InfoFormat": 只读字符串，该属性应表示Info属性的格式
● "PartLocationContext": 可读字符串，用于区分同一外壳内不同部件的PartLocation值，这些值可能包含该部件的父级PartLocation值的层次信息
说明：BMC500 5.13.0及以上版本支持
Locationstringtrue-指定PCIe SSD驱动器丝印
Infostringtrue-丝印信息
InfoFormatstringtrue-丝印格式
RotationSpeedRPMnumbertrue-指定驱动器的转速
Oem.Public自定义属性true-自定义属性
DriveIDnumbertrue-指定PCIe SSD驱动器ID
RebuildStatestringtrue-指定PCIe SSD驱动器数据重建状态，包括：
● DoneOrNotRebuilt
● Rebuilding
AssociatedResourcestringtrue-指定驱动器的资源归属
RebuildProgressstringtrue-指定PCIe SSD驱动器数据重建进度
PatrolStatestringtrue-指定PCIe SSD驱动器巡检状态，包括：
● DoneOrNotPatrolled
● Patrolling
TemperatureCelsiusnumbertrue-指定PCIe SSD驱动器当前温度
说明：已屏蔽该属性值频繁变化导致的事件上报
FirmwareStatusstringtrue-指定PCIe SSD驱动器的状态
SpareforLogicalDrivesarraytrue-指定局部热备盘所属逻辑盘列表
SASAddressarraytrue-指定PCIe SSD驱动器SAS地址
SlotPowerStatestringtrue-指定物理盘槽位的电源状态
● On
● Off
说明：BMC300 5.13.0.1及以上版本支持
Typestringtrue-驱动器类型，包括：
● Disk
● SDCard
● PCIe SSD Card
Positionstringtrue-指定PCIe SSD驱动器容器
HoursOfPoweredUpnumbertrue-指定PCIe SSD驱动器上电运行时间
说明：已屏蔽该属性值频繁变化导致的事件上报
SATASmartInformationobjecttrue-SATA接口SMART信息
SASSmartInformationobjecttrue-SAS接口SMART信息
Links-true-指定PCIe SSD驱动器关联的资源
Volumesarraytrue-指定PCIe SSD驱动器所属逻辑盘列表
Actions-true-Redfish允许的指定驱动器资源可执行操作
#Drive.Resetobjecttrue-重启指定物理盘操作
说明：BMC300 5.13.0.1及以上版本支持
targetstringtrue-重启指定物理盘操作的访问路径
@Redfish.ActionInfostringtrue-重启指定物理盘操作ActionInfo的访问路径

supported_methods ​

  • GET
  • POST
  • PATCH

HTTP methods ​

GET ​

命令功能

查询指定驱动器资源信息

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Drives/drive_id

请求头:


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

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
chassis_id系统资源的ID● 针对机架服务器，取值 为1
● 针对高密服务器，取值 为BladeN（N表示节点 槽位号），例如 “Blade1”
● 针对刀片服务器，取值 可以为BladeN（N表示 计算节点槽位号）
● 针对X6800 V5，X6000 V5，G5500，XA320 V2 服务器，取值还可以为 Enc，表示计算节点所在 的机框资源
● 针对设备U位信息，取值 可以为UN(N表示设备U 位号)，例如"U1"
● 针对机柜资源，取值为 Rack
drive_id指定驱动器的ID可从指定机箱资源中获取
auth_value执行该GET请求时，必须在 “Headers”中携带“X- Auth-Token”值用于鉴权可通过/redfish/v1/ SessionService/Sessions创 建会话时获得

使用指南

无

使用实例

SAS接口驱动器请求样例：

GET https://device_ip/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1

请求头：

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

请求消息体：无

响应样例1：

json
{
  "@odata.context": "/redfish/v1/$metadata#Drive.Drive",
  "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1",
  "@odata.type": "#Drive.v1_1_0.Drive",
  "Id": "HDDPlaneDisk1",
  "Name": "Disk1",
  "Model": "MBF2300RC",
  "Revision": "0109",
  "Status": {
    "Health": "OK",
    "Oem": {
      "Public": {
        "Severity": "Informational"
      }
    },
    "State": "Enabled"
  },
  "CapacityBytes": 298999349248,
  "BlockSizeBytes": 512,
  "FailurePredicted": false,
  "Protocol": "SAS",
  "MediaType": "HDD",
  "Manufacturer": "TOSHIBA",
  "SerialNumber": "EB72PC600G1C",
  "CapableSpeedGbs": 6,
  "NegotiatedSpeedGbs": 6,
  "PredictedMediaLifeLeftPercent": null,
  "IndicatorLED": "Off",
  "HotspareType": "None",
  "StatusIndicator": "OK",
  "PartNumber": "",
  "LocationIndicatorActive": false,
  "DriveFormFactor": null,
  "Metrics": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1/Metrics"
  },
  "Assembly": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1/Assembly"
  },
  "PhysicalLocation": {
    "Info": "Disk1",
    "InfoFormat": "DeviceName",
    "PartLocationContext": ""
  },
  "Location": [
    {
      "Info": "Disk1",
      "InfoFormat": "DeviceName"
    }
  ],
  "RotationSpeedRPM": 7200,
  "Oem": {
    "Public": {
      "DriveID": 1,
      "RebuildState": "DoneOrNotRebuilt",
      "AssociatedResource": null,
      "RebuildProgress": null,
      "PatrolState": "DoneOrNotPatrolled",
      "TemperatureCelsius": 70,
      "FirmwareStatus": "Online",
      "IsEPD": false,
      "SpareforLogicalDrives": [],
      "SASAddress": [
        "5000039418218546",
        "0000000000000000"
      ],
      "PowerState": "Spun Up",
      "SlotPowerState": "On",
      "Type": "Disk",
      "Position": "HDDPlane",
      "EstimatedRemainingLifespan": 1675,
      "HoursOfPoweredUp": 6504.18,
      "SATASmartInformation": null,
      "SASSmartInformation": {
        "MediaErrorCount": 0,
        "PrefailErrorCount": 0,
        "OtherErrorCount": 0,
        "HealthStatus": null,
        "DiskTemperatureCelsius": 34,
        "DiskStripeTemperatureCelsius": 68,
        "ElementsInGrownDefectList": 0,
        "ElementsInPrimaryDefectList": 0,
        "WeekAndYearOfManufacture": "in week 34 of year 2013",
        "BlocksSentToInitiator": 272795360,
        "BlocksReceivedFromInitiator": 381334143,
        "NumberOfMinutesUntilNextSMARTTest": 33,
        "SequenceNumberOfLastPredFailEvent": 0
      },
      "BDF": "0000:80:02.2",
      "CryptoEraseSupported": false,
      "RelatedArrayInfo": {
        "Members": [
          "Disk0",
          "Disk1"
        ],
        "FreeSpaceMiBPerDrive": 0,
        "TotalFreeSpaceMiB": 0,
        "FreeBlocksSpaceMib": [
          0
        ],
        "NumDrivePerSpan": 2,
        "VolumeRaidLevel": "RAID0"
      }
    },
    "SlotNumber": 5,
    "EnclosureDeviceId": 66,
    "BootPriority": "None",
    "BootEnable": false,
    "FormFactor": "2.5 inch"
  },
  "Links": {
    "Volumes": [
      {
        "@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive3"
      }
    ]
  },
  "Actions": {
    "#Drive.Reset": {
      "target": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1/Actions/Drive.Reset",
      "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1/ResetActionInfo"
    },
    "Oem": {
      "Public": {
        "#Drive.CryptoErase": {
          "target": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1/Actions/Oem/Public/Drive.CryptoErase"
        }
      }
    }
  }
}

响应码：200

SATA接口驱动器请求样例： GET https://device_ip/redfish/v1/Chassis/1/Drives/HDDPlaneDisk2

请求头：

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

请求消息体：无

响应样例2：

json
{
  "@odata.context": "/redfish/v1/$metadata#Drive.Drive",
  "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk2",
  "@odata.type": "#Drive.v1_1_0.Drive",
  "Id": "HDDPlaneDisk2",
  "Name": "Disk2",
  "Model": "MBF2300RC",
  "Revision": "0109",
  "Status": {
    "Health": "OK",
    "Oem": {
      "Public": {
        "Severity": "Informational"
      }
    },
    "State": "Enabled"
  },
  "CapacityBytes": 298999349248,
  "BlockSizeBytes": 512,
  "FailurePredicted": false,
  "Protocol": "SATA",
  "MediaType": "HDD",
  "Manufacturer": "TOSHIBA",
  "SerialNumber": "EB72PC600G1C",
  "CapableSpeedGbs": 6,
  "NegotiatedSpeedGbs": 6,
  "PredictedMediaLifeLeftPercent": null,
  "IndicatorLED": "Off",
  "HotspareType": "None",
  "StatusIndicator": "OK",
  "PartNumber": "",
  "LocationIndicatorActive": false,
  "DriveFormFactor": null,
  "Metrics": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk2/Metrics"
  },
  "Assembly": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk2/Assembly"
  },
  "PhysicalLocation": {
    "Info": "Disk2",
    "InfoFormat": "DeviceName",
    "PartLocationContext": ""
  },
  "Location": [
    {
      "Info": " Disk2",
      "InfoFormat": "DeviceName"
    }
  ],
  "RotationSpeedRPM": 7200,
  "Oem": {
    "Public": {
      "DriveID": 2,
      "RebuildState": "DoneOrNotRebuilt",
      "RebuildProgress": null,
      "PatrolState": "DoneOrNotPatrolled",
      "TemperatureCelsius": 70,
      "FirmwareStatus": "Online",
      "SpareforLogicalDrives": [],
      "SASAddress": [
        "5000039418218546",
        "0000000000000000"
      ],
      "SlotPowerState": "On",
      "Type": "Disk",
      "Position": "HDDPlane",
      "HoursOfPoweredUp": 6455,
      "SATASmartInformation": {
        "AttributeRevision": 25,
        "AttributeRevisionNumber": 21,
        "AttributeItemList": [
          {
            "RawValue": 47637533,
            "UpdateMode": "Always",
            "AttributeName": "DISK_CURRENT_PENDING_SECTOR",
            "NormalizedValue": 76,
            "Flag": "0x000f",
            "WorstValue": 63,
            "FaultStatus": null,
            "Threshold": 44,
            "FaultWarningMode": "Pre-fail",
            "SmartAttributeID": 3
          },
          ......
        ]
      },
      "SASSmartInformation": null,
      "CryptoEraseSupported": false,
      "RelatedArrayInfo": {
        "Members": [
          "Disk0",
          "Disk1"
        ],
        "FreeSpaceMiBPerDrive": 0,
        "TotalFreeSpaceMiB": 0,
        "FreeBlocksSpaceMib": [
          0
        ],
        "NumDrivePerSpan": 2,
        "VolumeRaidLevel": "RAID0"
      },
      "SlotNumber": 5,
      "EnclosureDeviceId": 66,
      "BootEnable": false
    }
  },
  "Links": {
    "Volumes": [
      {
        "@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive3"
      }
    ]
  },
  "Actions": {
    "#Drive.Reset": {
      "target": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk2/Actions/Drive.Reset",
      "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk2/ResetActionInfo"
    },
    "Oem": {
      "Public": {
        "#Drive.CryptoErase": {
          "target": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk2/Actions/Oem/Public/Drive.CryptoErase"
        }
      }
    }
  }
}

响应码：200

SD驱动器请求样例： GET https://device_ip/redfish/v1/Chassis/1/Drives/mainboardSDCard1

请求头： X-Auth-Token: 123456789***********************

请求消息体：无

响应样例3：

json
{
  "@odata.context": "/redfish/v1/$metadata#Drive.Drive",
  "@odata.id": "/redfish/v1/Chassis/Blade8/Drives/mainboardSDCard1",
  "@odata.type": "#Drive.v1_1_0.Drive",
  "Id": "mainboardSDCard1",
  "Name": "mainboardSDCard1",
  "Model": null,
  "Revision": null,
  "Status": {
    "Health": "OK",
    "Oem": {
      "Public": {
        "Severity": "Informational"
      }
    },
    "State": "Enabled"
  },
  "CapacityBytes": 31635456,
  "BlockSizeBytes": 512,
  "FailurePredicted": null,
  "Protocol": null,
  "MediaType": null,
  "Manufacturer": "SMART",
  "SerialNumber": 3356845,
  "CapableSpeedGbs": null,
  "NegotiatedSpeedGbs": null,
  "PredictedMediaLifeLeftPercent": null,
  "IndicatorLED": null,
  "HotspareType": null,
  "StatusIndicator": null,
  "PartNumber": "",
  "LocationIndicatorActive": false,
  "DriveFormFactor": null,
  "Metrics": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/mainboardSDCard1/Metrics"
  },
  "Assembly": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/mainboardSDCard1/Assembly"
  },
  "PhysicalLocation": {
    "Info": "mainboardSDCard1",
    "InfoFormat": "DeviceName",
    "PartLocationContext": ""
  },
  "Location": [],
  "RotationSpeedRPM": null,
  "Oem": {
    "Public": {
      "SlotPowerState": "On",
      "Type": "SDCard",
      "RebuildState": "DoneOrNotRebuilt"
    }
  },
  "Links": {
    "Volumes": []
  },
  "Actions": {
    "#Drive.Reset": {
      "target": "/redfish/v1/Chassis/1/Drives/mainboardSDCard1/Actions/Drive.Reset",
      "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Drives/mainboardSDCard1/ResetActionInfo"
    }
  }
}

响应码：200

PCIe SSD驱动器请求样例： GET https://device_ip/redfish/v1/Chassis/1/Drives/mainboardPCIeCard4(SSD)

请求头： X-Auth-Token: 6599174c38c36838737d9749179e1ee1

请求消息体：无

响应样例4：

json
{
  "@odata.context": "/redfish/v1/$metadata#Drive.Drive",
  "@odata.id": "/redfish/v1/Chassis/1/Drives/mainboardPCIeCard4(SSD)",
  "@odata.type": "#Drive.v1_1_0.Drive",
  "Id": "mainboardPCIeCard4(SSD)",
  "Name": "PCIe Card4 (SSD)",
  "Model": null,
  "Revision": null,
  "Status": {
    "Health": "OK",
    "Oem": {
      "Public": {
        "Severity": "Informational"
      }
    },
    "State": null
  },
  "CapacityBytes": null,
  "FailurePredicted": false,
  "Protocol": "PCIe",
  "MediaType": "SSD",
  "Manufacturer": "",
  "SerialNumber": null,
  "CapableSpeedGbs": null,
  "NegotiatedSpeedGbs": null,
  "PredictedMediaLifeLeftPercent": 100,
  "IndicatorLED": "Off",
  "HotspareType": null,
  "StatusIndicator": null,
  "PartNumber": "",
  "LocationIndicatorActive": false,
  "DriveFormFactor": null,
  "Metrics": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/mainboardPCIeCard4(SSD)/Metrics"
  },
  "Assembly": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/mainboardPCIeCard4(SSD)/Assembly"
  },
  "PhysicalLocation": {
    "Info": "mainboardPCIeCard4(SSD)",
    "InfoFormat": "DeviceName",
    "PartLocationContext": ""
  },
  "Location": [
    {
      "Info": "PCIeCard4(SSD)",
      "InfoFormat": "DeviceName"
    }
  ],
  "RotationSpeedRPM": null,
  "Oem": {
    "Public": {
      "DriveID": 4,
      "RebuildState": "DoneOrNotRebuilt",
      "AssociatedResource": null,
      "RebuildProgress": null,
      "PatrolState": "DoneOrNotPatrolled",
      "TemperatureCelsius": null,
      "FirmwareStatus": null,
      "SpareforLogicalDrives": [],
      "SASAddress": [],
      "SlotPowerState": "On",
      "Type": "PCIe SSD Card",
      "Position": "mainboard",
      "HoursOfPoweredUp": null,
      "SATASmartInformation": null,
      "SASSmartInformation": null
    }
  },
  "Links": {
    "Volumes": []
  },
  "Actions": {
    "#Drive.Reset": {
      "target": "/redfish/v1/Chassis/1/Drives/mainboardPCIeCard4(SSD)/Actions/Drive.Reset",
      "@Redfish.ActionInfo": "/redfish/v1/Chassis/1/Drives/mainboardPCIeCard4(SSD)/ResetActionInfo"
    }
  }
}

响应码：200

PATCH ​

命令功能

修改指定驱动器属性

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Drives/drives_id

请求头:


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

请求消息体：

● 设置定位指示灯状态：

json
{
  "IndicatorLED": ledstate
}

● 设置全局热备盘或取消热备盘：

json
{
  "HotspareType": hotsparetype
}

● 设置局部热备盘：

json
{
  "HotspareType": Dedicated,
  "Oem": {
    "Public": {
      "SpareforLogicalDrives": [
        {
          "@odata.id": volumepath
        }
      ]
    }
  }
}

● 设置自动替换热备盘：

json
{
  "HotspareType": "Auto Replace",
  "Oem": {
    "Public": {
      "SpareforLogicalDrives": [
        {
          "@odata.id": volumepath
        }
      ]
    }
  }
}

● 设置巡检开关：

json
{
  "Oem": {
    "Public": {
      "PatrolState": patrolstate
    }
  }
}

● 设置硬盘状态：

json
{
  "Oem": {
    "Public": {
      "FirmwareStatus": diskstate
    }
  }
}

● 设置启动盘：

json
{
  "Oem": {
    "Public": {
      "BootEnable": bootstate
    }
  }
}

● 设置启动优先级：

json
{
  "Oem": {
    "Public": {
      "BootPriority": bootpriority
    }
  }
}

● 设置硬盘定位状态：

json
{
  "LocationIndicatorActive": location_indicator_active
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
chassis_id系统资源的ID● 针对机架服务器，取值 为1
● 针对高密服务器，取值 为BladeN（N表示节点 槽位号），例如 “Blade1”
● 针对刀片服务器，取值 可以为BladeN（N表示 计算节点槽位号）
● 针对X6800 V5，X6000 V5，G5500，XA320 V2 服务器，取值还可以为 Enc，表示计算节点所在 的机框资源
● 针对设备U位信息，取值 可以为UN(N表示设备U 位号)，例如"U1"
● 针对机柜资源，取值为 Rack
drive_id驱动器资源的ID可通过指定机箱资源获取。
ledstate定位指示灯状态● Off
● Blinking
hotsparetype驱动器的热备状态● None
● Global
● Dedicated
● Auto Replace
volumepath驱动器设置为局部热备盘 时，所关联的逻辑盘访问路 径 说明 当“hotsparetype”为 “None”和“Global”时，不 需要设置此Oem参数。可通过查询指定存储资源获 得 例如："/redfish/v1/ Systems/1/Storages/ RAIDStorage0/Volumes/ LogicalDrive3
diskstate驱动器状态。驱动器状态可在如下状态之 间切换：
● “Online”和 “Offline”
● “UnconfiguredGood” 和“JBOD”
● “UnconfigureBad” 到 “UnconfiguredGood” 说明 驱动器状态设置为“JBOD” 之前，请先通过BMC Web开 启控制器的JBOD功能。
patrolstate巡检开关的状态可设置为：
● “Patrolling” : 开启
● “DoneOrNotPatrolled ” :关闭
bootstate是否为启动盘可设置为：
● true
● false
bootpriority启动优先级可设置为
● Primary：第一启动设备
● Secondary：第二启动设 备
● All：第一和第二启动设 备
● None：取消启动设备
location_indicator_act ive硬盘定位状态可设置为：
● true
● false 说明 BMC500 5.13.0 及以上版 本支持。

使用指南

无

使用实例

请求样例1：

http
PATCH https://device_ip/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1

请求头：


X-Auth-Token: 123456789***********************
Content-Type: application/json
If-Match: W/"3d607e36"

请求消息体：

json
{
  "IndicatorLED": "Blinking",
  "LocationIndicatorActive": true
}

响应样例：

json
{
  "@odata.context": "/redfish/v1/$metadata#Drive.Drive",
  "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0",
  "@odata.type": "#Drive.v1_1_0.Drive",
  "Id": "HDDPlaneDisk1",
  "Name": "Disk1",
  "Model": "MBF2300RC",
  "Revision": "0109",
  "Status": {
    "Health": "OK",
    "Oem": {
      "Public": {
        "Severity": "Informational"
      }
    },
    "State": "Enabled"
  },
  "CapacityBytes": 298999349248,
  "BlockSizeBytes": 512,
  "FailurePredicted": false,
  "Protocol": "SAS",
  "MediaType": "HDD",
  "Manufacturer": "TOSHIBA",
  "SerialNumber": "EB72PC600G1C",
  "CapableSpeedGbs": 6,
  "NegotiatedSpeedGbs": 6,
  "PredictedMediaLifeLeftPercent": null,
  "IndicatorLED": "Off",
  "HotspareType": "None",
  "StatusIndicator": "OK",
  "PartNumber": "",
  "LocationIndicatorActive": true,
  "DriveFormFactor": null,
  "Metrics": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0/Metrics"
  },
  "Assembly": {
    "@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0/Assembly"
  },
  "PhysicalLocation": {
    "Info": "Disk0",
    "InfoFormat": "DeviceName",
    "PartLocationContext": ""
  },
  "Location": [
    {
      "Info": "Disk1",
      "InfoFormat": "DeviceName"
    }
  ],
  "RotationSpeedRPM": 7200,
  "Oem": {
    "Public": {
      "DriveID": 1,
      "RebuildState": "DoneOrNotRebuilt",
      "AssociatedResource": null,
      "RebuildProgress": null,
      "PatrolState": "DoneOrNotPatrolled",
      "TemperatureCelsius": 70,
      "FirmwareStatus": "Online",
      "SpareforLogicalDrives": [],
      "SASAddress": [
        "5000039418218546",
        "0000000000000000"
      ],
      "PowerState": "Spun Up",
      "Type": "Disk",
      "Position": "HDDplane",
      "HoursOfPoweredUp": 100,
      "SATASmartInformation": null,
      "SASSmartInformation": {
        "MediaErrorCount": 0,
        "PrefailErrorCount": 0,
        "OtherErrorCount": 0,
        "HealthStatus": null,
        "DiskTemperatureCelsius": 34,
        "DiskStripeTemperatureCelsius": 68,
        "ElementsInGrownDefectList": 0,
        "ElementsInPrimaryDefectList": 0,
        "WeekAndYearOfManufacture": "in week 34 of year 2013",
        "BlocksSentToInitiator": 272795360,
        "BlocksReceivedFromInitiator": 381334143,
        "NumberOfMinutesUntilNextSMARTTest": 33,
        "SequenceNumberOfLastPredFailEvent": 0
      },
      "BDF": "0000:80:02.2",
      "CryptoEraseSupported": false,
      "RelatedArrayInfo": {
        "Members": [
          "Disk0",
          "Disk1"
        ],
        "FreeSpaceMiBPerDrive": 0,
        "TotalFreeSpaceMiB": 0,
        "FreeBlocksSpaceMib": [
          0
        ],
        "NumDrivePerSpan": 2,
        "VolumeRaidLevel": "RAID0"
      },
      "SlotNumber": 5,
      "EnclosureDeviceId": 66,
      "BootEnable": false
    }
  },
  "Links": {
    "Volumes": [
      {
        "@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive3"
      }
    ]
  },
  "Actions": {
    "Oem": {
      "Public": {
        "#Drive.CryptoErase": {
          "target": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk1/Actions/Oem/Public/Drive.CryptoErase"
        }
      }
    }
  }
}

响应码：200

POST (ACTION) ​

SecureErase ​

命令功能

加密盘的数据安全擦除

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Drives/drives_id/Actions/Oem/Public/Drive.CryptoErase

请求头:


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

请求消息体:

json
{}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
Chassis_id系统资源的ID● 针对机架服务器，取值 为1
● 针对高密服务器，取值 为BladeN（N表示节点 槽位号），例如 “Blade1”
● 针对刀片服务器，取值 可以为BladeN（N表示 计算节点槽位号）
● 针对X6800 V5，X6000 V5，G5500，XA320 V2 服务器，取值还可以为 Enc，表示计算节点所在 的机框资源
● 针对设备U位信息，取值 可以为UN(N表示设备U 位号)，例如"U1"
● 针对机柜资源，取值为 Rack
drive_id指定驱动器的ID● 可从指定机箱资源中获 取

使用指南

无

使用实例

请求样例：

http
POST https://device_ip/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0/Actions/Oem/Public/Drive.CryptoErase

请求头：


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体：

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) ​

Drive.ResetPhysicalDisk ​

命令功能

复位指定物理盘

命令格式

URL: https://device_ip/redfish/v1/Chassis/chassis_id/Drives/drives_id/Actions/Drive.Reset

请求头:


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

请求消息体:

json
{
  "ResetType": reset_type
}

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
Chassis_id系统资源的ID● 针对机架服务器，取值 为1
● 针对高密服务器，取值 为BladeN（N表示节点 槽位号），例如 “Blade1”
● 针对刀片服务器，取值 可以为BladeN（N表示 计算节点槽位号）
● 针对X6800 V5，X6000 V5，G5500，XA320 V2 服务器，取值还可以为 Enc，表示计算节点所在 的机框资源
● 针对设备U位信息，取值 可以为UN(N表示设备U 位号)，例如"U1"
● 针对机柜资源，取值为 Rack
drive_id指定驱动器的ID● 可从指定机箱资源中获 取
reset_type上下电操作类型取值：
● ForceOn：强制上电
● ForceOff：强制下电

使用指南

BMC300 5.13.0.1及以上版本支持。

使用实例

请求样例：

http
POST https://device_ip/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0/Actions/Drive.Reset

请求头：


X-Auth-Token: 123456789***********************
Content-Type: application/json

请求消息体：

json
{
  "ResetType": "On"
}

响应样例：

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