dellemc.openmanage.redfish_storage_volume – Управляет конфигурацией хранилища

Примечание

Этот плагин входит в коллекцию dellemc.openmanage (версия 3.0.0).

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

Для использования в книге задач укажите: dellemc.openmanage.redfish_storage_volume.

Новый в версии 2.1.0: модуля dellemc.openmanage

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Этот модуль позволяет создавать, изменять, инициализировать или удалять один том хранилища.

Требования

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

python >= 2.7.5

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
baseuri строка / обязательно		IP-адрес целевого контроллера вне полосы. Например- <ipaddress>:<port>.
block_size_bytes целое число		Размер блока в байтах. Применимо только когда state равен `present`.
capacity_bytes строка		Размер тома в байтах. Применимо только когда state равен `present`.
command строка	Варианты: initialize	`initialize` инициализирует существующий том хранения для указанного volume_id.
controller_id строка		Полное квалифицированное описание устройства (FQDD) контроллера хранения. Например- RAID.Slot.1-1. Этот параметр обязателен, когда state равен `present`, при создании тома.
drives список / элементы=строка		FQDD физических дисков. Например- Disk.Bay.0:Enclosure.Internal.0-1:RAID.Slot.1-1. Применимо только когда state равен `present`, при создании нового тома.
encrypted логическое значение	Варианты: no yes	Указывает, использует ли том шифрование в данный момент. Применимо только когда state равен `present`.
encryption_types строка	Варианты: NativeDriveEncryption ControllerAssisted SoftwareAssisted	Можно выбрать следующие типы шифрования. `ControllerAssisted` Том шифруется устройством хранения. `NativeDriveEncryption` Том использует возможности встроенного шифрования дисков аппаратного обеспечения. `SoftwareAssisted` Том шифруется программным обеспечением, работающим на системе или операционной системе. Применимо только когда state равен `present`.
initialize_type строка	Варианты: Быстро ← Медленно	Тип инициализации существующего тома. Применимо только когда command равен `initialize`.
name строка		Имя создаваемого тома. Применимо только когда state равен `present`.
oem словарь		Включает расширенные платные данные OEM. Применимо только когда state равно present.
optimum_io_size_bytes целое число		Значение размера полосы должно быть кратно 64 * 1024. Применимо только когда state равно `present`.
password строка / обязательно		Пароль целевого контроллера вне полосы.
state строка	Варианты: present absent	`present` создаёт том хранения для указанного I (controller_id) или изменяет том хранения для указанного I (volume_id). Примечание: изменение свойств существующего тома зависит от возможностей дисков и контроллера. `absent` удаляет том для указанного volume_id.
username строка / обязательно		Имя пользователя целевого контроллера вне полосы.
volume_id строка		FQDD существующего тома. Например- Disk.Virtual.4:RAID.Slot.1-1. Этот параметр обязателен в следующих случаях, state равен `present`, при обновлении тома. state равен `absent`, при удалении тома. command равен `initialize`, при инициализации тома.

volume_type

string

Choices:

NonRedundant
Mirrored
StripedWithParity
SpannedMirrors
SpannedStripesWithParity

Один из следующих типов тома должен быть выбран для создания тома.

Mirrored Том — это зеркальное устройство.

NonRedundant Том — это устройство хранения без избыточности.

SpannedMirrors Том — это набор зеркальных устройств.

SpannedStripesWithParity Том — это набор устройств с использованием чётности для сохранения избыточной информации.

StripedWithParity Том — это устройство, которое использует чётность для сохранения избыточной информации.

Примечания

Примечание

Запустите этот модуль с системы, имеющей прямой доступ к API Redfish.
Этот модуль не поддерживает check_mode.

Примеры

---
- name: Create a volume with supported options
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    volume_type: "Mirrored"
    name: "VD0"
    controller_id: "RAID.Slot.1-1"
    drives:
      - Disk.Bay.5:Enclosure.Internal.0-1:RAID.Slot.1-1
      - Disk.Bay.6:Enclosure.Internal.0-1:RAID.Slot.1-1
    block_size_bytes: 512
    capacity_bytes: 299439751168
    optimum_io_size_bytes: 65536
    encryption_types: NativeDriveEncryption
    encrypted: true

- name: Create a volume with minimum options
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    controller_id: "RAID.Slot.1-1"
    volume_type: "NonRedundant"
    drives:
       - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1

- name: Modify a volume's encryption type settings
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    volume_id: "Disk.Virtual.5:RAID.Slot.1-1"
    encryption_types: "ControllerAssisted"
    encrypted: true

- name: Delete an existing volume
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "absent"
    volume_id: "Disk.Virtual.5:RAID.Slot.1-1"

- name: Initialize an existing volume
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    command: "initialize"
    volume_id: "Disk.Virtual.6:RAID.Slot.1-1"
    initialize_type: "Slow"

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

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

Ключ	Возвращаемое значение	Описание
error_info dictionary	при ошибке http	Подробности об ошибке http. Пример: {'error': {'@Message.ExtendedInfo': [{'Message': 'Невозможно выполнить операции конфигурации, так как для устройства уже существует задача конфигурации.', 'MessageArgs': [], 'MessageArgs@odata.count': 0, 'MessageId': 'IDRAC.1.6.STOR023', 'RelatedProperties': [], 'RelatedProperties@odata.count': 0, 'Resolution': 'Дождитесь завершения текущей задачи для устройства или отмены текущей задачи перед попыткой выполнения дополнительных операций конфигурации на устройстве.', 'Severity': 'Информационное'}], 'code': 'Base.1.2.GeneralError', 'message': 'Произошла общая ошибка. Для получения дополнительной информации см. ExtendedInfo'}}
msg string	всегда	Общий статус операции конфигурации хранилища. Пример: Задача создания тома успешно отправлена.
task dictionary	успех	Возвращает идентификатор и URI созданной задачи. Пример: {'id': 'JID_XXXXXXXXXXXXX', 'uri': '/redfish/v1/TaskService/Tasks/JID_XXXXXXXXXXXXX'}

Авторы

Sajna Shetty(@Sajna-Shetty)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/dellemc/openmanage/redfish_storage_volume_module.html