Spec-Zone.ru › Ansible 2.6

vmware_host_lockdown — Управление правами администратора для локальной учетной записи администратора хоста ESXi

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

  • Обзор
    • Требования
  • Параметры
  • Примечания
  • Примеры
  • Значения возврата
  • Статус
  • Техническое обслуживание
    • Автор

Обзор

  • Этот модуль может использоваться для управления правами администратора для локальной учетной записи администратора хоста, когда задано имя хоста ESXi.
  • Все параметры и значения объектов VMware чувствительны к регистру.
  • Этот модуль является деструктивным, поскольку права администратора управляются с помощью API, пожалуйста, внимательно ознакомьтесь с параметрами и продолжайте.
  • Укажите hostname как IP-адрес или имя хоста vCenter, поскольку операции блокировки невозможны со стороны автономного сервера ESXi.

Требования

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

  • python >= 2.6
  • PyVmomi

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
cluster_name
Имя кластера.
Все системы хостов из заданного кластера используются для управления блокировкой.
Обязательный параметр, если esxi_hostname не задан.
esxi_hostname
Список имен хостов ESXi для управления блокировкой.
Обязательный параметр, если cluster_name не задан.
См. примеры для спецификаций.
hostname
str
Имя хоста или IP-адрес сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_HOST.
Поддержка переменных среды добавлена в версии 2.6.
password
str
Пароль сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PASSWORD.
Поддержка переменных среды добавлена в версии 2.6.

псевдонимы: pass, pwd
port
int

(добавлен в 2.5)
По умолчанию:
443
Номер порта сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_PORT.
Поддержка переменных среды добавлена в версии 2.6.
state
(добавлен в 2.5)
    Варианты:
  • present ←
  • absent
Состояние системы хостов
Если установлено значение present, все системы хостов будут переведены в режим блокировки.
Если система хоста уже находится в режиме блокировки и установлено значение present, никаких действий не будет выполнено.
Если установлено значение absent, все системы хостов будут исключены из режима блокировки.
Если система хоста уже не находится в режиме блокировки и установлено значение absent, никаких действий не будет выполнено.
username
str
Имя пользователя сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_USER.
Поддержка переменных среды добавлена в версии 2.6.

псевдонимы: admin, user
validate_certs
bool
    Варианты:
  • no
  • yes ←
Разрешает подключение, когда сертификаты SSL недействительны. Установите значение false, когда сертификаты ненадёжны.
Если значение не указано в задаче, будет использовано значение переменной среды VMWARE_VALIDATE_CERTS.
Поддержка переменных среды добавлена в версии 2.6.
Если установлено значение yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9.

Примечания

Примечание

  • Тестировалось на vSphere 6.5

Примеры

- name: Enter host system into lockdown mode
  vmware_host_lockdown:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    state: present

- name: Exit host systems from lockdown mode
  vmware_host_lockdown:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
    state: absent

- name: Enter host systems into lockdown mode
  vmware_host_lockdown:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname:
        - '{{ esxi_hostname_1 }}'
        - '{{ esxi_hostname_2 }}'
    state: present

- name: Exit host systems from lockdown mode
  vmware_host_lockdown:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname:
        - '{{ esxi_hostname_1 }}'
        - '{{ esxi_hostname_2 }}'
    state: absent

- name: Enter all host system from cluster into lockdown mode
  vmware_host_lockdown:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
    state: present

Значения возврата

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

Ключ Возвращаемое значение Описание
results
dict
всегда
Метаданные о состоянии блокировки системы хоста

Пример:
{'host_lockdown_state': {'DC0_C0': {'current_state': 'present', 'previous_state': 'absent', 'desired_state': 'present'}}}


Статус

Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость.

Техническое обслуживание

Этот модуль помечен как сообщество, что означает, что он поддерживается сообществом Ansible. Дополнительную информацию см. в разделе Техническое обслуживание и поддержка модулей.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

  • Abhijeet Kasurde (@Akasurde)

Подсказка

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

© 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_host_lockdown_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API