W3cubDocs

/Ansible

infinidat.infinibox.infini_user module – Create, Delete and Modify a User on Infinibox

Note

This module is part of the infinidat.infinibox collection (version 1.6.3).

You might already have this collection installed if you are using the ansible package. It is not included in ansible-core. To check whether it is installed, run ansible-galaxy collection list.

To install it, use: ansible-galaxy collection install infinidat.infinibox. You need further requirements to be able to use this module, see Requirements for details.

To use it in a playbook, specify: infinidat.infinibox.infini_user.

New in infinidat.infinibox 2.9.0

Synopsis

  • This module creates, deletes or modifies a user on Infinibox.

Requirements

The below requirements are needed on the host that executes this module.

Parameters

Parameter

Comments

password

string / required

Infinibox User password.

state

string

Creates/Modifies user when present or removes when absent.

Use state ‘login’ to test user credentials.

Use state ‘reset’ to reset a user password.

Choices:

  • "stat"
  • "reset_password"
  • "present" ← (default)
  • "absent"
  • "login"

stay_logged_in

boolean

If True, persist API session to disk.

Load the session on subsequent module calls.

Persisted sessions are only usable for stay_logged_in_minutes.

Choices:

  • false ← (default)
  • true

stay_logged_in_minutes

integer

Number of minutes for which a persisted session may be reused.

After this time, the session data will be deleted.

The time should be shorter than the IBOX session timeout time.

Default: 5

system

string / required

Infinibox Hostname or IPv4 Address.

user

string / required

Infinibox User username with sufficient priveledges ( see notes ).

user_email

string

The new user’s Email address

user_enabled

boolean

Specify whether to enable the user

Choices:

  • false
  • true ← (default)

user_ldap_group_dn

string

DN of the LDAP user group

user_ldap_group_ldap

string

Name of the LDAP

user_ldap_group_name

string

Name of the LDAP user group

user_ldap_group_pools

list / elements=string

A list of existing pools managed by the LDAP user group

Default: []

user_ldap_group_role

string

Role for the LDAP user group

Choices:

  • "admin"
  • "pool_admin"
  • "read_only"

user_name

string

The new user’s Name. Once a user is created, the user_name may not be changed from this module. It may be changed from the UI or from infinishell.

user_password

string

The new user’s password

user_pool

string

Use with role==pool_admin. Specify the new user’s pool.

user_role

string

The user’s role

Choices:

  • "admin"
  • "pool_admin"
  • "read_only"

Notes

Note

  • This module requires infinisdk python library
  • You must set INFINIBOX_USER and INFINIBOX_PASSWORD environment variables if user and password arguments are not passed to the module directly
  • Ansible uses the infinisdk configuration file ~/.infinidat/infinisdk.ini if no credentials are provided. See http://infinisdk.readthedocs.io/en/latest/getting_started.html
  • All Infinidat modules support check mode (–check). However, a dryrun that creates resources may fail if the resource dependencies are not met for a task. For example, consider a task that creates a volume in a pool. If the pool does not exist, the volume creation task will fail. It will fail even if there was a previous task in the playbook that would have created the pool but did not because the pool creation was also part of the dry run.

Examples

- name: Create new user
  infini_user:
    user_name: foo_user
    user_email: [email protected]
    user_password: secret2
    user_role: pool_admin
    user_enabled: false
    pool: foo_pool
    state: present
    password: secret1
    system: ibox001

Authors

  • David Ohlemacher (@ohlemacher)

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/infinidat/infinibox/infini_user_module.html