Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_mav_config — глобальная настройка многоадминистраторской проверки (MAV) NetApp ONTAP

Примечание

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

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

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

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

Новый модуль в netapp.ontap 23.0.0

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

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

  • Включение или отключение конфигурации многоадминистраторской проверки (MAV).
  • Для включения функции многоадминистраторская проверка не требуется. Однако она необходима для отключения функции.
  • Если включено многоадминистраторское утверждение, для внесения любых изменений требуется многоадминистраторская проверка.
  • Пока ожидающий запрос не будет утверждён, информация о запросе возвращается в выводе модуля. После утверждения модуль необходимо запустить повторно, чтобы применить требуемые изменения.

Требования

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

  • 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 или новее.

Параметры

Параметр

Комментарии

approval_expiry

string

Указывает время в формате длительности ISO-8601, в течение которого после отправки нового запроса на выполнение утверждающие лица могут утвердить или отклонить запрос до истечения срока его действия.

Значение по умолчанию — один час (PT1H), минимальное поддерживаемое значение — одна секунда (PT1S), максимальное поддерживаемое значение — 14 дней (P14D).

approval_groups

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

Указывает список глобальных групп утверждения, наследуемых правилом, если для этого правила не задан параметр approval-groups.

Значение по умолчанию — пустой список.

cert_filepath

string

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

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

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

enabled

boolean

Указывает, настроено ли в данный момент многоадминистраторское утверждение.

По умолчанию функция отключена, а значение равно false.

Варианты:

  • false ← (по умолчанию)
  • true

execution_expiry

string

Указывает время в формате длительности ISO-8601, в течение которого после утверждения запроса уполномоченные пользователи могут выполнить запрошенную операцию до истечения срока действия запроса.

Значение по умолчанию — один час (PT1H), минимальное поддерживаемое значение — одна секунда (PT1S), максимальное поддерживаемое значение — 14 дней (P14D).

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, причём каждый элемент должен быть целым числом.

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

password

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

string

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

required_approvers

integer

Указывает необходимое количество утверждающих лиц для утверждения запроса; это значение наследуется правилом, если для него не задан параметр required-approvers.

Значение по умолчанию и минимальное количество утверждающих лиц — 1.

state

string

Изменение глобальной настройки MAV; поддерживается только состояние present.

Варианты:

  • "present" ← (по умолчанию)

use_lambda

boolean

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

Указывает, следует ли использовать функцию прокси AWS Lambda для подключения к системе ONTAP.

Поддерживается только с REST.

Варианты:

  • false ← (по умолчанию)
  • true

use_rest

string

Этот модуль поддерживает только REST.

always — всегда использовать REST API. Если модуль не поддерживает REST, выводится предупреждение.

По умолчанию: "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 ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Enable multi-admin approval
  netapp.ontap.na_ontap_mav_config:
    state: present
    enabled: true
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

- name: Update MAV configuration
  netapp.ontap.na_ontap_mav_config:
    state: present
    approval_groups: ["group1", "group2"]
    execution_expiry: "P14D"
    approval_expiry: "P14D"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

# this generates multi-admin-verify request which needs approval
- name: Disable multi-admin approval
  netapp.ontap.na_ontap_mav_config:
    state: present
    enabled: false
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"
    use_rest: always

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

request_info

dictionary

Возвращает сведения о запросе multi-admin-verify при попытке отключить глобальную настройку MAV; при включении или изменении возвращается пустое значение.

Возвращается: всегда

Пример: {"request_info": {"calling: security/multi-admin-verify: got {'message': 'The security multi-admin-verify request (index 1) requires approval.', 'code': '262325'}.": null}}

Авторы

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

Spec-Zone.ru

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