Spec-Zone.ru › Ansible

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

Примечание

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

У вас может быть уже установлена эта коллекция, если вы используете пакет 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

путь

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

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

force

булево

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

Варианты:

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

idrac_ip

строка / обязательно

IP-адрес iDRAC.

idrac_password

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

строка

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

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

Пример: export IDRAC_PASSWORD=password

idrac_port

целое число

Порт iDRAC.

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

idrac_user

строка

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

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

Пример: export IDRAC_USERNAME=username

resource_id

строка

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

timeout

целое число

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

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

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

validate_certs

булево

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

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

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

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

Варианты:

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

virtual_media

список / элементы=словарь / обязательно

Подробная информация о сетевом ресурсе.

domain

строка

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

image

путь

Путь к файлу образа. Поддерживаются типы файлов .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

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

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

index

целое число

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

insert

булево / обязательно

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

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

Варианты:

  • false
  • true

media_type

строка

Тип файла образа. Применим, когда insert true.

Варианты:

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

password

строка

Пароль сетевого ресурса. Применим для CIFS и HTTPS-ресурсов.

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

username

строка

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

x_auth_token

строка

добавлен в 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

словарь

Подробная информация об ошибке 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

строка

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

Возвращаемое значение: success

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

Авторы

  • Felix Stephen (@felixs88)

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

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (источники)

© 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_virtual_media_module.html

Spec-Zone.ru

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