跳到主要内容

PATCH – 更新 userid/password/role/ PasswordChangeRequired

使用 PATCH 方法更新 Redfish 服务的 Account 资源中的属性。

请求 URL​

PATCH https://<BMC_IPADDR>/redfish/v1/AccountService/Accounts/{1...12}

请求正文​

要更新的属性如下所示，所有这些属性都可以单独更改。

字段类型描述

UserName

字符串此帐户的用户名。

Password

字符串帐户的密码。在 PATCH 响应中显示 null。

RoleId

字符串为此帐户配置的 Role 资源的 ID

Enabled

布尔是否启用此帐户。

PasswordChangeRequired

布尔

如果必须更改此帐户的密码才能允许进一步访问，则应将此字段设置为 true。

注
此设置在基于 Intel Purley 的系统中不可用。

SNMP

对象展开
 

AuthenticationProtocol

字符串认证遵循认证协议。
 

EncryptionKey

字符串SNMPv3 的机密认证密钥。
 

EncryptionProtocol

字符串加密遵循加密协议。

响应正文​

响应返回的内容与 GET 操作相同，但更新了属性。

状态代码​

HTTP 状态代码错误消息 ID
500InternalError

示例​

以下示例是 PATCH 正文。

{
    "UserName": "USERID",
    "RoleId": "Administrator",
    "PasswordChangeRequired": false
}

返回以下示例 JSON 响应：

{
    "AccountTypes": [
        "Redfish"
    ],
    "@odata.type": "#ManagerAccount.v1_4_0.ManagerAccount",
    "@odata.id": "/redfish/v1/AccountService/Accounts/1",
    "Password": null,
    "Links": {
        "Role": {
            "@odata.id": "/redfish/v1/AccountService/Roles/Administrator"
        }
    },
    "Name": "User1",
    "Enabled": true,
    "Id": "1",
    "Oem": {
        "Lenovo": {
            "SSHPublicKey": [
                "",
                "",
                "",
                ""
            ],
            "SNMPv3Settings": {
                "AccessType": "Get",
                "PrivacyProtocolPassword": null,
                "Destination": "",
                "AuthenticationProtocol": "None",
                "PrivacyProtocol": "None"
            },
            "@odata.type": "#LenovoManagerAccount.v1_0_0.LenovoManagerAccount"
        }
    },
    "RoleId": "Administrator",
    "UserName": "USERID",
    "PasswordChangeRequired": false,
    "@odata.etag": "\"fab97f1216ebd001a50b81fb6d23270b\"",
    "Locked": false,
    "Description": "This resource is used to represent an account for the manager for a Redfish implementation."
}