Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_quotas — квоты NetApp ONTAP

Примечание

Этот модуль входит в коллекцию netapp.ontap (версия 23.5.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 или более поздняя.
  • netapp-lib — только при использовании ZAPI (устанавливается командой ‘pip install netapp-lib’). Обратите внимание, что netapp-lib устарела и больше не поддерживается. Используйте её на свой страх и риск.
  • Физическая или виртуальная кластерная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии; для поддержки REST требуется ONTAP 9.6 или более поздняя версия.

Параметры

Параметр

Комментарии

activate_quota_on_change

string

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

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

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

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

Варианты:

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

cert_filepath

string

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

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

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

disk_limit

string

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

Укажите число с единицей измерения: B (байты), KB, MB, GB или TB.

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

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

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

Чтобы сбросить ограничение на дисковое пространство, используйте ‘-’.

feature_flags

dictionary

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

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

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

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

file_limit

string

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

Чтобы сбросить ограничение на количество файлов, используйте ‘-’.

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.

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.

ontapi

integer

Версия API ONTAP, которую следует использовать.

password

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

string

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

perform_user_mapping

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

boolean

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

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

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

Варианты:

  • false
  • true

policy

string

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

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

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

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

qtree

string

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

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

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

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

quota_target

string

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

В REST для users и group используется значение quota_target.

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

set_quota_status

boolean

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

Варианты:

  • false
  • true

soft_disk_limit

string

Объём дискового пространства, превышение которого целевым объектом приводит к записи сообщения в журнал и созданию 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_lambda

boolean

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

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

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

Варианты:

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

use_rest

string

Определяет, использовать REST или ZAPI.

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

never — всегда использовать ZAPI, если модуль поддерживает 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 ← (по умолчанию)

volume

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

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

vserver

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

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

Примечания

Примечание

  • При использовании REST поддерживается прокси-функция AWS Lambda. Примеры см. в файле README.
  • Модули с префиксом 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: tree
    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–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_quotas_module.html

Spec-Zone.ru

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