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.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	null	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	null	true	-	初始化模式 ● UnInit：未初始化/取消初始化 ● QuickInit：快速初始化(不创建任务) ● FullInit：完全初始化(会创建任务)
Oem.Public.AccelerationMethod	string	false	-	加速方法 ● ControllerCache：控制器缓存加速(同时使用读缓存和写缓存) ● IOBypass：IOBypass加速(仅SSD组成的逻辑盘有效) ● maxCache：maxCache加速(使用最大缓存) ● None
Oem.Public.CacheLineSizeKB	null	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	-	逻辑盘可执行的初始化操作信息查询路径
}
}

supported_methods

GET
PATCH
POST
DELETE

HTTP methods

GET

命令功能

查询指定逻辑盘资源信息

命令格式

URL: https://device_ip/redfish/v1/Systems/system_id/Storages/storage_id/Volumes/volume_id

请求头:


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

请求头:


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：在读、写场景中的定义不同： – 在读场景中，直接从物理盘读取数据。（“DefaultReadPo licy”设置为 “ReadAhead”时除外，此时读数据经过RAID控制器的 Cache处理） – 在写场景中，写数据经过RAID控制器的 Cache处理（“DefaultWritePo licy”设置为 “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

命令功能

初始化指定逻辑盘

命令格式

URL: 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
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
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

请求头:


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

输出说明

参见 DELETE 通用输出说明

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

PATCH ​

POST (ACTION) ​

Initialize ​

DELETE ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

PATCH

POST (ACTION)

Initialize

DELETE