Spec-Zone.ru › Ansible

модуль netapp.ontap.na_ontap_fpolicy_event – настройка события политики FPolicy NetApp ONTAP

Примечание

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

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

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

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

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

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

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

  • Создание, удаление или изменение события политики FPolicy.

Требования

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

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

Параметры

Параметр

Комментарии

cert_filepath

string

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

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

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

feature_flags

dictionary

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

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

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

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

file_operations

list / elements=string

Названия файловых операций, применяемых к событию. По умолчанию операции не отслеживаются.

Варианты:

  • "close"
  • "create"
  • "create_dir"
  • "delete"
  • "delete_dir"
  • "getattr"
  • "link"
  • "lookup"
  • "open"
  • "read"
  • "write"
  • "rename"
  • "rename_dir"
  • "setattr"
  • "symlink"

filters

list / elements=string

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

Варианты:

  • "monitor_ads"
  • "close_with_modification"
  • "close_without_modification"
  • "first_read"
  • "first_write"
  • "offline_bit"
  • "open_with_delete_intent"
  • "open_with_write_intent"
  • "write_with_size_change"
  • "close_with_read"
  • "setattr_with_owner_change"
  • "setattr_with_group_change"
  • "setattr_with_sacl_change"
  • "setattr_with_dacl_change"
  • "setattr_with_modify_time_change"
  • "setattr_with_access_time_change"
  • "setattr_with_creation_time_change"
  • "setattr_with_mode_change"
  • "setattr_with_size_change"
  • "setattr_with_allocation_size_change"
  • "exclude_directory"

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-клиента.

name

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

Имя события.

ontapi

integer

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

password

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

string

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

protocol

string

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

Варианты:

  • "cifs"
  • "nfsv3"
  • "nfsv4"

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, выводится ошибка.

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

auto — пытаться использовать REST API, если модуль его поддерживает и параметры модуля совместимы. В противном случае использовать 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_monitoring

boolean

Указывает, требуется ли для события операция с томом. Если параметр не задан, значение по умолчанию — false.

Варианты:

  • false
  • true

vserver

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

Имя vserver, в котором создаётся событие.

Примечания

Примечание

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

Примеры

- name: Create FPolicy Event
  netapp.ontap.na_ontap_fpolicy_event:
    state: present
    vserver: svm1
    name: fpolicy_event
    file_operations: ['create', 'create_dir', 'delete', 'delete_dir', 'read', 'close', 'rename', 'rename_dir']
    filters: ['first_read', 'close_with_modification']
    protocol: cifs
    volume_monitoring: false
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Modify FPolicy Event
  netapp.ontap.na_ontap_fpolicy_event:
    state: present
    vserver: svm1
    name: fpolicy_event
    volume_monitoring: true
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Delete FPolicy Event
  netapp.ontap.na_ontap_fpolicy_event:
    state: absent
    vserver: svm1
    name: fpolicy_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_event_module.html

Spec-Zone.ru

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