代码仓
中
文档中心
Drives
更新时间： 2026/09/07
在AtomGit上查看源码

ResourceDefinition ​

uris ​

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

properties ​

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue-指定驱动器资源模型的OData描述信息
@odata.idstringtrue-指定驱动器资源的访问路径
@odata.typestringtrue-指定驱动器资源的类型
Idstringtrue-指定驱动器资源的ID
Namestringtrue-指定驱动器资源的名称
Modelstringtrue-指定驱动器型号
Revisionstringtrue-指定驱动器的版本信息
Status {objecttrue-指定驱动器的状态，包括：
● State：驱动器使能状态
● Health：驱动器健康状态
● Severity：驱动器的自定义健康状态
Status.Healthstringtrue-驱动器健康状态，包括：
● OK：正常
● Warning：警告
● Critical：严重
Status.Oem {objecttrue-自定义属性
Status.Oem.Public {objecttrue-自定义属性
Status.Oem.Public.Severitystringtrue-驱动器的自定义健康状态，例如Informational
Status.Statestringtrue-驱动器使能状态，包括：
● Enabled：使能
● Disabled：禁用
}
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：HDD
● SSD：SSD
● SMR：SMR
Manufacturerstringtrue-指定驱动器的制造商
SerialNumberstringtrue-指定驱动器的序列号
CapableSpeedGbsnumbertrue-指定驱动器接口的最大速率
NegotiatedSpeedGbsnumbertrue-指定驱动器接口的协商速率
PredictedMediaLifeLeftPercentnulltrue-指定驱动器的剩余寿命百分比
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及以上版本支持。
DriveFormFactornulltrue-硬盘尺寸，取值范围：
● Drive3_5：3.5英寸硬盘
● Drive2_5：2.5英寸硬盘
● M2：M.2接口硬盘
● OEM：厂商自定义尺寸 说明 BMC500 5.13.0及以上版本支持。
Metrics {objecttrue-指向与此驱动器关联的硬件诊断信息的URI链接 说明 BMC500 5.13.0及以上版本支持。
Metrics.@odata.idstringtrue-硬件诊断信息资源的访问路径
}
Assembly {objecttrue-指向与此驱动器关联的装配体资源的URI链接 说明 BMC500 5.13.0及以上版本支持。
Assembly.@odata.idstringtrue-装配体资源的访问路径
}
PhysicalLocation {objecttrue-阵列中硬盘的相对位置 说明 BMC500 5.13.0及以上版本支持。
PhysicalLocation.Infostringtrue-只读字符串，表示资源的位置
PhysicalLocation.InfoFormatstringtrue-只读字符串，表示Info属性的格式
PhysicalLocation.PartLocationContextstringtrue-可读字符串，用于区分同一外壳内不同部件的PartLocation值，这些值可能包含该部件的父级PartLocation值的层次信息
}
Location[ ]arraytrue-指定驱动器丝印
Location[].Infostringtrue-指定驱动器丝印信息
Location[].InfoFormatstringtrue-指定驱动器丝印格式
RotationSpeedRPMnumbertrue-指定驱动器的转速
Oem {objecttrue-自定义属性
Oem.Public {objecttrue-自定义属性
Oem.Public.Presencestringtrue-驱动器在位状态，包括：
● Present：在位
● Absent：不在位
Oem.Public.DriveIDnumbertrue-创建逻辑盘时指定的驱动器的ID
Oem.Public.RebuildStatestringtrue-指定驱动器数据重建状态，包括：
● DoneOrNotRebuilt：未重建或已完成重建
● Rebuilding：正在重建
Oem.Public.AssociatedResourcenulltrue-指定驱动器的资源归属
Oem.Public.RebuildProgressnulltrue-指定驱动器数据重建进度
Oem.Public.PatrolStatestringtrue-指定驱动器巡检状态，包括：
● DoneOrNotPatrolled：未巡检或已完成
● Patrolling：正在巡检
Oem.Public.TemperatureCelsiusnumbertrue-指定驱动器当前温度。 说明 已屏蔽该属性值频繁变化导致的事件上报
Oem.Public.FirmwareStatusstringtrue-指定驱动器的状态，包括：
● UnconfiguredGood：未配置到任何卷的完好硬盘。
● UnconfigureBad：未配置的坏硬盘。
● HotSpareDrive：热备盘。
● Offline： 成员盘处于离线状态。
● Failed： 已配置的坏硬盘（故障盘）。
● Online： 成员盘处于正常状态。
● GettingCopied：硬盘正在复制数据。
● JBOD：硬盘由主机控制，不受RAID卡管理（直通模式）。
● UnconfiguredShieded： 未配置且被屏蔽的硬盘。
● HotSpareShielded：热备且被屏蔽的硬盘。
● ConfiguredShielded：已配置且被屏蔽的硬盘。
● Foreign： 带有外来（外部）配置的硬盘。
● Active：硬盘处于活动状态。
● Standby： 硬盘处于待机状态。
● Sleep： 硬盘处于休眠状态。
● DSTInProgress： 磁盘自检（DST）正在后台执行中。
● SMARTOfflineDataCollection： SMART离线数据收集正在后台执行中。
● SCTCommand：SCT命令正在后台执行中。
● Rebuilding：已配置的硬盘正在重建。
● Raw：设备以原始模式运行
● Ready：设备已准备就绪
● NotSupported：当前设备或操作不被系统或控制器所支持。
● PredictiveFailure：设备可能即将发生故障
● EraseInProgress：设备正在进行数据擦除操作
Oem.Public.IsEPDbooleantrue-是否为加强型物理硬盘
Oem.Public.SpareforLogicalDrives[ ]arraytrue-指定驱动器是局部热备盘时所属逻辑盘列表
Oem.Public.SASAddress[ ]arraytrue-指定驱动器SAS地址
Oem.Public.PowerStatestringtrue-物理盘的节能休眠状态
● Spun Up：电机旋转
● Spun Down：电机停转
● Transition：状态切换中
Oem.Public.SlotPowerStatestringtrue-指定物理盘槽位的电源状态
● On
● Off：下电 说明 BMC300 5.13.0.1及以上版本支持
Oem.Public.Typestringtrue-驱动器类型，包括
● Disk：磁盘
● SDCard：SD卡
● PCIe SSD Card：PCIe固态硬盘卡
Oem.Public.Positionstringtrue-指定驱动器容器
Oem.Public.EstimatedRemainingLifespannumbertrue-指定驱动器预估剩余寿命
Oem.Public.HoursOfPoweredUpnumbertrue-指定驱动器上电运行时间 说明 已屏蔽该属性值频繁变化导致的事件上报
Oem.Public.SATASmartInformationnulltrue-SATA接口SMART信息
Oem.Public.SASSmartInformation {objecttrue-SAS接口SMART信息
Oem.Public.SASSmartInformation.MediaErrorCountnumbertrue-介质错误数
Oem.Public.SASSmartInformation.PrefailErrorCountnumbertrue-预测故障错误数
Oem.Public.SASSmartInformation.OtherErrorCountnumbertrue-其它错误数
Oem.Public.SASSmartInformation.HealthStatusnulltrue-健康状态
Oem.Public.SASSmartInformation.DiskTemperatureCelsiusnumbertrue-驱动器温度(摄氏度)
Oem.Public.SASSmartInformation.DiskStripeTemperatureCelsiusnumbertrue-驱动器条带温度(摄氏度)
Oem.Public.SASSmartInformation.ElementsInGrownDefectListnumbertrue-增长缺陷列表(G表)中的元素
Oem.Public.SASSmartInformation.ElementsInPrimaryDefectListnumbertrue-主缺陷列表(P表)中的元素
Oem.Public.SASSmartInformation.WeekAndYearOfManufacturestringtrue-生产日期
Oem.Public.SASSmartInformation.BlocksSentToInitiatornumbertrue-发送到启动器的块
Oem.Public.SASSmartInformation.BlocksReceivedFromInitiatornumbertrue-从启动器收到的块
Oem.Public.SASSmartInformation.NumberOfMinutesUntilNextSMARTTestnumbertrue-距下一次内部SMART测试的时长(分钟)
Oem.Public.SASSmartInformation.SequenceNumberOfLastPredFailEventnumbertrue-最后一次预测故障事件的序列号
}
Oem.Public.BDFstringtrue-BDF值：
● Bus：总线
● Device：设备
● Function：功能
● null
Oem.Public.CryptoEraseSupportedbooleantrue-指定驱动器是否支持加密盘数据擦除
Oem.Public.RelatedArrayInfo {objecttrue-指定驱动器上的驱动器阵列信息
Oem.Public.RelatedArrayInfo.Members[ ]arraytrue-指定驱动器阵列的成员
Oem.Public.RelatedArrayInfo.FreeSpaceMiBPerDrivenumbertrue-指定驱动器阵列中每个驱动器的剩余容量（单位： MB）
Oem.Public.RelatedArrayInfo.TotalFreeSpaceMiBnumbertrue-指定驱动器阵列中总的剩余容量（单位：MB）
Oem.Public.RelatedArrayInfo.FreeBlocksSpaceMib[ ]arraytrue-指定驱动器阵列中的剩余容量（单位：MB）
Oem.Public.RelatedArrayInfo.NumDrivePerSpannumbertrue-指定驱动器阵列中每个Span的成员的个数
Oem.Public.RelatedArrayInfo.VolumeRaidLevelstringtrue-指定驱动器阵列组成的虚拟磁盘的级别
}
}
Oem.SlotNumbernumbertrue-物理盘所在背板的槽位号
Oem.EnclosureDeviceIdnumbertrue-物理盘所在背板的设备ID，由RAID控制器固件生成
Oem.BootPrioritystringtrue-启动优先级
● Primary：第一启动设备
● Secondary：第二启动设备
● All：第一和第二启动设备
● None
Oem.BootEnablebooleantrue-是否为启动盘
Oem.FormFactorstringtrue-硬盘尺寸
● Unknown：未知
● 5.25 inch：5.25英寸
● 3.5 inch：3.5英寸
● 2.5 inch：2.5英寸
● 1.8 inch：1.8英寸
● Lessthan 1.8 inch：小于1.8英寸
● mSATA：mSATA
● M.2：M.2
● MicroSSD：MicroSSD
● CFast：CFast卡
}
Links {objecttrue-驱动器关联的资源
Links.Volumes[ ]arraytrue-指定驱动器所属逻辑盘列表
Links.Volumes[].@odata.idstringtrue-指定驱动器所属逻辑盘的访问路径
}
Actions {objecttrue-Redfish允许的指定驱动器资源可执行操作
Actions.#Drive.Reset {objecttrue-重启指定物理盘操作 说明 BMC300 5.13.0.1及以上版本支持
Actions.#Drive.Reset.targetstringtrue-重启指定物理盘操作的访问路径
Actions.#Drive.Reset.@Redfish.ActionInfostringtrue-重启指定物理盘操作ActionInfo的访问路径
}
Actions.Oem {objecttrue-自定义属性
Actions.Oem.Public {objecttrue-自定义属性
Actions.Oem.Public.#Drive.CryptoErase {objecttrue-加密盘的数据安全擦除操作
Actions.Oem.Public.#Drive.CryptoErase.targetstringtrue-加密盘的数据安全擦除操作的访问路径
}
}
}
}

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": {
      "Presence": "Present",
      "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
}

