修改指定用户信息
命令功能
当前仅支持修改指定用户的密码信息。
命令格式
操作类型: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参数
参数名 |
是否必选 |
参数说明 |
取值 |
---|---|---|---|
<member_id> |
必选 |
待查询的用户ID。 |
用户ID,数字,长度为1~16字符。 |
请求参数
参数名 |
是否必选 |
参数说明 |
取值 |
---|---|---|---|
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
输出说明
字段 |
类型 |
说明 |
---|---|---|
@odata.context |
字符串 |
指定用户资源模型的OData描述信息。 |
@odata.id |
字符串 |
指定用户资源的访问路径。 |
@odata.type |
字符串 |
指定用户资源类型。 |
Id |
字符串 |
指定用户资源的ID。 |
Name |
字符串 |
指定用户资源的名称。 |
Oem |
对象 |
自定义属性。 |
LastLoginSuccessTime |
字符串 |
上次成功登录的时间。 为空时表示首次登录。 |
LastLoginFailureTime |
字符串 |
上次登录失败的时间。 为空时表示没有失败过。 |
AccountInsecurePrompt |
布尔值 |
帐号不安全提示。
|
ConfigNavigatorPrompt |
布尔值 |
是否需要提示进入快速配置向导,默认为“true”。浏览器完成配置向导时,将该字段修改为“false”。 |
PasswordValidDays |
字符串 |
取值为数字,表示密码有效期剩余天数。 “--”表示有效期无限。 |
PwordWrongTimes |
数字 |
登录成功前的失败次数。 取值为0、1、2、3、4、5。 |
LastLoginIP |
字符串 |
上次登录的IP地址。 |