跳到主要内容

POST – 创建会话

创建会话资源以进行进一步的访问认证。

请求 URL​

POST https://<BMC_IPADDR>/redfish/v1/SessionService/Sessions

请求正文​

字段类型描述

UserName

字符串创建此会话的用户名。

Password

字符串此属性在 POST 中用于在创建新会话时指定密码。此属性在 GET 中为 null。

响应正文​

字段类型描述

UserName

字符串创建此会话的用户名。

Password

字符串此属性在 POST 中用于在创建新会话时指定密码。此属性在 POST 响应中为 null。

SessionType

字符串“Redfish”

Name

字符串会话 ID 值

Id

字符串会话 ID 值

响应标头​

字段描述

Location

创建的会话资源的链接。

X-Auth-Token

创建新会话时生成认证代码。

状态代码​

HTTP 状态代码错误消息 ID
201Created
401NoValidSession
403SessionLimitExceeded
500InternalError

示例​

以下示例是 POST 正文。

{
   "UserName" : "USERID",
   "Password" : "PASSW0RD"
}

返回以下示例 JSON 响应：

{
    "@odata.id": "/redfish/v1/SessionService/Sessions/6",
    "Password": null,
    "@odata.type": "#Session.v1_3_0.Session",
    "Id": "6",
    "SessionType": "Redfish",
    "@odata.etag": "\"1470b92b471825a097d \"",
    "Name": "6",
    "UserName": "USERID"
}