Spec-Zone.ru › Ansible

Модуль community.vmware.vmware_dvswitch_nioc — управление Network IO Control распределенного коммутатора

Примечание

Этот модуль входит в коллекцию community.vmware (версия 6.2.0).

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать коллекцию в плейбуке, укажите: community.vmware.vmware_dvswitch_nioc.

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Этот модуль предназначен для управления конфигурациями Network IO Control распределенного коммутатора.

Параметры

Параметр

Комментарии

hostname

string

Имя хоста или IP-адрес сервера vSphere vCenter.

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

password

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

string

Пароль сервера vSphere vCenter.

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

port

integer

Номер порта сервера vSphere vCenter.

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

По умолчанию: 443

proxy_host

string

Адрес прокси-сервера, который будет принимать все HTTPS-запросы и перенаправлять их.

Формат: имя хоста или IP-адрес.

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

proxy_port

integer

Порт HTTP-прокси, который будет принимать все HTTPS-запросы и перенаправлять их.

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

resources

list / элементы=dictionary

Список словарей, содержащих.

По умолчанию: []

limit

integer

Максимальное допустимое использование ресурсов для класса трафика, относящегося к этому пулу ресурсов, на одну физическую сетевую карту узла.

По умолчанию: -1

name

string / обязательный

Имя ресурса.

Варианты:

  • "faultTolerance"
  • "hbr"
  • "iSCSI"
  • "management"
  • "nfs"
  • "vdp"
  • "virtualMachine"
  • "vmotion"
  • "vsan"
  • "backupNfc"
  • "nvmetcp"

reservation

integer

Игнорируется, если для версии NIOC задано значение version2

Объем пропускной способности, гарантированно доступный классу трафика инфраструктуры узла.

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

Если задано ограничение, значение резервирования не должно превышать его.

Единица измерения — Мбит/с.

Игнорируется, если для версии задано значение, отличное от «version3».

Объем пропускной способности, гарантированно доступный классу трафика инфраструктуры узла.

По умолчанию: 0

shares

integer

Количество выделенных долей.

Игнорируется, если не задано resources[].shares_level=custom.

shares_level

string

Уровень распределения

Уровень представляет собой упрощенное отображение долей.

Уровням соответствуют заранее определенные числовые значения долей.

Варианты:

  • "low"
  • "normal"
  • "high"
  • "custom"

state

string

Включение или отключение NIOC на распределенном коммутаторе.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

switch

псевдоним: dvswitch

string / обязательный

Имя распределенного коммутатора.

username

псевдонимы: admin, user

string

Имя пользователя сервера vSphere vCenter.

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

validate_certs

boolean

Разрешает подключение, если SSL-сертификаты недействительны. Если сертификаты не являются доверенными, задайте значение false.

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

Варианты:

  • false
  • true ← (по умолчанию)

version

string

Версия Network IO Control.

Варианты:

  • "version2"
  • "version3"

Примечания

Примечание

  • Для всех модулей требуется доступ к API на запись, поэтому они не поддерживаются при использовании бесплатной лицензии ESXi.
  • Все переменные и имена объектов VMware чувствительны к регистру.
  • Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не применяет системное хранилище сертификатов. Указать хранилище сертификатов можно, задав переменную среды REQUESTS_CA_BUNDLE. Обратите внимание: в некоторых случаях при заданной переменной параметр ‘validate_certs’ со значением ‘false’ может быть проигнорирован. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- name: Enable NIOC
  community.vmware.vmware_dvswitch_nioc:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    version: version3
    resources:
        - name: vmotion
          limit: -1
          reservation: 128
          shares_level: normal
        - name: vsan
          limit: -1
          shares_level: custom
          shares: 99
          reservation: 256
    state: present
  delegate_to: localhost

- name: Disable NIOC
  community.vmware.vmware_dvswitch_nioc:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch: dvSwitch
    state: absent
  delegate_to: localhost

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

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

Ключ

Описание

dvswitch_nioc_status

string

Результат изменений

Возвращается: при успехе

resources_changed

list / элементы=string

Список измененных ресурсов

Возвращается: при успехе

Пример: ["vmotion", "vsan"]

Авторы

  • Joseph Andreatta (@vmwjoseph)

Ссылки на коллекцию

  • Отслеживание проблем
  • Домашняя страница
  • Репозиторий (исходный код)

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

Spec-Zone.ru

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