Spec-Zone.ru › Ansible 2.6

vmware_vswitch — Управление стандартным коммутатором VMware на узле ESXi.

Новое в версии 2.0.

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

Обзор

  • Этот модуль можно использовать для добавления, удаления и обновления стандартного коммутатора VMware на узле ESXi.

Требования

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

  • python >= 2.6
  • PyVmomi

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
esxi_hostname
(добавлено в 2.5)
Управление коммутатором vSwitch с помощью этого узла ESXi.

псевдонимы: host
hostname
str
Имя хоста или IP-адрес сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной окружения VMWARE_HOST.
Поддержка переменных окружения добавлена в версии 2.6.
mtu Значение по умолчанию:
1500
MTU для настройки на коммутаторе vSwitch.
nics Значение по умолчанию:
[]
Список имен vmnic или имени vmnic для подключения к коммутатору vSwitch.
Псевдоним nics добавлен в версии 2.4.

псевдонимы: nic_name
number_of_ports Значение по умолчанию:
128
Количество портов для настройки на коммутаторе vSwitch.
password
str
Пароль сервера vCenter или ESXi vSphere.
Если значение не указано в задаче, используется значение переменной окружения VMWARE_PASSWORD.
Поддержка переменных окружения добавлена в версии 2.6.

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

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

псевдонимы: switch_name
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 5.5 и 6.5

Примеры

- name: Add a VMware vSwitch
  action:
    module: vmware_vswitch
    hostname: esxi_hostname
    username: esxi_username
    password: esxi_password
    switch: vswitch_name
    nics: vmnic_name
    mtu: 9000
  delegate_to: localhost

- name: Add a VMWare vSwitch without any physical NIC attached
  vmware_vswitch:
    hostname: 192.168.10.1
    username: admin
    password: password123
    switch: vswitch_0001
    mtu: 9000
  delegate_to: localhost

- name: Add a VMWare vSwitch with multiple NICs
  vmware_vswitch:
    hostname: esxi_hostname
    username: esxi_username
    password: esxi_password
    switch: vmware_vswitch_0004
    nics:
    - vmnic1
    - vmnic2
    mtu: 9000
  delegate_to: localhost

- name: Add a VMware vSwitch to a specific host system
  vmware_vswitch:
    hostname: 192.168.10.1
    username: esxi_username
    password: esxi_password
    esxi_hostname: DC0_H0
    switch_name: vswitch_001
    nic_name: vmnic0
    mtu: 9000
  delegate_to: localhost

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

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

Ключ Возвращаемое значение Описание
result
строка
всегда
информация об операции, которая была выполнена

Пример:
Коммутатор vSwitch 'vSwitch_1002' успешно создан


Статус

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

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

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

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

Автор

  • Joseph Callen (@jcpowermac)
  • Russell Teague (@mtnbikenc)
  • 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_vswitch_module.html

Spec-Zone.ru

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