ResourceDefinition

uris

/redfish/v1/TaskService/Tasks/{taskid}/SubTasks/{subtaskid}

properties

名称	类型	是否只读	取值范围/枚举值	说明
@odata.context	string	true	-	子任务资源模型的OData描述信息
@odata.id	string	true	-	子任务资源的访问路径
@odata.type	string	true	-	子任务资源的类型
Id	string	true	-	子任务资源的ID
Name	string	true	-	子任务资源的名称
Description	string	true	-	子任务描述
TaskState	string	true	New,Starting,Running,Suspended,Interrupted,Pending,Stopping,Completed,Killed,Exception,Service	子任务的状态。 ● New ● Starting ● Running ● Suspended ● Interrupted ● Pending ● Stopping ● Completed ● Killed ● Exception ● Service
TaskStatus	string	true	OK,Warning,Major,Critical	子任务的完成状态。 ● OK ● Warning ● Major ● Critical
StartTime	string	true	-	子任务的起始时间
EndTime	string	true	-	子任务完成的日期和时间。此属性仅在任务完成后才会显示。
EstimatedDuration	string	true	^P(\d+D)?(T(\d+H)?(\d+M)?(\d+S)?)?$	预估子任务完成总时间。当前仅并行升级任务中，升级BMC的子任务支持该属性
Messages	object	true	-	子任务的相关消息
Messages.@odata.type	string	true	-	消息资源的OData描述信息
Messages.MessageId	string	true	-	信息编号
Messages.RelatedProperties	array	true	-	任务属性描述
Messages.Message	string	true	-	任务信息
Messages.MessageArgs	array	true	-	任务的详细信息
Messages.Severity	string	true	OK,Warning,Critical	错误严重级别，包括： ● OK ● Warning ● Critical
Messages.Resolution	string	true	-	解决任务状态的处理建议
Messages.MessageSeverity	string	true	OK,Warning,Critical	错误严重级别，包括： ● OK ● Warning ● Critical
PercentComplete	number	true	-	子任务完成的百分比进度
Oem	object	true	-	自定义属性
Oem.Public	object	true	-	自定义属性
Oem.Public.TaskPercentage	string	true	-	任务完成进度

supported_methods

HTTP methods

GET

命令功能

查询指定子任务资源信息

说明

BMC500 5.13.0.1及以上版本支持

命令格式

URL: https://device_ip/redfish/v1/TaskService/Tasks/{taskid}/SubTasks/{subtaskid}

请求头:


X-Auth-Token: 123456789***********************

请求消息体: 无

参数说明

参数	参数说明	取值
device_ip	登录设备的IP地址	IPv4或IPv6地址
auth_value	执行该GET请求时，必须在"Headers"中携带"X-Auth-Token"值用于鉴权	可通过/redfish/v1/SessionService/Sessions创建会话时获得
taskid	待查询子任务对应的任务ID	可从任务集合资源中获得
subtaskid	待查询子任务的ID	可从子任务集合资源中获得

使用指南

无

使用实例

请求样例：

http

GET https://device_ip/redfish/v1/TaskService/Tasks/1/SubTasks/1

请求头：


X-Auth-Token: 123456789***********************

请求消息体：无

任务未完成时的响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#Task.Task",
  "@odata.type": "#Task.v1_7_4.Task",
  "@odata.id": "/redfish/v1/TaskService/Tasks/1/SubTasks/1",
  "Id": "1",
  "Name": "Upgarde Task",
  "Description"："",
  "TaskStatus": "OK",
  "TaskState": "Running",
  "StartTime": "2000-03-02T11:09:02+00:00",
  "EstimatedDuration"："PT4M"
  "Messages": [],

  "PercentComplete": 8,
  "Oem": {
    "Public": {
      "TaskPercentage": "8%"
    }
  }
}

响应码：200

任务完成时的响应样例：

json

{
  "@odata.context": "/redfish/v1/$metadata#Task.Task",
  "@odata.type": "#Task.v1_7_4.Task",
  "@odata.id": " /redfish/v1/TaskService/Tasks/1/SubTasks/1",
  "Id": "1",
  "Name": "Upgarde Task",
  "Description": "",
  "TaskState": "Completed",
  "TaskStatus": "OK",
  "StartTime": "2000-03-02T11:09:02+00:00",
  "EndTime": "2000-03-02T11:13:02+00:00",
  "EstimatedDuration": "PT4M",
  "Messages": {
    "@odata.type": "#Message.v1_0_0.Message",
    "MessageId": "iBMC.1.0.DumpingOK",
    "RelatedProperties": [],
    "Message": "Successfully collected the dump information file.",
    "MessageArgs": [],
    "Severity": "OK",
    "Resolution": "None",
    "MessageSeverity": "OK"
  },
  "PercentComplete": 100,
  "Oem": {
    "Public": {
      "TaskPercentage": "100%"
    }
  }
}

响应码：200

ResourceDefinition ​

uris ​

properties ​

supported_methods ​

HTTP methods ​

GET ​

ResourceDefinition

uris

properties

supported_methods

HTTP methods

GET