ResourceDefinition

uris

/redfish/v1/Managers/manager_id/SPService/SPDriveErase

properties

名称	类型	是否只读	说明
@odata.context	string	true	硬盘擦除配置集合资源模型的OData描述信息
@odata.id	string	true	硬盘擦除配置集合资源的访问路径
@odata.type	string	true	硬盘擦除配置集合资源的类型
Name	string	true	硬盘擦除配置集合资源的名称
Members@odata.count	number	true	硬盘擦除配置资源数量
device_ip	登录设备的IP地址	true	IPv4或IPv6地址
manager_id	管理资源ID	true	● 针对机架服务器，取值为1 ● 针对高密服务器，取值为BladeN（N表示节点槽位号），例如 “Blade1” ● 针对刀片服务器，取值可以为BladeN（N表示计算节点槽位号）或SwiN（N表示交换模块槽位号），例如 “Swi1” ● 针对X6800 V5，X6000 V5，G5500，XA320 V2服务器，取值还可以为Enc，表示计算节点所在的机框资源 ● 针对设备U位信息，取值可以为UN(N表示设备U位号)，例如"U1" ● 针对机柜资源，取值为Rack
auth_value	请求消息的鉴权参数	true	可通过/redfish/v1/ SessionService/Sessions创建会话时获得
header_type	请求消息的格式	true	支持的消息格式包括： ● application/json ● application/ json;charset=utf-8
mode_value	字符串(必填选项)	true	擦除模式，取值包括： ● Quick：快速模式 ● Secure：安全模式说明快速模式针对逻辑盘进行分区擦除，安全模式对物理盘进行全盘擦除
stategy_value	string	true	擦除策略，擦除的模式为安全模式时生效，包括： ● Simple：全盘擦除1次 ● Normal：全盘擦除3次 ● Thorough：全盘擦除9次
DriveErase	object	false	硬盘擦除配置参数
EraseMode	string	false	擦除模式，取值包括： ● Quick：快速模式 ● Secure：安全模式说明快速模式针对逻辑盘进行分区擦除，安全模式对物理盘进行全盘擦除
EraseStrategy	string	false	擦除策略，擦除的模式为安全模式时生效，包括： ● Simple：全盘擦除1次 ● Normal：全盘擦除3次 ● Thorough：全盘擦除9次

supported_methods

GET
POST(CREATE)

HTTP methods

GET

命令功能

查询 SP 服务的硬盘擦除配置集合资源

命令格式

URL: https://device_ip/redfish/v1/Managers/manager_id/SPService/SPDriveErase

请求头:

X-Auth-Token: auth_value

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
auth_value	请求消息的鉴权参数	可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

GA140C机型不支持 SP版本和机型兼容性列表详见Smart Provisioning用户指南

使用实例

请求样例： GET https://device_ip/redfish/v1/Managers/manager_id/SPService/SPDriveErase

X-Auth-Token: auth_value 请求消息体：无

响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#Managers/Members/1/SPService/SPDriveErase/$entity",
  "@odata.id": "/redfish/v1/Managers/1/SPService/SPDriveErase",
  "@odata.type": "#HwSPDriveEraseCollection.HwSPDriveEraseCollection",
  "Name": "SP Drive Erase Collection",
  "Members@odata.count": 1,
  "Members": [
    {
      "@odata.id": "/redfish/v1/Managers/1/SPService/SPDriveErase/1"
    }
  ]
}

响应码：200

POST (CREATE)

命令功能

创建 SP 服务的硬盘擦除配置

命令格式

URL: https://device_ip/redfish/v1/Managers/manager_id/SPService/SPDriveErase

请求头:

X-Auth-Token: auth_value
Content-Type: header_type

请求消息体:

json

{
  "DriveErase": {
    "EraseMode": mode_value,
    "EraseStrategy": stategy_value
  }
}

请求头参数说明

参见请求头参数说明

请求体参数说明

参数	参数说明	取值
mode_value	字符串(必填选项)	擦除模式，取值包括： ● Quick：快速模式 ● Secure：安全模式说明快速模式针对逻辑盘进行分区擦除，安全模式对物理盘进行全盘擦除
stategy_value	字符串	擦除策略，擦除的模式为安全模式时生效，包括： ● Simple：全盘擦除1次 ● Normal：全盘擦除3次 ● Thorough：全盘擦除9次

使用指南

GA140C机型不支持 SP版本和机型兼容性列表详见Smart Provisioning用户指南创建SP服务的硬盘擦除配置的流程如下：

请参阅本章节使用实例，完成任务下发。
请参阅3.2.71 修改SP服务资源属性，设置从Smart Provisioning启动使能。
在不影响服务器业务的情况下，请参阅3.3.4 重启服务器，重启完成后服务器自动进入Smart Provisioning来执行硬盘擦除任务。
请参阅3.2.84 查询SP服务的配置结果资源查询任务结果。
（可选）SP版本1.13.0及以上版本，在执行硬盘擦除任务过程中，如需终止任务，请参阅3.2.71 修改SP服务资源属性，设置SPFinished为true进行任务终止。请参阅3.2.84 查询SP服务的配置结果资源，仅允许在Status为Deploying状态下进行任务终止。 SP版本1.16.0及以上版本支持下发多任务执行。支持在上述步骤1中同时下发其他支持多任务执行的接口任务，其他步骤与上述一致。支持多任务执行的任务接口和任务结果请参阅3.2.84 查询SP服务的配置结果资源的使用指南中的相关描述。

使用实例

请求样例： POST https://device_ip/redfish/v1/Managers/manager_id/SPService/SPDriveErase

X-Auth-Token: auth_value Content-Type: header_type 请求消息体：

json

{
  "DriveErase": {
    "EraseMode": mode_value,
    "EraseStrategy": stategy_value
  }
}

响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#Managers/Members/1/SPService/SPDriveErase/Members/$entity",
  "@odata.id": "/redfish/v1/Managers/1/SPService/SPDriveErase/1",
  "@odata.type": "#HwSPDriveErase.v1_0_0.HwSPDriveErase",
  "DriveErase": {
    "EraseMode": "Secure",
    "EraseStrategy": "Normal"
  }
}

响应码：201

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

POST (CREATE) ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET

POST (CREATE)