Spec-Zone.ru › Ansible

Модуль dellemc.openmanage.idrac_virtual_media – настройка параметров удалённого файлового ресурса.

Примечание

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

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

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

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

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

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

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

  • Этот модуль позволяет настраивать параметры удалённого файлового ресурса.

Требования

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

  • python >= 3.9.6

Параметры

Параметр

Комментарии

ca_path

path

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

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

force

boolean

true извлекает файл образа, если он уже подключён, и подключает файл, указанный в image. Применяется, если insert имеет значение true.

Варианты:

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

idrac_ip

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

IP-адрес iDRAC.

idrac_password

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

string

Пароль пользователя iDRAC.

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

Пример: export IDRAC_PASSWORD=password

idrac_port

integer

Порт iDRAC.

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

idrac_user

string

Имя пользователя iDRAC.

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

Пример: export IDRAC_USERNAME=username

resource_id

string

Идентификатор ресурса iDRAC; если он не указан, используется идентификатор коллекции manager.

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 ← (по умолчанию)

virtual_media

list / elements=dictionary / обязательный

Сведения об удалённом файловом ресурсе.

domain

string

Доменное имя сетевого ресурса. Этот параметр применим к ресурсам CIFS и HTTPS.

image

path

Путь к файлу образа. Поддерживаются файлы типов .img и .iso.

Файл с расширением .img перенаправляется как виртуальная дискета, а файл с расширением .iso — как виртуальный CD-ROM.

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

Примеры расположения ресурса: ресурс CIFS: //192.168.0.1/file_path/image_name.iso, ресурс NFS: 192.168.0.2:/file_path/image_name.img, ресурс HTTP: http://192.168.0.3/file_path/image_name.iso, ресурс HTTPS: https://192.168.0.4/file_path/image_name.img

iDRAC8 не поддерживает ресурсы CIFS.

iDRAC8 не поддерживает ресурсы HTTPS с учётными данными.

index

integer

Индекс удалённого файлового ресурса. Например, чтобы указать удалённый файловый ресурс 1, значение index должно быть равно 1. Если index не указан, будет учитываться порядок элементов в списке virtual_media.

insert

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

true подключает удалённый файл образа.

false извлекает подключённый удалённый файл образа.

Варианты:

  • false
  • true

media_type

string

Тип файла образа. Применяется, если insert имеет значение true.

Варианты:

  • "CD"
  • "DVD"
  • "USBStick"

password

string

Пароль сетевого ресурса. Этот параметр применим к ресурсам CIFS и HTTPS.

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

username

string

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

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 iDRAC.
  • Этот модуль поддерживает check_mode.

Примеры

---
- name: Insert image file to Remote File Share 1 using CIFS share.
  dellemc.openmanage.idrac_virtual_media:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    virtual_media:
      - insert: true
        image: "//192.168.0.2/file_path/file.iso"
        username: "username"
        password: "password"

- name: Insert image file to Remote File Share 2 using NFS share.
  dellemc.openmanage.idrac_virtual_media:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    virtual_media:
      - index: 2
        insert: true
        image: "192.168.0.4:/file_path/file.iso"

- name: Insert image file to Remote File Share 1 and 2 using HTTP.
  dellemc.openmanage.idrac_virtual_media:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    force: true
    virtual_media:
      - index: 1
        insert: true
        image: "http://192.168.0.4/file_path/file.img"
      - index: 2
        insert: true
        image: "http://192.168.0.4/file_path/file.img"

- name: Insert image file using HTTPS.
  dellemc.openmanage.idrac_virtual_media:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    force: true
    virtual_media:
      - index: 1
        insert: true
        image: "https://192.168.0.5/file_path/file.img"
        username: username
        password: password

- name: Eject multiple virtual media.
  dellemc.openmanage.idrac_virtual_media:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    force: true
    virtual_media:
      - index: 1
        insert: false
      - index: 2
        insert: false

- name: Ejection of image file from Remote File Share 1.
  dellemc.openmanage.idrac_virtual_media:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    force: true
    virtual_media:
      insert: false

- name: Insertion and ejection of image file in single task.
  dellemc.openmanage.idrac_virtual_media:
    idrac_ip: "192.168.0.1"
    idrac_user: "user_name"
    idrac_password: "user_password"
    ca_path: "/path/to/ca_cert.pem"
    force: true
    virtual_media:
      - index: 1
        insert: true
        image: https://192.168.0.5/file/file.iso
        username: username
        password: password
      - index: 2
        insert: false

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

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

Ключ

Описание

error_info

dictionary

Сведения об ошибке 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

string

Операция с виртуальным носителем успешно выполнена.

Возвращается: при успехе

Пример: "Successfully performed the virtual media operation."

Авторы

  • Felix Stephen (@felixs88)

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

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

© 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/idrac_virtual_media_module.html

Spec-Zone.ru

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