Spec-Zone.ru › Ansible

модуль cisco.intersight.intersight_storage_policy – настройка политики хранения для Cisco Intersight

Примечание

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

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

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

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

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

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

  • Управляет настройкой политики хранения в Cisco Intersight.
  • Политика для настройки параметров хранения и конфигураций виртуальных дисков на серверах, управляемых Cisco Intersight.
  • Дополнительные сведения см. в разделе Cisco Intersight.

Параметры

Параметр

Комментарии

api_key_id

строка / обязательный

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

Если значение не задано, используется значение переменной среды INTERSIGHT_API_KEY_ID.

api_private_key

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

Имя файла (абсолютный путь) или строка с данными закрытого ключа в формате 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

строка

URI для доступа к API Intersight.

Если значение не задано, используется значение переменной среды INTERSIGHT_API_URI.

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

controller_attached_nvme_slots

строка

Необходимо указать только накопители NVMe U.3; указанные слоты будут переведены в режим подключения к контроллеру.

Допустимые слоты: 1-9, 21-24, 101-104.

Допустимое значение — диапазоны чисел, разделенные запятыми или дефисами.

Примеры формата слотов: “1,4,5”, “2”, “1-5”, “1,2,6-8”

default_drive_mode

строка

При развертывании все ненастроенные накопители перейдут в выбранное состояние.

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

Выберите параметр UnconfiguredGood, чтобы сохранить существующую конфигурацию.

Выберите Jbod, чтобы перевести ненастроенные накопители в состояние JBOD.

Выберите RAID0, чтобы создать виртуальный диск RAID0 на каждом ненастроенном накопителе.

Варианты:

  • "UnconfiguredGood" ← (по умолчанию)
  • "Jbod"
  • "RAID0"

description

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

строка

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

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

direct_attached_nvme_slots

строка

Необходимо указать только накопители NVMe U.3; указанные слоты будут переведены в режим прямого подключения.

Допустимые слоты: 1-9, 21-24, 101-104.

Допустимое значение — диапазоны чисел, разделенные запятыми или дефисами.

Примеры формата слотов: “1,4,5”, “2”, “1-5”, “1,2,6-8”

drive_groups

список / элементы=словарь

Список групп накопителей, которые необходимо создать и связать с политикой хранилища.

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

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

dedicated_hot_spares

строка

Набор накопителей, которые будут использоваться в качестве горячих резервов для этой группы накопителей.

Не применяется для RAID0.

Примеры формата слотов: “1,4,5”, “2”, “1-5”, “1,2,6-8”

name

строка / обязательный

Имя группы накопителей.

Имя должно содержать от 1 до 64 буквенно-цифровых символов.

raid_level

строка

Поддерживаемый уровень RAID для группы дисков.

Варианты:

  • "Raid0" ← (по умолчанию)
  • "Raid1"
  • "Raid5"
  • "Raid6"
  • "Raid10"
  • "Raid50"
  • "Raid60"

secure_drive_group

логическое значение

Включает или отключает защиту всех накопителей, используемых в этой политике.

Этот флаг только включает защиту накопителей; фактическая защита будет применена только после настройки удаленного или ручного управления ключами.

Варианты:

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

span_groups

список / элементы=словарь / обязательный

Список групп span для группы накопителей.

Каждая группа span содержит слоты накопителей.

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

Одна группа span для RAID0, RAID1, RAID5, RAID6.

Несколько групп span (2–8) для RAID10, RAID50, RAID60.

slots

строка / обязательный

Слоты накопителей для этой группы span.

Примеры формата слотов: “1,4,5”, “2”, “1-5”, “1,2,6-8”

state

строка

Создать/обновить или удалить группу накопителей.

Варианты:

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

virtual_drives

список / элементы=словарь

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

access_policy

строка

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

Варианты:

  • "Default" ← (по умолчанию)
  • "ReadWrite"
  • "ReadOnly"
  • "Blocked"

boot_drive

логическое значение

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

Варианты:

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

disk_cache

строка

Политика кэширования диска для виртуального диска.

Варианты:

  • "Default" ← (по умолчанию)
  • "NoChange"
  • "Enable"
  • "Disable"

expand_to_available

логическое значение

Расширять ли виртуальный диск для использования всего доступного пространства.

Варианты:

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

name

строка / обязательный

Имя виртуального диска.

Имя должно содержать от 1 до 15 буквенно-цифровых символов.

