Модуль netapp.ontap.na_ontap_iscsi – Управление службой iSCSI в NetApp ONTAP

Примечание

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

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

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

Для использования в playbook, укажите: netapp.ontap.na_ontap_iscsi.

Новое в netapp.ontap 2.6.0

Краткое описание
Требования
Параметры
Примечания
Примеры

Краткое описание

создание, удаление, запуск, остановка службы iSCSI на SVM.

Требования

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

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 string added in netapp.ontap 20.6.0	путь к файлу сертификата клиента SSL (.pem). не поддерживается с python 2.6.
feature_flags dictionary added in netapp.ontap 20.5.0	Включить или отключить новую функцию. Это может использоваться для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.
force_ontap_version string added in 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.
hostname string / required	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределить порт по умолчанию (80 или 443) этим портом
https boolean	Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании проверки подлинности с помощью SSL-сертификата, так как это требует SSL. Варианты: `false` ← (default) `true`
key_filepath string added in netapp.ontap 20.6.0	путь к файлу закрытого ключа SSL.
ontapi integer	Используемая версия API ontap
password aliases: pass string	Пароль для указанного пользователя.
service_state string	Должна ли указанная служба работать. Варианты: `"started"` `"stopped"`
state string	Должна ли служба присутствовать или быть удалена. Варианты: `"present"` ← (default) `"absent"`
target_alias string added in netapp.ontap 22.2.0	Псевдоним целевого объекта iSCSI службы iSCSI. Псевдоним целевого объекта может содержать от одного (1) до 128 символов и включать любой печатный символ, кроме пробела (” “). Запрос PATCH с пустым псевдонимом (“”) очищает псевдоним. Этот параметр предназначен только для REST.
use_rest string	Использовать REST или ZAPI. always – всегда будет использовать REST API, если модуль поддерживает REST. Выдается предупреждение, если модуль не поддерживает REST. Выдается ошибка, если параметр модуля не поддерживается в REST. never – всегда будет использовать ZAPI, если модуль поддерживает ZAPI. Ошибка может быть выдана, если параметр REST не поддерживается в ZAPI. auto – будет пытаться использовать REST API, если модуль поддерживает REST и параметры модулей поддерживаются. В противном случае возвращается к ZAPI. По умолчанию: `"auto"`
username aliases: user string	Это может быть учетная запись в масштабе кластера или SVM, в зависимости от того, требуется ли API уровня кластера или SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации базовая аутентификация, используя имя пользователя и пароль, проверка подлинности с помощью SSL-сертификата, используя файл сертификата клиента ssl и, необязательно, файл закрытого ключа. Для использования сертификата сертификат должен быть установлен в кластере ONTAP, и должна быть включена аутентификация сертификатов.
validate_certs boolean	Если установлено в `no`, SSL-сертификаты не будут проверяться. Это должно быть установлено в `False` только на лично контролируемых сайтах, использующих самозаверяющие сертификаты. Варианты: `false` `true` ← (default)
vserver string / required	Имя используемого vserver.

Примечания

Примечание

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

Примеры

- name: Create iscsi service
  netapp.ontap.na_ontap_iscsi:
    state: present
    service_state: started
    vserver: ansibleVServer
    target_alias: ansibleSVM
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Stop Iscsi service
  netapp.ontap.na_ontap_iscsi:
    state: present
    service_state: stopped
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete Iscsi service
  netapp.ontap.na_ontap_iscsi:
    state: absent
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

NetApp Ansible Team (@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_iscsi_module.html