Class: OvirtSDK4::UsersService
- Defined in:
- lib/ovirtsdk4/services.rb,
lib/ovirtsdk4/services.rb
Instance Method Summary collapse
-
#add(user, opts = {}) ⇒ User
Add user from a directory service.
-
#list(opts = {}) ⇒ Array<User>
List all the users in the system.
-
#service(path) ⇒ Service
Locates the service corresponding to the given path.
-
#user_service(id) ⇒ UserService
Locates the
user
service.
Methods inherited from Service
Instance Method Details
#add(user, opts = {}) ⇒ User
Add user from a directory service.
For example, to add the myuser
user from the myextension-authz
authorization provider send a request
like this:
POST /ovirt-engine/api/users
With a request body like this:
<user>
<user_name>[email protected]</user_name>
<domain>
<name>myextension-authz</name>
</domain>
</user>
In case you are working with Active Directory you have to pass user principal name (UPN) as username
, followed
by authorization provider name. Due to bug 1147900 you need to provide
also principal
parameter set to UPN of the user.
For example, to add the user with UPN [email protected]
from the myextension-authz
authorization provider send a request body like this:
<user>
<principal>[email protected]</principal>
<user_name>[email protected]@myextension-authz</user_name>
<domain>
<name>myextension-authz</name>
</domain>
</user>
29498 29499 29500 |
# File 'lib/ovirtsdk4/services.rb', line 29498 def add(user, opts = {}) internal_add(user, User, ADD, opts) end |
#list(opts = {}) ⇒ Array<User>
List all the users in the system.
Usage:
GET /ovirt-engine/api/users
Will return the list of 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>[email protected]</user_name>
<domain href="/ovirt-engine/api/domains/45678" id="45678">
<name>domain-authz</name>
</domain>
</user>
</users>
The order of the returned list of users isn’t guaranteed.
29568 29569 29570 |
# File 'lib/ovirtsdk4/services.rb', line 29568 def list(opts = {}) internal_get(LIST, opts) end |
#service(path) ⇒ Service
Locates the service corresponding to the given path.
29590 29591 29592 29593 29594 29595 29596 29597 29598 29599 |
# File 'lib/ovirtsdk4/services.rb', line 29590 def service(path) if path.nil? || path == '' return self end index = path.index('/') if index.nil? return user_service(path) end return user_service(path[0..(index - 1)]).service(path[(index + 1)..-1]) end |
#user_service(id) ⇒ UserService
Locates the user
service.
29579 29580 29581 |
# File 'lib/ovirtsdk4/services.rb', line 29579 def user_service(id) UserService.new(self, id) end |