Пробелы и специальные символы, кроме - (дефиса) и _ (подчеркивания), не допускаются.

read_policy

строка

Режим упреждающего чтения данных с этого виртуального диска.

Варианты:

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

size

целое число

Размер виртуального диска в мебибайтах.

Указание размера обязательно, кроме случаев, когда включен параметр Expand to Available.

strip_size

целое число

Требуемый размер полосы в КиБ.

Варианты:

  • 64 ← (по умолчанию)
  • 128
  • 256
  • 512
  • 1024

write_policy

строка

Режим записи данных на этот виртуальный диск.

Варианты:

  • "Default" ← (по умолчанию)
  • "WriteThrough"
  • "WriteBackGoodBbu"
  • "AlwaysWriteBack"

m2_virtual_drive_config

словарь

Конфигурация виртуального диска RAID M.2.

controller_slot

строка

Слот контроллера RAID M.2 для создания виртуального диска.

Выберите ‘MSTOR-RAID-1’, чтобы создать виртуальный диск на контроллере RAID M.2 в первом слоте.

Выберите ‘MSTOR-RAID-2’ для второго слота.

Выберите ‘MSTOR-RAID-1,MSTOR-RAID-2’ для обоих слотов или любого из них.

Варианты:

  • "MSTOR-RAID-2"
  • "MSTOR-RAID-1" ← (по умолчанию)
  • "MSTOR-RAID-1,MSTOR-RAID-2"

enable

логическое значение

Включить конфигурацию виртуального диска M.2.

Варианты:

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

name

строка

Имя виртуального диска.

Имя должно содержать от 1 до 15 буквенно-цифровых символов.

Пробелы и специальные символы, кроме - (дефиса) и _ (подчеркивания), не допускаются.

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

name

строка / обязательный

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

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

organization

строка

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

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

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

raid0_drive_config

словарь

Конфигурация RAID0 для одного диска MRAID/RAID.

access_policy

строка

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

Варианты:

  • "Default" ← (по умолчанию)
  • "ReadWrite"
  • "ReadOnly"
  • "Blocked"

disk_cache

строка

Политика кэширования диска для виртуального диска.

Варианты:

  • "Default" ← (по умолчанию)
  • "NoChange"
  • "Enable"
  • "Disable"

drive_slots

строка

Набор слотов накопителей, в которых необходимо создать виртуальные диски RAID0.

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

Примеры формата слотов: “1,4,5”, “2”, “1-5”, “1,2,6-8”

enable

логическое значение

Включить конфигурацию накопителей RAID0.

Варианты:

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

read_policy

строка

Режим упреждающего чтения данных с этого виртуального диска.

Варианты:

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

strip_size

целое число

Требуемый размер полосы в КиБ.

Варианты:

  • 64 ← (по умолчанию)
  • 128
  • 256
  • 512
  • 1024

write_policy

строка

Режим записи данных на этот виртуальный диск.

Варианты:

  • "Default" ← (по умолчанию)
  • "WriteThrough"
  • "WriteBackGoodBbu"
  • "AlwaysWriteBack"

secure_jbods

строка

Диски JBOD, указанные в этом диапазоне слотов, будут зашифрованы.

Допустимые значения: ‘ALL’ или диапазон чисел, разделенных запятыми или дефисами.

Примеры формата: ALL, 1, 3 или 4-6, 8.

При значении ‘ALL’ будут зашифрованы все неиспользуемые диски в состояниях UnconfigureGood/JBOD.

Примеры формата слотов: “1,4,5”, “2”, “1-5”, “1,2,6-8”

state

строка

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

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

Варианты:

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

tags

список / элементы=словарь

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

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

unused_disks_state

строка

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

NoChange не изменит состояние накопителя.

Необходимо выбрать No Change, если для параметра Default Drive State задано значение JBOD или RAID0.

Варианты:

  • "NoChange" ← (по умолчанию)
  • "UnconfiguredGood"
  • "Jbod"

use_jbod_for_vd_creation

логическое значение

Для создания виртуальных дисков используются диски в состоянии JBOD.

Этот параметр необходимо отключить, если для параметра Default Drive State задано значение JBOD.

Варианты:

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

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

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

Варианты:

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

Примеры

- name: Create a basic storage policy
  cisco.intersight.intersight_storage_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "basic-storage-policy"
    description: "Basic storage policy configuration"
    m2_virtual_drive_config:
      enable: false
    raid0_drive_config:
      enable: false
    tags:
      - Key: "Environment"
        Value: "Production"

