Spec-Zone.ru › Ansible

модуль netapp_eseries.santricity.netapp_e_volume – управление томами хранилища NetApp E-Series (стандартными и тонкими)

Примечание

Этот модуль входит в коллекцию netapp_eseries.santricity (версия 1.4.1).

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

Для установки используйте: ansible-galaxy collection install netapp_eseries.santricity.

Чтобы использовать коллекцию в плейбуке, укажите: netapp_eseries.santricity.netapp_e_volume.

Добавлено в netapp_eseries.santricity 2.2.0

  • Краткое описание
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Создание и удаление томов (стандартных и тонких) для систем хранения NetApp серии E/EF.

Параметры

Параметр

Комментарии

api_password

string / обязательный

Пароль для аутентификации в SANtricity Web Services Proxy или Embedded Web Services API.

api_url

string / обязательный

URL-адрес SANtricity Web Services Proxy или Embedded Web Services API. Пример: https://prod-1.wahoo.acme.com/devmgr/v2

api_username

string / обязательный

Имя пользователя для аутентификации в SANtricity Web Services Proxy или Embedded Web Services API.

cache_without_batteries

boolean

добавлено в netapp_eseries.santricity 2.9.0

Указывает, следует ли использовать кэш без резервного питания от батареи.

Предупреждение: если cache_without_batteries==true, система хранения потеряет питание и резервного питания от батареи не будет, данные будут потеряны!

Варианты:

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

data_assurance_enabled

boolean

Определяет, следует ли включить проверку целостности данных (DA) для тома.

Доступно только при создании нового тома в пуле хранения с дисками, поддерживающими функцию DA.

Варианты:

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

initialization_timeout

integer

добавлено в netapp_eseries.santricity 2.9.0

Продолжительность ожидания в секундах до завершения операции wait_for_initialization.

Для влияния на работу модуля необходимо задать wait_for_initialization==True.

metadata

dictionary

добавлено в netapp_eseries.santricity 2.8.0

Словарь с метаданными о назначении, пользователе, расположении и т. д. тома (структура словаря определяется произвольно в соответствии с потребностями пользователя).

Если на системе хранения уже существует workload_name, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения будут применены ко всем связанным томам!)

При задании metadata необходимо указать workload_name.

name

string / обязательный

Имя управляемого тома.

owning_controller

string

добавлено в netapp_eseries.santricity 2.9.0

Указывает, какой контроллер будет основным владельцем тома.

Если параметр не указан, контроллер самостоятельно выберет владельца.

Варианты:

  • "A"
  • "B"

read_ahead_enable

boolean

добавлено в netapp_eseries.santricity 2.8.0

Указывает, включено ли автоматическое предварительное чтение из кэша.

Этот параметр не влияет на тонкие тома, поскольку их архитектура не позволяет использовать кэширование с предварительным чтением.

Варианты:

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

read_cache_enable

boolean

добавлено в netapp_eseries.santricity 2.8.0

Указывает, следует ли включить кэширование чтения для тома.

Варианты:

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

segment_size_kb

integer

Размер сегмента тома.

Все значения указаны в кибибайтах.

Часто используются значения «8», «16», «32», «64», «128», «256» и «512», но доступные варианты зависят от системы.

Полный список значений для системы можно получить с помощью netapp_eseries.santricity.netapp_e_facts в разделе segment_sizes.

Если пул хранения является raidDiskPool, размер сегмента должен составлять 128 КБ.

Этот модуль не поддерживает изменение размера сегмента.

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

size

float / обязательный

Обязателен только при state==’present’.

Размер тома в единицах size_unit.

Для тонкого тома — размер виртуального тома в единицах size_unit.

Максимальный размер виртуального тома с тонким выделением составляет 256 ТБ; однако могут действовать дополнительные ограничения на уровне ОС.

size_unit

string

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

Варианты:

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

ssd_cache_enabled

boolean

Следует ли включить для тома существующий кэш SSD (операция завершится ошибкой, если кэш SSD не настроен).

По умолчанию существующая настройка кэша SSD игнорируется.

Варианты:

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

ssid

string

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

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

state

string / обязательный

Должен ли указанный том существовать.

Варианты:

  • "present"
  • "absent"

storage_pool_name

string

Обязателен только при заданном значении state==’present’.

Имя пула хранения, в котором должен находиться том.

thin_provision

boolean

Следует ли использовать для тома тонкое выделение ресурсов.

Тонкие тома можно создавать только при raid_level==”raidDiskPool”.

Как правило, тонкое выделение ресурсов не рекомендуется из-за снижения производительности.

Варианты:

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

thin_volume_expansion_policy

string

добавлено в netapp_eseries.santricity 2.8.0

