Spec-Zone.ru › Ansible

Модуль cisco.intersight.intersight_virtual_media_policy — настройка политики виртуальных носителей для Cisco Intersight

Примечание

Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).

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

Для установки используйте: ansible-galaxy collection install cisco.intersight.

Чтобы использовать коллекцию в плейбуке, укажите: cisco.intersight.intersight_virtual_media_policy.

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

Обзор

  • Настройка политики виртуальных носителей для Cisco Intersight.
  • Используется для настройки сопоставлений образов виртуальных носителей на устройствах, управляемых Cisco Intersight.
  • Дополнительные сведения см. в документации Cisco Intersight.

Параметры

Параметр

Комментарии

api_key_id

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

Идентификатор открытого API-ключа, связанного с закрытым ключом.

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

api_private_key

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

Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате PEM, используемого для аутентификации в API Intersight.

Если используется строка, зашифруйте строковые данные с помощью Ansible Vault.

Например: ansible-vault encrypt_string --vault-id tme@/Users/dsoper/Documents/vault_password_file ‘-----BEGIN EC PRIVATE KEY-----

<your private key data>

-----END EC PRIVATE KEY-----’

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

api_uri

string

URI для доступа к API Intersight.

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

По умолчанию: "https://intersight.com/api/v1"

cdd_virtual_media

dictionary

Параметры сопоставления образа виртуального носителя CDD.

authentication_protocol

string

Протокол аутентификации для типа монтирования CIFS

По умолчанию: "none"

enable

boolean

Включить или отключить сопоставление образа CDD.

Варианты:

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

mount_options

string

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

Для NFS поддерживаются параметры ro, rw, nolock, noexec, soft, port=VALUE, timeo=VALUE, retry=VALUE

Для CIFS поддерживаются параметры soft, nounix, noserverino, guest

mount_type

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

Тип (протокол) сетевого ресурса, используемого remote_hostname.

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

Если выбран тип монтирования CIFS, убедитесь, что порт 445 (порт связи CIFS) на remote_hostname доступен.

Для HTTP убедитесь, что доступен порт 80.

Для HTTPS убедитесь, что доступен порт 443.

Для NFS убедитесь, что доступен порт 2049.

Варианты:

  • "nfs"
  • "cifs"
  • "http"
  • "https"

password

string

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

remote_file

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

Имя файла удалённого образа.

Например: custom_image.iso

remote_hostname

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

Имя хоста или IP-адрес сервера, на котором размещён образ виртуального носителя.

remote_path

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

Путь к файлу удалённого образа (без имени файла).

Например: mnt/SHARE/ISOS

username

string

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

volume

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

Имя, заданное пользователем для образа, смонтированного для сопоставления.

description

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

string

Описание политики NTP, заданное пользователем.

Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или символ подчёркивания (_).

enable

boolean

Включить или отключить виртуальные носители.

Варианты:

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

encryption

boolean

Если включено, шифруется весь обмен данными с виртуальными носителями.

Варианты:

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

hdd_virtual_media

dictionary

Параметры сопоставления образа виртуального носителя HDD.

authentication_protocol

string

Протокол аутентификации для типа монтирования CIFS

По умолчанию: "none"

enable

boolean

Включить или отключить сопоставление образа HDD.

Варианты:

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

mount_options

string

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

Для NFS поддерживаются параметры ro, rw, nolock, noexec, soft, port=VALUE, timeo=VALUE, retry=VALUE

Для CIFS поддерживаются параметры soft, nounix, noserverino, guest

mount_type

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

Тип (протокол) сетевого ресурса, используемого remote_hostname.

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

Если выбран тип монтирования CIFS, убедитесь, что порт 445 (порт связи CIFS) на remote_hostname доступен.

Для HTTP убедитесь, что доступен порт 80.

Для HTTPS убедитесь, что доступен порт 443.

Для NFS убедитесь, что доступен порт 2049.

Варианты:

  • "nfs"
  • "cifs"
  • "http"
  • "https"

password

string

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

remote_file

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

Имя файла удалённого образа.

Например: custom_image.iso

remote_hostname

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

Имя хоста или IP-адрес сервера, на котором размещён образ виртуального носителя.

remote_path

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

Путь к файлу удалённого образа (без имени файла).

Например: mnt/SHARE/ISOS

username

string

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

volume

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

Имя, заданное пользователем для образа, смонтированного для сопоставления.

low_power_usb

boolean

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

Варианты:

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

name

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

Имя, присвоенное политике NTP.

Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.

organization

string

Имя организации, которой назначен этот ресурс.

Профили и политики, созданные в пользовательской организации, применяются только к устройствам в этой же организации.

По умолчанию: "default"

state

string

Если задано значение present, будет проверено наличие ресурса, и при необходимости он будет создан.

Если задано значение absent, будет проверено отсутствие ресурса, и при необходимости он будет удалён.

Варианты:

  • "present" ← (по умолчанию)
  • "absent"

tags

list / elements=dictionary

Список тегов в формате Key:<ключ, заданный пользователем> Value:<значение, заданное пользователем>.

use_proxy

boolean

Если задано значение no, прокси-сервер использоваться не будет, даже если он указан в переменной окружения на целевых хостах.

Варианты:

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

validate_certs

boolean

Логический параметр для проверки сертификата TLS api_uri

Варианты:

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

Примеры

- name: Configure Virtual Media Policy
  cisco.intersight.intersight_virtual_media_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: DevNet
    name: lab-vmedia
    description: Virutal Media policy for lab use
    tags:
      - Key: Site
        Value: RCDN
    cdd_virtual_media:
      mount_type: nfs
      volume: nfs-cdd
      remote_hostname: 172.28.224.77
      remote_path: mnt/SHARE/ISOS/CENTOS
      remote_file: CentOS7.iso
    hdd_virtual_media:
      mount_type: nfs
      volume: nfs-hdd
      remote_hostname: 172.28.224.77
      remote_path: mnt/SHARE/ISOS/CENTOS
      remote_file: CentOS7.iso

- name: Delete Virtual Media Policy
  cisco.intersight.intersight_virtual_media_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: DevNet
    name: lab-vmedia
    state: absent

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

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

Ключ

Описание

api_response

dictionary

Выходные данные ответа API, возвращённые указанным ресурсом.

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

Пример: {"api_response": {"Name": "lab-ntp", "ObjectType": "ntp.Policy", "Tags": [{"Key": "Site", "Value": "RCDN"}]}}

Авторы

  • David Soper (@dsoper2)
  • Sid Nath (@SidNath21)

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

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

© 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/cisco/intersight/intersight_virtual_media_policy_module.html

Spec-Zone.ru

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