メインコンテンツまでスキップ

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 である必要があります。使用できる文字:未定
  • 「ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789._-」

Password

空のパスワードが使用できない場合、パスワードの長さは、AccountService の PasswordLength の値と 20 の間である必要があります。使用できる文字: 未定
  • 「ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz~!@#$%^&*()-+={}[]|:;\”’<>,?/._0123456789」
注
パスワードが 20 文字を超える場合、資格情報は IPMI にアクセスできません。パスワードを 20 文字以下に設定し直すと、資格情報は再び IPMI にアクセスできるようになります。

RoleId

既存の Role リソースの RoleId プロパティである必要があります。
注
RoleId は「Administrator+」に設定しないでください。

PasswordChangeRequired

注
  • アカウントから POST を使用して作成された Redfish セッションが存在する場合、アカウントが削除されると、ユーザーがサービスにアクセスするときに 403 (Forbidden) を受け取る Redfish セッションもすぐに期限切れになります。ユーザーがサービスへのアクセスを許可されている Redfish セッションは、セッション・タイムアウト制限に達するまで存続し、アクセスが許可されます。
  • POST を使用してアカウントを作成する場合、入力パラメーター「Enabled」はオプションであり、デフォルト値は true です。

AccountTypes

[「WebUI」、「Redfish」、「IPMI」]。このフィールドには、「WebUI」と「Redfish」が同時に存在する必要があります。設定されていない場合、デフォルトのアカウント・タイプは [「WebUI」、「Redfish」、「IPMI」] です。

アカウントを作成するには、UserName、Password、および RoleId を要求本文で指定する必要があります。PrivacyProtocolPassword は、SNMP アカウントの作成時に特定の EncryptionProtocol が指定されている (「None」ではない) 場合は必須です。

REST でエラーが発生したり、要求を完了できなかったりすると、「500 Internal Server Error」が返されますが、有効なプロパティに加えられた変更はロールバックされません。

注

  • DMTF Redfish 仕様 DSP0266 に基づき、ユーザーは、ユーザー・リソースにパッチを適用するときに Etag 値を指定できます。つまり、サービスでは、ユーザーが PATCH 要求のヘッダーに Etag を指定しないことも許可されますが、ユーザーが指定した場合、サービスは更新前に Etag 値を検証します。

ステータス・コード​

HTTP ステータス・コードエラー・メッセージ ID
500InternalError