Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_quotas – Квоты NetApp ONTAP

Примечание

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

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

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

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

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

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

Обзор

  • Установка/изменение/удаление квот на ONTAP

Требования

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

  • Ansible 2.9 или более поздней версии - рекомендуется 2.12 или более поздней.
  • Python3 - рекомендуется 3.9 или более поздней версии.
  • При использовании ZAPI, netapp-lib 2018.11.13 или более поздней версии (установка с помощью ‘pip install netapp-lib’), strongly рекомендуется netapp-lib 2020.3.12, так как она предоставляет более подробные сообщения об ошибках при подключении.
  • физическая или виртуальная кластеризованная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и более поздние версии, поддержка REST требует ONTAP 9.6 или более поздних версий

Параметры

Параметр

Комментарии

activate_quota_on_change

строка

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

Метод для активации квоты при изменении.

Значение по умолчанию — ‘resize’ в ZAPI.

При использовании REST, изменения лимитов правил квоты file_limit, disk_limit, soft_file_limit, и soft_disk_limit применяются автоматически без необходимости операции изменения размера квоты.

Варианты:

  • "resize"
  • "reinitialize"
  • "none"

cert_filepath

строка

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

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

не поддерживается с python 2.6.

disk_limit

строка

Объем дискового пространства, зарезервированного для целевого объекта.

Ожидается число, за которым следует B (для байтов), KB, MB, GB, TB.

Если единица измерения отсутствует, используется KB по умолчанию.

Примеры — 10MB, 20GB, 1TB, 20B, 10.

В REST, если лимит меньше 1024 байтов, значение округляется до 1024 байтов.

Используйте ‘-’ для сброса лимита дискового пространства.

feature_flags

словарь

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

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

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

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

file_limit

строка

Количество файлов, которое может иметь целевой объект.

Используйте ‘-’ для сброса лимита файлов.

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.

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 для использования

password

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

строка

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

perform_user_mapping

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

булево

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

Будет ли управление квотой выполнять сопоставление пользователей для пользователя, указанного в quota-target.

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

Варианты:

  • false
  • true

policy

строка

Имя политики квоты, из которой должно быть получено правило квоты.

Поддерживается только с ZAPI.

Несколько альтернативных политик квот (активная и резервная) не поддерживаются в REST.

REST управляет правилами квот активной политики.

qtree

строка

Имя qtree для квоты.

Для правил для пользователей или групп это может быть имя qtree или “” если qtree не используется.

Для правил типа дерева это поле должно быть “”.

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

quota_target

строка

Целевой объект квоты указанного типа.

Необходим для создания или изменения правила.

Пользователи и группы принимают значение quota_target в REST.

Для правил квот по умолчанию для пользователей и групп quota_target должен быть указан как “”.

set_quota_status

булево

Устанавливает, должно ли у указанного тома быть состояние квоты включенным или выключенным.

Варианты:

  • false
  • true

soft_disk_limit

строка

Объем дискового пространства, превышение которого приведет к записи сообщения и генерации SNMP-ловушки.

См. disk_limit для описания формата.

В REST, если лимит меньше 1024 байтов, значение округляется до 1024 байтов.

Используйте ‘-’ для сброса мягкого лимита дискового пространства.

soft_file_limit

string

Количество файлов, превышение которого целевым объектом приведет к записи сообщения и генерации SNMP-ловушки.

Используйте ‘-’ для сброса мягкого лимита файлов.

state

string

Определяет, должно ли существовать заданное ограничение.

Варианты:

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

threshold

string

Объём дискового пространства, превышение которого целевым объектом приведет к записи сообщения.

См. disk_limit для описания формата.

Поддерживается только с ZAPI.

type

string

Тип правила квоты

Требуется для создания или изменения правила.

Варианты:

  • "user"
  • "group"
  • "tree"

use_rest

string

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

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

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

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

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

username

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

string

Это может быть учетная запись кластерного или 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 ← (по умолчанию)

volume

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

Имя тома, на котором находится квота.

vserver

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

Имя vserver для использования.

Примечания

Примечание

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

Примеры

- name: Create quota rule in ZAPI.
  netapp.ontap.na_ontap_quotas:
    state: present
    vserver: ansible
    volume: ansible
    quota_target: user1
    type: user
    policy: ansible
    file_limit: 2
    disk_limit: 3
    set_quota_status: True
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Resize quota
  netapp.ontap.na_ontap_quotas:
    state: present
    vserver: ansible
    volume: ansible
    quota_target: user1
    type: user
    policy: ansible
    file_limit: 2
    disk_limit: 3
    set_quota_status: True
    activate_quota_on_change: resize
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Reinitialize quota
  netapp.ontap.na_ontap_quotas:
    state: present
    vserver: ansible
    volume: ansible
    quota_target: user1
    type: user
    policy: ansible
    file_limit: 2
    disk_limit: 3
    set_quota_status: True
    activate_quota_on_change: reinitialize
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: modify quota
  netapp.ontap.na_ontap_quotas:
    state: present
    vserver: ansible
    volume: ansible
    quota_target: user1
    type: user
    policy: ansible
    file_limit: 2
    disk_limit: 3
    threshold: 3
    set_quota_status: False
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Delete quota
  netapp.ontap.na_ontap_quotas:
    state: absent
    vserver: ansible
    volume: ansible
    quota_target: /vol/ansible
    type: user
    policy: ansible
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Add/Set quota rule for type user in REST.
  netapp.ontap.na_ontap_quotas:
    state: present
    vserver: ansible
    volume: ansible
    quota_target: "user1,user2"
    qtree: qtree
    type: user
    file_limit: 2
    disk_limit: 3
    set_quota_status: True
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Modify quota reset file limit and modify disk limit.
  netapp.ontap.na_ontap_quotas:
    state: present
    vserver: ansible
    volume: ansible
    quota_target: "user1,user2"
    qtree: qtree
    type: user
    file_limit: "-"
    disk_limit: 100
    set_quota_status: True
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Add/Set quota rule for type group in REST.
  netapp.ontap.na_ontap_quotas:
    state: present
    vserver: ansible
    volume: ansible
    quota_target: group1
    qtree: qtree
    type: group
    file_limit: 2
    disk_limit: 3
    set_quota_status: True
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
- name: Add/Set quota rule for type qtree in REST.
  netapp.ontap.na_ontap_quotas:
    state: present
    vserver: ansible
    volume: ansible
    quota_target: qtree1
    type: qtree
    file_limit: 2
    disk_limit: 3
    set_quota_status: True
    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_quotas_module.html

Spec-Zone.ru

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