модуль 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 | Время применения конфигурации тома.
Значение apply_time по умолчанию зависит от типа контроллера. Например, для контроллеров BOSS-S1 и BOSS-N1 значение apply_time по умолчанию — Варианты:
|
baseuri string / обязательный | IP-адрес целевого контроллера внеполосного управления. Например: <ipaddress>:<port>. |
block_size_bytes integer | (устарело) Размер блока в байтах. Применимо только, если state имеет значение |
ca_path path добавлено в dellemc.openmanage 5.0.0 | Файл Privacy Enhanced Mail (PEM), содержащий сертификат CA для проверки. |
capacity_bytes string | Размер тома в байтах. Применимо только, если state имеет значение |
command string |
Варианты:
|
controller_id string | Полный квалифицированный дескриптор устройства (FQDD) контроллера хранилища. Например: RAID.Slot.1-1. Этот параметр обязателен, если при создании тома state имеет значение |
drives list / элементы=string | FQDD физических дисков. Например: Disk.Bay.0:Enclosure.Internal.0-1:RAID.Slot.1-1. Применимо только при создании нового тома, если state имеет значение |
encrypted boolean | Указывает, используется ли в настоящее время шифрование тома. Применимо только, если state имеет значение Варианты:
|
encryption_types string | (устарело) Можно выбрать следующие типы шифрования.
Применимо только, если state имеет значение Варианты:
|
force_reboot boolean добавлено в dellemc.openmanage 8.5.0 | Принудительно перезагрузить сервер для применения изменений, если обычная перезагрузка не удалась. force_reboot применяется только, если reboot_server имеет значение Варианты:
|
initialize_type string | Тип инициализации существующего тома. Применимо только, если command имеет значение Варианты:
|
job_wait boolean добавлено в dellemc.openmanage 8.5.0 | Этот параметр позволяет дождаться завершения задания. Применимо, если apply_time имеет значение Применимо, если apply_time имеет значение Варианты:
|
job_wait_timeout integer добавлено в dellemc.openmanage 8.5.0 | Максимальное время ожидания завершения job_wait в секундах. Этот параметр применим, если job_wait имеет значение По умолчанию: |
name псевдонимы: volume_name string | Имя создаваемого тома. Применимо только, если state имеет значение |
oem dictionary | Содержит расширенные данные OEM. Применимо только, если state имеет значение present. |
optimum_io_size_bytes integer | Размер страйпа должен быть кратен 64 * 1024. Применимо только, если state имеет значение |
password string | Пароль целевого контроллера внеполосного управления. Если пароль не указан, используется переменная среды Пример: export IDRAC_PASSWORD=password |
raid_type string добавлено в dellemc.openmanage 8.3.0 |
raid_type нельзя использовать одновременно с volume_type. Варианты:
|
reboot_server boolean добавлено в dellemc.openmanage 8.5.0 | Перезагрузить сервер для применения изменений. reboot_server применим только, если apply_timeout имеет значение Варианты:
|
state string |
Варианты:
|
timeout integer добавлено в dellemc.openmanage 5.0.0 | Тайм-аут на уровне сокета в секундах. По умолчанию: |
username string | Имя пользователя целевого контроллера внеполосного управления. Если имя пользователя не указано, используется переменная среды Пример: export IDRAC_USERNAME=username |
validate_certs boolean добавлено в dellemc.openmanage 5.0.0 | Если Настраивайте До версии коллекции Варианты:
|
volume_id string | FQDD существующего тома. Например: Disk.Virtual.4:RAID.Slot.1-1. Этот параметр обязателен в следующих случаях: state имеет значение state имеет значение command имеет значение |
volume_type string | Для создания тома необходимо выбрать один из следующих типов.
volume_type нельзя использовать одновременно с raid_type. Варианты:
|
x_auth_token string добавлено в dellemc.openmanage 9.3.0 | Токен аутентификации. Если 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 Пример: |
msg string | Общий статус операции настройки хранилища. Возвращается: всегда Пример: |
task dictionary | Возвращает идентификатор и URI созданной задачи. Возвращается: при успешном выполнении Пример: |
Ссылки на коллекцию
© 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