dellemc.openmanage.idrac_storage_volume модуль — Настройка атрибутов конфигурации RAID

Примечание

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

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

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

Чтобы использовать его в книге задач, укажите: dellemc.openmanage.idrac_storage_volume.

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

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

Описание

Этот модуль отвечает за настройку атрибутов RAID.

Псевдонимы: dellemc_idrac_storage_volume

Требования

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

python >= 3.9.6

Параметры

Параметр	Комментарии
ca_path путь добавлен в dellemc.openmanage 5.0.0	Файл PEM (Privacy Enhanced Mail), содержащий сертификат CA, используемый для валидации.
capacity вещественное число	Размер виртуального диска в ГБ.
controller_id строка	Полное квалифицированное описание устройства (FQDD) контроллера хранилища, например, ‘RAID.Integrated.1-1’. FQDD контроллера требуется для `create` конфигурации RAID.
disk_cache_policy строка	Политика кэширования диска. Выбор: `"Default"` ← (по умолчанию) `"Enabled"` `"Disabled"`
idrac_ip строка / обязательно	IP-адрес iDRAC.
idrac_password псевдонимы: idrac_pwd строка	Пароль пользователя iDRAC. Если пароль не указан, используется переменная среды `IDRAC_PASSWORD`. Пример: export IDRAC_PASSWORD=пароль
idrac_port целое число	Порт iDRAC. По умолчанию: `443`
idrac_user строка	Имя пользователя iDRAC. Если имя пользователя не указано, используется переменная среды `IDRAC_USERNAME`. Пример: export IDRAC_USERNAME=имя_пользователя
job_wait булево	Данный параметр предоставляет возможность ожидания завершения задачи. Применимо, когда state равен `create` или `delete`. Выбор: `false` `true` ← (по умолчанию)
job_wait_timeout целое число	Данный параметр — максимальное время ожидания job_wait в секундах. Применимо, когда job_wait равен `true`. По умолчанию: `900`
media_type строка	Тип носителя. Выбор: `"HDD"` `"SSD"`
number_dedicated_hot_spare целое число	Количество выделенных резервных дисков. По умолчанию: `0`
protocol строка	Протокол шины. Выбор: `"SAS"` `"SATA"` `"PCIE"`
raid_init_operation строка	Данный параметр представляет операцию конфигурации инициализации, которая должна быть выполнена на виртуальном диске. Выбор: `"None"` `"Fast"`
raid_reset_config строка	Данный параметр определяет, необходимо ли выполнять операцию сброса конфигурации на контроллере RAID. Операция сброса конфигурации удаляет все виртуальные диски, присутствующие на контроллере RAID. Выбор: `"true"` `"false"` ← (по умолчанию)
read_cache_policy строка	Политика кэширования чтения. Выбор: `"NoReadAhead"` ← (по умолчанию) `"ReadAhead"` `"AdaptiveReadAhead"`
span_depth целое число	Количество сегментов в конфигурации RAID. span_depth требуется для `create`, и его значение зависит от volume_type. По умолчанию: `1`
span_length целое число	Количество дисков в сегменте. span_length требуется для `create`, и его значение зависит от volume_type. По умолчанию: `1`

state string	`create`, выполняет операцию создания тома. `delete`, выполняет операцию удаления тома. `view`, возвращает представление хранилища. Выбооры: `"create"` `"delete"` `"view"` ← (по умолчанию)
stripe_size integer	Значение размера полосы, которое должно быть кратно 64 * 1024. По умолчанию: `65536`
time_to_wait integer	Максимальное время ожидания перед завершением операции импорта профиля конфигурации сервера (SCP) в секундах. Этот параметр применим, когда state равен `create` или `delete`. По умолчанию: `300`
timeout integer добавлен в dellemc.openmanage 5.0.0	Таймаут уровня сокета в секундах. По умолчанию: `30`
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.0:RAID.Slot.1-1». Этот параметр используется для получения информации о виртуальном диске.
volume_type string	Укажите требуемый уровень RAID. Выбооры: `"RAID 0"` ← (по умолчанию) `"RAID 1"` `"RAID 5"` `"RAID 6"` `"RAID 10"` `"RAID 50"` `"RAID 60"`
volumes list / elements=dictionary	Список атрибутов iDRAC, специфичных для виртуальных дисков. Это применимо для операций `create` и `delete`. Для операции `create`, параметры name и drives являются допустимыми, а также могут быть указаны другие параметры тома. drives — обязательный параметр для операции `create` и принимает либо location (список слотов накопителя), либо id (список FQDD накопителя). В iDRAC8 нет предварительной проверки состояния накопителей. Идентификатор или номер слота диска, предоставленного вами, могут или не могут находиться в состоянии Ready. Введите идентификатор или номер слота диска, который уже находится в состоянии Ready. Для операции `delete` применим только параметр name. См. примеры для получения более подробной информации.
write_cache_policy string	Политика кэширования записи. Выбооры: `"WriteThrough"` ← (по умолчанию) `"WriteBack"` `"WriteBackForce"`
x_auth_token string добавлен в dellemc.openmanage 9.3.0	Токен аутентификации. Если x_auth_token не предоставлен, используется переменная среды `IDRAC_X_AUTH_TOKEN`. Пример: export IDRAC_X_AUTH_TOKEN=x_auth_token

