Spec-Zone.ru › Ansible

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

Примечание

Этот модуль входит в коллекцию dellemc.openmanage (версия 10.0.2).

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

Для установки используйте: ansible-galaxy collection install dellemc.openmanage. Для использования этого модуля требуются дополнительные зависимости; подробности см. в разделе Требования.

Чтобы использовать модуль в плейбуке, укажите: dellemc.openmanage.redfish_storage_volume.

Добавлено в dellemc.openmanage 2.1.0

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

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

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

Требования

Следующие требования должны быть выполнены на узле, где запускается этот модуль.

  • python >= 3.9.6

Параметры

Параметр

Комментарии

apply_time

string

добавлено в dellemc.openmanage 8.5.0

Время применения конфигурации тома.

Immediate позволяет немедленно применить конфигурацию тома на сервере и применить изменения. Это применимо для job_wait.

OnReset позволяет применить изменения при следующей перезагрузке сервера.

Значение apply_time по умолчанию зависит от типа контроллера. Например, для контроллеров BOSS-S1 и BOSS-N1 значение apply_time по умолчанию — OnReset, а для контроллеров PERC — Immediate.

Варианты:

  • "Immediate"
  • "OnReset"

baseuri

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

IP-адрес целевого контроллера внеполосного управления. Например: <ipaddress>:<port>.

block_size_bytes

integer

(устарело) Размер блока в байтах. Применимо только, если state имеет значение present.

ca_path

path

добавлено в dellemc.openmanage 5.0.0

Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки.

capacity_bytes

string

Размер тома в байтах.

Применимо только, если state имеет значение present.

command

string

initialize инициализирует существующий том хранилища с указанным volume_id.

Варианты:

  • "initialize"

controller_id

string

Полный квалифицированный дескриптор устройства (FQDD) контроллера хранилища.

Например: RAID.Slot.1-1.

Этот параметр обязателен, если при создании тома state имеет значение present.

drives

list / элементы=string

FQDD физических дисков.

Например: Disk.Bay.0:Enclosure.Internal.0-1:RAID.Slot.1-1.

Применимо только при создании нового тома, если state имеет значение present.

encrypted

boolean

Указывает, используется ли в настоящее время шифрование тома.

Применимо только, если state имеет значение present.

Варианты:

  • false
  • true

encryption_types

string

(устарело) Можно выбрать следующие типы шифрования.

ControllerAssisted Том шифруется сущностью контроллера хранилища.

NativeDriveEncryption Том использует встроенные возможности шифрования оборудования накопителя.

SoftwareAssisted Том шифруется программным обеспечением, работающим в системе или операционной системе.

Применимо только, если state имеет значение present.

Варианты:

  • "NativeDriveEncryption"
  • "ControllerAssisted"
  • "SoftwareAssisted"

force_reboot

boolean

добавлено в dellemc.openmanage 8.5.0

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

force_reboot применяется только, если reboot_server имеет значение true.

Варианты:

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

initialize_type

string

Тип инициализации существующего тома.

Применимо только, если command имеет значение initialize.

Варианты:

  • "Fast" ← (по умолчанию)
  • "Slow"

job_wait

boolean

добавлено в dellemc.openmanage 8.5.0

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

Применимо, если apply_time имеет значение Immediate.

Применимо, если apply_time имеет значение OnReset, а reboot_server — true.

Варианты:

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

job_wait_timeout

integer

добавлено в dellemc.openmanage 8.5.0

Максимальное время ожидания завершения job_wait в секундах.

Этот параметр применим, если job_wait имеет значение true.

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

name

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

string

Имя создаваемого тома.

Применимо только, если state имеет значение present.

oem

dictionary

Содержит расширенные данные OEM.

Применимо только, если state имеет значение present.

optimum_io_size_bytes

integer

Размер страйпа должен быть кратен 64 * 1024.

Применимо только, если state имеет значение present.

password

string

Пароль целевого контроллера внеполосного управления.

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

Пример: export IDRAC_PASSWORD=password

raid_type

string

добавлено в dellemc.openmanage 8.3.0

RAID0 для создания тома типа RAID0.

RAID1 для создания тома типа RAID1.

RAID5 для создания тома типа RAID5.

RAID6 для создания тома типа RAID6.

RAID10 для создания тома типа RAID10.

RAID50 для создания тома типа RAID50.

RAID60 для создания тома типа RAID60.

raid_type нельзя использовать одновременно с volume_type.

Варианты:

  • "RAID0"
  • "RAID1"
  • "RAID5"
  • "RAID6"
  • "RAID10"
  • "RAID50"
  • "RAID60"

reboot_server

boolean

добавлено в dellemc.openmanage 8.5.0

Перезагрузить сервер для применения изменений.

reboot_server применим только, если apply_timeout имеет значение OnReset или значение времени применения по умолчанию для контроллера равно OnReset.

Варианты:

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

state

string

present создает том хранилища для указанного I (controller_id) или изменяет том хранилища для указанного I (volume_id). «Примечание: возможность изменения свойств существующего тома зависит от возможностей диска и контроллера».

absent удаляет том с указанным volume_id.

