Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_fpolicy_ext_engine — конфигурация внешнего движка 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_ext_engine.

Добавлено в 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.

certificate_ca

string

Имя центра сертификации. Для этого поля не задано значение по умолчанию.

certificate_common_name

string

Полное доменное имя (FQDN) или пользовательское общее имя сертификата. Для этого поля не задано значение по умолчанию.

certificate_serial

string

Серийный номер сертификата. Для этого поля не задано значение по умолчанию.

extern_engine_type

string

Тип внешнего движка. Если движок асинхронный, серверы FPolicy не отправляют ответ. Значение по умолчанию для этого поля — synchronous.

Варианты:

  • "synchronous"
  • "asynchronous"

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_resiliency_enabled

boolean

Указывает, требуется ли отказоустойчивость для этого движка.

Если задано значение true, уведомления будут сохраняться по пути resiliency_directory_path.

Если задано значение false, уведомления сохраняться не будут. Значение по умолчанию — false.

Варианты:

  • false
  • true

key_filepath

string

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

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

max_connection_retries

integer

Количество попыток, которые устройство хранения предпримет для восстановления разорванного соединения с сервером FPolicy. Значение по умолчанию для этого поля — 5.

max_server_reqs

integer

Максимальное количество ожидающих запросов на проверку, которые будут поставлены в очередь для сервера FPolicy. Значение по умолчанию для этого поля — 50.

name

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

Имя внешнего движка.

ontapi

integer

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

password

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

string

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

port

integer

Номер порта приложения сервера FPolicy.

primary_servers

list / элементы=string

Основные серверы FPolicy.

recv_buffer_size

integer

Размер буфера приема подключенного сокета сервера FPolicy. Значение по умолчанию для этого поля — 256 килобайт (256 КБ).

resiliency_directory_path

string

Путь к каталогу в пределах Vserver для хранения уведомлений о доступе к файлам. Во время сбоя уведомления о доступе к файлам будут сохраняться в созданный файл.

Путь указывается полностью, в виде пути, видимого пользователю, относительно корня Vserver; он может проходить через точки подключения junction.

secondary_servers

list / элементы=string

Вторичные серверы FPolicy. Для этого поля не задано значение по умолчанию.

send_buffer_size

integer

Размер буфера отправки подключенного сокета сервера FPolicy. Значение по умолчанию для этого поля — 256 килобайт (256 КБ).

ssl_option

string

Параметр SSL для внешнего обмена данными. Для этого поля не задано значение по умолчанию.

Варианты:

  • "no_auth"
  • "server_auth"
  • "mutual_auth"

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.

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

  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 fPolicy external engine
  netapp.ontap.na_ontap_fpolicy_ext_engine:
    state: present
    vserver: svm1
    name: fpolicy_ext_engine
    port: 8787
    extern_engine_type: asynchronous
    primary_servers: ['10.11.12.13', '10.11.12.14']
    ssl_option: no_auth
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Modify fPolicy external engine
  netapp.ontap.na_ontap_fpolicy_ext_engine:
    state: present
    vserver: svm1
    name: fpolicy_ext_engine
    port: 7878
    extern_engine_type: synchronous
    primary_servers: ['10.11.12.15', '10.11.12.16']
    ssl_option: server_auth
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    hostname: "{{ netapp_hostname }}"

- name: Delete fPolicy external engine
  netapp.ontap.na_ontap_fpolicy_ext_engine:
    state: absent
    vserver: svm1
    name: fpolicy_engine
    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_ext_engine_module.html

Spec-Zone.ru

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