跳到主要内容

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。

AccountTypes

数组允许此帐户访问的各种管理器服务。
 

AccountTypes[N]

字符串

“Redfish”、“SNMP”、“ManagerConsole”、“IPMI”、“WebUI”

注

如果帐户具有 IPMI 访问权限，则应将密码设置为等于或少于 20 个字符。

如果帐户具有 SNMP 访问权限，则应将 EncryptionKey 设置为等于或少于 32 个字符。此外，如果 EncryptionProtocol 不是“none”，则 AuthenticationProtocol 也不应该是“none”。

SNMP

对象

展开

注
当 AccountTypes 不包含“SNMP”时，此设置不可用。
 

AuthenticationProtocol

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

EncryptionKey

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

EncryptionProtocol

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

响应正文​

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

状态代码​

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

PropertyValueTypeError

PropertyValueFormatError

ResourceChangeRequried

NotRecommandedOperation

ForbiddenOperation

ResourceAlreadyExists

PropertyMissing

PasswordChangeRequired

示例​

以下示例是 PATCH 正文。

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

返回以下示例 JSON 响应：

{
    "Enabled": true,
    "Oem": {
        …
    },
    "Links": {
        "Role": {
            "@odata.id": "/redfish/v1/AccountService/Roles/Administrator"
        }
    },
    "Description": "This resource is used to represent an account for the manager for a Redfish implementation.",
    "Locked": false,
    "PasswordChangeRequired": false,
    "Password": null,
    "Id": "1",
    "@odata.context": "/redfish/v1/$metadata#ManagerAccount.ManagerAccount",
    "PasswordExpiration": null,
    "@odata.id": "/redfish/v1/AccountService/Accounts/1",
    "@odata.etag": "\"0000000000000000000000000000000032a05d16\"",
    "UserName": "USERID",
    "Name": "User1",
    "HostBootstrapAccount": false,
    "AccountTypes": [
        "WebUI",
        "Redfish",
        "ManagerConsole"
    ],
    "@odata.type": "#ManagerAccount.v1_8_1.ManagerAccount",
    "RoleId": "Administrator",
    "AccountTypes@Redfish.AllowableValues": [
        "WebUI",
        "Redfish",
        "ManagerConsole",
        "IPMI",
        "SNMP"
    ],
    "SNMP": {
        "AuthenticationProtocol": "HMAC_SHA96",
        "EncryptionKeySet": false,
        "EncryptionKey": null,
        "EncryptionProtocol": "CFB128_AES128"
    }
}