Spec-Zone.ru › Ansible

Модуль 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, где каждый элемент является целым числом.

Когда use_rest установлено в значение auto, это может привести к переключению на ZAPI в зависимости от версии и возможностей платформы.

Игнорируется с 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.

Варианты:

  • false ← (по умолчанию)
  • true

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

строка

Определяет, хотите ли вы создать или удалить маршрут сети.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

use_rest

строка

Использовать REST или ZAPI.

always – всегда будет использовать REST API, если модуль его поддерживает. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если параметр модуля не поддерживается в REST.

never – всегда будет использовать ZAPI, если модуль его поддерживает. Может быть выдана ошибка, если параметр REST не поддерживается в ZAPI.

auto – попытается использовать REST API, если модуль его поддерживает и параметры модуля поддерживаются. В противном случае переходит к ZAPI.

По умолчанию: "auto"

username

алиасы: user

строка

Это может быть учетная запись уровня кластера или SVM в зависимости от того, требуется ли API уровня кластера или SVM.

Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

Поддерживаются два метода аутентификации

  1. базовая аутентификация, используя имя пользователя и пароль,
  2. аутентификация по SSL-сертификату, используя файл SSL-сертификата клиента и, необязательно, файл закрытого ключа.

Для использования сертификата он должен быть установлен в кластер ONTAP, и должна быть включена аутентификация по сертификату.

validate_certs

boolean

Если установлено в no, сертификаты SSL не будут проверены.

Это следует устанавливать только в False на сайтах с собственными сертификатами, контролируемыми вручную.

Варианты:

  • false
  • true ← (по умолчанию)

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

Авторы

  • Команда 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_routes_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API