跳到主要内容

PATCH – 更新自定义角色权限

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

请求 URL​

PATCH https://<BMC_IPADDR>/redfish/v1/AccountService/Roles/CustomRole{N}

请求正文​

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

字段类型描述

OemPrivileges

数组

此属性的值应为此角色包含的 OEM 权限。对于预定义的角色，此属性应为 readOnly。对于自定义角色，某些实现可能不允许对此属性进行写入。这些值可以是：

“UserAccountManagement”、

“RemoteConsoleAccess”、

“RemoteConsoleAndVirtualMediaAccess”、

“RemoteServerPowerRestartAccess”、

“AbilityClearEventLogs”、

“Configuration_Basic”、

“Configuration_NetworkingAndSecurity”、

“Configuration_Advanced”、

“Configuration_UEFISecurity”

响应​

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

状态代码​

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

示例​

以下示例是 PATCH 正文。

{
   "OemPrivileges" : [
      " RemoteConsoleAccess "
   ]
}

返回以下示例 JSON 响应：

{
    "Id": "CustomRole12",
    "AssignedPrivileges": [
        "Login"
    ],
    "@odata.type": "#Role.v1_3_1.Role",
    "@odata.id": "/redfish/v1/AccountService/Roles/CustomRole12",
    "RoleId": "CustomRole12",
    "OemPrivileges@Redfish.AllowableValues": [
        "UserAccountManagement",
        "RemoteConsoleAccess",
        "RemoteConsoleAndVirtualMediaAccess",
        "RemoteServerPowerRestartAccess",
        "AbilityClearEventLogs",
        "Configuration_Basic",
        "Configuration_NetworkingAndSecurity",
        "Configuration_Advanced",
        "Configuration_UEFISecurity"
    ],
    "@odata.context": "/redfish/v1/$metadata#Role.Role",
    "IsPredefined": false,
    "OemPrivileges": [
        "RemoteConsoleAccess"
    ],
    "Description": "This resource is used to represent a user role for the user account for a Redfish implementation.",
    "Name": "CustomRole12",
    "@odata.etag": "\"5b9583e74906242bc70\""
}