Модуль netapp.ontap.na_ontap_object_store – управление конфигурацией хранилища объектов NetApp ONTAP.

Примечание

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

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

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

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

Добавлено в netapp.ontap 2.9.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 или более поздняя версия.

Параметры

Параметр	Комментарии
access_key string	Идентификатор ключа доступа для типов поставщика AWS_S3 и SGWS.
cert_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу сертификата клиента SSL (.pem). Не поддерживается в Python 2.6.
certificate_validation_enabled boolean добавлено в netapp.ontap 21.9.0	Включена ли проверка сертификата SSL/TLS? Если параметр не указан, ONTAP по умолчанию задаёт значение true. Варианты: `false` `true`
change_password boolean добавлено в netapp.ontap 21.13.0	По умолчанию secret_password используется при создании, но игнорируется, если ресурс уже существует. Если задано значение true, модуль всегда пытается изменить пароль, так как не может прочитать его текущее значение. Если задано значение true, модуль не является идемпотентным. Варианты: `false` ← (по умолчанию) `true`
container string	Имя корзины/контейнера данных, используемое в запросах S3.
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`
key_filepath string добавлено в netapp.ontap 20.6.0	Путь к файлу ключа клиента SSL.
name string / обязательный	Имя конфигурации хранилища объектов, которой нужно управлять.
ontapi integer	Версия API ONTAP, которую следует использовать.
owner string добавлено в netapp.ontap 21.13.0	Владелец целевого объекта. Не может быть изменён. При использовании REST допустимые значения — fabricpool или snapmirror. Целевой объект может использоваться только одной функцией. При использовании ZAPI допустимое значение только одно — fabricpool. Если параметр не указан, при создании предполагается значение fabricpool.
password псевдонимы: pass string	Пароль указанного пользователя.
port integer добавлено в netapp.ontap 21.9.0	Номер порта хранилища объектов, используемый ONTAP при установлении соединения.
provider_type string	Имя поставщика конфигурации хранилища объектов.
secret_password string	Секретный ключ доступа для типов поставщика AWS_S3 и SGWS.
server string	Полное доменное имя конфигурации хранилища объектов.
ssl_enabled boolean добавлено в netapp.ontap 21.9.0	Включён ли SSL? Если параметр не указан, ONTAP по умолчанию задаёт значение true. Варианты: `false` `true`
state string	Указывает, должна ли указанная конфигурация хранилища объектов существовать. Варианты: `"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. Поддерживаются два метода аутентификации: Базовая аутентификация с использованием имени пользователя и пароля. Аутентификация с помощью сертификата SSL с использованием файла сертификата клиента SSL и, при необходимости, файла закрытого ключа. Чтобы использовать сертификат, его необходимо установить в кластере ONTAP и включить аутентификацию по сертификату.
validate_certs boolean	Если задано значение `no`, сертификаты SSL не будут проверяться. Задавайте значение `False` только на сайтах под вашим контролем, где используются самоподписанные сертификаты. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Object store Create
  netapp.ontap.na_ontap_object_store:
    state: present
    name: ansible
    provider_type: SGWS
    server: abc
    container: abc
    access_key: s3.amazonaws.com
    secret_password: abc
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Object store delete
  netapp.ontap.na_ontap_object_store:
    state: absent
    name: ansible
    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_object_store_module.html