Модуль community.general.nictagadm — управление тегами NIC в системах SmartOS

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install community.general.

Чтобы использовать её в плейбуке, укажите: community.general.nictagadm.

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

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

Создание и удаление тегов NIC в системах SmartOS.

Параметры

Параметр	Комментарии
etherstub логический	Указывает, что тег NIC присоединён к созданному `etherstub`. Параметр `etherstub` несовместим с параметрами `mtu` и `mac`. Варианты: `false` ← (по умолчанию) `true`
force логический	Если `state=absent`, этот параметр использует параметр `-f` и удаляет тег NIC независимо от существующих виртуальных машин. Варианты: `false` ← (по умолчанию) `true`
mac строка	Указывает адрес `mac`, к которому нужно привязать тег NIC, если `etherstub` не создаётся. Параметры `mac` и `etherstub` несовместимы.
mtu целое число	Указывает размер `mtu` для нужного тега NIC. Параметры `mtu` и `etherstub` несовместимы.
name строка / обязательный	Имя тега NIC.
state строка	Создать или удалить тег NIC в SmartOS. Варианты: `"absent"` `"present"` ← (по умолчанию)

Атрибуты

Атрибут	Поддержка	Описание
check_mode	Поддержка: полная	Может работать в режиме `check_mode` и возвращать прогноз изменения состояния, не изменяя целевой объект.
diff_mode	Поддержка: отсутствует	В режиме сравнения возвращает сведения об изменениях (или о возможных изменениях в `check_mode`).

Примеры

- name: Create 'storage0' on '00:1b:21:a3:f5:4d'
  community.general.nictagadm:
    name: storage0
    mac: 00:1b:21:a3:f5:4d
    mtu: 9000
    state: present

- name: Remove 'storage0' nic tag
  community.general.nictagadm:
    name: storage0
    state: absent

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

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

Ключ	Описание
etherstub логический	Указывает, был ли создан тег NIC и присоединён ли он к etherstub. Возвращается: всегда Пример: `false`
force логический	Показывает, использовался ли параметр `-f` при удалении тега NIC. Возвращается: всегда Пример: `false`
mac строка	MAC-адрес, к которому был привязан тег NIC. Возвращается: всегда Пример: `"00:1b:21:a3:f5:4d"`
mtu целое число	Указывает размер MTU, переданный при выполнении команды nictagadm add. Параметры mtu и etherstub несовместимы. Возвращается: всегда Пример: `1500`
name строка	Имя тега NIC. Возвращается: всегда Пример: `"storage0"`
state строка	Состояние целевого объекта. Возвращается: всегда Пример: `"present"`

Авторы

Bruce Smith (@SmithX10)

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

© 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/general/nictagadm_module.html