创建新会话。
操作类型:POST
URL:https://device_ip/redfish/v1/SessionService/Sessions
请求头:
Content-Type: header_type
请求消息体:
{
"UserName":name,
"Password":password
}
参数名 |
是否必选 |
参数说明 |
取值 |
---|---|---|---|
UserName |
必选 |
新建会话对应的用户。 |
字符串,长度为1~16个字符,支持数字和英文字母,不能全为数字。 |
Password |
必选 |
新建会话对应的用户的密码。 |
边缘管理系统的用户对应的密码。字符串,长度为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
字段 |
类型 |
说明 |
---|---|---|
@odata.context |
字符串 |
新创建会话资源模型的OData描述信息。 |
@odata.id |
字符串 |
新创建会话资源节点的访问路径。 |
@odata.type |
字符串 |
新创建会话资源类型。 |
Id |
字符串 |
新创建会话资源的唯一标识。 |
Name |
字符串 |
新创建会话的名称。 |
UserName |
字符串 |
该会话对应的用户。 |
Oem |
对象 |
自定义属性。 |
UserId |
数字 |
当前会话用户ID。 |
AccountInsecurePrompt |
布尔值 |
帐号不安全提示。
|
message |
字符串 |
该会话用户及ID消息内容。 |