модуль netapp.ontap.na_ontap_cifs_unix_symlink_mapping — модуль NetApp ONTAP для управления сопоставлением символических ссылок UNIX для клиентов CIFS.

Примечание

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

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

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

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

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

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Создание, изменение или удаление сопоставления символической ссылки UNIX для клиента CIFS.

Требования

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

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.
cifs_path string	Задает путь CIFS на целевом ресурсе, на который указывает символическая ссылка. Обратите внимание, что значение указывается с использованием пути в стиле UNIX. Путь должен начинаться и заканчиваться прямой косой чертой (/).
cifs_server string	Задает целевой сервер CIFS (DNS-имя, IP-адрес или имя NetBIOS). Это поле обязательно, если расположение символической ссылки — «widelink».
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, каждый элемент должен быть целым числом.
home_directory boolean	Указывает, является ли целевой общий ресурс домашним каталогом. Значение по умолчанию — false. Варианты: `false` ← (по умолчанию) `true`
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.4.0	Параметры конфигурации прокси-функции AWS Lambda. Этот параметр и его вложенные параметры поддерживаются только при использовании REST.
aws_profile string	Имя профиля AWS, используемого для аутентификации.
aws_region string / обязательный	Название региона AWS.
function_name string / обязательный	Имя вызываемой функции AWS Lambda.
locality string	Указывает, является ли символическая ссылка CIFS локальной или широкой ссылкой. По умолчанию задается локальная ссылка. Поддерживаются следующие значения: local — локальная символическая ссылка указывает только на тот же общий ресурс CIFS; widelink — широкая символическая ссылка указывает на любой общий ресурс CIFS в сети. Варианты: `"local"` ← (по умолчанию) `"widelink"`
password псевдонимы: pass string	Пароль указанного пользователя.
share_name string	Задает имя общего ресурса CIFS на целевом сервере CIFS, на который указывает символическая ссылка UNIX.
state string	Указывает, должно ли существовать заданное сопоставление символической ссылки. Варианты: `"present"` ← (по умолчанию) `"absent"`
unix_path string / обязательный	Задает префикс пути UNIX, который необходимо сопоставить. Путь должен начинаться и заканчиваться прямой косой чертой (/).
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. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация по SSL-сертификату с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Для использования сертификата он должен быть установлен в кластере ONTAP, а аутентификация по сертификату должна быть включена.
validate_certs boolean	Если задано значение `no`, SSL-сертификаты не проверяются. Задавайте значение `False` только на контролируемых вами сайтах, использующих самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)
vserver string / обязательный	Имя используемого vserver.

Примечания

Примечание

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

Примеры

- name: Create a UNIX symlink mapping for CIFS share
  netapp.ontap.na_ontap_cifs_unix_symlink_mapping:
    state: present
    vserver: "{{ svm }}"
    unix_path: "/example1/"
    share_name: "share1"
    cifs_path: "/path1/test_dir/"
    cifs_server: "CIFS"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Update a specific UNIX symlink mapping for a SVM
  netapp.ontap.na_ontap_cifs_unix_symlink_mapping:
    state: present
    vserver: "{{ svm }}"
    unix_path: "/example1/"
    share_name: "share2"
    cifs_path: "/path2/test_dir/"
    cifs_server: "CIFS"
    locality: "widelink"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

- name: Remove a specific UNIX symlink mapping for a SVM
  netapp.ontap.na_ontap_cifs_unix_symlink_mapping:
    state: absent
    vserver: "{{ svm }}"
    unix_path: "/example1/"
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"
    https: true
    validate_certs: "{{ validate_certs }}"

Авторы

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