Модуль netapp.ontap.na_ontap_fpolicy_policy — NetApp ONTAP — создание, удаление или изменение политики FPolicy.

Примечание

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

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

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

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

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

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

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

Создание, удаление или изменение политики FPolicy. Перед запуском этого модуля должна существовать область действия FPolicy.
FPolicy — это платформа уведомлений о доступе к файлам, позволяющая администратору отслеживать доступ к файлам и каталогам в хранилищах, настроенных для CIFS и NFS.

Требования

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

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

Параметры

Параметр	Комментарии
allow_privileged_access boolean	Указывает, следует ли предоставлять привилегированный доступ серверам FPolicy, зарегистрированным для этой политики. Варианты: `false` `true`
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
engine string	Имя обработчика. Внешние обработчики необходимо создать до запуска этой задачи.
events list / элементы=string / обязательный	События для мониторинга доступа к файлам.
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, где каждый элемент является целым числом. Если для `use_rest` установлено значение auto, это может привести к переключению на ZAPI с учётом версии и возможностей платформы. Игнорируется при использовании ZAPI.
hostname string / обязательный	Имя хоста или IP-адрес экземпляра ONTAP.
http_port integer	Переопределяет порт по умолчанию (80 или 443) указанным портом.
https boolean	Включение и отключение HTTPS. Игнорируется при использовании REST, так как поддерживается только HTTPS. Игнорируется при использовании аутентификации с помощью SSL-сертификата, так как для неё требуется SSL. Варианты: `false` ← (по умолчанию) `true`
is_mandatory boolean	Указывает, какое действие следует выполнить при событии доступа к файлу, если все основные и вторичные серверы недоступны или от серверов FPolicy не получен ответ в течение заданного периода ожидания. Если значение равно True, в этих случаях доступ к файлам будет запрещён. Варианты: `false` `true`
is_passthrough_read_enabled boolean	Указывает, следует ли разрешить серверам FPolicy, зарегистрированным для этой политики, чтение в режиме passthrough. Варианты: `false` `true`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
name string / обязательный	Имя политики.
ontapi integer	Версия API ONTAP, которую следует использовать.
password псевдонимы: pass string	Пароль указанного пользователя.
privileged_user_name string	Имя пользователя для привилегированного доступа.
state string	Определяет, должна ли существовать политика fPolicy. Варианты: `"present"` ← (по умолчанию) `"absent"`
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. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью SSL-сертификата: используется файл сертификата клиента SSL и, при необходимости, файл закрытого ключа. Чтобы использовать сертификат, его необходимо установить в кластере ONTAP, а аутентификация по сертификату должна быть включена.
validate_certs boolean	Если установлено значение `no`, SSL-сертификаты не будут проверяться. Это значение следует использовать только для `False` на контролируемых пользователем ресурсах с самоподписанными сертификатами. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Имя vserver, в котором следует создать политику.

Примечания

Примечание

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

Примеры

- name: Create FPolicy policy
  netapp.ontap.na_ontap_fpolicy_policy:
    state: present
    vserver: svm1
    name: fpolicy_policy
    events: fcpolicy_event
    engine: fpolicy_ext_engine
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Modify FPolicy policy
  netapp.ontap.na_ontap_fpolicy_policy:
    state: present
    vserver: svm1
    name: fpolicy_policy
    events: fcpolicy_event
    is_mandatory: false
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Delete FPolicy policy
  netapp.ontap.na_ontap_fpolicy_policy:
    state: absent
    vserver: svm1
    name: fpolicy_policy
    events: fcpolicy_event
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

Авторы

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