Spec-Zone.ru › Ansible

модуль netapp.ontap.na_ontap_export_policy_rule — управление правилами политики экспорта NetApp ONTAP

Примечание

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

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

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

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

Добавлено в netapp.ontap 2.6.0

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

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

  • Создание, удаление и изменение правил экспорта в ONTAP

Требования

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

  • 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 или более поздней версии.

Параметры

Параметр

Комментарии

allow_device_creation

boolean

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

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

По умолчанию — true.

В REST поддерживается начиная с ONTAP 9.9.1.

Варианты:

  • false
  • true

allow_suid

boolean

Если значение равно ‘true’, сервер NFS будет учитывать биты SetUID в операции SETATTR. Значение по умолчанию при создании — ‘true’

Варианты:

  • false
  • true

anonymous_user_id

string

Имя пользователя или идентификатор, которому сопоставляются анонимные пользователи. Значение по умолчанию — ‘65534’.

cert_filepath

string

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

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

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

chown_mode

string

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

Указывает, кому разрешено изменять режим владения файлом.

В REST поддерживается начиная с ONTAP 9.9.1.

Варианты:

  • "restricted"
  • "unrestricted"

client_match

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

Список имен узлов, IP-адресов, сетевых групп или доменов для сопоставления клиента.

feature_flags

dictionary

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

Включение или отключение новой функции.

Этот параметр можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость.

Поддерживаемые ключи и значения могут изменяться без предварительного уведомления. Неизвестные ключи игнорируются.

force_delete_on_first_match

boolean

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

Если параметр rule_index не задан, по умолчанию при нескольких совпадениях сообщается об ошибке.

Если этот параметр задан, при state со значением absent удаляется одно из правил с точным совпадением.

Игнорируется, если state имеет значение present.

Варианты:

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

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.

from_rule_index

integer

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

Индекс правила политики экспорта, которому необходимо назначить новый индекс

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.

lambda_config

dictionary

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

Параметры конфигурации функции прокси-сервера AWS Lambda.

Этот параметр и его подпараметры поддерживаются только в REST.

aws_profile

string

Имя профиля AWS, используемого для аутентификации.

aws_region

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

Название региона AWS.

function_name

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

Имя вызываемой функции AWS Lambda.

name

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

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

Имя политики экспорта, в которую будет добавлено это правило (или в которой оно будет изменено либо удалено).

ntfs_unix_security

string

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

Параметры безопасности UNIX для экспорта NTFS.

В REST поддерживается начиная с ONTAP 9.9.1.

Варианты:

  • "fail"
  • "ignore"

ontapi

integer

Версия API ONTAP, которую следует использовать

password

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

string

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

protocol

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

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

Список протоколов доступа клиента.

При создании по умолчанию используется значение ‘any’.

Варианты:

  • "any"
  • "nfs"
  • "nfs3"
  • "nfs4"
  • "cifs"
  • "flexcache"

ro_rule

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

Список спецификаций доступа только для чтения для этого правила

Варианты:

  • "any"
  • "none"
  • "never"
  • "krb5"
  • "krb5i"
  • "krb5p"
  • "ntlm"
  • "sys"

rule_index

integer

Индекс правила политики экспорта.

Если rule_index не задан, выполняется поиск правила с точным совпадением. Если такое правило найдено, при state со значением present никаких действий не выполняется, а при state со значением absent правило удаляется. Если найдено несколько правил, сообщается об ошибке.

Если rule_index задан и state имеет значение present, но правило с этим индексом не найдено, выполняется поиск правила с точным совпадением; если оно найдено, ему назначается указанный индекс. Если совпадений нет, создается новое правило.

Для поиска точного совпадения используются все заданные атрибуты. Как минимум требуются client_match, ro_rule и rw_rule.

rw_rule

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

Список спецификаций доступа на чтение и запись для этого правила

Варианты:

  • "any"
  • "none"
  • "never"
  • "krb5"
  • "krb5i"
  • "krb5p"
  • "ntlm"
  • "sys"

state

string

Должно ли указанное правило политики экспорта существовать.

Варианты:

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

super_user_security

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

Список спецификаций доступа на чтение и запись для этого правила

Варианты:

  • "any"
  • "none"
  • "krb5"
  • "krb5i"
  • "krb5p"
  • "ntlm"
  • "sys"

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.

Примечания

Примечание

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

Примеры

- name: Create ExportPolicyRule
  netapp.ontap.na_ontap_export_policy_rule:
    state: present
    name: default123
    rule_index: 100
    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
    ntfs_unix_security: ignore
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Modify ExportPolicyRule
  netapp.ontap.na_ontap_export_policy_rule:
    state: present
    name: default123
    rule_index: 100
    vserver: ci_dev
    client_match: 0.0.0.0/0
    anonymous_user_id: 65521
    ro_rule: ntlm
    rw_rule: any
    protocol: any
    allow_suid: false
    ntfs_unix_security: fail
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Rename ExportPolicyRule index
  netapp.ontap.na_ontap_export_policy_rule:
    state: present
    name: default123
    from_rule_index: 100
    rule_index: 99
    client_match: 0.0.0.0/0
    anonymous_user_id: 65521
    ro_rule: ntlm
    rw_rule: any
    protocol: any
    allow_suid: false
    ntfs_unix_security: fail
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete ExportPolicyRule
  netapp.ontap.na_ontap_export_policy_rule:
    state: absent
    name: default123
    rule_index: 99
    vserver: ci_dev
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

Авторы

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

Spec-Zone.ru

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