Spec-Zone.ru › Ansible

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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: cisco.intersight.intersight_power_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), дефис (-), точку (.), двоеточие (:) или подчеркивание (_).

dynamic_power_rebalancing

string

Задает режим динамического перераспределения питания шасси.

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

Применимо к платформам «Chassis» и «All».

Варианты:

  • "Enabled" ← (по умолчанию)
  • "Disabled"

extended_power_capacity

string

Задает расширенную мощность шасси.

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

Этот параметр поддерживается только для шасси Cisco UCS X series.

Применимо к платформам «Chassis» и «All».

Варианты:

  • "Enabled" ← (по умолчанию)
  • "Disabled"

name

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

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

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

organization

string

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

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

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

power_allocation

integer

Задает предел максимального потребления входной мощности шасси (в ваттах). Значение 0 означает отсутствие ограничения.

Применимо к платформам «Chassis» и «All».

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

power_priority

string

Задает приоритет питания сервера. Этот приоритет используется для определения начального распределения питания между серверами.

Это поле поддерживается только для серверов Cisco UCS B series и X series.

Применимо к платформам «FIAttached» и «All».

Варианты:

  • "Low" ← (по умолчанию)
  • "Medium"
  • "High"

power_profiling

string

Задает профилирование питания сервера.

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

Это поле поддерживается только для серверов Cisco UCS X series.

Применимо к платформам «FIAttached» и «All».

Варианты:

  • "Enabled" ← (по умолчанию)
  • "Disabled"

power_redundancy

string

Задает режим резервирования питания шасси. Режим резервирования определяет количество блоков питания, которые шасси сохраняет в резерве.

Режим N+2 поддерживается только для шасси Cisco UCS X series.

Применимо к платформам «Chassis» и «All».

Варианты:

  • "Grid" ← (по умолчанию)
  • "NotRedundant"
  • "N+1"
  • "N+2"

power_restore

string

Задает состояние питания сервера после восстановления.

При отсутствии подключения к Intersight шасси/сервер использует эту политику для восстановления питания хоста после сбоя питания.

Применимо к платформам «Standalone», «FIAttached» и «All».

Варианты:

  • "AlwaysOff" ← (по умолчанию)
  • "AlwaysOn"
  • "LastState"

power_save_mode

string

Задает режим энергосбережения шасси.

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

Применимо к платформам «Chassis» и «All».

Варианты:

  • "Enabled" ← (по умолчанию)
  • "Disabled"

processor_package_power_limit

string

Задает ограничение мощности пакета процессора (PPL) сервера. PPL — это количество мощности, которое может потреблять ЦП от источника питания.

Функция ограничения мощности пакета процессора (PPL) в настоящее время доступна только на серверах Cisco UCS C225/C245 M8.

Применимо к платформам «Standalone», «FIAttached» и «All».

Варианты:

  • "Default" ← (по умолчанию)
  • "Maximum"
  • "Minimum"

state

string

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

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

Варианты:

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

tags

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

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

target_platform

string

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

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

Варианты:

  • "All"
  • "Standalone"
  • "FIAttached"
  • "Chassis"

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

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

Варианты:

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

Примеры

- name: Create a Power Policy for a Standalone Server
  cisco.intersight.intersight_power_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "Standalone-Server-Power-Policy"
    description: "Power policy for standalone servers, restores to last state."
    target_platform: "Standalone"
    power_restore: "LastState"
    processor_package_power_limit: "Minimum"
    tags:
      - Key: "Owner"
        Value: "DevOps"

- name: Create a Power Policy for a Chassis with N+1 Redundancy
  cisco.intersight.intersight_power_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "Chassis-N1-Redundancy"
    description: "Power policy for chassis with N+1 redundancy."
    target_platform: "Chassis"
    power_redundancy: "N+1"
    power_save_mode: "Disabled"
    power_allocation: 7500

- name: Create a universal Power Policy for FIAttached Servers
  cisco.intersight.intersight_power_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "FI-Attached-Default"
    description: "Default power policy for all FIAttached servers."
    target_platform: "FIAttached"
    power_profiling: "Enabled"
    power_priority: "Medium"

- name: Delete a Power Policy
  cisco.intersight.intersight_power_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "Standalone-Server-Power-Policy"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

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

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

Пример: {"api_response": {"...": null, "Name": "FI-Attached-Default", "ObjectType": "power.Policy", "PowerPriority": "Medium", "PowerProfiling": "Enabled", "PowerRestoreState": "AlwaysOff", "Tags": []}}

Авторы

  • 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_power_policy_module.html

Spec-Zone.ru

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