Модуль netapp.ontap.na_ontap_local_hosts – Локальные хосты NetApp ONTAP

Примечание

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

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

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

Для использования в плейбуке укажите: netapp.ontap.na_ontap_local_hosts.

Новая функция в netapp.ontap 22.0.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 или более поздних версий.

END_OF_DOCUMENT_MARKER

Параметры

Параметр	Комментарии
address строка / обязательно	Адрес IPv4/IPv6 в точечной форме.
aliases список / элементы=строка	Список псевдонимов.
cert_filepath строка добавлено в netapp.ontap 20.6.0	Путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
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.
host строка	Каноническое имя хоста. минимальная длина — 1, максимальная — 255.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить стандартный порт (80 или 443) на этот порт
https булево	Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. Выбор: `false` ← (по умолчанию) `true`
key_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу закрытого ключа SSL-клиента.
ontapi целое число	Используемая версия api ontap
owner строка / обязательно	Имя SVM данных или кластера.
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/. Поддерживаются два метода аутентификации аутентификация по логину и паролю, аутентификация по 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 IP to host mapping
  netapp.ontap.na_ontap_local_hosts:
    state: present
    address: 10.10.10.10
    host: example.com
    aliases: ['ex1.com', 'ex2.com']
    owner: svm1
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Modify IP to host mapping
  netapp.ontap.na_ontap_local_hosts:
    state: present
    address: 10.10.10.10
    owner: svm1
    host: example1.com
    aliases: ['ex1.com', 'ex2.com', 'ex3.com']
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Delete host object
  netapp.ontap.na_ontap_local_hosts:
    state: absent
    address: 10.10.10.10
    owner: svm1
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

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