Примечания

Примечание

Запустите этот модуль с системы, имеющей прямой доступ к интегрированному контроллеру удаленного доступа Dell.
Этот модуль поддерживает как IPv4, так и IPv6 адреса для idrac_ip.
Этот модуль поддерживает check_mode.
Этот модуль не отображает данные о батарее контроллера для операции view хранилища в iDRAC8.

Примеры

---
- name: Create single volume
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "create"
    controller_id: "RAID.Slot.1-1"
    volumes:
      - drives:
        location: [5]

- name: Create multiple volume
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    raid_reset_config: "True"
    state: "create"
    controller_id: "RAID.Slot.1-1"
    volume_type: "RAID 1"
    span_depth: 1
    span_length: 2
    number_dedicated_hot_spare: 1
    disk_cache_policy: "Enabled"
    write_cache_policy: "WriteBackForce"
    read_cache_policy: "ReadAhead"
    stripe_size: 65536
    capacity: 100
    raid_init_operation: "Fast"
    volumes:
      - name: "volume_1"
        drives:
          id: ["Disk.Bay.1:Enclosure.Internal.0-1:RAID.Slot.1-1", "Disk.Bay.2:Enclosure.Internal.0-1:RAID.Slot.1-1"]
      - name: "volume_2"
        volume_type: "RAID 5"
        span_length: 3
        span_depth: 1
        drives:
          location: [7, 3, 5]
        disk_cache_policy: "Disabled"
        write_cache_policy: "WriteBack"
        read_cache_policy: "NoReadAhead"
        stripe_size: 131072
        capacity: "200"
        raid_init_operation: "None"

- name: View all volume details
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "view"

- name: View specific volume details
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "view"
    controller_id: "RAID.Slot.1-1"
    volume_id: "Disk.Virtual.0:RAID.Slot.1-1"

- name: Delete single volume
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "delete"
    volumes:
      - name: "volume_1"

- name: Delete multiple volume
  dellemc.openmanage.idrac_storage_volume:
    idrac_ip: "192.168.0.1"
    idrac_user: "username"
    idrac_password: "password"
    ca_path: "/path/to/ca_cert.pem"
    state: "delete"
    volumes:
      - name: "volume_1"
      - name: "volume_2"

Значения возврата

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

Ключ	Описание
error_info словарь	Подробная информация об ошибке HTTP. Возвращается: при ошибке HTTP Пример: `{"error": {"@Message.ExtendedInfo": [{"Message": "Unable to process the request because an error occurred.", "MessageArgs": [], "MessageId": "GEN1234", "RelatedProperties": [], "Resolution": "Retry the operation. If the issue persists, contact your system administrator.", "Severity": "Critical"}], "code": "Base.1.0.GeneralError", "message": "A general error has occurred. See ExtendedInfo for more information."}}`
msg строка	Общий статус операции конфигурации хранилища. Возвращается: всегда Пример: `"Successfully completed the view storage volume operation"`
storage_status словарь	Подробности задачи конфигурации хранилища и ход выполнения из iDRAC. Возвращается: при успехе Пример: `{"Id": "JID_XXXXXXXXX", "JobState": "Completed", "JobType": "ImportConfiguration", "Message": "Successfully imported and applied Server Configuration Profile.", "MessageId": "XXX123", "Name": "Import Configuration", "PercentComplete": 100, "StartTime": "TIME_NOW", "TargetSettingsURI": null}`

Авторы

Felix Stephen (@felixs88)
Kritika Bhateja (@Kritika-Bhateja-03)
Abhishek Sinha(@ABHISHEK-SINHA10)

Ссылки на сборку

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