- name: Create storage policy with M.2 virtual drive enabled
  cisco.intersight.intersight_storage_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "m2-enabled-storage-policy"
    description: "Storage policy with M.2 virtual drive"
    m2_virtual_drive_config:
      enable: true
      controller_slot: "MSTOR-RAID-1"
      name: "MStorBootVd"
    raid0_drive_config:
      enable: false
    tags:
      - Key: "Site"
        Value: "Datacenter1"

- name: Create storage policy with RAID0 configuration
  cisco.intersight.intersight_storage_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "raid0-storage-policy"
    description: "Storage policy with RAID0 configuration"
    use_jbod_for_vd_creation: true
    default_drive_mode: "RAID0"
    secure_jbods: "1"
    m2_virtual_drive_config:
      enable: false
    raid0_drive_config:
      enable: true
      strip_size: 128
      access_policy: "ReadWrite"
      read_policy: "ReadAhead"
      write_policy: "WriteBackGoodBbu"
      disk_cache: "Enable"
    controller_attached_nvme_slots: "2"
    direct_attached_nvme_slots: "3"

- name: Create storage policy with drive groups
  cisco.intersight.intersight_storage_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "drive-group-storage-policy"
    description: "Storage policy with drive groups"
    m2_virtual_drive_config:
      enable: false
    raid0_drive_config:
      enable: false
    drive_groups:
      - name: "raid0-group"
        raid_level: "Raid0"
        secure_drive_group: false
        span_groups:
          - slots: "1,2"
        virtual_drives:
          - name: "raid0-vd"
            size: 1024
            expand_to_available: false
            boot_drive: true
            strip_size: 128
            access_policy: "ReadWrite"
            read_policy: "ReadAhead"
            write_policy: "WriteBackGoodBbu"
            disk_cache: "Enable"
      - name: "raid1-group"
        raid_level: "Raid1"
        secure_drive_group: true
        dedicated_hot_spares: "3,4"
        span_groups:
          - slots: "5,6"
        virtual_drives:
          - name: "raid1-vd"
            size: 0
            expand_to_available: true
            boot_drive: false
            strip_size: 64
            access_policy: "Default"
            read_policy: "Default"
            write_policy: "Default"
            disk_cache: "Default"

- name: Create storage policy with nested RAID drive groups
  cisco.intersight.intersight_storage_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "nested-raid-storage-policy"
    description: "Storage policy with nested RAID configurations"
    m2_virtual_drive_config:
      enable: false
    raid0_drive_config:
      enable: false
    drive_groups:
      - name: "raid60-group"
        raid_level: "Raid60"
        secure_drive_group: false
        dedicated_hot_spares: "33,34,35,36"
        span_groups:
          - slots: "1,2,3,4"
          - slots: "5,6,7,8"
          - slots: "9,10,11,12"
          - slots: "13,14,15,16"
          - slots: "17,18,19,20"
          - slots: "21,22,23,24"
          - slots: "25,26,27,28"
          - slots: "29,30,31,32"
        virtual_drives:
          - name: "raid60-vd1"
            size: 1024
            expand_to_available: false
            boot_drive: true
            strip_size: 64
            access_policy: "ReadWrite"
            read_policy: "Default"
            write_policy: "Default"
            disk_cache: "Default"
          - name: "raid60-vd2"
            size: 1024
            expand_to_available: false
            boot_drive: false
            strip_size: 64
            access_policy: "ReadWrite"
            read_policy: "Default"
            write_policy: "Default"
            disk_cache: "Default"

- name: Delete a storage policy
  cisco.intersight.intersight_storage_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "old-storage-policy"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

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

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

Пример: {"api_response": {"DefaultDriveMode": "UnconfiguredGood", "M2VirtualDrive": {"ControllerSlot": "MSTOR-RAID-1", "Enable": false, "Name": "MStorBootVd"}, "Name": "basic-storage-policy", "ObjectType": "storage.StoragePolicy", "Raid0Drive": {"Enable": false, "VirtualDrivePolicy": {"AccessPolicy": "Default", "DriveCache": "Default", "ReadPolicy": "Default", "StripSize": 64, "WritePolicy": "Default"}}, "Tags": [{"Key": "Environment", "Value": "Production"}], "UnusedDisksState": "NoChange", "UseJbodForVdCreation": 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_storage_policy_module.html

Spec-Zone.ru

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