Spec-Zone.ru › Ansible

Модуль cisco.intersight.intersight_firmware_policy — настройка политики микропрограмм для Cisco Intersight

Примечание

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

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

Чтобы установить её, используйте: ansible-galaxy collection install cisco.intersight.

Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_firmware_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"

description

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

string

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

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

exclude_drives

boolean

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

В ExcludeComponentList добавляется local-disk.

Варианты:

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

exclude_storage_controllers

boolean

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

В ExcludeComponentList добавляется storage-controller.

Варианты:

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

model_bundle_combo

list / элементы=dictionary

Список пар «модель сервера — версия микропрограммы».

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

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

bundle_version

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

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

model_family

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

Семейство моделей серверов (например, UCSC-C220-M5, UCSC-C220-M4, UCSC-C220-M7).

name

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

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

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

organization

string

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

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

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

state

string

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

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

Варианты:

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

tags

list / элементы=dictionary

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

По умолчанию: []

target_platform

string

Тип платформы, для которой предназначена политика микропрограмм.

Тип сервера может быть Standalone или FIAttached.

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

Варианты:

  • "Standalone"
  • "FIAttached"

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

Включает или отключает проверку TLS-сертификата api_uri.

Варианты:

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

Примеры

- name: Create a firmware policy for standalone servers
  cisco.intersight.intersight_firmware_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "Standalone-Firmware-Policy"
    description: "Firmware policy for standalone servers"
    target_platform: "Standalone"
    model_bundle_combo:
      - model_family: "UCSC-C220-M5"
        bundle_version: "4.3(2.250037)"
      - model_family: "UCSC-C220-M4"
        bundle_version: "4.1(2m)"
    tags:
      - Key: "Environment"
        Value: "Production"

- name: Create a firmware policy with excluded components
  cisco.intersight.intersight_firmware_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "Firmware-Policy-With-Exclusions"
    description: "Firmware policy excluding storage components"
    target_platform: "Standalone"
    model_bundle_combo:
      - model_family: "UCSC-C220-M7"
        bundle_version: "4.3(4.242038)"
    exclude_drives: true
    exclude_storage_controllers: true
    tags:
      - Key: "Site"
        Value: "Datacenter1"

- name: Delete a firmware policy
  cisco.intersight.intersight_firmware_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "Old-Firmware-Policy"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

Ответ API, возвращённый указанным ресурсом.

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

Пример: {"api_response": {"ExcludeComponentList": ["local-disk", "storage-controller"], "ModelBundleCombo": [{"BundleVersion": "4.3(2.250037)", "ModelFamily": "UCSC-C220-M5"}], "Name": "Standalone-Firmware-Policy", "ObjectType": "firmware.Policy", "Tags": [{"Key": "Environment", "Value": "Production"}], "TargetPlatform": "Standalone"}}

Авторы

  • Ron Gershburg (@rgershbu)

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

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

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

Spec-Zone.ru

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