vmware_local_role_manager - Управление локальными ролями на хосте ESXi
Новое в версии 2.5.
Обзор
- Управление локальными ролями на хосте ESXi
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- python >= 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
|
force_remove
bool
|
|
Если установлено в
False, предотвращает удаление роли, если она используется любыми разрешениями. |
|
hostname
str
|
Имя хоста или IP-адрес сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной среды
VMWARE_HOST. Поддержка переменных среды добавлена в версии 2.6.
|
|
| local_privilege_ids | Значение по умолчанию: [] |
Список привилегий, которые должна иметь роль.
|
|
local_role_name
обязательно
|
Имя локальной роли, подлежащей управлению. |
|
|
password
str
|
Пароль сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной среды
VMWARE_PASSWORD. Поддержка переменных среды добавлена в версии 2.6.
псевдонимы: pass, pwd |
|
|
port
int
(добавлено в 2.5)
|
Значение по умолчанию: 443 |
Номер порта сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной среды
VMWARE_PORT. Поддержка переменных среды добавлена в версии 2.6.
|
| state |
|
Указывает желаемое состояние роли.
Если роль уже существует при
state=present, информация о роли обновляется. |
|
username
str
|
Имя пользователя сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной среды
VMWARE_USER. Поддержка переменных среды добавлена в версии 2.6.
псевдонимы: admin, user |
|
|
validate_certs
bool
|
|
Позволяет подключиться, когда сертификаты SSL недействительны. Установите в
false, когда сертификаты не доверенны.Если значение не указано в задаче, используется значение переменной среды
VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в версии 2.6.
Если установлено в
yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Тестировалось на ESXi 6.5
- Убедитесь, что у пользователя ESXi, используемого для входа, есть соответствующие права на создание/удаление/редактирование ролей
Примеры
# Example vmware_local_role_manager command from Ansible Playbooks
- name: Add local role to ESXi
vmware_local_role_manager:
hostname: esxi_hostname
username: root
password: vmware
local_role_name: vmware_qa
state: present
- name: Add local role with privileges to ESXi
vmware_local_role_manager:
hostname: esxi_hostname
username: root
password: vmware
local_role_name: vmware_qa
local_privilege_ids: [ 'Folder.Create', 'Folder.Delete']
state: present
- name: Remove local role from ESXi
vmware_local_role_manager:
hostname: esxi_hostname
username: root
password: vmware
local_role_name: vmware_qa
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны в документе, следующие поля уникальны для этого модуля:
| Ключ | Возвращается | Описание |
|---|---|---|
|
local_role_name
строка
|
всегда |
Имя локальной роли
|
|
new_privileges
список
|
при обновлении | Список привилегий роли после обновления |
|
old_privileges
список
|
при обновлении | Список привилегий роли до обновления |
|
role_id
целое число
|
всегда | Сгенерированный ESXi локальный идентификатор роли |
Статус
Этот модуль помечен как превью, что означает, что он не гарантирует обратную совместимость интерфейса.
Техническое обслуживание
Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Подробнее см. в Разделе поддержки и технического обслуживания модулей.
Список других модулей, поддерживаемых сообществом Ansible, см. здесь.
Автор
- Abhijeet Kasurde (@Akasurde) <akasurde@redhat.com>
Подсказка
Если вы обнаружите какие-либо проблемы в этом документе, вы можете отредактировать этот документ, чтобы улучшить его.
© 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/vmware_local_role_manager_module.html
