community.network.cnos_user – Управление списком локальных пользователей на устройствах Lenovo CNOS
Примечание
Этот плагин входит в коллекцию community.network (версия 1.3.0).
Для его установки используйте: ansible-galaxy collection install community.network.
Для использования в playbook, укажите: community.network.cnos_user.
Обзор
- Этот модуль обеспечивает декларативное управление локальными именами пользователей, настроенными на устройствах Lenovo CNOS. Он позволяет playbooks управлять либо отдельными именами пользователей, либо списком имен пользователей в текущей конфигурации. Он также поддерживает удаление имен пользователей из конфигурации, которые не определены явно.
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| aggregate строка | Набор объектов имени пользователя, которые должны быть настроены на удаленном устройстве Lenovo CNOS. Элементы списка могут быть именем пользователя или хешем имени пользователя и свойств. Этот аргумент взаимоисключающий с аргументом name.псевдонимы: users, collection | |
| configured_password строка | Пароль, который нужно настроить на сетевом устройстве. Пароль должен быть предоставлен в открытом виде, и он будет зашифрован на устройстве. Обратите внимание, что этот параметр не такой же, как provider password. | |
| name строка | Имя пользователя, которое нужно настроить на удаленном устройстве Lenovo CNOS. Этот аргумент принимает строковое значение и взаимоисключающий с аргументом aggregate. | |
| purge логическое |
| Аргумент purge указывает модулю рассматривать определение ресурса как абсолютное. Он удалит всех ранее настроенных имен пользователей на устройстве, за исключением пользователя `admin`, который не может быть удален из-за ограничений CNOS. |
| role строка | Аргумент role настраивает роль для имени пользователя в рабочей конфигурации устройства. Аргумент принимает строковое значение, определяющее имя роли. Этот аргумент не проверяет, настроена ли роль на устройстве.псевдонимы: roles | |
| sshkey строка | Аргумент sshkey определяет открытый ключ SSH для настройки имени пользователя. Этот аргумент принимает действительное значение ключа SSH. | |
| state строка |
| Аргумент state настраивает состояние определения имени пользователя по отношению к рабочей конфигурации устройства. При установке в значение present имя(на) пользователя(ей) должно быть настроено в активной конфигурации устройства, а при установке в значение absent имя(на) пользователя(ей) не должно быть в активной конфигурации устройства. |
| update_password строка |
| Поскольку пароли зашифрованы в рабочей конфигурации устройства, этот аргумент укажет модулю, когда нужно изменить пароль. При установке в значение always, пароль всегда будет обновлен на устройстве, а при установке в значение on_create, пароль будет обновлен только в случае создания имени пользователя. |
Примеры
- name: Create a new user
community.network.cnos_user:
name: ansible
sshkey: "{{ lookup('file', '~/.ssh/id_rsa.pub') }}"
state: present
- name: Remove all users except admin
community.network.cnos_user:
purge: yes
- name: Set multiple users role
aggregate:
- name: Netop
- name: Netend
role: network-operator
state: present
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание |
|---|---|---|
| commands список / элементы=строка | всегда | Список команд режима конфигурации для отправки на устройство Пример: ['name ansible', 'name ansible password password'] |
| delta строка | всегда | Время, затраченное на выполнение всех операций Пример: 0:00:10.469466 |
| end строка | всегда | Время завершения задачи Пример: 2016-11-16 10:38:25.595612 |
| start строка | всегда | Время начала задачи Пример: 2016-11-16 10:38:15.126146 |
Авторы
- Anil Kumar Muraleedharan (@amuraleedhar)
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/cnos_user_module.html
