跳到主要内容

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_2_1.Session",
"Id": "6",
"SessionType": "Redfish",
"@odata.etag": "\"1470b92b471825a097d \"",
"Name": "6",
"UserName": "USERID"
}