跳到主要内容

POST – 创建自定义角色

使用 POST 方法为 Redfish 服务创建自定义角色。

请求 URL​

POST https://<BMC_IPADDR>/redfish/v1/AccountService/Roles

请求正文​

字段类型描述

RoleId

字符串

RoleId 长度限制为 1~32 个字符。允许的字符：A-Z、a-z、0-9、-（短划线）、.（句点）和 _（下划线）。

OemPrivileges

数组

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

“UserAccountManagement”、

“RemoteConsoleAccess”、

“RemoteConsoleAndVirtualMediaAccess”、

“RemoteServerPowerRestartAccess”、

“AbilityClearEventLogs”、

“Configuration_Basic”、

“Configuration_NetworkingAndSecurity”、

“Configuration_Advanced”、

“Configuration_UEFISecurity”

响应正文​

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

状态代码​

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

示例​

以下示例是 POST 正文。

{
   "RoleId": "CustomRole",
   "OemPrivileges" : [
      "UserAccountManagement"
   ]
}

返回以下示例 JSON 响应：

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