GET – 由存储控制器管理的卷
使用 GET 方法检索服务器的卷资源。
请求 URL
GET https://<BMC_IPADDR>/redfish/v1/Systems/1/Storage/{StorageId}/Volumes/{VolumeId}
响应正文
字段 | 类型 | 描述 | ||
|---|---|---|---|---|
AccessCapabilities | 数组 | 支持的 IO 访问功能。 注 如果存储为 M.2 存储，则此对象将被隐藏。 | ||
BlockSizeBytes | 数字 | 关联卷的最小可寻址单元的大小。 注 如果存储为 7 毫米或 M.2 存储，则此对象将被隐藏。 | ||
CapacityBytes | 数字 | 此卷的大小（以字节为单位）。 | ||
Description | 字符串 | “This resource is used to represent volume in Redfish implementation.” | ||
DisplayName | 字符串 | 用于命名卷的用户可配置字符串。 注 如果存储为 7 毫米或 M.2 存储，则此对象将被隐藏。 | ||
Encrypted | 布尔 | 此卷是否已加密？ | ||
EncryptionTypes | 数组 | 此卷使用的加密类型。 | ||
Id | 字符串 | 卷 ID | ||
IsBootCapable | 布尔 | 指示卷是否包含引导映像以及是否能够引导。 | ||
Links | 对象 | 已展开。 | ||
Drives | 数组 | 用于创建卷的硬盘的引用数组。 | ||
Drives[N] | 链接 | 链接 | ||
DedicatedSpareDrives | 数组 | DedicatedSpareDrives 的链接。 | ||
MediaSpanCount | 数字 | 分层 RAID 类型在辅助 RAID 中为每个跨度使用的介质元素数量（请求值）。 | ||
RAIDType | 字符串 | 此卷的 RAID 类型。 | ||
Name | 字符串 | 卷信息名称 | ||
OptimumIOSizeBytes | 数字 | 此卷的最佳 IO 大小（以字节为单位）。 | ||
ReadCachePolicy | 字符串 | 指示卷的读取缓存策略设置。 注 如果存储为 7 毫米或 M.2 存储，则此属性将被隐藏。 | ||
ReadCachePolicy @Redfish.AllowableValues | 字符串 | “Off”、“ReadAhead”。 注 如果存储为 7 毫米或 M.2 存储，则此属性将被隐藏。 | ||
WriteCachePolicy | 字符串 | 指示卷的写入缓存策略设置。 注 如果存储为 7 毫米或 M.2 存储，则此属性将被隐藏。 | ||
WriteCachePolicy @Redfish.AllowableValues | 字符串 | “WriteThrough”、“UnprotectedWriteBack”和“ProtectedWriteBack”。 注
| ||
WriteCacheState | 字符串 | 指示卷的 WriteCacheState 策略设置。 | ||
StripSizeBytes | 数字 | 使用条带化数据映射的磁盘阵列中的条带的块（字节）数。 注 如果存储为 7 毫米或 M.2 存储，则此对象将被隐藏。 | ||
Status | 对象 | 已展开。 | ||
State | 字符串 | Enabled | ||
Health | 字符串 | 此卷的运行状况。可能的值为“OK”、“Warning”和“Critical”。 | ||
Actions | 对象 | 已展开。 注 如果存储为 7 毫米或 M.2 存储，则此对象将被隐藏。 | ||
#Volume.Initialize | 对象 | 已展开。 | ||
target | 字符串 | Initialize | ||
title | 字符串 | 此操作的链接。 | ||
InitializeType@Redfish.AllowableValues | 数组 | 项：字符串 项数：1 | ||
状态代码
| HTTP 状态代码 | 错误消息 ID |
|---|---|
| 500 | InternalError |
示例
返回以下示例 JSON 响应：
{
"@Redfish.WriteableProperties": [
"DisplayName",
"IOPolicy",
"DriveCachePolicy",
"AccessPolicy",
"WriteCachePolicy",
"ReadCachePolicy"
],
"@odata.context": "/redfish/v1/$metadata#Volume.Volume",
"@odata.etag": "\"ADE20C32\"",
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Volumes/238",
"@odata.type": "#Volume.v1_8_0.Volume",
"AccessCapabilities": [
"Read",
"Write"
],
"Actions": {
"#Volume.Initialize": {
"InitializeType@Redfish.AllowableValues": [
"Fast",
"Full"
],
"target": "/redfish/v1/Systems/1/Storage/controller_slot8/Volumes/238/Actions/Volume.Initialize",
"title": "Initialize"
}
},
"BlockSizeBytes": 512,
"CapacityBytes": 3997997989888,
"Description": "This resource is used to represent a volume for a Redfish implementation.",
"DisplayName": "VD_2",
"Encrypted": false,
"EncryptionTypes": [],
"Id": "238",
"IsBootCapable": false,
"Links": {
"DedicatedSpareDrives": [],
"Drives": [
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_4"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_5"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_6"
},
{
"@odata.id": "/redfish/v1/Systems/1/Storage/controller_slot8/Drives/drive_bay_7"
}
]
},
"MediaSpanCount": 2,
"Name": "VD_2",
"Oem": {
...
}
},
"OptimumIOSizeBytes": 262144,
"RAIDType": "RAID10",
"ReadCachePolicy": "ReadAhead",
"ReadCachePolicy@Redfish.AllowableValues": [
"ReadAhead",
"Off"
],
"Status": {
"Health": "OK",
"State": "Enabled"
},
"StripSizeBytes": 262144,
"WriteCachePolicy": "WriteThrough",
"WriteCachePolicy@Redfish.AllowableValues": [
"WriteThrough"
],
"WriteCacheState": null
}