ResourceDefinition
uris
/redfish/v1/Managers/manager_id/LogServices/logservices_id
properties
| 名称 | 类型 | 是否只读 | 取值范围/枚举值 | 说明 |
|---|---|---|---|---|
| @odata.context | string | true | 指定日志服务资源模型的OData描述信息 | |
| @odata.id | string | true | 指定日志服务资源的访问路径 | |
| @odata.type | string | true | 指定日志服务资源的类型 | |
| Id | string | true | 指定日志服务资源的ID | |
| Name | string | true | 指定日志服务资源的名称 | |
| MaxNumberOfRecords | number | true | 指定日志服务资源的最大可记录日志条数 | |
| OverWritePolicy | string | true | 指定日志服务资源的覆盖策略 ● Unknown ● WrapsWhenFull ● NeverOverWrites | |
| DateTime | string | true | 指定日志服务资源的系统时间 | |
| DateTimeLocalOffset | string | true | 指定日志服务资源的时区 | |
| ServiceEnabled | boolean | true | 指定日志服务资源的启用状态 ● true ● false | |
| #LogService.ExportLog | object | true | 导出日志操作 | |
| target | string | true | 导出日志操作的访问路径 | |
| @Redfish.ActionInfo | string | true | 导出日志操作的查询路径 | |
| Entries | object | true | 日志集合资源的访问路径 | |
| Description | string | true | 任务描述 | |
| TaskState | string | true | 任务执行状态 ● New ● Starting ● Running ● Suspended ● Interrupted ● Pending ● Stopping ● Completed ● Killed ● Exception ● Service | |
| TaskStatus | string | true | 指定任务的完成状态。 ● OK ● Warning ● Major ● Critical | |
| StartTime | string | true | 任务的起始时间 | |
| Messages | array | true | 任务相关的消息 | |
| PercentComplete | string | true | 任务完成的百分比进度。 | |
| TaskPercentage | string | true | 任务执行的进度 |
supported_methods
- GET
- POST
HTTP methods
GET
命令功能
查询指定日志服务资源信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/LogServices/logservices_id
请求头:
X-Auth-Token: auth_value请求消息体: 无
参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| device_ip | 登录设备的IP地址 | IPv4或IPv6地址 |
| auth_value | 请求消息的鉴权参数 | 可通过/redfish/v1/SessionService/Sessions创建会话时获得 |
使用指南
该资源已屏蔽属性频繁变化导致的事件上报。
使用实例
请求样例： GET https://device_ip/redfish/v1/Managers/manager_id/LogServices/logservices_id
X-Auth-Token: auth_value 请求消息体：无
响应样例：
{
"@odata.context": "/redfish/v1/$metadata#Managers/Members/1/LogServices/Members/$entity",
"@odata.id": "/redfish/v1/Managers/1/LogServices/OperateLog",
"@odata.type": "#LogService.v1_0_3.LogService",
"Id": "OperateLog",
"Name": "Operate Log",
"MaxNumberOfRecords": 456,
"OverWritePolicy": "WrapsWhenFull",
"DateTime": "2018-08-30T17:42:17+00:00",
"DateTimeLocalOffset": "GMT",
"ServiceEnabled": true,
"Actions": {
"Oem": {
"Public": {
"#LogService.ExportLog": {
"target": "/redfish/v1/Managers/1/LogServices/OperateLog/Actions/Oem/Public/LogService.ExportLog",
"@Redfish.ActionInfo": "/redfish/v1/Managers/1/LogServices/OperateLog/ExportLogActionInfo"
}
}
}
},
"Entries": {
"@odata.id": "/redfish/v1/Managers/1/LogServices/OperateLog/Entries"
}
}响应码：200
POST (ACTION)
ExportLog
命令功能
导出日志信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/LogServices/logservices_id/Actions/Oem/Public/LogService.ExportLog
请求头:
X-Auth-Token: auth_value
Content-Type: header_type请求消息体:
{
"Type": type_value,
"Content": Content
}请求头参数说明
参见 请求头参数说明
请求体参数说明
| 参数 | 参数说明 | 取值 |
|---|---|---|
| type_value | 导出类型 | ● URI |
| Content | 导出文件路径 | ● 操作路径 ● 1、本地导出：“/tmp/ 文件路径” ● 2、远程导出：“文件传输协议://用户名:密码@ip地址/目录/文件名” 文件传输协议包括五种：sftp、https、nfs、cifs、scp |
使用指南
无
使用实例
请求样例： POST https://device_ip/redfish/v1/Managers/manager_id/LogServices/logservices_id/Actions/Oem/Public/LogService.ExportLog
X-Auth-Token: auth_value Content-Type: header_type 请求消息体：
{
"Type": type_value,
"Content": Content
}响应样例：
{
"@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": "1",
"Description": "",
"TaskState": "Running",
"TaskStatus": "OK",
"StartTime": "2017-05-09T16:57:14+00:00",
"Messages": [],
"PercentComplete": null,
"Oem": {
"Public": {
"TaskPercentage": null
}
}
}响应码：202
POST (ACTION)
ClearLog
命令功能
清空日志信息
命令格式
URL: https://device_ip/redfish/v1/Managers/manager_id/LogServices/EventLog/Actions/LogService.ClearLog
请求头:
X-Auth-Token: auth_value
Content-Type: header_type请求消息体:
{}请求头参数说明
参见 请求头参数说明
请求体参数说明
无
使用指南
无
使用实例
请求样例： POST https://device_ip/redfish/v1/Managers/manager_id/LogServices/EventLog/Actions/LogService.ClearLog
X-Auth-Token: auth_value Content-Type: header_type 请求消息体：
{}响应样例：
{
"error": {
"code": "Base.1.0.GeneralError",
"message": "A general error has occurred. See ExtendedInfo for more information.",
"@Message.ExtendedInfo": [
{
"@odata.type": "#Message.v1_0_0.Message",
"MessageId": "Base.1.0.Success",
"RelatedProperties": [],
"Message": "Successfully Completed Request",
"MessageArgs": [],
"Severity": "OK",
"Resolution": "None"
}
]
}
}响应码：200