Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_vscan_on_access_policy — настройка политики Vscan при доступе в NetApp ONTAP.

Примечание

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

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

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

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

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

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

Описание

  • Настройка политики Vscan (проверки на вирусы) при доступе

Требования

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

  • 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_ext_to_exclude

list / elements=string

Расширения файлов, для которых не следует выполнять сканирование при доступе.

file_ext_to_include

list / elements=string

Расширения файлов, подлежащих сканированию при доступе. Значение по умолчанию — «*», то есть сканируются все файлы, кроме

исключённых из сканирования.

filters

list / elements=string

Список фильтров, позволяющих точнее определить область действия политики при доступе. Фильтры можно добавлять в любом порядке. Возможные значения:

scan_ro_volume — включить сканирование томов, доступных только для чтения;

scan_execute_access — сканировать только файлы, открытые с правом выполнения (только CIFS).

Устарело при использовании REST; используйте scan_readonly_volumes или only_execute_access.

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_scan_mandatory

boolean

Указывает, разрешён ли доступ к файлу, если для сканирования на вирусы недоступны внешние серверы проверки на вирусы.

Если параметр не указан, в ZAPI по умолчанию используется значение False.

Варианты:

  • false
  • true

key_filepath

string

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

Путь к файлу ключа клиента SSL.

max_file_size

integer

Максимальный размер файла (в байтах), разрешённый для сканирования. Если при создании политики значение не указано, используется значение по умолчанию 2147483648 (2 ГБ).

only_execute_access

boolean

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

Сканировать только файлы, открытые с правом выполнения.

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

Варианты:

  • false
  • true

ontapi

integer

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

password

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

string

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

paths_to_exclude

list / elements=string

Пути к файлам, для которых не следует выполнять сканирование при доступе.

policy_name

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

Имя политики.

policy_status

boolean

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

Статус созданной политики.

Варианты:

  • false
  • true

scan_files_with_no_ext

boolean

Указывает, следует ли включать в сканирование файлы без расширения.

Если параметр не указан, в ZAPI по умолчанию используется значение True.

Варианты:

  • false
  • true

scan_readonly_volumes

boolean

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

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

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

Варианты:

  • false
  • true

state

string

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

Варианты:

  • "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.

Поддерживаются два способа аутентификации:

  1. Обычная аутентификация с использованием имени пользователя и пароля.
  2. Аутентификация по 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 Vscan On Access Policy
  netapp.ontap.na_ontap_vscan_on_access_policy:
    state: present
    username: '{{ netapp_username }}'
    password: '{{ netapp_password }}'
    hostname: '{{ netapp_hostname }}'
    vserver: carchi-vsim2
    policy_name: carchi_policy
    file_ext_to_exclude: ['exe', 'yml']
- name: Create Vscan On Access Policy with Policy Status enabled
  netapp.ontap.na_ontap_vscan_on_access_policy:
    state: present
    username: '{{ netapp_username }}'
    password: '{{ netapp_password }}'
    hostname: '{{ netapp_hostname }}'
    vserver: carchi-vsim2
    policy_name: carchi_policy
    file_ext_to_exclude: ['exe', 'yml']
    policy_status: true
- name: Modify Vscan on Access Policy
  netapp.ontap.na_ontap_vscan_on_access_policy:
    state: present
    username: '{{ netapp_username }}'
    password: '{{ netapp_password }}'
    hostname: '{{ netapp_hostname }}'
    vserver: carchi-vsim2
    policy_name: carchi_policy
    file_ext_to_exclude: ['exe', 'yml', 'py']
- name: Delete On Access Policy
  netapp.ontap.na_ontap_vscan_on_access_policy:
    state: absent
    username: '{{ netapp_username }}'
    password: '{{ netapp_password }}'
    hostname: '{{ netapp_hostname }}'
    vserver: carchi-vsim2
    policy_name: carchi_policy

Авторы

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

Spec-Zone.ru

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