netapp.ontap.na_ontap_net_ifgrp модуль – NetApp Ontap изменение группы сетевых интерфейсов

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 22.12.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные требования, см. Требования для получения подробностей.

Чтобы использовать его в плейбуке, укажите: netapp.ontap.na_ontap_net_ifgrp.

Новая функция в netapp.ontap 2.6.0

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Создание, изменение портов, удаление группы сетевых интерфейсов

Требования

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

Ansible 2.9 или более поздняя версия - рекомендуется 2.12 или более поздняя.
Python3 - рекомендуется 3.9 или более поздняя версия.
При использовании ZAPI, netapp-lib 2018.11.13 или более поздняя версия (установить с помощью ‘pip install netapp-lib’), netapp-lib 2020.3.12 рекомендуется для лучшего отчета об ошибках при подключении
физическая или виртуальная кластеризованная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и более поздние версии, поддержка REST требует ONTAP 9.6 или более поздние версии

Параметры

Параметр	Комментарии
broadcast_domain строка добавлен в netapp.ontap 21.14.0	Укажите имя broadcast_domain. Поддерживается только с REST и игнорируется с ZAPI. Требуется с ONTAP 9.6 и 9.7, но необязательно с 9.8 или более поздними версиями.
cert_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
distribution_function строка	Определяет функцию распределения трафика для ifgrp. Выбираемые значения: `"mac"` `"ip"` `"sequential"` `"port"`
feature_flags словарь добавлен в netapp.ontap 20.5.0	Включить или выключить новую функцию. Это может быть использовано для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version строка добавлен в netapp.ontap 21.23.0	Переопределить версию кластера ONTAP при использовании REST. Поведение неопределено, если версия не соответствует целевому кластеру. Это предоставляется как обходной путь, когда версия кластера не может быть прочитана из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Это должно быть в формате 9.10 или 9.10.1, где каждый элемент — целое число. Когда `use_rest` установлено в auto, это может привести к переключению на ZAPI в зависимости от версии и возможностей платформы. Игнорируется с ZAPI.
from_lag_ports список / элементы=строка добавлен в netapp.ontap 2.14.0	Поддерживается только с REST и игнорируется с ZAPI. Укажите все порты для поиска текущего порта LAG. Игнорируется, если LAG найден с точным соответствием `ports`. Например, если текущий LAG имеет порты `['e0c','e0d']` и `ports=['e0c','e0d']`, то from_lag_ports будет проигнорировано. Если LAG не найден с `ports`, тогда используются порты в этом списке для поиска текущего LAG. Порты в этом списке используются только для поиска текущего LAG, предоставьте точное соответствие всех портов в текущем LAG. Игнорируется, когда `state=absent`.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределите стандартный порт (80 или 443) этим портом
https логическое значение	Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. Выбираемые значения: `false` ← (по умолчанию) `true`
ipspace строка добавлен в netapp.ontap 21.14.0	Укажите ipspace для broadcast domain. Поддерживается только с REST и игнорируется с ZAPI. Требуется с ONTAP 9.6 и 9.7, но необязательно с 9.8 или более поздними версиями.
key_filepath строка добавлен в netapp.ontap 20.6.0	путь к файлу закрытого ключа SSL клиента.
mode строка	Указывает политику связи для ifgrp.
name строка	Указывает имя группы интерфейсов. Не поддерживается с REST, используйте `ports` или `from_lag_ports`. Имена LAG автоматически создаются в REST и возвращаются в выходные данные модуля. Требуется с ZAPI.
node строка / обязательно	Указывает имя узла.
ontapi целое число	Версия API ontap для использования
password псевдонимы: pass строка	Пароль для указанного пользователя.
ports псевдонимы: port список / элементы=строка добавлен в netapp.ontap 2.8.0	Список ожидаемых портов, которые должны присутствовать в группе интерфейсов. Если порт присутствует в этом списке, но отсутствует на целевом устройстве, он будет добавлен. Если порт отсутствует в списке, но присутствует на целевом устройстве, он будет удален. Убедитесь, что список содержит все порты, которые вы хотите увидеть на целевом устройстве. С REST порты в этом списке используются для поиска текущего порта LAG. Если LAG не найден или соответствие портам частичное, то `from_lag_port` используются для получения текущего LAG. С REST, когда `state=absent` установлено, все порты в ifgrp должны быть предоставлены для удаления. Например `ports=['e0c','e0a']` удалит ifgrp, который имеет порты `['e0c','e0a']`.

