netapp.ontap.na_ontap_vscan_on_demand_task – Настройка задачи NetApp ONTAP Vscan по запросу.
Примечание
Этот плагин входит в состав коллекции netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap.
Для использования в плейбуке укажите: netapp.ontap.na_ontap_vscan_on_demand_task.
Новое в версии 2.8.0: для netapp.ontap
Обзор
- Настройка задачи Vscan по запросу
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- Физическая или виртуальная кластеризованная система Data ONTAP. Модули поддерживают Data ONTAP 9.1 и более поздние версии.
- Поддержка REST требует ONTAP 9.6 или более поздней версии.
- Ansible 2.6
- Сильно рекомендуется использовать Ansible 2.9 или более поздней версии, так как это позволяет использовать новую систему доставки коллекций.
- Python2 netapp-lib (2017.10.30) или более поздняя версия. Установите с помощью «pip install netapp-lib»
- Python3 netapp-lib (2018.11.13) или более поздняя версия. Установите с помощью «pip install netapp-lib»
- Сильно рекомендуется использовать netapp-lib 2020.3.12, так как он обеспечивает более подробную отчетность об ошибках при подключении.
- Для включения HTTP в кластере необходимо выполнить следующие команды: «set -privilege advanced;» «system services web modify -http-enabled true;»
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| cert_filepath строка добавлен в 20.6.0 версии netapp.ontap | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с Python 2.6. | |
| cross_junction булево |
| Указывает, разрешено ли задаче по запросу пересекать соединения томов |
| directory_recursion булево |
| Указывает, разрешено ли задаче по запросу рекурсивно сканировать подкаталоги. |
| feature_flags словарь добавлен в 20.5.0 версии netapp.ontap | Включение или отключение новой функции. Это может быть использовано для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| file_ext_to_exclude список / элементы=строка | Расширения файлов, для которых не должно выполняться сканирование. Файлы, расширение которых совпадает с включенным и исключенным списком, не рассматриваются для сканирования. | |
| file_ext_to_include список / элементы=строка | Расширения файлов, для которых выполняется сканирование. Значение по умолчанию — «*», что означает, что все файлы рассматриваются для сканирования, за исключением исключенных. Файлы, расширение которых совпадает с включенным и исключенным списком, не рассматриваются для сканирования. | |
| hostname строка / требуется | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределите порт по умолчанию (80 или 443) с помощью этого порта | |
| https булево |
| Включить и выключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации с сертификатом SSL, так как это требует SSL. |
| key_filepath строка добавлен в 20.6.0 версии netapp.ontap | путь к файлу ключа SSL-клиента. | |
| max_file_size строка | Максимальный размер файла (в байтах), разрешенный для сканирования. Значение по умолчанию 10737418240 (10 ГБ) используется, если оно не указано при создании задачи. | |
| ontapi целое число | Версия API ontap для использования | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| paths_to_exclude список / элементы=строка | Пути к файлам, для которых не должно выполняться сканирование. | |
| report_directory строка | Путь от корня vserver, где создается отчет задачи. Путь должен быть каталогом и указан в формате Unix от корня Vserver. Пример /vol1/on-demand-reports. | |
| report_log_level строка |
| Уровень ведения журнала для отчета по запросу. |
| request_timeout строка | Общее ограничение времени обслуживания запроса в секундах. Если вирусный сканер не отвечает в течение указанного времени, сканирование будет прервано по таймауту. | |
| scan_files_with_no_ext булево |
| Указывает, рассматриваются ли файлы без расширения для сканирования или нет. |
| scan_paths список / элементы=строка | Список путей, которые нужно отсканировать. Путь должен быть указан в формате Unix от корня Vserver. Пример /vol1/large_files. | |
| scan_priority строка |
| Приоритет запросов на сканирование по запросу, созданных этой задачей. |
| schedule строка | График задачи. Задача будет выполняться в соответствии с графиком. Для немедленного запуска задачи необходимо использовать api vscan-on-demand-task-run после создания задачи. | |
| state строка |
| Наличие или отсутствие задачи Vscan по запросу. |
| task_name строка / требуется | Имя задачи. | |
| use_rest строка | Значение по умолчанию: "auto" | REST API, если оно поддерживается целевой системой для всех ресурсов и атрибутов, которые необходимы модулю. В противном случае используется ZAPI. всегда -- всегда использует REST API никогда -- всегда использует ZAPI автоматически -- попытается использовать REST API |
| username строка | Это может быть учетная запись на уровне кластера или на уровне SVM, в зависимости от того, требуется API на уровне кластера или на уровне SVM. Дополнительную информацию можно найти в документации https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. аутентификация по протоколу Basic с использованием имени пользователя и пароля, 2. аутентификация с помощью сертификата SSL с использованием файла SSL-сертификата клиента и необязательно файла закрытого ключа. Для использования сертификата сертификат должен быть установлен в кластере ONTAP, а аутентификация с помощью сертификата должна быть включена. псевдонимы: user | |
| validate_certs булево |
| Если установлено no, сертификаты SSL не будут проверены.Это следует устанавливать только False при использовании на контролируемых лично сайтах с использованием самозаверяющих сертификатов. |
| vserver строка / требуется | Имя виртуального сервера данных для использования. |
Примечания
Примечание
- Модули с префиксом na_ontap разработаны для поддержки платформы хранения ONTAP.
Примеры
- name: Create Vscan On Demand Task
na_ontap_vscan_on_demand_task:
state: present
username: '{{ netapp_username }}'
password: '{{ netapp_password }}'
hostname: '{{ netapp_hostname }}'
vserver: carchi-vsim2
task_name: carchiOnDemand
scan_paths: /
report_directory: /
file_ext_to_exclude: ['py', 'yml']
max_file_size: 10737418241
paths_to_exclude: ['/tmp', '/var']
report_log_level: info
request_timeout: 60
- name: Delete Vscan On Demand Task
na_ontap_vscan_on_demand_task:
state: absent
username: '{{ netapp_username }}'
password: '{{ netapp_password }}'
hostname: '{{ netapp_hostname }}'
vserver: carchi-vsim2
task_name: carchiOnDemand
Авторы
- Команда NetApp Ansible (@carchi8py) <ng-ansibleteam@netapp.com>
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/netapp/ontap/na_ontap_vscan_on_demand_task_module.html