Spec-Zone.ru › Ansible

Модуль netapp.ontap.na_ontap_flexcache – NetApp ONTAP FlexCache - создание/удаление взаимосвязей

Примечание

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

Эта коллекция может быть уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить её установку, выполните ansible-galaxy collection list.

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

Для использования в книге задач укажите: netapp.ontap.na_ontap_flexcache.

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

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

Описание

  • Создание/удаление взаимосвязей томов FlexCache.
  • Этот модуль не изменяет существующий том FlexCache, за исключением двух случаев.
  • При использовании REST можно запустить предварительную подготовку существующего тома FlexCache.
  • При использовании REST можно монтировать или размонтировать том. Установите путь ‘’ для размонтирования.
  • Для предварительной подготовки требуется, чтобы том был смонтирован.
  • Некоторые действия также доступны через модуль na_ontap_volume.
  • Том кэша не может быть удален в ZAPI.

Требования

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

  • Ansible 2.9 или более поздней версии; рекомендуется версия 2.12 или выше.
  • Python3 3.9 или более поздней версии; рекомендуется.
  • При использовании ZAPI, netapp-lib 2018.11.13 или более поздней версии (устанавливается с помощью ‘pip install netapp-lib’); strongly рекомендуется netapp-lib 2020.3.12, так как он обеспечивает лучшие сообщения об ошибках при проблемах с подключением.
  • Физическая или виртуальная кластерная система Data ONTAP; модули поддерживают Data ONTAP 9.1 и более поздние версии; поддержка REST требует ONTAP 9.6 или более поздней версии.

Параметры

Параметр

Комментарии

aggr_list

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

список / элементы=строка

Список агрегатов для размещения целевого тома FlexCache.

aggr_list_multiplier

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

целое число

Количество повторений списка агрегатов.

REST - Количество компонентов FlexCache на агрегат, когда упоминается поле aggregates.

auto_provision_as

строка

Используйте этот параметр для автоматического выбора существующих агрегатов для выделения тома. Например, flexgroup

Обратите внимание, что будет выбран наиболее быстрый тип агрегата с по крайней мере одним агрегатом на каждом узле кластера.

Игнорируется при использовании REST - опустить aggr_list для автоматического выбора.

cert_filepath

строка

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

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

не поддерживается с python 2.6.

feature_flags

словарь

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

Включить или выключить новую функцию.

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

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

force_offline

логическое значение

Отключить том FlexCache перед удалением связи FlexCache.

Том будет уничтожен, и данные могут быть потеряны.

Варианты:

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

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.

force_unmount

логическое значение

Отключить том FlexCache. Удалить путь соединения, на котором смонтирован том, перед удалением связи FlexCache.

Варианты:

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

hostname

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

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

http_port

целое число

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

https

логическое значение

Включить и выключить https.

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

Игнорируется при использовании аутентификации по SSL-сертификату, так как это требует SSL.

Варианты:

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

junction_path

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

строка

Путь соединения кэша.

key_filepath

строка

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

Путь к файлу закрытого ключа SSL клиента.

name

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

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

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

Имя целевого тома для FlexCache.

ontapi

целое число

Версия API ontap для использования

origin_cluster

строка

Имя исходного кластера для FlexCache.

По умолчанию используется кластер, связанный с целевым vserver, если отсутствует.

Не используется при создании.

origin_volume

строка

Имя исходного тома для FlexCache.

Требуется для создания.

origin_vserver

строка

Имя исходного vserver для FlexCache.

Требуется для создания.

password

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

строка

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

prepopulate

словарь

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

Инициализировать FlexCache данными с исходного тома.

Требуется ONTAP 9.8 или более поздняя версия и поддержка REST.

Для эффективной работы этого параметра необходимо установить dir_paths.

dir_paths

список / элементы=строка / обязательный

Список путей к каталогам в пространстве имен SVM, которому принадлежит том FlexCache.

Путь должен начинаться с ‘/’.

exclude_dir_paths

список / элементы=строка

Путь к каталогу, который необходимо исключить из инициализации.

Путь должен начинаться с ‘/’.

Требуется ONTAP 9.9 или более поздняя версия.

force_prepopulate_if_already_created

булево

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

Если установить в значение false, задача инициализации не запускается, если FlexCache уже существует.

Варианты:

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

recurse

булево

Определяет, будет ли действие инициализации искать по каталогу рекурсивно.

Если не задано, используется значение по умолчанию ‘true’.

Варианты:

  • false
  • true

size

целое число

Размер тома кеша.

size_unit

строка

Единица измерения для параметра размера.

Варианты:

  • "bytes"
  • "b"
  • "kb"
  • "mb"
  • "gb" ← (по умолчанию)
  • "tb"
  • "pb"
  • "eb"
  • "zb"
  • "yb"

state

строка

Существование заданной связи.

Варианты:

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

time_out

целое число

Время ожидания создания или удаления flexcache в секундах.

Если 0, запрос асинхронный.

По умолчанию 3 минуты.

По умолчанию: 180

use_rest

строка

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

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

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

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

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

username

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

строка

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

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

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

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

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

validate_certs

булево

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

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

Варианты:

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

vserver

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

Имя целевого vserver для FlexCache.

Обратите внимание, что хост, имя пользователя, пароль предназначены для целевого vserver.

Примечания

Примечание

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

Примеры

- name: Create FlexCache
  netapp.ontap.na_ontap_flexcache:
    state: present
    origin_volume: test_src
    name: test_dest
    origin_vserver: ansible_src
    vserver: ansible_dest
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_password }}"

- name: Delete FlexCache
  netapp.ontap.na_ontap_flexcache:
    state: absent
    name: test_dest
    vserver: ansible_dest
    hostname: "{{ netapp_hostname }}"
    username: "{{ netapp_username }}"
    password: "{{ netapp_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_flexcache_module.html

Spec-Zone.ru

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