修改指定用户信息

命令功能

当前仅支持修改指定用户的密码信息。

命令格式

操作类型：PATCH

URL：https://device_ip/redfish/v1/AccountService/Accounts/<member_id>

请求头：

X-Auth-Token: auth_value
Content-Type: application/json

请求消息体：

{
    "UserName": "admin",
    "old_password": "old_password",
    "Password":"new_password",
    "new_password_second": "new_password_second"
}

URL参数

表1 URL参数
参数名	是否必选	参数说明	取值
<member_id>	必选	待查询的用户ID。	用户ID，数字，长度为1~16字符。

请求参数

表2 请求参数
参数名	是否必选	参数说明	取值
UserName	必选	需要修改密码的用户名。	字符串，长度为1~16个字符，支持数字和英文字母，不能全为数字。
old_password	必选	用户需要修改的密码。	长度为8~20的字符串。默认开启密码复杂度检查功能，设置和修改的密码必须遵循密码复杂度的规则。
Password	必选	修改后的用户密码。	长度为8~20的字符串。默认开启密码复杂度检查功能，设置和修改的密码必须遵循密码复杂度的规则。
new_password_second	必选	再次输入修改后的密码。	长度为8~20的字符串。默认开启密码复杂度检查功能，设置和修改的密码必须遵循密码复杂度的规则。

使用指南

针对指定用户，仅支持修改请求消息体中的密码属性。

使用实例

请求样例：

PATCH https://10.10.10.10/redfish/v1/AccountService/Accounts/1

请求头：

X-Auth-Token: auth_value
Content-Type: application/json

请求消息体：

{
    "UserName": "test",
    "old_password": "old_password",
    "Password":"password",
    "new_password_second":"password"
}

响应样例：

{
    "@odata.context": "/redfish/v1/$metadata#AccountService/Accounts/Members/$entity",
    "@odata.id": "/redfish/v1/AccountService/Accounts/1",
    "@odata.type": "#ManagerAccount.v1_3_4.ManagerAccount",
    "Id": "1",
    "Name": "User Account",
    "Oem": {
        "LastLoginSuccessTime": "2022-11-16 20:54:03",
        "LastLoginFailureTime": "2022-11-16 06:15:29",
        "AccountInsecurePrompt": false,
        "ConfigNavigatorPrompt": true,
        "PasswordValidDays": "--",
        "PwordWrongTimes": 0,
        "LastLoginIP": "127.0.xx.xx"
    }
}

响应码：200

输出说明

表3 操作输出说明
字段	类型	说明
@odata.context	字符串	指定用户资源模型的OData描述信息。
@odata.id	字符串	指定用户资源的访问路径。
@odata.type	字符串	指定用户资源类型。
Id	字符串	指定用户资源的ID。
Name	字符串	指定用户资源的名称。
Oem	对象	自定义属性。
LastLoginSuccessTime	字符串	上次成功登录的时间。为空时表示首次登录。
LastLoginFailureTime	字符串	上次登录失败的时间。为空时表示没有失败过。
AccountInsecurePrompt	布尔值	帐号不安全提示。 true密码为默认密码。 false：密码不是默认密码。
ConfigNavigatorPrompt	布尔值	是否需要提示进入快速配置向导，默认为“true”。浏览器完成配置向导时，将该字段修改为“false”。
PasswordValidDays	字符串	取值为数字，表示密码有效期剩余天数。 “--”表示有效期无限。
PwordWrongTimes	数字	登录成功前的失败次数。取值为0、1、2、3、4、5。
LastLoginIP	字符串	上次登录的IP地址。

父主题： 用户管理