跳到主要内容

GET – 由存储控制器管理的硬盘

使用 GET 方法检索服务器的硬盘资源。

请求 URL​

GET https://<BMC_IPADDR>/redfish/v1/Systems/1/Storage/Id/Drives/{DriveId}

请求正文​

无

响应正文​

字段

类型

描述

AssetTag

字符串

此硬盘的资产标记。

Description

字符串

“This resource is used to represent a drive for a Redfish implementation.”

BlockSizeBytes

数字

关联硬盘的最小可寻址单元的大小。

CapableSpeedGbs

数字

关联硬盘的最快总线速度。

CapacityBytes

数字

此硬盘的大小（以字节为单位）。

EncryptionAbility

字符串

“None”和“SelfEncryptingDrive”之一

EncryptionStatus

字符串

“Unlocked”、“Locked”和“Unencrypted”之一

NegotiatedSpeedGbs

数字

此硬盘当前与存储控制器通信的速度，以千兆位/秒（Gbit/s）为单位。

HotspareType

字符串

“None”和“Global”之一

Id

字符串

硬盘插槽 ID

FailurePredicted

布尔

指示此硬盘当前是否预测到即将发生故障。

Identifiers

数组

硬盘的持久名称。

 

Identifiers[N]

对象

已展开。

  

DurableNameFormat

字符串

“UUID”

  

DurableName

字符串

硬盘的 UUID 信息

Links

对象

已展开。

 

Chassis

链接

机箱资源的 URI 引用。

 

Volumes

数组

此硬盘中包含的卷的引用数组。

  

Volumes[N]

链接

链接

 

PCIeFunctions

数组

硬盘产生的 PCIe 功能的链接数组。

  

PCIeFunctions[N]

链接

链接

PhysicalLocation

对象

此硬盘的位置。

 

PartLocation

对象

部件位置。

  

LocationOrdinalValue

整数

表示此硬盘的位置的数字。

  

LocationType

字符串

“Bay”。

  

ServiceLabel

字符串

此硬盘的服务标签。

 

Info

字符串

硬盘的插槽编号。如果存储是主机总线适配器或 RAID，则将显示此属性。

 

InfoFormat

字符串

“Slot Number”。如果存储是主机总线适配器或 RAID，则将显示此属性。

Manufacturer

字符串

硬盘的制造商。

MediaType

字符串

硬盘的介质类型。

Model

字符串

硬盘的型号。

Name

字符串

硬盘的名称。

PredictedMediaLifeLeftPercent

数字

0-100，磁盘信息剩余寿命。

SKU

字符串

此硬盘的 SKU。

StatusIndicator

字符串

状态指示灯的状态，用于指示此硬盘的状态信息。

PartNumber

字符串

硬盘的部件号。

Protocol

字符串

此硬盘用于与存储控制器通信的协议。

Revision

字符串

硬盘的固件/硬件版本。

RotationSpeedRPM

数字

硬盘的转速。

SerialNumber

字符串

硬盘的序列号。

Status

对象

已展开。

 

State

字符串

“Enabled”

 

Health

字符串

硬盘的运行状况信息。

注

资源“Drive”可以描述多种类型的硬盘。在某些情况下，例如当 M.2 卡上添加了 NVMe 时，部分信息可能不可用。

状态代码​

HTTP 状态代码错误消息 ID
500InternalError

示例​

返回以下示例 JSON 响应：

{
    "SerialNumber": "W0K02Y42",
    "Id": "Disk.1",
    "@odata.id": "/redfish/v1/Systems/1/Storage/RAID_Slot18/Drives/Disk.1",
    "Revision": "L5A7",
    "AssetTag": "",
    "FailurePredicted": false,
    "BlockSizeBytes": 512,
    "HotspareType": "None",
    "CapableSpeedGbs": 12,
    "Identifiers": [
        {
            "DurableName": "",
            "DurableNameFormat": "UUID"
        }
    ],
    "StatusIndicator": null,
    "PartNumber": "SH20L60465",
    "EncryptionStatus": "Unencrypted",
    "MediaType": "HDD",
    "Description": "This resource is used to represent a drive for a Redfish implementation.",
Volumes": [],
        "Chassis": {
            "@odata.id": "/redfish/v1/Chassis/1"
        },
        "PCIeFunctions": []
    },
    "RotationSpeedRPM": 10500,
    "NegotiatedSpeedGbs": 12,
    "@odata.type": "#Drive.v1_6_0.Drive",
    "Status": {
        "State": "Enabled",
        "Health": "OK"
    },
    "Protocol": "SAS",
    "Name": "300GB 10K 12Gbps SAS 2.5 HDD",
    "PredictedMediaLifeLeftPercent": null,
    "EncryptionAbility": "None",
    "Oem": {
        "Lenovo": {
            "DriveStatus": "Unconfigured good",
            "@odata.type": "#LenovoDrive.v1_0_0.LenovoDrive"
        }
    },
    "CapacityBytes": 300000000000,
    "PhysicalLocation": {
        "PartLocation": {
            "LocationType": "Bay",
            "ServiceLabel": "Drive 1",
            "LocationOrdinalValue": 1
        },
        "InfoFormat": "Slot Number",
        "Info": "Slot 1",
        "Info@Redfish.Deprecated": "The property is deprecated. Please use PartLocation instead.",
        "InfoFormat@Redfish.Deprecated": "The property is deprecated. Please use PartLocation instead."
    },
    "Manufacturer": "LENOVO",
    "@odata.etag": "\"9ed0621341dee6bbe98b640ddee6ad61\"",
    "Model": "ST300MM0048",
    "SKU": "00FC612"
}