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 |
|---|---|
| 201 | Created |
| 401 | NoValidSession |
| 403 | SessionLimitExceeded |
| 500 | InternalError |
示例
以下示例是 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"
}
提供反馈