Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_qtree — управление qtree в NetApp ONTAP

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: netapp.ontap.na_ontap_qtree.

Добавлено в netapp.ontap 2.6.0

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

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

  • Создание, изменение и удаление qtree.

Требования

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

  • Ansible 2.9 или более поздней версии — рекомендуется версия 2.12 или более поздняя.
  • Python 3 — рекомендуется версия 3.9 или более поздняя.
  • netapp-lib, только при использовании ZAPI (установите с помощью «pip install netapp-lib»). Обратите внимание: netapp-lib устарела и больше не поддерживается. Используйте на свой страх и риск.
  • Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии; для работы REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр

Описание

cert_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу сертификата клиента SSL (.pem).

Не поддерживается в Python 2.6.

export_policy

string

добавлено в netapp.ontap 2.9.0

Имя применяемой политики экспорта.

feature_flags

dictionary

добавлено в netapp.ontap 20.5.0

Включение или отключение новой функции.

Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.

flexvol_name

псевдонимы: volume_name

string / обязательный

Имя FlexVol, в котором должна находиться qtree.

force_delete

boolean

добавлено в netapp.ontap 20.8.0

Следует ли удалять qtree, даже если в ней остались файлы.

Обратите внимание: значение по умолчанию true соответствует поведению REST API.

Значение false не поддерживается при использовании REST.

Варианты:

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

force_ontap_version

string

добавлено в 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

string

добавлено в netapp.ontap 2.7.0

Имя qtree, которую необходимо переименовать.

hostname

string / обязательный

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

integer

Переопределение порта по умолчанию (80 или 443) этим портом

https

boolean

Включение и отключение HTTPS.

Игнорируется при использовании REST, так как поддерживается только HTTPS.

Игнорируется при использовании аутентификации по сертификату SSL, так как для нее требуется SSL.

Варианты:

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

key_filepath

string

добавлено в netapp.ontap 20.6.0

Путь к файлу ключа клиента SSL.

lambda_config

dictionary

добавлено в netapp.ontap 23.5.0

Параметры конфигурации прокси-функции AWS Lambda.

Эти параметр и вложенные параметры поддерживаются только при использовании REST.

aws_profile

string

Имя профиля AWS, используемого для аутентификации.

aws_region

string / обязательный

Имя региона AWS.

function_name

string / обязательный

Имя вызываемой функции AWS Lambda.

name

string / обязательный

Имя управляемой qtree.

При использовании REST здесь также можно указать путь.

ontapi

integer

Версия API ONTAP для использования

oplocks

string

добавлено в netapp.ontap 2.9.0

Следует ли включить oplocks для qtree.

Варианты:

  • "enabled"
  • "disabled"

password

псевдонимы: pass

string

Пароль указанного пользователя.

security_style

string

добавлено в netapp.ontap 2.9.0

Стиль безопасности qtree.

Варианты:

  • "unix"
  • "ntfs"
  • "mixed"

state

string

Должна ли указанная qtree существовать.

Варианты:

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

time_out

integer

добавлено в netapp.ontap 2.9.0

Максимальное время ожидания удаления qtree в секундах, если для wait_for_completion задано значение True.

Возвращает ошибку, если задача не завершена за указанное время.

По умолчанию установлено значение 3 минуты.

По умолчанию: 180

unix_group

string

добавлено в netapp.ontap 21.21.0

Группа, назначенная владельцем qtree.

Необязательный параметр. Применим только для стилей безопасности Unix и mixed.

Игнорируется, если для security_style задано значение «ntfs».

Поддерживается только в REST и ONTAP 9.9 или более поздней версии.

unix_permissions

string

добавлено в netapp.ontap 2.9.0

Биты разрешений файлов для qtree.

Принимает восьмеричный формат или строковое представление.

Примеры: 0777, 777 в восьмеричном формате и ---rwxrwxrwx, sstrwxrwxrwx, rwxrwxrwx в строковом формате.

Необязательный параметр. Применим только для стилей безопасности Unix и mixed.

Игнорируется, если для security_style задано значение «ntfs».

unix_user

string

добавлено в netapp.ontap 21.21.0

Пользователь, назначенный владельцем qtree.

Необязательный параметр. Применим только для стилей безопасности Unix и mixed.

Игнорируется, если для security_style задано значение «ntfs».

Поддерживается только в REST и ONTAP 9.9 или более поздней версии.

use_lambda

boolean

добавлено в netapp.ontap 23.2.0

Указывает, следует ли использовать прокси-функцию AWS Lambda для подключения к системе ONTAP.

Поддерживается только при использовании REST.

Варианты:

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

use_rest

string

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

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

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

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

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

username

псевдонимы: user

string

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

Дополнительные сведения см. в документации https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html.

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

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

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

validate_certs

boolean

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

Задавать это значение следует только для False на сайтах, контролируемых лично вами и использующих самоподписанные сертификаты.

Варианты:

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

vserver

string / обязательный

Имя используемого vserver.

wait_for_completion

boolean

добавлено в netapp.ontap 2.9.0

Применимо только для REST. При использовании ZAPI удаление всегда выполняется синхронно.

Удаление qtree может занять время, если необходимо удалить много файлов.

Задайте для этого параметра значение «true», чтобы удаление выполнялось синхронно.

Задайте для этого параметра значение «false», чтобы удаление выполнялось асинхронно.

При асинхронном выполнении операция завершается сразу после отправки запроса, а qtree удаляется в фоновом режиме.

Варианты:

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

Примечания

Примечание

  • Поддерживается прокси-функция AWS Lambda при использовании REST. Примеры см. в файле README.
  • Модули с префиксом 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: 777
    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
    volume_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: Create Qtree with NTFS security style.
  netapp.ontap.na_ontap_qtree:
    state: present
    name: ntfsQTree
    flexvol_name: ansibleVolume
    security_style: ntfs
    vserver: ansibleVServer
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    # Note: unix_user, unix_group, and unix_permissions are not needed for NTFS security style

- 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–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/netapp/ontap/na_ontap_qtree_module.html

Spec-Zone.ru

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