community.grafana.grafana_user – Управление пользователем Grafana
Примечание
Этот плагин входит в коллекцию community.grafana (версия 1.1.0).
Для его установки используйте: ansible-galaxy collection install community.grafana.
Для использования в книге задач укажите: community.grafana.grafana_user.
Новое в версии 1.0.0: модуля community.grafana
Описание
- Создание/обновление/удаление пользователя Grafana через API пользователей и администраторов.
- Тестировался с Grafana v6.4.3
- Обновление пароля на данный момент не поддерживается
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| client_cert путь | Файл цепочки сертификатов в формате PEM, используемый для проверки подлинности клиента SSL. Этот файл также может включать ключ, и если ключ включён, client_key не требуется | |
| client_key путь | Файл в формате PEM, содержащий ваш закрытый ключ, используемый для проверки подлинности клиента SSL. Если client_cert содержит как сертификат, так и ключ, этот параметр не требуется. | |
| email строка | Электронная почта пользователя Grafana. | |
| is_admin булево |
| Пользователь Grafana является администратором. |
| login строка / обязательно | Логин пользователя Grafana. | |
| name строка | Имя пользователя Grafana. | |
| password строка | Пароль пользователя Grafana. В данный момент это поле еще не обновляется. | |
| state строка |
| Указывает, должен ли пользователь присутствовать в Grafana или нет |
| url строка / обязательно | URL Grafana. псевдонимы: grafana_url | |
| url_password строка | Значение по умолчанию: "admin" | Пароль Grafana для аутентификации API. псевдонимы: grafana_password |
| url_username строка | Значение по умолчанию: "admin" | Имя пользователя Grafana для аутентификации API. псевдонимы: grafana_user |
| use_proxy булево |
| Если no, прокси не будет использоваться, даже если он определён в переменной среды на целевых хостах. |
| validate_certs булево |
| Если no, сертификаты SSL не будут проверены.Это следует устанавливать только в no на сайтах с самоподписанными сертификатами, подконтрольными лично вам. |
Примеры
---
- name: Create or update a Grafana user
community.grafana.grafana_user:
url: "https://grafana.example.com"
url_username: admin
url_password: changeme
name: "Bruce Wayne"
email: batman@gotham.city
login: batman
password: robin
is_admin: true
state: present
- name: Delete a Grafana user
community.grafana.grafana_user:
url: "https://grafana.example.com"
url_username: admin
url_password: changeme
login: batman
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:
| Ключ | Возвращаемое значение | Описание | |
|---|---|---|---|
| user сложное | при state present | Информация о пользователе | |
| email строка | всегда | Электронный адрес пользователя Пример: ['foo.bar@example.com'] | |
| id целое число | всегда | ID пользователя Пример: [42] | |
| isDisabled булево | всегда | Статус учётной записи Grafana Пример: [False] | |
| isExternal булево | всегда | Информация учётной записи Grafana на внешнем поставщике пользователей Пример: [False] | |
| isGrafanaAdmin булево | всегда | Права пользователя Grafana на администрирование Пример: [False] | |
| login строка | всегда | Логин пользователя Пример: ['batman'] | |
| orgId целое число | всегда | ID организации, к которой относится команда. Пример: [1] | |
| theme строка | всегда | Тема Grafana Пример: ['light'] | |
Авторы
- Antoine Tanzilli (@Tailzip)
- Hong Viet LE (@pomverte)
- Julien Alexandre (@jual)
- Marc Cyprien (@LeFameux)
© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/grafana/grafana_user_module.html