跳到主要内容

GET/POST – 帐户集合

使用 GET/POST 方法检索 Redfish 服务的帐户集合中的属性。

请求 URL

https://<SMM_IPADDR>/redfish/v1/AccountService/Accounts

请求正文

响应正文

字段

类型

描述

Description

字符串

“BMC 用户帐户”

Members

数组

项:链接

项数: 1~15

 

Members[N]

链接

用户帐户资源实例的链接。

  

@odata.id

字符串

“/redfish/v1/AccountService/Accounts/{id}”

Name

字符串

Accounts Collection

REST 操作 — POST

操作属性注释
POST

UserName

长度应在 1~16 之间。允许的字符:TBD
  • “ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-”

Password

如果不允许使用空的密码,密码长度应介于 AccountService 中的 PasswordLength 值和 20 之间。允许的字符:TBD
  • “ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz~!@#$%^&*()-+={}[]|:;\”’<>,?/._0123456789”
如果设置的密码超过 20 个字符,该凭证将无法访问 IPMI。如果将密码重新设置为少于或等于 20 个字符,该凭证将能够再次访问 IPMI。

RoleId

必须是现有 Role 资源的 RoleId 属性。
不应将 RoleId 设置为“Administrator+”。

PasswordChangeRequired

  • 如果有从某个帐户使用 POST 方法创建的 Redfish 会话,那么在删除这个帐户后会出现两种情况:用户在访问服务时收到 403(禁止访问)状态码的 Redfish 会话将立即到期;允许用户访问服务的 Redfish 会话仍将有效并允许访问,直至达到会话超时限制。
  • 使用 POST 创建帐户时,输入参数“Enabled”为可选参数,默认值为 true。

AccountTypes

[“WebUI”,“Redfish”,“IPMI”]。“WebUI”和“Redfish”必须同时存在于此字段中。如果未设置,则默认帐户类型为 [“WebUI”, “Redfish”, “IPMI”]

要创建帐户,必须在请求正文中指定 UserName、Password 和 RoleId。如果在创建 SNMP 帐户时指定了某个 EncryptionProtocol(不是“None”),那么还必须指定 PrivacyProtocolPassword。

如果 REST 遇到错误或无法完成请求,它将返回“500 内部服务器错误”,但不会回滚对有效属性所做的更改。

  • 根据 DMTF Redfish 规范 DSP0266,用户可以在使用 PATCH 方法更新用户资源时提供 Etag 值。换言之,服务允许用户不在 PATCH 请求的标头中提供 Etag,但如果用户提供,服务将在更新前验证 Etag 值。

状态代码

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