community / community.general / 8.5.0 / module / manageiq_user Management of users in ManageIQ Authors: Daniel Korn (@dkorn)community.general.manageiq_user (8.5.0) — module
Install with ansible-galaxy collection install community.general:==8.5.0
collections: - name: community.general version: 8.5.0
The manageiq_user module supports adding, updating and deleting users in ManageIQ.
- name: Create a new user in ManageIQ community.general.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 # only do this when you trust the network!
- name: Create a new user in ManageIQ using a token community.general.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 # only do this when you trust the network!
- name: Delete a user in ManageIQ community.general.manageiq_user: state: 'absent' userid: 'jdoe' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: false # only do this when you trust the network!
- name: Delete a user in ManageIQ using a token community.general.manageiq_user: state: 'absent' userid: 'jdoe' manageiq_connection: url: 'http://127.0.0.1:3000' token: 'sometoken' validate_certs: false # only do this when you trust the network!
- name: Update email of user in ManageIQ community.general.manageiq_user: userid: 'jdoe' email: 'jaustine@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' username: 'admin' password: 'smartvm' validate_certs: false # only do this when you trust the network!
- name: Update email of user in ManageIQ using a token community.general.manageiq_user: userid: 'jdoe' email: 'jaustine@example.com' manageiq_connection: url: 'http://127.0.0.1:3000' token: 'sometoken' validate_certs: false # only do this when you trust the network!
name: description: - The users' full name. type: str email: description: - The users' E-mail address. type: str group: description: - The name of the group to which the user belongs. type: str state: choices: - absent - present default: present description: - absent - user should not exist, present - user should be. type: str userid: description: - The unique userid in manageiq, often mentioned as username. required: true type: str password: description: - The users' password. type: str update_password: choices: - always - on_create default: always description: - V(always) will update passwords unconditionally. V(on_create) will only set the password for a newly created user. type: str 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. type: str password: description: - ManageIQ password. E(MIQ_PASSWORD) environment variable if set. Otherwise, required if no token is passed in. type: str token: description: - ManageIQ token. E(MIQ_TOKEN) environment variable if set. Otherwise, required if no username or password is passed in. type: str url: description: - ManageIQ environment URL. E(MIQ_URL) environment variable if set. Otherwise, it is required to pass it. required: false type: str username: description: - ManageIQ username. E(MIQ_USERNAME) environment variable 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. type: bool type: dict