Модуль netapp.ontap.na_ontap_net_routes – Маршруты сети 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_routes.
Добавлен в netapp.ontap 2.6.0
Описание
- Изменение маршрутов сети ONTAP.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- 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 или более поздней версии
Параметры
Параметр | Комментарии |
|---|---|
cert_filepath строка добавлено в netapp.ontap 20.6.0 | путь к файлу сертификата SSL-клиента (.pem). не поддерживается с python 2.6. |
destination строка / обязательно | Укажите пункт назначения маршрута. Пример 10.7.125.5/20, fd20:13::/64. |
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, где каждый элемент является целым числом. Когда Игнорируется с ZAPI. |
from_destination строка добавлено в netapp.ontap 2.8.0 | Укажите пункт назначения маршрута, который следует изменить. |
from_gateway строка добавлено в netapp.ontap 2.8.0 | Укажите шлюз маршрута, который следует изменить. |
from_metric целое число добавлено в netapp.ontap 2.8.0 | Укажите метрику маршрута, которая должна быть изменена. Этот параметр игнорируется, так как значение считывается из ONTAP. Не поддерживается с REST, игнорируется с ZAPI. |
gateway строка / обязательно | Укажите шлюз маршрута. Пример 10.7.125.1, fd20:13::1. |
hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port целое число | Переопределите порт по умолчанию (80 или 443) этим портом |
https логическое значение | Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как требуется SSL. Варианты:
|
key_filepath строка добавлено в netapp.ontap 20.6.0 | путь к файлу ключа SSL-клиента. |
metric целое число | Укажите метрику маршрута. Если этот параметр не указан, ONTAP по умолчанию будет 20. Поддерживается с ONTAP 9.11.0 в REST. При использовании REST, попытка изменения пункта назначения или шлюза также сбросит метрику до 20 в ONTAP 9.10.1 или более ранних версиях. |
ontapi целое число | Версия API ontap для использования |
password алиасы: pass строка | Пароль для указанного пользователя. |
state строка | Определяет, хотите ли вы создать или удалить маршрут сети. Варианты:
|
use_rest строка | Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль его поддерживает. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если параметр модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI. auto – попытается использовать REST API, если модуль его поддерживает и параметры модуля поддерживаются. В противном случае переходит к ZAPI. По умолчанию: |
username алиасы: user строка | Это может быть учетная запись уровня кластера или SVM в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации
Для использования сертификата он должен быть установлен в кластер ONTAP, и должна быть включена аутентификация по сертификату. |
validate_certs boolean | Если установлено в Это следует устанавливать только в Варианты:
|
vserver string | Имя vserver. Требуется при использовании ZAPI. При использовании REST, опустите этот параметр для маршрутов уровня кластера или установите его в NULL. |
Примечания
Примечание
- Модули, начинающиеся с na_ontap, разработаны для поддержки платформы хранения ONTAP.
- https включен по умолчанию и рекомендуется. Чтобы включить http в кластере, необходимо выполнить следующие команды: ‘set -privilege advanced;’ ‘system services web modify -http-enabled true;’
Примеры
- name: create route
netapp.ontap.na_ontap_net_routes:
state: present
vserver: "{{ Vserver name }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
hostname: "{{ netapp_hostname }}"
destination: 10.7.125.5/20
gateway: 10.7.125.1
metric: 30
- name: create route - cluster scope, using REST
netapp.ontap.na_ontap_net_routes:
state: present
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
hostname: "{{ netapp_hostname }}"
destination: 10.7.125.5/20
gateway: 10.7.125.1
- name: create route - vserver scope, using REST
netapp.ontap.na_ontap_net_routes:
state: present
vserver: "{{ Vserver name }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
hostname: "{{ netapp_hostname }}"
destination: 10.7.125.5/20
gateway: 10.7.125.1
Ссылки на сборку
© 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_routes_module.html