Spec-Zone.ru › Ansible

Модуль 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.

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

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.

Возможные значения:

  • "1-255"
  • "M"
  • "HBA"
  • "SAS"
  • "RAID"
  • "MRAID"
  • "MSTOR-RAID"

device_name

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

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

Это может быть любая строка, соответствующая следующим ограничениям.

Строка должна начинаться и заканчиваться буквенно-цифровым символом.

Допускается использование символов подчёркивания и дефиса.

Длина строки не должна превышать 30 символов.

device_type

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

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

Возможные значения определяются названиями устройств в схеме API.

Возможные значения:

  • "iSCSI"
  • "Local CDD"
  • "Local Disk"
  • "NVMe"
  • "PCH Storage"
  • "PXE"
  • "SAN"
  • "SD Card"
  • "UEFI Shell"
  • "USB"
  • "Virtual Media"

enabled

boolean

Указывает, включено или отключено устройство загрузки.

Возможные значения:

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

interface_name

string

Имя базового виртуального интерфейса Ethernet, используемого устройством загрузки PXE и устройством загрузки SAN.

Параметр используется, если device_type имеет значение pxe, а interface_source — name или san.

interface_source

string

Список поддерживаемых источников интерфейса для устройства PXE.

Параметр используется, если device_type имеет значение pxe.

Возможные значения:

  • "name" ← (по умолчанию)
  • "mac"
  • "port"

ip_type

string

Тип семейства IP-адресов, используемый в процессе загрузки PXE.

Параметр используется, если device_type имеет значение pxe.

Возможные значения:

  • "None" ← (по умолчанию)
  • "IPv4"
  • "IPv6"

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.

Возможные значения:

  • "1 - 255"
  • "MLOM"
  • "L"
  • "L1"
  • "L2"
  • "OCP"

port

integer

Идентификатор порта контроллера для устройства iscsi и pxe.

Параметр используется, если device_type имеет значение iscsi или pxe.

Идентификатор порта должен быть целым числом от 0 до 255.

sd_card_subtype

string

Подтип выбранного типа устройства.

Параметр используется, если device_type имеет значение sd_card.

Возможные значения:

  • "None" ← (по умолчанию)
  • "flex-util"
  • "flex-flash"
  • "SDCARD"

usb_subtype

string

Подтип выбранного типа устройства.

Параметр используется, если device_type имеет значение usb.

Возможные значения:

  • "None" ← (по умолчанию)
  • "usb-cd"
  • "usb-fdd"
  • "usb-hdd"

virtual_media_subtype

string

Подтип выбранного типа устройства.

Параметр используется, если device_type имеет значение virtual_media.

Возможные значения:

  • "None" ← (по умолчанию)
  • "cimc-mapped-dvd"
  • "cimc-mapped-hdd"
  • "kvm-mapped-dvd"
  • "kvm-mapped-hdd"
  • "kvm-mapped-fdd"

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).

Возможные значения:

  • "Legacy" ← (по умолчанию)
  • "Uefi"

description

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

string

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

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

name

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

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

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

organization

string

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

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

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

state

string

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

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

Возможные значения:

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

tags

list / elements=dictionary

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

uefi_enable_secure_boot

boolean

Безопасная загрузка гарантирует, что устройство загружается только с использованием программного обеспечения, которому доверяет производитель оригинального оборудования (OEM).

Параметр используется только в том случае, если для configured_boot_mode задано значение Uefi.

Возможные значения:

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

use_proxy

boolean

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

Возможные значения:

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

validate_certs

boolean

Логический параметр, управляющий проверкой TLS-сертификата api_uri.

Возможные значения:

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

Примеры

- 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, возвращённые указанным ресурсом.

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

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

Авторы

  • Tse Kai “Kevin” Chan (@BrightScale)

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

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

© 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

Spec-Zone.ru

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