Варианты:

  • "present"
  • "absent"

timeout

integer

добавлено в dellemc.openmanage 5.0.0

Тайм-аут на уровне сокета в секундах.

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

username

string

Имя пользователя целевого контроллера внеполосного управления.

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

Пример: export IDRAC_USERNAME=username

validate_certs

boolean

добавлено в dellemc.openmanage 5.0.0

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

Настраивайте false только в контролируемых вами средах, где используются самозаверяющие сертификаты.

До версии коллекции 5.0.0 значение validate_certs по умолчанию — false.

Варианты:

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

volume_id

string

FQDD существующего тома.

Например: Disk.Virtual.4:RAID.Slot.1-1.

Этот параметр обязателен в следующих случаях:

state имеет значение present при обновлении тома.

state имеет значение absent при удалении тома.

command имеет значение initialize при инициализации тома.

volume_type

string

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

NonRedundant Том представляет собой устройство хранения без резервирования.

Mirrored Том представляет собой зеркальное устройство.

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

SpannedMirrors Том представляет собой объединенный набор зеркальных устройств.

SpannedStripesWithParity Том представляет собой объединенный набор устройств, использующих четность для хранения избыточной информации.

volume_type нельзя использовать одновременно с raid_type.

Варианты:

  • "NonRedundant"
  • "Mirrored"
  • "StripedWithParity"
  • "SpannedMirrors"
  • "SpannedStripesWithParity"

x_auth_token

string

добавлено в dellemc.openmanage 9.3.0

Токен аутентификации.

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

Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

  • Запускайте этот модуль в системе, имеющей прямой доступ к API Redfish.
  • Этот модуль поддерживает check_mode.
  • Этот модуль всегда сообщает об изменениях, если не указаны name и volume_id. Для поддержки check_mode требуется указать либо name, либо volume_id.
  • Этот модуль не поддерживает создание томов хранилища RAID6 и RAID60 на iDRAC8.
  • Этот модуль поддерживает адреса IPv4 и IPv6.

Примеры

---
- name: Create a volume with supported options
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    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
    capacity_bytes: 299439751168
    optimum_io_size_bytes: 65536
    encrypted: true

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

- name: Create a RAID0 on PERC controller on reset
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    controller_id: "RAID.Slot.1-1"
    raid_type: "RAID0"
    drives:
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-2
    apply_time: OnReset

- name: Create a RAID0 on BOSS controller with restart
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    controller_id: "RAID.Slot.1-1"
    raid_type: "RAID0"
    drives:
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-2
    apply_time: OnReset
    reboot_server: true

- name: Create a RAID0 on BOSS controller with force restart
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    controller_id: "RAID.Slot.1-1"
    raid_type: "RAID0"
    drives:
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-2
    reboot_server: true
    force_reboot: true

- name: Modify a volume's encryption type settings
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "present"
    volume_id: "Disk.Virtual.5:RAID.Slot.1-1"
    encrypted: true

- name: Delete an existing volume
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    ca_path: "/path/to/ca_cert.pem"
    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"
    ca_path: "/path/to/ca_cert.pem"
    command: "initialize"
    volume_id: "Disk.Virtual.6:RAID.Slot.1-1"
    initialize_type: "Slow"

- name: Create a RAID6 volume
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    controller_id: "RAID.Slot.1-1"
    raid_type: "RAID6"
    drives:
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-2
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-3
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-4

- name: Create a RAID60 volume
  dellemc.openmanage.redfish_storage_volume:
    baseuri: "192.168.0.1"
    username: "username"
    password: "password"
    state: "present"
    controller_id: "RAID.Slot.1-1"
    raid_type: "RAID60"
    drives:
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-2
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-3
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-4
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-5
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-6
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-7
      - Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-8

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

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

Ключ

Описание

error_info

dictionary

Сведения об ошибке HTTP.

Возвращается: при ошибке HTTP

Пример: {"error": {"@Message.ExtendedInfo": [{"Message": "Unable to perform configuration operations because a configuration job for the device already exists.", "MessageArgs": [], "MessageArgs@odata.count": 0, "MessageId": "IDRAC.1.6.STOR023", "RelatedProperties": [], "RelatedProperties@odata.count": 0, "Resolution": "Wait for the current job for the device to complete or cancel the current job before attempting more configuration operations on the device.", "Severity": "Informational"}], "code": "Base.1.2.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information"}}

msg

string

Общий статус операции настройки хранилища.

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

Пример: "Successfully submitted create volume task."

task

dictionary

Возвращает идентификатор и URI созданной задачи.

Возвращается: при успешном выполнении

Пример: {"id": "JID_XXXXXXXXXXXXX", "uri": "/redfish/v1/Managers/iDRAC.Embedded.1/Jobs/JID_XXXXXXXXXXXXX"}

Авторы

  • Sajna Shetty(@Sajna-Shetty)
  • Kritika Bhateja(@Kritika-Bhateja-03)
  • Shivam Sharma(@ShivamSh3)

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

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

© 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/dellemc/openmanage/redfish_storage_volume_module.html

Spec-Zone.ru

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