vmware_object_role_permission – Управление локальными ролями на хосте ESXi

Новая в версии 2.8.

Описание
Требования
Параметры
Примечания
Примеры
Возвращаемые значения
Статус

Описание

Этот модуль может быть использован для управления разрешениями объектов на данном хосте.

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

python >= 2.7
PyVmomi

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
group -		Группа, которой будут назначены разрешения. Обязательно, если `principal` не указано.
hostname строка		Имя хоста или IP-адрес сервера vCenter или ESXi сервера. Если значение не указано в задаче, используется значение переменной среды `VMWARE_HOST`. Поддержка переменных среды добавлена в Ansible 2.6.
object_name - / обязательно		Имя объекта, которому будут назначены разрешения.
object_type -	Варианты: Папка ← VirtualMachine Центр данных Ресурсный пул Хранилище данных Сеть Хост Ресурсный компьютер Ресурсный компьютер кластера Распределённый виртуальный коммутатор	Тип объекта, на который назначаются разрешения.
password строка		Пароль сервера vCenter или ESXi сервера. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PASSWORD`. Поддержка переменных среды добавлена в Ansible 2.6. Псевдонимы: pass, pwd
port целое число добавлено в 2.5	Значение по умолчанию: 443	Номер порта сервера vCenter или ESXi сервера. Если значение не указано в задаче, используется значение переменной среды `VMWARE_PORT`. Поддержка переменных среды добавлена в Ansible 2.6.
principal -		Пользователь, которому будут назначены разрешения. Обязательно, если `group` не указано.
recursive логическое значение	Варианты: нет да ←	Разрешения должны быть применены рекурсивно.
role - / обязательно		Роль, которой будут назначены разрешения.
state -	Варианты: present ← absent	Указывает желаемое состояние разрешения объекта. При `state=present`, разрешение будет добавлено, если оно ещё не существует. При `state=absent`, разрешение будет удалено, если оно существует.
username строка		Имя пользователя сервера vCenter или ESXi сервера. Если значение не указано в задаче, используется значение переменной среды `VMWARE_USER`. Поддержка переменных среды добавлена в Ansible 2.6. Псевдонимы: admin, user
validate_certs логическое значение	Варианты: нет да ←	Разрешает подключение, когда сертификаты SSL не являются валидными. Установите в `false`, когда сертификаты не надёжны. Если значение не указано в задаче, используется значение переменной среды `VMWARE_VALIDATE_CERTS`. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено значение `yes`, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

Тестировалось на ESXi 6.5, vSphere 6.7
Пользователь ESXi, используемый для входа, должен иметь соответствующие права для управления разрешениями.
Разрешения для распределенного коммутатора должны быть определены и управляются либо в центре данных, либо в папке, содержащей коммутатор.

Примеры

- name: Assign user to VM folder
  vmware_object_role_permission:
    role: Admin
    principal: user_bob
    object_name: services
    state: present
  delegate_to: localhost

- name: Remove user from VM folder
  vmware_object_role_permission:
    role: Admin
    principal: user_bob
    object_name: services
    state: absent
  delegate_to: localhost

- name: Assign finance group to VM folder
  vmware_object_role_permission:
    role: Limited Users
    group: finance
    object_name: Accounts
    state: present
  delegate_to: localhost

- name: Assign view_user Read Only permission at root folder
  vmware_object_role_permission:
    role: ReadOnly
    principal: view_user
    object_name: rootFolder
    state: present
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ	Возвращаемое значение	Описание
changed логическое значение	всегда	указывает, были ли внесены изменения в роль объекта

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

Derek Rushing (@kryptsi)
Joseph Andreatta (@vmwjoseph)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете редактировать этот документ для его улучшения.

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/vmware_object_role_permission_module.html