модуль netapp.ontap.na_ontap_mav_rule — правило многоадминистраторской проверки (MAV) NetApp ONTAP

Примечание

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

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

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

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

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

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

Обзор

Создание, изменение и удаление правила многоадминистраторской проверки (MAV).

Требования

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

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 или более поздняя версия.

Параметры

Параметр	Комментарии
approval_expiry string	Задаёт время в формате длительности ISO-8601, в течение которого утверждающие могут одобрить или отклонить запрос после отправки нового запроса на выполнение. По истечении этого времени запрос становится недействительным. Значение по умолчанию — один час (PT1H), минимально поддерживаемое значение — одна секунда (PT1S), максимально поддерживаемое значение — 14 дней (P14D).
approval_groups list / elements=string	Задаёт список групп утверждения, которым разрешено одобрять запросы для правил, у которых не указаны группы утверждения.
auto_request_create boolean	Если значение равно true, ONTAP автоматически создаёт запрос для каждой неудачной операции, для которой нет соответствующего ожидающего запроса. По умолчанию — True. Варианты: `false` `true`
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
execution_expiry string	Задаёт время в формате длительности ISO-8601, в течение которого авторизованные пользователи могут выполнить запрошенную операцию после одобрения запроса. По истечении этого времени запрос становится недействительным. Значение по умолчанию — один час (PT1H), минимально поддерживаемое значение — одна секунда (PT1S), максимально поддерживаемое значение — 14 дней (P14D).
feature_flags dictionary добавлено в netapp.ontap 20.5.0	Включение или отключение новой функции. Можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут меняться без уведомления. Неизвестные ключи игнорируются.
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, причём каждый элемент должен быть целым числом.
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.
operation string / обязательный	Задаёт команду, для выполнения которой требуется одно или несколько одобрений.
password псевдонимы: pass string	Пароль указанного пользователя.
query string	Задаёт сведения запроса, применяемые к подмножеству объектов операции ONTAP, указанной в правиле.
required_approvers integer	Задаёт необходимое количество утверждающих, не включая пользователя, создавшего запрос. По умолчанию и минимальное необходимое количество утверждающих равно 1.
state string	Задаёт, следует ли создать или изменить указанное правило либо удалить его. Варианты: `"present"` ← (по умолчанию) `"absent"`
use_lambda boolean добавлено в netapp.ontap 23.4.0	Задаёт, следует ли использовать прокси-функцию AWS Lambda для подключения к системе ONTAP. Поддерживается только с REST. Варианты: `false` ← (по умолчанию) `true`
use_rest string	Этот модуль поддерживает только REST. always — всегда использовать REST API. Если модуль не поддерживает REST, выдаётся предупреждение. По умолчанию: `"always"`
username псевдонимы: user string	Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, какой API, кластерный или SVM, требуется использовать. Дополнительную информацию см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация по SSL-сертификату с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.
validate_certs boolean	Если задано значение `no`, SSL-сертификаты не будут проверяться. Это следует задавать только как `False` на контролируемых пользователем сайтах, использующих самозаверенные сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Create a rule
  netapp.ontap.na_ontap_mav_rule:
    state: present
    auto_request_create: true
    required_approvers: 1
    approval_groups: ["group1", "group2"]
    approval_expiry: "P14D"
    execution_expiry: "P14D"
    operation: "volume delete"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Update a rule
  netapp.ontap.na_ontap_mav_rule:
    state: present
    query: "-vserver svm1"
    operation: "volume delete"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Delete a rule
  netapp.ontap.na_ontap_mav_rule:
    state: absent
    operation: "volume delete"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

Авторы

Команда 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_mav_rule_module.html