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

Примечание

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

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

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

Для использования в плейбуке укажите: community.general.nictagadm.

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

Описание

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

Параметры

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

Атрибуты

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

Примеры

- 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

END_OF_DOCUMENT_MARKER

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

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

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

Авторы

Брюс Смит (@SmithX10)

Ссылки на сборку

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/general/nictagadm_module.html