Модуль netapp.ontap.na_ontap_object_store – Управление конфигурацией хранилища объектов в NetApp ONTAP.
Примечание
Этот модуль входит в коллекцию netapp.ontap (версия 22.12.0).
Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install netapp.ontap. Для использования этого модуля требуются дополнительные условия, см. Требования для получения подробностей.
Для использования в playbook, укажите: netapp.ontap.na_ontap_object_store.
Новое в netapp.ontap 2.9.0
Описание
- Создание или удаление конфигурации хранилища объектов в ONTAP.
Требования
Ниже перечислены требования, необходимые на хосте, на котором будет выполняться этот модуль.
- Ansible 2.9 или более поздняя версия - рекомендуется 2.12 или более поздняя.
- Python3 - 3.9 или более поздняя версия рекомендуется.
- При использовании ZAPI, netapp-lib 2018.11.13 или более поздняя версия (установить с помощью «pip install netapp-lib»), сильно рекомендуется netapp-lib 2020.3.12, так как она обеспечивает лучшую обработку ошибок при подключении.
- Физическая или виртуальная кластерная система Data ONTAP, модули поддерживают Data ONTAP 9.1 и более поздние версии, поддержка REST требует ONTAP 9.6 или более поздней версии.
Параметры
Параметр | Комментарии |
|---|---|
access_key строка | Идентификатор ключа доступа для типов поставщиков AWS_S3 и SGWS. |
cert_filepath строка добавлен в netapp.ontap 20.6.0 | путь к файлу SSL-сертификата клиента (.pem). не поддерживается с python 2.6. |
certificate_validation_enabled булево добавлен в netapp.ontap 21.9.0 | Включена ли проверка SSL/TLS-сертификата? Если не указано, ONTAP по умолчанию установит значение true. Варианты:
|
change_password булево добавлен в netapp.ontap 21.13.0 | По умолчанию, secret_password используется при создании, но игнорируется, если ресурс уже существует. Если установлено в true, модуль всегда пытается изменить пароль, так как не может прочитать текущее значение. Когда это установлено в true, модуль не является идемпотентным. Варианты:
|
container строка | Имя корзины/контейнера данных, используемое в запросах S3. |
feature_flags словарь добавлен в netapp.ontap 20.5.0 | Включить или отключить новую функцию. Это можно использовать для включения экспериментальной функции или отключения новой функции, нарушающей обратную совместимость. Поддерживаемые ключи и значения могут быть изменены без предварительного уведомления. Неизвестные ключи игнорируются. |
force_ontap_version строка добавлен в netapp.ontap 21.23.0 | Переопределить версию кластера ONTAP при использовании REST. Поведение не определено, если версия не соответствует целевому кластеру. Это предоставляется как обходной путь, когда версия кластера не может быть прочитана из-за проблем с разрешениями. См. https://github.com/ansible-collections/netapp.ontap/wiki/Known-issues. Это должно быть в формате 9.10 или 9.10.1, где каждый элемент — целое число. Когда Игнорируется с ZAPI. |
hostname строка / обязательно | Имя хоста или IP-адрес экземпляра ONTAP. |
http_port целое число | Переопределить порт по умолчанию (80 или 443) на этот порт. |
https булево | Включить и отключить https. Игнорируется при использовании REST, так как поддерживается только https. Игнорируется при аутентификации с помощью SSL-сертификата, так как это требует SSL. Варианты:
|
key_filepath строка добавлен в netapp.ontap 20.6.0 | путь к файлу ключа SSL-клиента. |
name строка / обязательно | Имя конфигурации хранилища объектов для управления. |
ontapi целое число | Версия API ontap для использования |
owner строка добавлен в netapp.ontap 21.13.0 | Владелец целевого объекта. Не может быть изменен. С REST, допустимые значения - fabricpool или snapmirror. Одна функция может использовать только один целевой объект. С ZAPI, единственное допустимое значение - fabricpool. При отсутствии значения по умолчанию используется fabricpool при создании. |
password псевдонимы: pass строка | Пароль для указанного пользователя. |
port целое число добавлен в netapp.ontap 21.9.0 | Номер порта хранилища объектов, который ONTAP использует при установлении соединения. |
provider_type строка | Имя поставщика конфигурации хранилища объектов. |
secret_password строка | Секретный ключ доступа для типов поставщиков AWS_S3 и SGWS. |
server строка | Полное доменное имя конфигурации хранилища объектов. |
ssl_enabled булево добавлен в netapp.ontap 21.9.0 | Включен ли SSL? Если не указано, ONTAP по умолчанию установит значение true. Варианты:
|
состояние строка | Указывает, должно ли быть указано конфигурация хранилища объектов. Варианты:
|
использовать_rest строка | Использовать REST или ZAPI. always – всегда использует REST API, если модуль его поддерживает. Выводится предупреждение, если модуль не поддерживает REST. Возникает ошибка, если опция модуля не поддерживается в REST. never – всегда использует ZAPI, если модуль его поддерживает. Может возникнуть ошибка, если опция REST не поддерживается в ZAPI. auto – попытается использовать REST API, если модуль его поддерживает и опции модуля поддерживаются. В противном случае переходит к ZAPI. По умолчанию: |
имя_пользователя псевдонимы: пользователь строка | Это может быть учётная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM. Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/. Поддерживаются два метода аутентификации
Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам. |
проверить_сертификаты булево | Если установлено Это следует устанавливать только в Варианты:
|
Примечания
Примечание
- Модули, начинающиеся с prefx 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: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
- name: object store Create
netapp.ontap.na_ontap_object_store:
state: absent
name: ansible
hostname: "{{ hostname }}"
username: "{{ username }}"
password: "{{ password }}"
Ссылки на коллекции
© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/netapp/ontap/na_ontap_object_store_module.html