Spec-Zone.ru › Ansible

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

Примечание

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

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

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

Чтобы использовать модуль в плейбуке, укажите: cisco.intersight.intersight_memory_persistent_policy.

  • Краткое описание
  • Параметры
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Управляет настройкой политики постоянной памяти в Cisco Intersight.
  • Настраивает модули постоянной памяти (PMM) на серверах, включая параметры безопасности, цели и пространства имён.
  • Поддерживает режимы настройки под управлением 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), дефис (-), точку (.), двоеточие (:) или символ подчёркивания (_).

enable_goal

boolean

Включает настройку целевого режима для модулей постоянной памяти.

Настроенная цель будет применяться ко всем модулям постоянной памяти.

При развертывании профиля изменение цели удалит все существующие регионы и пространства имён вместе с содержащимися в них данными.

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

Применимо только при management_mode, равном configured-from-intersight.

Варианты:

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

enable_security_passphrase

boolean

Включает защищённую парольную фразу для модулей постоянной памяти.

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

Применимо только при management_mode, равном configured-from-intersight.

Варианты:

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

management_mode

string

Режим управления конфигурацией постоянной памяти.

configured-from-intersight — параметры политики настраиваются и управляются в Intersight.

configured-from-operating-system — связанные серверы управляются средствами операционной системы, а параметры политики недоступны.

Если задано значение configured-from-operating-system, остальные поля конфигурации не требуются и не используются.

Варианты:

  • "configured-from-intersight" ← (по умолчанию)
  • "configured-from-operating-system"

memory_mode_percentage

integer

Доля энергозависимой памяти для режима памяти.

Допустимый диапазон: 0–100.

Применимо, только если enable_goal равно true, а management_mode — configured-from-intersight.

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

name

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

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

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

namespaces

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

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

Применимо только при management_mode, равном configured-from-intersight.

capacity

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

Ёмкость этого пространства имён в ГиБ.

Допустимый диапазон: от 1 до 9223372036854775807.

mode

string

Режим этого пространства имён.

Варианты:

  • "raw" ← (по умолчанию)
  • "block"

name

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

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

socket_id

integer

Идентификатор сокета региона, в котором необходимо создать или изменить это пространство имён.

Допустимые значения: 1, 2, 3 или 4.

Варианты:

  • 1 ← (по умолчанию)
  • 2
  • 3
  • 4

socket_memory_id

integer

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

Применимо только при значении persistent_memory_type app-direct-non-interleaved.

Допустимые значения: 2, 4, 6, 8, 10 или 12.

Варианты:

  • 2 ← (по умолчанию)
  • 4
  • 6
  • 8
  • 10
  • 12

organization

string

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

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

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

persistent_memory_type

string

Тип конфигурации постоянной памяти.

app-direct — модули постоянной памяти объединяются в чередующийся набор.

app-direct-non-interleaved — модули постоянной памяти не чередуются.

Применимо, только если enable_goal равно true, а management_mode — configured-from-intersight.

Варианты:

  • "app-direct" ← (по умолчанию)
  • "app-direct-non-interleaved"

retain_namespaces

boolean

Сохраняет существующие пространства имён постоянной памяти.

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

Применимо только при management_mode, равном configured-from-intersight.

Варианты:

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

secure_passphrase

string

Защищённая парольная фраза, которая будет применена к модулям постоянной памяти на сервере.

Обязательна, если enable_security_passphrase равно true.

Допустимые символы: a-z, A-Z, 0-9 и специальные символы =, !, &,

Применимо только при management_mode, равном configured-from-intersight.

state

string

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

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

Варианты:

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

tags

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

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

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

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

Варианты:

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

Примеры

- name: Create Memory Persistent Policy with Intersight management
  cisco.intersight.intersight_memory_persistent_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "pmem-policy-01"
    description: "Persistent Memory policy with security and namespaces"
    management_mode: configured-from-intersight
    enable_security_passphrase: true
    secure_passphrase: "SecurePass123!"
    enable_goal: true
    memory_mode_percentage: 0
    persistent_memory_type: app-direct
    retain_namespaces: true
    namespaces:
      - name: "ns1"
        socket_id: 1
        capacity: 100000
        mode: raw
      - name: "ns2"
        socket_id: 4
        capacity: 1000065
        mode: block
    state: present

- name: Create Memory Persistent Policy with non-interleaved configuration
  cisco.intersight.intersight_memory_persistent_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "pmem-policy-non-interleaved"
    description: "Non-interleaved persistent memory configuration"
    management_mode: configured-from-intersight
    enable_security_passphrase: true
    secure_passphrase: "MySecurePass123"
    enable_goal: true
    memory_mode_percentage: 0
    persistent_memory_type: app-direct-non-interleaved
    retain_namespaces: true
    namespaces:
      - name: "ns1"
        socket_id: 1
        socket_memory_id: 2
        capacity: 100000
        mode: raw
      - name: "ns2"
        socket_id: 2
        socket_memory_id: 4
        capacity: 200000
        mode: block
    state: present

- name: Create Memory Persistent Policy with OS management
  cisco.intersight.intersight_memory_persistent_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "pmem-policy-os-managed"
    description: "OS-managed persistent memory configuration"
    management_mode: configured-from-operating-system
    state: present

- name: Create Memory Persistent Policy without security passphrase
  cisco.intersight.intersight_memory_persistent_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "pmem-policy-no-security"
    description: "Policy without security passphrase"
    management_mode: configured-from-intersight
    enable_security_passphrase: false
    enable_goal: true
    memory_mode_percentage: 10
    persistent_memory_type: app-direct
    state: present

- name: Delete Memory Persistent Policy
  cisco.intersight.intersight_memory_persistent_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "pmem-policy-01"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

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

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

Пример: {"api_response": {"Goals": [{"MemoryModePercentage": 0, "PersistentMemoryType": "app-direct", "SocketId": "All Sockets"}], "LocalSecurity": {"Enabled": true}, "LogicalNamespaces": [{"Capacity": 100000, "Mode": "raw", "Name": "ns1", "SocketId": 1, "SocketMemoryId": "Not Applicable"}], "ManagementMode": "configured-from-intersight", "Name": "pmem-policy-01", "ObjectType": "memory.PersistentMemoryPolicy", "RetainNamespaces": true}}

Авторы

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

Spec-Zone.ru

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