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
返すユーザーの最大数を設定します。指定しない場合、すべてのユーザーが返されます。