Sessions
更新时间: 2026/06/26
在Gitcode上查看源码

ResourceDefinition

uris

  • /redfish/v1/SessionService/Sessions/{session_id}

properties

名称类型是否只读取值范围/枚举值说明
@odata.contextstringtrue指定会话资源模型的访问路径
@odata.idstringtrue指定会话资源节点的访问路径
@odata.typestringtrue指定会话资源类型
Idstringtrue指定会话资源的唯一标识
Namestringtrue指定会话的名称
ClientOriginIPAddressstringtrue新创建会话对应的用户的地址。BMC300 5.9.0.1及以上版本支持
CreatedTimestringtrue新创建会话的创建时间。BMC300 5.9.0.1及以上版本支持
Rolesarraytrue用户角色。BMC300 5.9.0.1及以上版本支持
OemSessionTypestringtrueOEM定义的会话类型。BMC300 5.9.0.1及以上版本支持
SessionTypestringtrue● WebUI
● ManagerConsole
● Redfish
● KVMIP
● OEM
新创建会话对应的登录接口。BMC300 5.9.0.1及以上版本支持
Oem.Publicobjecttrue自定义属性
Oem.Public.UserAccountstringtrue该会话对应的用户
Oem.Public.LoginTimestringtrue该会话的创建时间。BMC300 5.7.0.1及以上版本支持
Oem.Public.UserIPstringtrue该会话对应的用户的地址。BMC300 5.7.0.1及以上版本支持
Oem.Public.UserTagstringtrue● GUI
● CLI
● Redfish
● VNC
● KVM
该会话对应的登录接口。BMC300 5.7.0.1及以上版本支持
Oem.Public.MySessionbooleantrue表示查询的会话是否为当前用户所创建。true:是;false:否
Oem.Public.UserIdnumbertrue用户ID
Oem.Public.UserValidDaysnumbertrue用户账号有效期
Oem.Public.AccountInsecurePromptEnabledbooleantrue用户账号不安全提示使能
Oem.Public.UserRolearraytrue用户角色。BMC300 5.7.0.1及以上版本支持

supported_methods

  • GET
  • DELETE

HTTP methods

GET

命令功能

查询指定会话资源信息

命令格式

URL: https://device_ip/redfish/v1/SessionService/Sessions/session_id

请求头:

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

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
session_id指定会话的ID可通过会话集合资源获得
auth_value执行该GET请求时,必须在"Headers"中携带"X-Auth-Token"值用于鉴权可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

使用实例

请求样例:

http
GET https://device_ip/redfish/v1/SessionService/Sessions/89abd1ef7686e27c

响应样例:

json
{
  "@odata.context": "/redfish/v1/$metadata#Session.Session",
  "@odata.id": "/redfish/v1/SessionService/Sessions/89abd1ef7686e27c",
  "@odata.type": "#Session.v1_0_2.Session",
  "Id": "89abd1ef7686e27c",
  "Name": "User Session",
  "ClientOriginIPAddress": "10.10.10.3",
  "CreatedTime": "2016-09-09T19:48:28+00:00",
  "Roles": ["Administrator"],
  "SessionType": "Redfish",
  "OemSessionType": "Redfish",
  "Oem": {
    "Public": {
      "UserAccount": "root",
      "LoginTime": "2016-09-09T19:48:28+00:00",
      "UserIP": "10.10.10.3",
      "UserTag": "Redfish",
      "MySession": false,
      "UserId": 4,
      "UserValidDays": null,
      "AccountInsecurePromptEnabled": false,
      "UserRole": ["Administrator"]
    }
  }
}

响应码:200

DELETE

命令功能

删除指定会话

命令格式

URL: https://device_ip/redfish/v1/SessionService/Sessions/session_id

请求头:

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

请求消息体: 无

参数说明

参数参数说明取值
device_ip登录设备的IP地址IPv4或IPv6地址
session_id待删除的会话ID在查询会话列表的返回信息中包含各会话的session_id,可用于删除指定会话信息
auth_value请求消息的鉴权参数可通过/redfish/v1/SessionService/Sessions创建会话时获得

使用指南

使用实例

请求样例:

http
DELETE https://device_ip/redfish/v1/SessionService/Sessions/d0f0593601de6483

请求头:

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

请求消息体:无

响应样例:

json
{
  "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

输出说明

参见 DELETE 通用输出说明