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 и необходимости расширения существующего тома модуль продолжит работу с предупреждением. Варианты:
|
api_password строка / обязательно | Пароль для аутентификации с прокси-сервером SANtricity Web Services или встроенным API Web Services. |
api_url строка / обязательно | URL-адрес прокси-сервера SANtricity Web Services или встроенного API Web Services. |
api_username строка / обязательно | Имя пользователя для аутентификации с прокси-сервером SANtricity Web Services или встроенным API Web Services. |
cache_without_batteries логический | Указывает, используется ли кэширование без резервного источника питания. Предупреждение: если cache_without_batteries==true и система хранения теряет питание без резервного источника, данные будут потеряны! Варианты:
|
data_assurance_enabled логический | Определяет, следует ли включить гарантию данных (DA) для тома. Доступно только при создании нового тома и на хранилище с дисками, поддерживающими функцию DA. Варианты:
|
name строка / обязательно | Имя тома для управления. |
owning_controller строка | Указывает, какой контроллер будет основным владельцем тома. Отсутствие значения позволит контроллеру выбрать владение. Варианты:
|
read_ahead_enable логический | Указывает, включено ли автоматическое кэширование предварительного чтения. Этот параметр не влияет на тонко разделяемые тома, так как архитектура тонких томов не может извлечь выгоды из кэширования предварительного чтения. Варианты:
|
read_cache_enable логический | Указывает, включено ли кэширование чтения для тома. Варианты:
|
segment_size_kb целое число | Размер сегмента тома Все значения в кибибайтах. Некоторые распространенные значения включают 8, 16, 32, 64, 128, 256 и 512, но варианты зависят от системы. Получите окончательный список системы из netapp_eseries.santricity.na_santricity_facts в разделе segment_sizes. Если хранилище — raidDiskPool, размер сегмента должен быть 128 КБ. Миграции размера сегмента в этом модуле не допускаются. По умолчанию: |
size вещественное число / обязательно | Требуется только при state==”present”. Размер тома в size_unit. Размер виртуального тома в случае тонкого тома в size_unit. Максимальный размер виртуального тома тонкого тома составляет 256 ТБ; однако могут существовать и другие ограничения на уровне ОС. |
size_tolerance_b целое число | Допуск к общему размеру тома, измеряемый в байтах; таким образом, если общий размер тома находится в пределах +/- size_tolerance_b, перерасчет не потребуется. Этот параметр может быть полезен в случае существующих томов, не созданных с помощью na_santricity_volume, так как предоставление точного размера может быть затруднено из-за выравнивания тома и накладных расходов. По умолчанию: |
size_unit строка | Единица измерения, используемая для интерпретации параметра размера. Единица pct определяет процент от общего размера доступного хранилища. Варианты:
|
ssd_cache_enabled логический | Включает ли существующий кэш SSD для тома (не выполняется, если кэш SSD не определен). Значение по умолчанию — игнорировать существующее значение кэша SSD. Варианты:
|
ssid string | Идентификатор массива для управления. Это значение должно быть уникальным для каждого массива. По умолчанию: |
state string | Должен ли существовать указанный том Варианты:
|
storage_pool_name string | Требуется только при запрошенном state==”present”. Имя пула хранения, в котором должен находиться том. |
thin_provision boolean | Должен ли том быть тонко выделенным. Тонкие тома могут быть созданы только тогда, когда raid_level==”raidDiskPool”. Как правило, использование тонкого выделения не рекомендуется из-за влияния на производительность. Варианты:
|
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. Варианты:
|
thin_volume_growth_alert_threshold integer | Это пороговое значение использования хранилища тонкого выделения (в процентах). Когда процент используемого хранилища от максимального размера хранилища превышает это значение, то будет выдано предупреждение, и будет выполнена thin_volume_expansion_policy. Значения должны быть между 10 и 99 включительно. По умолчанию: |
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-сертификаты? Варианты:
|
volume_metadata dictionary | Словарь, содержащий метаданные для самого тома. Ключ словаря не может быть длиннее 14 символов Значения словаря не могут быть длиннее 240 символов |
wait_for_initialization boolean | Заставляет модуль ожидать завершения операций расширения перед продолжением. Варианты:
|
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 | Указывает, следует ли включать кэширование записи для тома. Варианты:
|
write_cache_mirror_enable boolean | Указывает, следует ли включить кэширование записи с зеркальным отображением. Варианты:
|
Примечания
Примечание
- Модули 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 | Состояние тома Возвращаемое значение: всегда Пример: |
Ссылки на коллекцию
© 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