модуль community.vmware.vmware_local_role_manager – управление локальными ролями на узле ESXi или в vCenter
Примечание
Этот модуль входит в коллекцию community.vmware (версия 6.2.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install community.vmware.
Чтобы использовать коллекцию в плейбуке, укажите: community.vmware.vmware_local_role_manager.
Краткое описание
- Этот модуль предназначен для управления локальными ролями на узле ESXi или в vCenter.
Параметры
Параметр | Комментарии |
|---|---|
action string | Этот параметр действителен только при обновлении существующей роли с привилегиями.
Варианты:
|
force_remove boolean | Если задано значение Варианты:
|
hostname string | Имя узла или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
local_privilege_ids list / elements=string | Список привилегий, которыми должна обладать роль. По умолчанию: |
local_role_name string / обязательный | Имя локальной роли, которой нужно управлять. |
password псевдонимы: pass, pwd string | Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
port integer | Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды По умолчанию: |
proxy_host string | Адрес прокси-сервера, который будет принимать все HTTPS-запросы и перенаправлять их. Формат: имя узла или IP-адрес. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
proxy_port integer | Порт HTTP-прокси-сервера, который будет принимать все HTTPS-запросы и перенаправлять их. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
state string | Желаемое состояние роли. Если роль уже существует при Варианты:
|
username псевдонимы: admin, user string | Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использовано значение переменной среды |
validate_certs boolean | Разрешает подключение, если SSL-сертификаты недействительны. Установите значение Если значение не указано в задаче, вместо него будет использовано значение переменной среды Варианты:
|
Примечания
Примечание
- Убедитесь, что у пользователя, используемого для входа, есть необходимые права на создание, удаление и изменение ролей.
- Для всех модулей необходим доступ на запись через API, поэтому они не поддерживаются при использовании бесплатной лицензии ESXi.
- Все переменные и имена объектов VMware чувствительны к регистру.
- Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не использует системное хранилище сертификатов. Можно указать хранилище сертификатов, задав переменную среды REQUESTS_CA_BUNDLE. Обратите внимание: в некоторых случаях наличие этой переменной может привести к игнорированию значения ‘false’ параметра ‘validate_certs’. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’
Примеры
- name: Add local role to ESXi
community.vmware.vmware_local_role_manager:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
local_role_name: vmware_qa
state: present
delegate_to: localhost
- name: Add local role with privileges to vCenter
community.vmware.vmware_local_role_manager:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
local_role_name: vmware_qa
local_privilege_ids: [ 'Folder.Create', 'Folder.Delete']
state: present
delegate_to: localhost
- name: Remove local role from ESXi
community.vmware.vmware_local_role_manager:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
local_role_name: vmware_qa
state: absent
delegate_to: localhost
- name: Add a privilege to an existing local role
community.vmware.vmware_local_role_manager:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
local_role_name: vmware_qa
local_privilege_ids: [ 'Folder.Create' ]
action: add
delegate_to: localhost
- name: Remove a privilege to an existing local role
community.vmware.vmware_local_role_manager:
hostname: '{{ esxi_hostname }}'
username: '{{ esxi_username }}'
password: '{{ esxi_password }}'
local_role_name: vmware_qa
local_privilege_ids: [ 'Folder.Create' ]
action: remove
delegate_to: localhost
- name: Set a privilege to an existing local role
community.vmware.vmware_local_role_manager:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
local_role_name: vmware_qa
local_privilege_ids: [ 'Folder.Create' ]
action: set
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
local_role_name string | Имя локальной роли Возвращается: всегда |
new_privileges list / elements=string | Список привилегий Возвращается: всегда |
old_privileges list / elements=string | Список привилегий роли до обновления Возвращается: при обновлении |
privileges list / elements=string | Список привилегий Возвращается: всегда |
privileges_previous list / elements=string | Список привилегий роли до обновления Возвращается: при обновлении |
role_id integer | Сгенерированный идентификатор локальной роли Возвращается: всегда |
role_name string | Имя локальной роли Возвращается: всегда |
Ссылки на коллекцию
© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/community/vmware/vmware_local_role_manager_module.html