состояние строка	Указывает, должно ли существовать указанное сетевое интерфейсное устройство или нет. Варианты: `"present"` ← (по умолчанию) `"absent"`
использовать_rest строка	Указывает, использовать ли REST или ZAPI. always – всегда будет использовать REST API, если модуль его поддерживает. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если опция модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль его поддерживает. Возможна ошибка, если опция REST не поддерживается в ZAPI. auto – попытается использовать REST API, если модуль его поддерживает и опции модулей поддерживаются. В противном случае вернётся к ZAPI. По умолчанию: `"auto"`
имя_пользователя псевдонимы: пользователь строка	Это может быть учетная запись уровня кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации базовая аутентификация, используя имя пользователя и пароль, аутентификация с помощью сертификата SSL, используя файл сертификата SSL-клиента, и, необязательно, файл закрытого ключа. Для использования сертификата сертификат должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.
проверка_сертификатов логическое	Если установлено в `no`, сертификаты SSL не будут проверены. Это следует устанавливать только в `False` на сайтах, контролируемых лично, которые используют самозаверенные сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Модули с префиксом na_ontap созданы для поддержки платформы хранения ONTAP.
https включен по умолчанию и рекомендуется. Для включения http в кластере необходимо выполнить следующие команды «set -privilege advanced;» «system services web modify -http-enabled true;»

Примеры

- name: create ifgrp
  netapp.ontap.na_ontap_net_ifgrp:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    distribution_function: ip
    name: a0c
    ports: [e0a]
    mode: multimode
    node: "{{ Vsim node name }}"
- name: modify ports in an ifgrp
  netapp.ontap.na_ontap_net_ifgrp:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    distribution_function: ip
    name: a0c
    port: [e0a, e0c]
    mode: multimode
    node: "{{ Vsim node name }}"
- name: delete ifgrp
  netapp.ontap.na_ontap_net_ifgrp:
    state: absent
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    name: a0c
    node: "{{ Vsim node name }}"
- name: create ifgrp - REST
  netapp.ontap.na_ontap_net_ifgrp:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    distribution_function: ip
    ports: [e0a,e0b]
    mode: multimode
    node: "{{ Vsim node name }}"
    broadcast_domain: Default
    ipspace: Default
- name: Remove e0a and add port e0d to above created lag REST
  netapp.ontap.na_ontap_net_ifgrp:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    from_lag_ports: [a0a,e0b]
    ports: [e0b,e0d]
    node: "{{ Vsim node name }}"
- name: Add e0a to lag that has port e0b e0d REST
  netapp.ontap.na_ontap_net_ifgrp:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    distribution_function: ip
    ports: [e0b,e0d,e0a]
    mode: multimode
    node: "{{ Vsim node name }}"
- name: Modify broadcast_domain and ipspace REST
  netapp.ontap.na_ontap_net_ifgrp:
    state: present
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    broadcast_domain: test
    ipspace: test
    ports: [e0b,e0d,e0a]
    node: "{{ Vsim node name }}"
- name: Delete LAG with exact match of ports
  netapp.ontap.na_ontap_net_ifgrp:
    state: absent
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"
    ports: [e0b,e0d,e0a]
    node: "{{ Vsim node name }}"

Авторы

Команда NetApp Ansible (@carchi8py)

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

© 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/netapp/ontap/na_ontap_net_ifgrp_module.html