URL参数说明

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

请求头参数说明

参见 请求头参数说明

请求体参数说明

参数参数说明取值
IndicatorLED定位指示灯状态● Off
● Blinking
HotspareType驱动器的热备状态● None
● Global
● Dedicated
● Auto Replace
@odata.id驱动器设置为局部热备盘 时，所关联的逻辑盘访问路 径 说明 当“hotsparetype”为 “None”和“Global”时，不 需要设置此Oem参数。可通过查询指定存储资源获 得 例如："/redfish/v1/ Systems/1/Storages/ RAIDStorage0/Volumes/ LogicalDrive3
FirmwareStatus驱动器状态。驱动器状态可在如下状态之 间切换：
● “Online”和 “Offline”
● “UnconfiguredGood” 和“JBOD”
● “UnconfigureBad” 到 “UnconfiguredGood” 说明 驱动器状态设置为“JBOD” 之前，请先通过BMC Web开 启控制器的JBOD功能。
PatrolState巡检开关的状态可设置为：
● “Patrolling” : 开启
● “DoneOrNotPatrolled ” :关闭
BootEnable是否为启动盘可设置为：
● true
● false
BootPriority启动优先级可设置为
● Primary：第一启动设备
● Secondary：第二启动设 备
● All：第一和第二启动设 备
● None：取消启动设备
LocationIndicatorActive硬盘定位状态可设置为：
● 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

下一篇探索openUBMC