Политика расширения тонкого тома.

Если thin_volume_expansion_policy==”automatic” и превышено значение thin_volume_growth_alert_threshold, размер репозитория thin_volume_max_repo_size будет увеличен автоматически.

Если thin_volume_expansion_policy==”manual” и значение thin_volume_growth_alert_threshold превышено, система хранения будет ожидать вмешательства оператора.

В этом модуле нельзя изменить политику расширения существующих тонких томов.

Как правило, почти всегда следует использовать thin_volume_expansion_policy==”automatic.

Варианты:

  • "automatic" ← (по умолчанию)
  • "manual"

thin_volume_growth_alert_threshold

integer

добавлено в netapp_eseries.santricity 2.8.0

Порог использования репозитория тонкого тома (в процентах).

Когда процент использованного пространства от максимального размера репозитория превышает это значение, будет выдано предупреждение и выполнена политика thin_volume_expansion_policy.

Значение должно быть от 10 до 99 включительно.

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

thin_volume_max_repo_size

float

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

Имеет значение только при thin_volume_expansion_policy==”automatic”.

Когда доля thin_volume_repo_size от thin_volume_max_repo_size превышает thin_volume_growth_alert_threshold, будет выдано предупреждение, и массив хранения выполнит политику thin_volume_expansion_policy.

При операциях расширения с политикой thin_volume_expansion_policy==”automatic” максимальный размер репозитория будет увеличен.

По умолчанию используется то же значение, что и для size (в единицах size_unit).

thin_volume_repo_size

integer

Это значение (в единицах size_unit) задает объем пространства, выделяемого для репозитория тонкого тома.

Начальное значение должно составлять от 4 до 256 ГБ включительно с шагом 4 ГБ.

При операциях расширения увеличение должно составлять от 4 до 256 ГБ включительно с шагом 4 ГБ.

Этот параметр не влияет на расширение, если thin_volume_expansion_policy==”automatic”.

Как правило, почти всегда следует использовать thin_volume_expansion_policy==”automatic.

validate_certs

boolean

Следует ли проверять сертификаты HTTPS?

Варианты:

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

wait_for_initialization

boolean

добавлено в netapp_eseries.santricity 2.8.0

Заставляет модуль ожидать завершения операций расширения, прежде чем продолжить работу.

Варианты:

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

workload_name

string

добавлено в netapp_eseries.santricity 2.8.0

Метка рабочей нагрузки, определяемой метаданными.

Если указаны workload_name и metadata, определенная рабочая нагрузка будет добавлена в массив хранения.

Если на системе хранения уже существует workload_name, но метаданные отличаются, определение рабочей нагрузки будет обновлено. (Изменения будут применены ко всем связанным томам!)

Существующие рабочие нагрузки можно получить с помощью netapp_eseries.santricity.netapp_e_facts.

write_cache_enable

boolean

добавлено в netapp_eseries.santricity 2.8.0

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

Варианты:

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

Примечания

Примечание

  • Для управления системой хранения модулям Ansible для E-Series требуется либо экземпляр Web Services Proxy (WSP), либо система хранения E-Series с поддержкой Embedded Web Services API.
  • В настоящее время Embedded Web Services доступен на E2800, E5700, EF570 и более новых моделях оборудования.
  • netapp_eseries.santricity.netapp_e_storage_system можно использовать для настройки систем, управляемых экземпляром WSP.

Примеры

- name: Create simple volume with workload tags (volume meta data)
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume
    storage_pool_name: storage_pool
    size: 300
    size_unit: gb
    workload_name: volume_tag
    metadata:
      key1: value1
      key2: value2
- name: Create a thin volume
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 131072
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 1024
- name: Expand thin volume's virtual size
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 262144
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 1024
- name: Expand thin volume's maximum repository size
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: present
    name: volume1
    storage_pool_name: storage_pool
    size: 262144
    size_unit: gb
    thin_provision: true
    thin_volume_repo_size: 32
    thin_volume_max_repo_size: 2048
- name: Delete volume
  netapp_e_volume:
    ssid: "{{ ssid }}"
    api_url: "{{ netapp_api_url }}"
    api_username: "{{ netapp_api_username }}"
    api_password: "{{ netapp_api_password }}"
    validate_certs: "{{ netapp_api_validate_certs }}"
    state: absent
    name: volume

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

msg

string

Состояние тома

Возвращается: всегда

Пример: "Standard volume [workload_vol_1] has been created."

Авторы

  • Kevin Hulquest (@hulquest)
  • Nathan Swartz (@ndswartz)

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

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

© 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_eseries/santricity/netapp_e_volume_module.html

Spec-Zone.ru

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