Модуль cisco.intersight.intersight_boot_order_policy — настройка политики порядка загрузки для Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_boot_order_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. По умолчанию: |
boot_devices list / elements=dictionary | Список устройств загрузки, настроенных на конечном устройстве. |
|
bootloader_description string |
Сведения о загрузчике, используемом при загрузке с локального диска. Параметр используется, если device_type имеет значение local_disk, а configured_boot_mode — Uefi. По умолчанию: |
|
bootloader_name string |
Сведения о загрузчике, используемом при загрузке с локального диска. Параметр используется, если device_type имеет значение local_disk, а configured_boot_mode — Uefi. По умолчанию: |
|
bootloader_path string |
Сведения о загрузчике, используемом при загрузке с локального диска. Параметр используется, если device_type имеет значение local_disk, а configured_boot_mode — Uefi. По умолчанию: |
|
controller_slot string |
Идентификатор слота контроллера для устройства локального диска. Параметр используется, если device_type имеет значение local_disk. Возможные значения:
|
|
device_name string / обязательный |
Имя, позволяющее идентифицировать устройство загрузки. Это может быть любая строка, соответствующая следующим ограничениям. Строка должна начинаться и заканчиваться буквенно-цифровым символом. Допускается использование символов подчёркивания и дефиса. Длина строки не должна превышать 30 символов. |
|
device_type string / обязательный |
Тип устройства, используемый для этого варианта загрузки. Возможные значения определяются названиями устройств в схеме API. Возможные значения:
|
|
enabled boolean |
Указывает, включено или отключено устройство загрузки. Возможные значения:
|
|
interface_name string |
Имя базового виртуального интерфейса Ethernet, используемого устройством загрузки PXE и устройством загрузки SAN. Параметр используется, если device_type имеет значение pxe, а interface_source — name или san. |
|
interface_source string |
Список поддерживаемых источников интерфейса для устройства PXE. Параметр используется, если device_type имеет значение pxe. Возможные значения:
|
|
ip_type string |
Тип семейства IP-адресов, используемый в процессе загрузки PXE. Параметр используется, если device_type имеет значение pxe. Возможные значения:
|
|
lun integer |
Номер логического устройства (LUN). Параметр используется, если device_type имеет значение pch, san или sd_card. Значение LUN должно быть целым числом от 0 до 255. |
|
mac_address string |
MAC-адрес базового виртуального интерфейса Ethernet, используемого устройством загрузки PXE. Параметр используется, если device_type имеет значение pxe, а interface_source — mac. |
|
network_slot string |
Идентификатор слота контроллера для устройства iscsi и pxe. Параметр используется, если device_type имеет значение iscsi или pxe. Возможные значения:
|
|
port integer |
Идентификатор порта контроллера для устройства iscsi и pxe. Параметр используется, если device_type имеет значение iscsi или pxe. Идентификатор порта должен быть целым числом от 0 до 255. |
|
sd_card_subtype string |
Подтип выбранного типа устройства. Параметр используется, если device_type имеет значение sd_card. Возможные значения:
|
|
usb_subtype string |
Подтип выбранного типа устройства. Параметр используется, если device_type имеет значение usb. Возможные значения:
|
|
virtual_media_subtype string |
Подтип выбранного типа устройства. Параметр используется, если device_type имеет значение virtual_media. Возможные значения:
|
|
wwpn string |
WWPN-адрес базового интерфейса Fibre Channel, используемого устройством загрузки SAN. Значение должно быть указано в шестнадцатеричном формате xx:xx:xx:xx:xx:xx:xx:xx. Параметр обязателен, если device_type имеет значение san. |
configured_boot_mode string | Задаёт режим загрузки BIOS. В режиме UEFI используется таблица разделов GUID (GPT), а в устаревшем режиме — схема разметки с главной загрузочной записью (MBR). Возможные значения:
|
description псевдонимы: descr string | Описание политики порядка загрузки, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или подчёркивание (_). |
name string / обязательный | Имя, присвоенное политике порядка загрузки. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_. |
organization string | Имя организации, которой назначен этот ресурс. Профили и политики, созданные в пользовательской организации, применяются только к устройствам этой же организации. По умолчанию: |
state string | Если задано Если задано Возможные значения:
|
tags list / elements=dictionary | Список тегов в формате Key:<ключ, заданный пользователем> Value:<значение, заданное пользователем>. |
uefi_enable_secure_boot boolean | Безопасная загрузка гарантирует, что устройство загружается только с использованием программного обеспечения, которому доверяет производитель оригинального оборудования (OEM). Параметр используется только в том случае, если для configured_boot_mode задано значение Uefi. Возможные значения:
|
use_proxy boolean | Если задано Возможные значения:
|
validate_certs boolean | Логический параметр, управляющий проверкой TLS-сертификата api_uri. Возможные значения:
|
Примеры
- name: Configure Boot Order Policy
cisco.intersight.intersight_boot_order_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: DevNet
name: COS-Boot
description: Boot Order policy for COS
tags:
- Key: Site
Value: RCDN
configured_boot_mode: legacy
boot_devices:
- device_type: Local Disk
device_name: Boot-Lun
controller_slot: MRAID
- name: Configure Boot Order Policy with SAN Boot
cisco.intersight.intersight_boot_order_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: DevNet
name: SAN-Boot
description: Boot Order policy with SAN boot device
configured_boot_mode: Uefi
boot_devices:
- device_type: SAN
device_name: SAN-Primary
interface_name: fc0
network_slot: MLOM
lun: 0
wwpn: "50:00:00:25:B5:00:00:01"
- name: Delete Boot Order Policy
cisco.intersight.intersight_boot_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: DevNet
name: COS-Boot
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
api_response dictionary | Выходные данные ответа API, возвращённые указанным ресурсом. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_boot_order_policy_module.html