Volumes
更新时间： 2026/10/28
在AtomGit上查看源码ResourceDefinition
uris
/redfish/v1/Systems/system_id/Storages/storage_id/Volumes/volume_id
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | - | 逻辑盘资源模型的OData描述信息 |
| @odata.id | string | true | - | 逻辑盘资源的访问路径 |
| @odata.type | string | true | - | 逻辑盘资源的类型 |
| Id | string | true | - | 逻辑盘资源的ID |
| Name | string | true | - | 逻辑盘的名称 |
| CapacityBytes | number | false | - | 逻辑盘的容量 |
| VolumeType | string | true | - | 逻辑盘的冗余类型 ● RawDevice：裸设备 ● NonRedundant：非冗余卷 ● Mirrored：镜像卷 ● StripedWithParity：奇偶校验条带卷 ● SpannedMirrors：跨区镜像卷 ● SpannedStripesWithParity：跨区奇偶校验条带卷 |
| OptimumIOSizeBytes | number | false | - | 逻辑盘的最优 I/O 大小 |
| StripSizeBytes | number | true | - | 逻辑盘的条带大小 |
| ReadCachePolicy | string | true | - | ● NoReadAhead：关闭预读取功能 ● ReadAhead：使能预读取功能。控制器可以预读取顺序数据或预测需要即将使用到的数据并存储在Cache中 |
| Status { | object | true | - | 逻辑盘的状态，包括： ● Health：逻辑盘的健康状态 ● State：逻辑盘的使能状态 ● Severity：逻辑盘的自定义健康状态 |
| 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：安全擦除中 |
| Status.Health | null | true | - | 逻辑盘资源的健康状态，包括： ● OK：正常 ● Warning：警告 ● Critical：严重 ● null |
| Status.Oem { | object | true | - | 自定义属性 |
| Status.Oem.Public { | object | false | - | 自定义属性 |
| Status.Oem.Public.Severity | string | false | - | 逻辑盘资源的自定义健康状态，包括： ● Informational：正常 ● Minor：轻微 ● Major：严重 ● Critical：紧急 ● null |
| } | ||||
| } | ||||
| } | ||||
| Operations [ { | array | true | - | 逻辑盘上正在执行的操作，包括： ● OperationName：操作的名称 ● PercentageComplete：完成的进度 ● AssociatedTask：关联的Redfish任务资源的访问路径 说明：已屏蔽该属性值频繁变化导致的事件上报 |
| Operations[].AssociatedTask { | object | true | - | 关联的任务信息 |
Operations[].AssociatedTask.@odata.id | string | true | - | 成员资源节点的访问路径 |
| } | ||||
| Operations[].OperationName | string | true | - | 操作名称 |
| Operations[].PercentageComplete | number | true | - | 操作完成的百分比 |
| } ] | ||||
| Oem { | object | true | - | 逻辑盘定制化信息 |
| Oem.Public { | object | false | - | 逻辑盘定制化信息 |
| Oem.Public.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：安全擦除中 |
| Oem.Public.VolumeName | string | false | - | 逻辑盘的名称 |
| Oem.Public.RaidControllerID | number | true | - | 逻辑盘所属控制器的ID |
| Oem.Public.VolumeRaidLevel | string | true | - | 逻辑盘的RAID级别 ● RAID0：RAID0(无冗余条带化) ● RAID1：RAID1(镜像) ● RAID2：RAID2(汉明码) ● RAID3：RAID3(专用奇偶校验条带化) ● RAID4：RAID4(专用奇偶校验条带化) ● RAID5：RAID5(分布式奇偶校验条带化) ● RAID6：RAID6(双分布式奇偶校验) ● RAID10：RAID10(条带化镜像) ● RAID1E：RAID1E(近镜像) ● RAID20：RAID20 ● RAID30：RAID30 ● RAID40：RAID40 ● RAID50：RAID50 ● RAID60：RAID60 ● RAID1(ADM)：RAID1(ADM)(镜像三盘) ● RAID10(ADM)：RAID10(ADM)(条带化镜像三盘) ● RAID1Triple：RAID1Triple(三重镜像) ● RAID10Triple：RAID10Triple(三重条带化镜像) |
| Oem.Public.DefaultReadPolicy | string | false | - | 逻辑盘默认的读策略 ● NoReadAhead：关闭预读取 ● ReadAhead：使能预读取 |
| Oem.Public.DefaultWritePolicy | string | false | - | 逻辑盘默认的写策略 ● WriteThrough：写穿(磁盘子系统接受所有传输数据后向主机返回完成信号) ● WriteBackWithBBU：带BBU写回(无BBU或BBU损坏时自动切换为WriteThrough) ● WriteBack：写回(控制器Cache收到所有传输数据后向主机返回完成信号) |
| Oem.Public.DefaultCachePolicy | string | false | - | 逻辑盘默认的Cache策略 ● CachedIO：缓存IO(所有读写均经过RAID控制器Cache处理) ● DirectIO：直接IO(读场景直接读物理盘,写场景写数据经过RAID控制器Cache处理) |
| Oem.Public.ConsistencyCheck | boolean | true | - | 一致性检查功能的启用状态 |
| Oem.Public.SpanNumber | number | true | - | 逻辑盘包含的子组数 |
| Oem.Public.NumDrivePerSpan | number | true | - | 子组包含的成员盘个数 |
| Oem.Public.Spans [ { | array | true | - | 子属性如下，其中ArrayID，UsedSpaceMiB，FreeSpaceMiB, FreeBlocksSpaceMib仅RAID10/50/60/10(ADM)/10Triple支持： ● SpanName：子组名称 ● Drives：子组包含的成员盘列表 ● ArrayID：阵列ID ● UsedSpaceMiB：已使用的容量 ● FreeSpaceMiB：剩余总容量 ● FreeBlocksSpaceMib：剩余容量 |
| Oem.Public.Spans[].Drives[ ] | array | true | - | Span包含的驱动器列表 |
Oem.Public.Spans[].Drives[].@odata.id | string | true | - | 成员盘的访问路径 |
| } ] | ||||
| Oem.Public.Spans[].SpanName | string | true | - | Span的名称 |
| Oem.Public.AssociatedVolumes[ ] | array | true | - | 所关联的普通逻辑盘的访问路径 |
| } ] | ||||
| Oem.Public.CurrentReadPolicy | string | true | - | 逻辑盘当前读策略 |
| Oem.Public.CurrentWritePolicy | string | true | - | 逻辑盘当前写策略 |
| Oem.Public.CurrentCachePolicy | string | true | - | 逻辑盘当前Cache策略 |
| Oem.Public.AccessPolicy | string | false | - | 逻辑盘的访问策略 ● ReadWrite：可读可写 ● ReadOnly：只读 ● Blocked：禁止访问 ● Hidden：隐藏 |
| Oem.Public.BootPriority | string | false | - | 启动优先级 ● Primary：第一启动设备 ● Secondary：第二启动设备 ● All：第一和第二启动设备 ● None |
| Oem.Public.BootEnable | boolean | false | - | 是否为启动盘 |
| Oem.Public.BGIEnable | boolean | false | - | 后台初始化使能状态 |
| Oem.Public.SSDCachecadeVolume | boolean | true | - | 是否为CacheCade逻辑盘 |
| Oem.Public.SSDCachingEnable | boolean | false | - | 是否可使用CacheCade逻辑盘 |
| Oem.Public.AssociatedCacheCadeVolume[ ] | array | true | - | 所关联的CacheCade逻辑盘的访问路径 |
| Oem.Public.DriveCachePolicy | string | false | - | 物理盘的Cache策略 ● Enabled：启用(读写过程中数据经过物理盘写Cache,写性能提升,掉电有丢失风险) ● Disabled：禁用(读写过程中数据不经过物理盘写Cache,掉电不丢失) ● Unchanged：保持默认 |
| Oem.Public.OSDriveName | string | true | - | 逻辑盘对应的OS盘符 |
| Oem.Public.InitializationMode | string | true | - | 初始化模式 ● UnInit：未初始化/取消初始化 ● QuickInit：快速初始化(不创建任务) ● FullInit：完全初始化(会创建任务) |
| Oem.Public.AccelerationMethod | string | false | - | 加速方法 ● ControllerCache：控制器缓存加速(同时使用读缓存和写缓存) ● IOBypass：IOBypass加速(仅SSD组成的逻辑盘有效) ● maxCache：maxCache加速(使用最大缓存) ● None |
| Oem.Public.CacheLineSizeKB | number | true | - | 缓存行大小 ● 64：64KB缓存 ● 256：256KB缓存 |
| Oem.Public.RebuildState | string | true | - | 指定逻辑盘数据重建状态，包括： ● DoneOrNotRebuilt：已完成或未重建 ● Rebuilding：正在重建 |
| } | ||||
| } | ||||
| Links { | object | true | - | 逻辑盘资源的资源链接 |
| Links.Drives [ { | array | true | - | 关联的驱动器资源链接 |
Links.Drives[].@odata.id | string | true | - | 成员资源节点的访问路径 |
| } ] | ||||
Links.Drives@odata.count | number | true | - | 指定逻辑盘包含的物理盘个数 |
| } | ||||
| Actions { | object | true | - | Redfish允许的逻辑盘资源可执行操作 |
| Actions.#Volume.Initialize { | object | true | - | 逻辑盘可执行的初始化操作 |
| Actions.#Volume.Initialize.target | string | true | - | 逻辑盘可执行的初始化操作路径 |
Actions.#Volume.Initialize.@Redfish.ActionInfo | string | true | - | 逻辑盘可执行的初始化操作信息查询路径 |
| } | ||||
| } | ||||
| RebuildProgress | string | true | - | 指定逻辑盘数据重建进度 |
supported_methods
- GET
- PATCH
- POST
- DELETE
HTTP methods
GET
命令功能
查询指定逻辑盘资源信息
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Volumes/volume_id
请求头:
text
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/Storages/storage_id/Volumes/volume_id>X-Auth-Token: 123456789***********************
请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#Systems/Members/1/Storages/Members/RAIDStorage0/Volumes/Members/$entity",
"@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive0",
"@odata.type": "#Volume.v1_0_1.Volume",
"Id": "LogicalDrive0",
"Name": "LogicalDrive0",
"CapacityBytes": 298999349248,
"VolumeType": "Mirrored",
"OptimumIOSizeBytes": 262144,
"StripSizeBytes": 262144,
"ReadCachePolicy": "ReadAhead",
"Status": {
"State": "Enabled",
"Oem": {
"Public": {
"Severity": "Informational"
}
},
"Health": null
},
"Operations": [
{
"OperationName": "Foreground Init",
"PercentageComplete": 4,
"AssociatedTask": {
"@odata.id": "/redfish/v1/TaskService/Tasks/1"
}
}
],
"Oem": {
"Public": {
"State": "Optimal",
"VolumeName": "N/A",
"RaidControllerID": 0,
"VolumeRaidLevel": "RAID1",
"DefaultReadPolicy": "ReadAhead",
"DefaultWritePolicy": "WriteBackWithBBU",
"DefaultCachePolicy": "DirectIO",
"ConsistencyCheck": false,
"SpanNumber": 1,
"NumDrivePerSpan": 2,
"Spans": [
{
"SpanName": "Span0",
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk3"
}
]
}
],
"CurrentReadPolicy": "ReadAhead",
"CurrentWritePolicy": "WriteBackWithBBU",
"CurrentCachePolicy": "DirectIO",
"AccessPolicy": "ReadWrite",
"BootPriority": "None",
"BootEnable": false,
"BGIEnable": true,
"SSDCachecadeVolume": false,
"SSDCachingEnable": null,
"AssociatedCacheCadeVolume": [],
"DriveCachePolicy": "Unchanged",
"OSDriveName": "/dev/sdb",
"InitializationMode": null,
"AccelerationMethod": "null",
"CacheLineSizeKB": null,
"RebuildState": "DoneOrNotRebuilt"
}
},
"Links": {
"Drives@odata.count": 2,
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk3"
}
]
},
"Actions": {
"#Volume.Initialize": {
"target": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive0/Actions/Volume.Initialize",
"@Redfish.ActionInfo": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive0/InitializeActionInfo"
}
}
}响应码：200
PATCH
命令功能
修改指定逻辑盘资源属性
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Volumes/volume_id
请求头:
text
X-Auth-Token: 123456789***********************
Content-Type: header_type
If-Match: ifmatch_value请求消息体:
json
{
"CapacityBytes": capacity,
"OptimumIOSizeBytes": optsize,
"Oem": {
"Public": {
"VolumeName": name,
"DefaultReadPolicy": df_read_policy,
"DefaultWritePolicy": df_write_policy,
"DefaultCachePolicy": df_cache_policy,
"BootPriority": bootpriority,
"BootEnable": bootstate,
"BGIEnable": bgistate,
"AccessPolicy": access_policy,
"SSDCachingEnable": ssdcachestate,
"DriveCachePolicy": disk_cache_policy,
"AccelerationMethod": acceleration_method
}
}
}URL参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| system_id | 系统资源的ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如“Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或 SwiN（N表示交换模块槽位号），例如“Swi1” ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为 Rack |
| storage_id | 存储资源的ID | 表示服务器系统本身的存储资源，按照控制器划分：RAIDStorage+控制器 ID |
| volume_id | 逻辑盘资源的ID | 可通过逻辑盘集合资源获取。格式为：LogicalDrive +逻辑盘ID |
请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| CapacityBytes | 逻辑盘的容量 | 整数，单位为字节。不允许收缩逻辑盘的容量。如果取值不为1048576（1MB）的整数倍，结果按1048576（1MB）向上取整。 |
| OptimumIOSizeBytes | 逻辑盘的条带大小 | 单位为字节，可设置为： ● 16384 ● 32768 ● 65536 ● 131072 ● 262144 ● 524288 ● 1048576 |
| VolumeName | 逻辑盘的名称，非必选参数。 | 最大长度为15个字节的字符串范围：0x20~0x7E对应的 ASCII码 说明：如果RAID控制器类型为 3152-8i，最大长度为64个字节。 |
| DefaultReadPolicy | 默认读策略 | 支持的策略包括： ● NoReadAhead：关闭预读取功能 ● ReadAhead：使能预读取功能。控制器可以预读取顺序数据或预测需要即将使用到的数据并存储在Cache中 |
| DefaultWritePolicy | 默认写策略 | 支持的策略包括： ● WriteThrough：当磁盘子系统接受到所有传输数据后，控制器将给主机返回数据传输完成信号 ● WriteBackWithBBU：在控制器无BBU或BBU 损坏的情况下，控制器将自动切换到“WriteThrough”模式。 ● WriteBack：当控制器 Cache收到所有的传输数据后，将给主机返回数据传输完成信号 |
| DefaultCachePolicy | 默认Cache策略 | 支持的策略包括： ● CachedIO：所有读和写均经过RAID控制器 Cache处理。仅在配置 CacheCade 1.1时需要设置为此参数值，其他场景不推荐 ● DirectIO：在读、写场景中的定义不同：– 在读场景中，直接从物理盘读取数据。（“DefaultReadPolicy”设置为“ReadAhead”时除外，此时读数据经过RAID控制器的 Cache处理）– 在写场景中，写数据经过RAID控制器的 Cache处理（“DefaultWritePolicy”设置为“WriteThrough”时除外，此时写数据不经过RAID控制器的Cache处理，直接写入物理盘） |
| BootPriority | 启动优先级 | 可设置为： ● Primary：第一启动设备 ● Secondary：第二启动设备 ● All：第一和第二启动设备 ● None：取消启动设备 |
| BootEnable | 是否为启动盘 | 可设置为： ● true ● false |
| BGIEnable | 是否使能后台初始化 | 可设置为： ● true ● false |
| AccessPolicy | 访问策略 | 支持的策略包括： ● ReadWrite：可读可写 ● ReadOnly：只读访问 ● Blocked：禁止访问 说明：如果RAID控制器类型为 3508/3516/9440-8i/9460-8i/9460-16i，并且固件版本是MR7.9及之后的版本，需要重启OS设置才能生效。 |
| SSDCachingEnable | 是否使用CacheCade逻辑盘做缓存 | 可设置为： ● true ● false |
| DriveCachePolicy | 成员盘的Cache策略 | 支持的策略包括： ● Unchanged：保持默认的缓存策略 ● Enabled：读写过程中数据经过物理盘写 Cache，使写性能提升，但当系统意外掉电时，如果没有保护机制，数据会丢失 ● Disabled：读写过程中数据不经过物理盘写 Cache，当系统意外掉电时，数据不会丢失 |
| AccelerationMethod | 加速方法 | ControllerCache：同时使用读缓存和写缓存 IOBypass：只有当逻辑盘由SSD组成时，该选项有效 None：禁用加速 |
使用指南
无
使用实例
请求样例：
http
PATCH <https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Volumes/volume_id>X-Auth-Token: 123456789*********************** Content-Type: header_type If-Match: ifmatch_value
请求消息体：
json
{
"CapacityBytes": capacity,
"OptimumIOSizeBytes": optsize,
"Oem": {
"Public": {
"VolumeName": name,
"DefaultReadPolicy": df_read_policy,
"DefaultWritePolicy": df_write_policy,
"DefaultCachePolicy": df_cache_policy,
"BootPriority": bootpriority,
"BootEnable": bootstate,
"BGIEnable": bgistate,
"AccessPolicy": access_policy,
"SSDCachingEnable": ssdcachestate,
"DriveCachePolicy": disk_cache_policy,
"AccelerationMethod": acceleration_method
}
}
}响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#Systems/Members/1/Storages/Members/RAIDStorage0/Volumes/Members/$entity",
"@odata.id": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive0",
"@odata.type": "#Volume.v1_0_1.Volume",
"Id": "LogicalDrive0",
"Name": "LogicalDrive0",
"CapacityBytes": 298999349248,
"VolumeType": "Mirrored",
"OptimumIOSizeBytes": 262144,
"Status": {
"State": "Enabled",
"Oem": {
"Public": {
"Severity": "Informational"
}
},
"Health": null
},
"Operations": [
{
"OperationName": "Foreground Init",
"PercentageComplete": 4,
"AssociatedTask": {
"@odata.id": "/redfish/v1/TaskService/Tasks/1"
}
}
],
"Oem": {
"Public": {
"State": "Optimal",
"VolumeName": "N/A",
"RaidControllerID": 0,
"VolumeRaidLevel": "RAID1",
"DefaultReadPolicy": "ReadAhead",
"DefaultWritePolicy": "WriteBackWithBBU",
"DefaultCachePolicy": "DirectIO",
"ConsistencyCheck": false,
"SpanNumber": 1,
"NumDrivePerSpan": 2,
"Spans": [
{
"SpanName": "Span0",
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk3"
}
]
}
],
"CurrentReadPolicy": "ReadAhead",
"CurrentWritePolicy": "WriteBackWithBBU",
"CurrentCachePolicy": "DirectIO",
"AccessPolicy": "ReadWrite",
"BootPriority": "None",
"BootEnable": true,
"BGIEnable": false,
"SSDCachecadeVolume": false,
"SSDCachingEnable": null,
"AssociatedCacheCadeVolume": [],
"DriveCachePolicy": "Unchanged",
"OSDriveName": "/dev/sdb",
"InitializationMode": null,
"AccelerationMethod": null,
"CacheLineSizeKB": null,
"RebuildState": "DoneOrNotRebuilt"
}
},
"Links": {
"Drives@odata.count": 2,
"Drives": [
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk0"
},
{
"@odata.id": "/redfish/v1/Chassis/1/Drives/HDDPlaneDisk3"
}
]
},
"Actions": {
"#Volume.Initialize": {
"target": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive0/Actions/Volume.Initialize",
"@Redfish.ActionInfo": "/redfish/v1/Systems/1/Storages/RAIDStorage0/Volumes/LogicalDrive0/InitializeActionInfo"
}
}
}响应码：200
POST (ACTION)
Initialize
命令功能
初始化指定逻辑盘
命令格式
请求头:
text
X-Auth-Token: 123456789***********************
Content-Type: header_type请求消息体:
json
{
"Type": init_type
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| system_id | 系统资源的ID | ● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如“Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或 SwiN（N表示交换模块槽位号），例如“Swi1” ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为 Rack |
| storage_id | 存储资源的ID | 通过存储集合资源获得。 |
| volume_id | 逻辑盘的ID | 通过逻辑盘集合获得。 |
| init_type | 初始化的方式 | 支持的初始化方式包括： ● QuickInit：快速初始化，不会创建任务 ● FullInit：完全初始化，会创建任务 ● CancelInit：取消初始化，不会创建任务 |
使用指南
无
使用实例
请求样例：
http
POST <https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Volumes/volume_id/Actions/Volume.Initialize>X-Auth-Token: 123456789*********************** Content-Type: header_type
请求消息体：
json
{
"Type": init_type
}响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#Task.Task",
"@odata.type": "#Task.v1_0_2.Task",
"@odata.id": "/redfish/v1/TaskService/Tasks/1",
"Id": "1",
"Name": "RaidController0_LogicalDrive1_init",
"Description": "",
"TaskState": "Running",
"TaskStatus": "OK",
"StartTime": "2016-07-08T14:52+00:00",
"Messages": [],
"PercentComplete": null,
"Oem": {
"Public": {
"TaskPercentage": null
}
}
}响应码：202
DELETE
命令功能
删除指定逻辑盘
命令格式
URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Volumes/volume_id
请求头:
text
X-Auth-Token: 123456789***********************请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| id | 资源id | 用户可通过查询资源列表获得 |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
无
使用实例
请求样例：
http
DELETE <https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Volumes/volume_id>X-Auth-Token: 123456789***********************
请求消息体：无
响应样例：
json
{
"@odata.context": "/redfish/v1/$metadata#TaskService/Tasks/Members/$entity",
"@odata.type": "#Task.v1_0_2.Task",
"@odata.id": "/redfish/v1/TaskService/Tasks/1",
"Id": "1",
"Name": "volume deletion task",
"Description": "",
"TaskState": "Running",
"TaskStatus": "OK",
"StartTime": "2016-07-08T14:52+00:00",
"Messages": [],
"PercentComplete": null,
"Oem": {
"Public": {
"TaskPercentage": null
}
}
}响应码：202
输出说明