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

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.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 или новее.
netapp-lib требуется только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание, что netapp-lib объявлен устаревшим и больше не поддерживается. Используйте на свой страх и риск.
Физическая или виртуальная кластерная система 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. Варианты: `"multimode"` `"multimode_lacp"` `"singlemode"`
name строка	Указывает имя группы интерфейсов. Не поддерживается с REST; используйте `ports` или `from_lag_ports`. В REST имена LAG создаются автоматически и возвращаются в выводе модуля. Обязательно при использовании ZAPI.
node строка / обязательный	Указывает имя узла.
ontapi целое число	Версия API ONTAP, которую следует использовать.
password псевдонимы: pass строка	Пароль указанного пользователя.
ports псевдонимы: port список / элементы=строка добавлено в netapp.ontap 2.8.0	Список портов, которые должны присутствовать в группе интерфейсов. Если порт указан в этом списке, но отсутствует на целевом узле, он будет добавлен. Если порт не указан в списке, но присутствует на целевом узле, он будет удален. Убедитесь, что список содержит все порты, которые должны присутствовать на целевом узле. В REST порты из этого списка используются для поиска текущего порта LAG. Если LAG не найден или совпадение найдено только для части портов, для поиска текущего LAG используются `from_lag_port`. В REST, если задано `state=absent`, для удаления ifgrp необходимо указать все его порты. Например, `ports=['e0c','e0a']` удалит ifgrp с портами `['e0c','e0a']`.
state строка	Определяет, должна ли указанная группа сетевых интерфейсов существовать. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda логическое значение добавлено в netapp.ontap 23.2.0	Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP. Поддерживается только с REST. Варианты: `false` ← (по умолчанию) `true`
use_rest строка	Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, выдается предупреждение. Если параметр модуля не поддерживается в REST, возникает ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может возникнуть ошибка. auto — попытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае используется ZAPI. По умолчанию: `"always"`
username псевдонимы: user строка	Это может быть учетная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью SSL-сертификата с использованием файла SSL-сертификата клиента и, при необходимости, файла закрытого ключа. Для использования сертификата его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs логическое значение	Если задано значение `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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/netapp/ontap/na_ontap_net_ifgrp_module.html