创建会话

命令功能

创建新会话。

命令格式

操作类型：POST

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

请求头：

Content-Type: header_type

请求消息体：

    "UserName":name,

    "Password":password

请求参数

表1 请求参数
参数名	是否必选	参数说明	取值
UserName	必选	新建会话对应的用户。	字符串，长度为1~16个字符，支持数字和英文字母，不能全为数字。
Password	必选	新建会话对应的用户的密码。	Atlas IES系统的用户对应的密码。字符串，长度为8~20个字符。

使用指南

在Redfish操作过程中，该POST操作是首先要执行的。因为后续大部分操作，都需要在“Headers”中携带“X-Auth-Token”值用于鉴权，而“X-Auth-Token”可通过本操作获得。

使用实例

请求样例：

POST https://10.10.10.10/redfish/v1/SessionService/Sessions

请求头：

Content-Type: application/json

请求消息体：

{
    "UserName": "username",
    "Password": "password"
}

响应样例：

{
    "@odata.context": "/redfish/v1/$metadata#Session.Session",
    "@odata.id": "/redfish/v1/SessionService/Sessions/49fec170a501116ec8e10c8dd279fe51218a3a805ee37173",
    "@odata.type": "#Session.v1_4_0.Session",
    "Id": "49fec170a501116ec8e10c8dd279fe51218a3a805ee37173",
    "Name": "User Session",
    "UserName": "admin",
    "Oem": {
        "UserId": 1,
        "AccountInsecurePrompt": false,
        "message": "[1:admin]"
    }
}

响应码：201

输出说明

表2 操作输出说明
字段	类型	说明
@odata.context	字符串	新创建会话资源模型的OData描述信息。
@odata.id	字符串	新创建会话资源节点的访问路径。
@odata.type	字符串	新创建会话资源类型。
Id	字符串	新创建会话资源的唯一标识。
Name	字符串	新创建会话的名称。
UserName	字符串	该会话对应的用户。
Oem	对象	自定义属性。
UserId	数字	当前会话用户ID。
AccountInsecurePrompt	布尔值	帐号不安全提示。 true：密码为默认密码。 false：密码不是默认密码。
message	字符串	该会话用户及ID消息内容。

父主题： 用户管理