ansible / ansible.builtin / v2.9.27 / module / manageiq_user Management of users in ManageIQ. | "added in version" 2.4 of ansible.builtin" Authors: Daniel Korn (@dkorn) preview | supported by communityansible.builtin.manageiq_user (v2.9.27) — module
pip
Install with pip install ansible==2.9.27
The manageiq_user module supports adding, updating and deleting users in ManageIQ.
- name: Create a new user in ManageIQ manageiq_user: userid: 'jdoe' name: 'Jane Doe' password: 'VerySecret' group: 'EvmGroup-user' email: 'jdoe@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: False
- name: Create a new user in ManageIQ using a token manageiq_user: userid: 'jdoe' name: 'Jane Doe' password: 'VerySecret' group: 'EvmGroup-user' email: 'jdoe@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' token: 'sometoken' validate_certs: False
- name: Delete a user in ManageIQ manageiq_user: state: 'absent' userid: 'jdoe' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: False
- name: Delete a user in ManageIQ using a token manageiq_user: state: 'absent' userid: 'jdoe' manageiq_connection: url: 'http://127.0.0.1:3000' token: 'sometoken' validate_certs: False
- name: Update email of user in ManageIQ manageiq_user: userid: 'jdoe' email: 'jaustine@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: False
- name: Update email of user in ManageIQ using a token manageiq_user: userid: 'jdoe' email: 'jaustine@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' token: 'sometoken' validate_certs: False
name: description: - The users' full name. email: description: - The users' E-mail address. group: description: - The name of the group to which the user belongs. state: choices: - absent - present default: present description: - absent - user should not exist, present - user should be. userid: description: - The unique userid in manageiq, often mentioned as username. required: true password: description: - The users' password. update_password: choices: - always - on_create default: always description: - C(always) will update passwords unconditionally. C(on_create) will only set the password for a newly created user. version_added: '2.5' version_added_collection: ansible.builtin manageiq_connection: description: - ManageIQ connection configuration information. required: false suboptions: ca_cert: aliases: - ca_bundle_path description: - The path to a CA bundle file or directory with certificates. defaults to None. type: str password: description: - ManageIQ password. C(MIQ_PASSWORD) env var if set. otherwise, required if no token is passed in. type: str token: description: - ManageIQ token. C(MIQ_TOKEN) env var if set. otherwise, required if no username or password is passed in. type: str url: description: - ManageIQ environment url. C(MIQ_URL) env var if set. otherwise, it is required to pass it. required: false type: str username: description: - ManageIQ username. C(MIQ_USERNAME) env var if set. otherwise, required if no token is passed in. type: str validate_certs: aliases: - verify_ssl default: true description: - Whether SSL certificates should be verified for HTTPS requests. defaults to True. type: bool type: dict