netapp.ontap.na_ontap_export_policy_rule – NetApp ONTAP управление правилами политики экспорта
Примечание
Этот плагин входит в сборку netapp.ontap (версия 20.12.0).
Для его установки используйте: ansible-galaxy collection install netapp.ontap
Для использования в плейбуке укажите: netapp.ontap.na_ontap_export_policy_rule
Новое в версии 2.6.0: сборки netapp.ontap
Обзор
- Создание, удаление или изменение правил экспорта в ONTAP
Требования
Ниже перечислены требования к хосту, на котором будет выполняться этот модуль.
- Физическая или виртуальная кластерная система 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;’
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| allow_suid логический |
| Если 'true', сервер NFS будет учитывать биты SetUID в операции SETATTR. Значение по умолчанию при создании - 'true' |
| anonymous_user_id целое число | Имя пользователя или ID, которому сопоставлены анонимные пользователи. Значение по умолчанию - '65534'. | |
| cert_filepath строка добавлен в 20.6.0 сборки netapp.ontap | Путь к файлу SSL-сертификата клиента (.pem). не поддерживается с Python 2.6. | |
| client_match список / элементы=строка | Список имен хостов, IP-адресов, сетевых групп или доменов для сопоставления клиентов. Если rule_index не указан, client_match используется в качестве ключа для получения текущего правила, чтобы определить действия создания, удаления, изменения. Если правило с заданным client_match существует, новое правило не будет создано, а существующее правило будет изменено или удалено. Если правило с заданным client_match не существует, новое правило будет создано, если state присутствует. | |
| feature_flags словарь добавлен в 20.5.0 сборки netapp.ontap | Включение или отключение новой функции. Это может быть использовано для включения экспериментальной функции или отключения новой функции, которая нарушает обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. | |
| hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. | |
| http_port целое число | Переопределить порт по умолчанию (80 или 443) с помощью этого порта | |
| https логический |
| Включение и отключение https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при использовании аутентификации с сертификатом SSL, так как она требует SSL. |
| key_filepath строка добавлен в 20.6.0 сборки netapp.ontap | Путь к файлу закрытого ключа SSL-клиента. | |
| name строка / обязательно | Имя политики экспорта, к которой будет добавлено (или изменено или удалено) это правило. псевдонимы: policy_name | |
| ontapi целое число | Версия ONTAP API для использования | |
| password строка | Пароль для указанного пользователя. псевдонимы: pass | |
| protocol список / элементы=строка |
| Список протоколов доступа клиентов. Значение по умолчанию при создании - 'any'. |
| ro_rule список / элементы=строка |
| Список спецификаций доступа только для чтения для правила. |
| rule_index целое число | Индекс правила политики экспорта. | |
| rw_rule список / элементы=строка |
| Список спецификаций доступа для чтения и записи для правила. |
| state строка |
| Нужно ли, чтобы указанное правило политики экспорта существовало. |
| super_user_security список / элементы=строка |
| Список спецификаций доступа для чтения и записи для правила. |
| use_rest строка | Значение по умолчанию: "auto" | API REST, если поддерживается целевой системой для всех ресурсов и атрибутов, необходимых модулю. В противном случае возвращается к ZAPI. always -- всегда будет использовать API REST never -- всегда будет использовать ZAPI auto -- будет пытаться использовать API REST |
| username строка | Это может быть учетная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или на уровне SVM. Дополнительную информацию можно найти в документации по адресу https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации 1. аутентификация по паролю, используя имя пользователя и пароль, 2. аутентификация с помощью сертификата SSL, используя файл сертификата клиента ssl и, необязательно, файл закрытого ключа. Для использования сертификата сертификат должен быть установлен в кластере ONTAP, а аутентификация с сертификатом должна быть включена. псевдонимы: user | |
| validate_certs логический |
| Если установлено в no, сертификаты SSL не будут проверены.Это следует устанавливать только в False используемых на сайтах, управляемых лично, с использованием самозаверенных сертификатов. |
| vserver строка / обязательно | Имя vserver для использования. |
Примечания
Примечание
- Модули с префиксом na\_ontap разработаны для поддержки платформы хранилища ONTAP.
Примеры
- name: Create ExportPolicyRule
na_ontap_export_policy_rule:
state: present
name: default123
vserver: ci_dev
client_match: 0.0.0.0/0,1.1.1.0/24
ro_rule: krb5,krb5i
rw_rule: any
protocol: nfs,nfs3
super_user_security: any
anonymous_user_id: 65534
allow_suid: true
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Modify ExportPolicyRule
na_ontap_export_policy_rule:
state: present
name: default123
rule_index: 100
client_match: 0.0.0.0/0
anonymous_user_id: 65521
ro_rule: ntlm
rw_rule: any
protocol: any
allow_suid: false
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
- name: Delete ExportPolicyRule
na_ontap_export_policy_rule:
state: absent
name: default123
rule_index: 100
vserver: ci_dev
hostname: "{{ netapp_hostname }}"
username: "{{ netapp_username }}"
password: "{{ netapp_password }}"
Авторы
- Команда 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_export_policy_rule_module.html