Spec-Zone.ru › Ansible

Модуль 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.

Варианты:

  • false
  • true

change_password

булево

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

По умолчанию, secret_password используется при создании, но игнорируется, если ресурс уже существует.

Если установлено в true, модуль всегда пытается изменить пароль, так как не может прочитать текущее значение.

Когда это установлено в true, модуль не является идемпотентным.

Варианты:

  • false ← (по умолчанию)
  • 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, где каждый элемент — целое число.

Когда use_rest установлено в auto, это может принудительно переключить использование ZAPI в зависимости от версии и возможностей платформы.

Игнорируется с ZAPI.

hostname

строка / обязательно

Имя хоста или IP-адрес экземпляра ONTAP.

http_port

целое число

Переопределить порт по умолчанию (80 или 443) на этот порт.

https

булево

Включить и отключить https.

Игнорируется при использовании REST, так как поддерживается только https.

Игнорируется при аутентификации с помощью SSL-сертификата, так как это требует SSL.

Варианты:

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

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.

Варианты:

  • false
  • true

состояние

строка

Указывает, должно ли быть указано конфигурация хранилища объектов.

Варианты:

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

использовать_rest

строка

Использовать REST или ZAPI.

always – всегда использует REST API, если модуль его поддерживает. Выводится предупреждение, если модуль не поддерживает REST. Возникает ошибка, если опция модуля не поддерживается в REST.

never – всегда использует ZAPI, если модуль его поддерживает. Может возникнуть ошибка, если опция REST не поддерживается в ZAPI.

auto – попытается использовать REST API, если модуль его поддерживает и опции модуля поддерживаются. В противном случае переходит к ZAPI.

По умолчанию: "auto"

имя_пользователя

псевдонимы: пользователь

строка

Это может быть учётная запись на уровне кластера или SVM, в зависимости от того, требуется ли API на уровне кластера или SVM.

Для получения дополнительной информации, пожалуйста, ознакомьтесь с документацией https://mysupport.netapp.com/NOW/download/software/nmsdk/9.4/.

Поддерживаются два метода аутентификации

  1. базовая аутентификация, использующая имя пользователя и пароль,
  2. аутентификация с помощью SSL-сертификата, использующая файл ssl-клиентского сертификата и, необязательно, файл закрытого ключа.

Для использования сертификата он должен быть установлен в кластере ONTAP, и должна быть включена аутентификация по сертификатам.

проверить_сертификаты

булево

Если установлено no, SSL-сертификаты не будут проверяться.

Это следует устанавливать только в False для сайтов с самоподписанными сертификатами, находящимися под вашим контролем.

Варианты:

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

Примечания

Примечание

  • Модули, начинающиеся с 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 }}"

Авторы

  • Команда NetApp Ansible (@carchi8py)

Ссылки на коллекции

  • Система отслеживания ошибок
  • Главная страница
  • Репозиторий (исходные коды)

© 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

Spec-Zone.ru

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