Модуль 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; используйте |
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, где каждый элемент является целым числом. Если для Игнорируется при использовании ZAPI. |
hostname string / обязательный | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port integer | Заменяет порт по умолчанию (80 или 443) указанным портом. |
https boolean | Включение и отключение HTTPS. Игнорируется при использовании REST, поскольку поддерживается только HTTPS. Игнорируется при использовании аутентификации по SSL-сертификату, так как для неё требуется SSL. Варианты:
|
is_scan_mandatory boolean | Указывает, разрешён ли доступ к файлу, если для сканирования на вирусы недоступны внешние серверы проверки на вирусы. Если параметр не указан, в ZAPI по умолчанию используется значение False. Варианты:
|
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. Варианты:
|
ontapi integer | Версия API ONTAP, которую следует использовать. |
password псевдонимы: pass string | Пароль указанного пользователя. |
paths_to_exclude list / elements=string | Пути к файлам, для которых не следует выполнять сканирование при доступе. |
policy_name string / обязательный | Имя политики. |
policy_status boolean добавлено в netapp.ontap 20.8.0 | Статус созданной политики. Варианты:
|
scan_files_with_no_ext boolean | Указывает, следует ли включать в сканирование файлы без расширения. Если параметр не указан, в ZAPI по умолчанию используется значение True. Варианты:
|
scan_readonly_volumes boolean добавлено в netapp.ontap 21.20.0 | Указывает, можно ли сканировать тома, доступные только для чтения. Если параметр не указан, при создании политики по умолчанию используется значение False. Варианты:
|
state string | Определяет, должна ли существовать политика Vscan при доступе. Варианты:
|
use_lambda boolean добавлено в netapp.ontap 23.2.0 | Указывает, следует ли использовать прокси-функциональность AWS Lambda для подключения к системе ONTAP. Поддерживается только при использовании REST. Варианты:
|
use_rest string | Определяет, использовать REST или ZAPI. always — всегда использовать REST API, если модуль поддерживает REST. Если модуль не поддерживает REST, будет выдано предупреждение. Если параметр модуля не поддерживается в REST, будет выдана ошибка. never — всегда использовать ZAPI, если модуль поддерживает ZAPI. Если параметр REST не поддерживается в ZAPI, может быть выдана ошибка. auto — попытаться использовать REST API, если модуль поддерживает REST и параметры модуля поддерживаются. В противном случае переключиться на ZAPI. По умолчанию: |
username псевдонимы: user string | Это может быть учётная запись уровня кластера или уровня SVM — в зависимости от того, требуется ли API уровня кластера или SVM. Дополнительные сведения см. в документации: https://docs.netapp.com/us-en/ontap/authentication/create-svm-user-accounts-task.html. Поддерживаются два способа аутентификации:
Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена. |
validate_certs boolean | Если установлено значение Значение Варианты:
|
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
Ссылки на коллекцию
© 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