Spec-Zone.ru › Ansible

netapp_eseries.santricity.na_santricity_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.na_santricity_volume.

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

Описание

  • Создание или удаление объёмов (стандартных и разряженных) для хранилищ NetApp E/EF-серии.

Параметры

Параметр

Комментарии

allow_expansion

логический

Разрешает расширение размера тома для соответствия требуемым параметрам.

Предупреждение: при allows_expansion==false и необходимости расширения существующего тома модуль продолжит работу с предупреждением.

Варианты:

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

api_password

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

Пароль для аутентификации с прокси-сервером SANtricity Web Services или встроенным API Web Services.

api_url

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

URL-адрес прокси-сервера SANtricity Web Services или встроенного API Web Services.

Пример https://prod-1.wahoo.acme.com:8443/devmgr/v2

api_username

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

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

cache_without_batteries

логический

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

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

Варианты:

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

data_assurance_enabled

логический

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

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

Варианты:

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

name

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

Имя тома для управления.

owning_controller

строка

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

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

Варианты:

  • "A"
  • "B"

read_ahead_enable

логический

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

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

Варианты:

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

read_cache_enable

логический

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

Варианты:

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

segment_size_kb

целое число

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

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

Некоторые распространенные значения включают 8, 16, 32, 64, 128, 256 и 512, но варианты зависят от системы.

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

Если хранилище — raidDiskPool, размер сегмента должен быть 128 КБ.

Миграции размера сегмента в этом модуле не допускаются.

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

size

вещественное число / обязательно

Требуется только при state==”present”.

Размер тома в size_unit.

Размер виртуального тома в случае тонкого тома в size_unit.

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

size_tolerance_b

целое число

Допуск к общему размеру тома, измеряемый в байтах; таким образом, если общий размер тома находится в пределах +/- size_tolerance_b, перерасчет не потребуется.

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

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

size_unit

строка

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

Единица pct определяет процент от общего размера доступного хранилища.

Варианты:

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

ssd_cache_enabled

логический

Включает ли существующий кэш SSD для тома (не выполняется, если кэш SSD не определен).

Значение по умолчанию — игнорировать существующее значение кэша SSD.

Варианты:

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

ssid

string

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

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

state

string

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

Варианты:

  • "present" ← (default)
  • "absent"

storage_pool_name

string

Требуется только при запрошенном state==”present”.

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

thin_provision

boolean

Должен ли том быть тонко выделенным.

Тонкие тома могут быть созданы только тогда, когда raid_level==”raidDiskPool”.

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

Варианты:

  • false ← (default)
  • true

thin_volume_expansion_policy

string

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

Когда 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" ← (default)
  • "manual"

thin_volume_growth_alert_threshold

integer

Это пороговое значение использования хранилища тонкого выделения (в процентах).

Когда процент используемого хранилища от максимального размера хранилища превышает это значение, то будет выдано предупреждение, и будет выполнена 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.

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 ← (default)

volume_metadata

dictionary

Словарь, содержащий метаданные для самого тома.

Ключ словаря не может быть длиннее 14 символов

Значения словаря не могут быть длиннее 240 символов

wait_for_initialization

boolean

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

Варианты:

  • false ← (default)
  • true

workload_metadata

aliases: metadata

dictionary

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

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

workload_name должен быть указан, когда определены metadata.

Ключ словаря не может быть длиннее 16 символов

Значения словаря не могут быть длиннее 60 символов

workload_name

string

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

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

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

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

write_cache_enable

boolean

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

Варианты:

  • false
  • true ← (default)

write_cache_mirror_enable

boolean

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

Варианты:

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

Примечания

Примечание

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

Примеры

- name: Create simple volume with workload tags (volume meta data)
  na_santricity_volume:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    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
  na_santricity_volume:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    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
  na_santricity_volume:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    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
  na_santricity_volume:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    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
  na_santricity_volume:
    ssid: "1"
    api_url: "https://192.168.1.100:8443/devmgr/v2"
    api_username: "admin"
    api_password: "adminpass"
    validate_certs: true
    state: absent
    name: volume

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

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

Ключ

Описание

msg

string

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

Возвращаемое значение: всегда

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

Авторы

  • Nathan Swartz (@swartzn)
  • Vu Tran (@VuTran007)

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

  • Система отслеживания задач
  • Репозиторий (источники)

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

Spec-Zone.ru

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