netapp.ontap.na_ontap_qtree модуль – NetApp ONTAP управление Qtrees

Примечание

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

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

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

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

Новая функция в netapp.ontap 2.6.0

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Создание/изменение/удаление Qtrees.

Требования

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

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

Параметры

Параметр	Комментарии
cert_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6.
export_policy строка добавлено в netapp.ontap 2.9.0	Имя политики экспорта, которую необходимо применить.
feature_flags словарь добавлено в netapp.ontap 20.5.0	Включить или выключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются.
flexvol_name строка / обязательно	Имя FlexVol, на котором должна существовать qtree.
force_delete логический добавлено в netapp.ontap 20.8.0	Удалить qtree даже если файлы всё ещё существуют. Обратите внимание, что значение по умолчанию true отражает поведение REST API. Значение false не поддерживается с REST. Варианты: `false` `true` ← (по умолчанию)
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_name строка добавлено в netapp.ontap 2.7.0	Имя qtree, которое необходимо переименовать.
hostname строка / обязательно	Имя хоста или IP-адрес экземпляра ONTAP.
http_port целое число	Переопределить порт по умолчанию (80 или 443) на указанный порт
https логический	Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации по SSL-сертификату, так как она требует SSL. Варианты: `false` ← (по умолчанию) `true`
key_filepath строка добавлено в netapp.ontap 20.6.0	путь к файлу закрытого SSL-ключа клиента.
name строка / обязательно	Имя qtree, которое нужно управлять. В REST, это может быть и путь.
ontapi целое число	Версия API ontap для использования
oplocks строка добавлено в netapp.ontap 2.9.0	Включить или выключить oplocks для qtree. Варианты: `"enabled"` `"disabled"`
password псевдонимы: pass строка	Пароль для указанного пользователя.
security_style строка добавлено в netapp.ontap 2.9.0	Стиль безопасности для qtree. Варианты: `"unix"` `"ntfs"` `"mixed"`
state строка	Указывает, должна ли существовать указанная qtree. Варианты: `"present"` ← (по умолчанию) `"absent"`
time_out целое число добавлено в netapp.ontap 2.9.0	Максимальное время ожидания удаления qtree в секундах, когда wait_for_completion — True. Прекратить выполнение задачи, если она не завершится в указанное время. По умолчанию установлено 3 минуты. По умолчанию: `180`
unix_group строка добавлено в netapp.ontap 21.21.0	Группа, назначенная владельцем qtree. Поддерживается только с REST и ONTAP 9.9 или более поздних версий.

unix_permissions строка добавлен в netapp.ontap 2.9.0	Разрешения файла qtree. Принимает восьмеричный или строковый формат. Примеры: 0777, 777 в восьмеричном формате и —rwxrwxrwx, sstrwxrwxrwx, rwxrwxrwx в строковом формате.
unix_user строка добавлен в netapp.ontap 21.21.0	Пользователь, заданный как владелец qtree. Поддерживается только с REST и ONTAP 9.9 или более поздними версиями.
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` ← (по умолчанию)
vserver строка / обязательно	Имя vserver для использования.
wait_for_completion логическое значение добавлен в netapp.ontap 2.9.0	Применимо только для REST. При использовании ZAPI удаление всегда синхронное. Удаление qtree может занять время, если необходимо удалить много файлов. Установите этот параметр в ‘true’ для синхронного выполнения при удалении. Установите этот параметр в ‘false’ для асинхронного выполнения. Для асинхронного выполнения выполнение завершается сразу после отправки запроса, и qtree удаляется в фоновом режиме. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Create Qtrees.
  netapp.ontap.na_ontap_qtree:
    state: present
    name: ansibleQTree
    flexvol_name: ansibleVolume
    export_policy: policyName
    security_style: mixed
    oplocks: disabled
    unix_permissions: 0777
    vserver: ansibleVServer
    unix_user: user1
    unix_group: group1
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Rename Qtrees.
  netapp.ontap.na_ontap_qtree:
    state: present
    from_name: ansibleQTree
    name: ansibleQTree_rename
    flexvol_name: ansibleVolume
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: modify Qtrees unix_permissions using string format.
  netapp.ontap.na_ontap_qtree:
    state: present
    name: ansibleQTree_rename
    flexvol_name: ansibleVolume
    vserver: ansibleVServer
    unix_permissions: sstrwxrwxrwx
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: delete Qtrees.
  netapp.ontap.na_ontap_qtree:
    state: absent
    name: ansibleQTree_rename
    vserver: ansibleVServer
    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_qtree_module.html