6.250. ユーザー
システム内のユーザーを管理するサービス。
| 名前 | Summary |
|---|---|
|
| ディレクトリーサービスからユーザーを追加します。 |
|
| システム内のすべてのユーザーをリスト表示します。 |
6.250.1. add POST リンクのコピーリンクがクリップボードにコピーされました!
ディレクトリーサービスからユーザーを追加します。
たとえば、myextension-authz 承認プロバイダーから myuser ユーザーを追加するには、次のようなリクエストを送信します。
POST /ovirt-engine/api/users
リクエスト本文は以下のようになります。
<user>
<user_name>myuser@myextension-authz</user_name>
<domain>
<name>myextension-authz</name>
</domain>
</user>
Active Directory を使用している場合は、ユーザープリンシパル名 (UPN) を username として渡し、その後に承認プロバイダー名を渡す必要があります。バグ 1147900 のため、ユーザーの UPN に設定された principal パラメーターも提供する必要があります。
たとえば、UPN myuser@mysubdomain.mydomain.com を持つユーザーを myextension-authz 承認プロバイダーから追加するには、以下のようなリクエスト本文を送信します。
<user>
<principal>myuser@mysubdomain.mydomain.com</principal>
<user_name>myuser@mysubdomain.mydomain.com@myextension-authz</user_name>
<domain>
<name>myextension-authz</name>
</domain>
</user>
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In/Out |
6.250.2. list GET リンクのコピーリンクがクリップボードにコピーされました!
システム内のすべてのユーザーをリスト表示します。
使用方法:
GET /ovirt-engine/api/users
ユーザーのリストを返します。
<users>
<user href="/ovirt-engine/api/users/1234" id="1234">
<name>admin</name>
<link href="/ovirt-engine/api/users/1234/sshpublickeys" rel="sshpublickeys"/>
<link href="/ovirt-engine/api/users/1234/roles" rel="roles"/>
<link href="/ovirt-engine/api/users/1234/permissions" rel="permissions"/>
<link href="/ovirt-engine/api/users/1234/tags" rel="tags"/>
<domain_entry_id>23456</domain_entry_id>
<namespace>*</namespace>
<principal>user1</principal>
<user_name>user1@domain-authz</user_name>
<domain href="/ovirt-engine/api/domains/45678" id="45678">
<name>domain-authz</name>
</domain>
</user>
</users>
返されるユーザーのリストの順序は保証されません。
| 名前 | 型 | 方向 | Summary |
|---|---|---|---|
|
| In |
| |
|
| In | たどる 必要のある内部リンクを指定します。 | |
|
| In | 返すユーザーの最大数を設定します。 | |
|
| In | 返されるユーザーを制限するために使用されるクエリー文字列。 | |
|
| Out | ユーザーのリスト。 |
6.250.2.1. case_sensitive リンクのコピーリンクがクリップボードにコピーされました!
search パラメーターを使用して実行する検索を、大文字と小文字を区別して実行する必要があるかどうかを示します。デフォルト値は true です。つまり、大文字と小文字の区別が考慮されます。ケースを無視する場合は、false に設定します。
6.250.2.2. follow リンクのコピーリンクがクリップボードにコピーされました!
たどる 必要のある内部リンクを指定します。これらのリンクで参照されるオブジェクトは、現在の要求の一部としてフェッチされます。詳細は、こちら を参照してください。
6.250.2.3. max リンクのコピーリンクがクリップボードにコピーされました!
返すユーザーの最大数を設定します。指定しない場合、すべてのユーザーが返されます。