22.3. メソッド
22.3.1. ユーザーの追加
API は、既存のディレクトリーサービスユーザーを、
ユーザー コレクションに POST リクエストのある Red Hat Virtualization Manager データベースに追加します。クライアントが提供する新規ユーザー表現には、ユーザーに割り当てる初期 ロール が 1 つ以上含まれる組み込み ロール 一覧が含まれます。たとえば、以下の要求は、2 つの初期ロールをユーザー joe@domain.example.com に割り当てます。
例22.2 ディレクトリーサービスからのユーザーの追加と 2 つのロールを割り当てる
POST /ovirt-engine/api/users HTTP/1.1
Content-Type: application/xml
Accept: application/xml
<user>
<user_name>joe@domain.example.com</user_name>
<roles>
<role>
<name>RHEVMPowerUser</name>
</role>
<role id="00000000-0000-0000-0001-000000000003"/>
</roles>
</user>
新しいユーザーは、Red Hat Virtualization Manager のユーザー ID またはディレクトリーサービスのユーザープリンシパル名(UPN)で識別されます。ディレクトリーサービスドメインから報告されるユーザー ID 形式は、LDIF など、予想される Red Hat Virtualization Manager 形式とは異なる場合があります。 [5] ID は逆のバイト順序を持ち、base-64 でエンコードされます。したがって、通常は UPN で新しいユーザーを参照する方が便利です。
注記
ユーザーは、Red Hat Virtualization Manager データベースに追加される前にディレクトリーサービスドメインに存在します。API ユーザーには、ユーザーを作成する前に domain コレクションを介してこの
ドメイン をクエリーするオプションがあります。
ロールは名前または ID で識別されます。上記の例は、両方のアプローチを示しています。
