On this page
avi_useraccount - Avi UserAccount Module
New in version 2.6.
Synopsis
- This module can be used for updating the password of a user.
- This module is useful for setting up admin password for Controller bootstrap.
Requirements
The below requirements are needed on the host that executes this module.
- avisdk
Parameters
Parameter | Choices/Defaults | Comments |
---|---|---|
api_context
(added in 2.5)
|
Avi API context that includes current session ID and CSRF Token.
This allows user to perform single login and re-use the session.
|
|
api_version | Default:
"16.4.4"
|
Avi API version of to use for Avi API and objects.
|
avi_credentials
(added in 2.5)
|
Avi Credentials dictionary which can be used in lieu of enumerating Avi Controller login details.
|
|
controller | Default:
""
|
IP address or hostname of the controller. The default value is the environment variable AVI_CONTROLLER .
|
old_password |
Old password for update password or default password for bootstrap.
|
|
password | Default:
""
|
Password of Avi user in Avi controller. The default value is the environment variable AVI_PASSWORD .
|
tenant | Default:
"admin"
|
Name of tenant used for all Avi API calls and context of object.
|
tenant_uuid | Default:
""
|
UUID of tenant used for all Avi API calls and context of object.
|
username | Default:
""
|
Username used for accessing Avi controller. The default value is the environment variable AVI_USERNAME .
|
Notes
Note
- For more information on using Ansible to manage Avi Network devices see https://www.ansible.com/ansible-avi-networks.
Examples
- name: Update user password
avi_useraccount:
controller: ""
username: ""
password: new_password
old_password: ""
api_version: ""
- name: Update user password using avi_credentials
avi_useraccount:
avi_credentials: ""
old_password: ""
Return Values
Common return values are documented here, the following are the fields unique to this module:
Key | Returned | Description |
---|---|---|
obj
dict
|
success, changed |
Avi REST resource
|
Status
This module is flagged as preview which means that it is not guaranteed to have a backwards compatible interface.
Maintenance
This module is flagged as community which means that it is maintained by the Ansible Community. See Module Maintenance & Support for more info.
For a list of other modules that are also maintained by the Ansible Community, see here.
Author
- Chaitanya Deshpande (chaitanya.deshpande@avinetworks.com)
Hint
If you notice any issues in this documentation you can edit this document to improve it.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.6/modules/avi_useraccount_module.html