Spec-Zone.ru › Ansible

Модуль cisco.intersight.intersight_wwn_pool — настройка пула WWNN/WWPN для Cisco Intersight

Примечание

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

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

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

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

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

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

  • Настройка пула WWNN/WWPN для Cisco Intersight.
  • Используется для настройки параметров пулов WWN на устройствах, управляемых Cisco Intersight.
  • Дополнительные сведения см. в Cisco Intersight.

Параметры

Параметр

Комментарии

api_key_id

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

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

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

api_private_key

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

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

Если используется строка, для шифрования её данных следует использовать 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 для доступа к Intersight API.

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

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

assignment_order

string

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

Если sequential, идентификаторы назначаются последовательно.

Если default, порядок назначения определяется системой.

Варианты:

  • "default" ← (по умолчанию)
  • "sequential"

description

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

string

Описание пула WWNN/WWPN, заданное пользователем.

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

id_blocks

list / элементы=словарь

Блоки WWN

Блок идентификаторов WWNN/WWPN.

size

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

Количество идентификаторов, которое может содержать этот блок.

Значение должно быть целым числом от 1 до 1024 включительно.

wwn_from

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

Начальный идентификатор WWN блока должен быть в шестнадцатеричном формате xx:xx:xx:xx:xx:xx:xx:xx.

Допустимые диапазоны: от 20:00:00:00:00:00:00:00 до 20:FF:FF:FF:FF:FF:FF:FF

Или от 50:00:00:00:00:00:00:00 до 5F:FF:FF:FF:FF:FF:FF:FF.

Чтобы обеспечить уникальность WWN в фабрике SAN, настоятельно рекомендуется использовать следующий префикс WWN: 20:00:00:25:B5:xx:xx:xx.

name

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

Имя, присвоенное пулу WWNN/WWPN.

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

Пулы WWNN и WWNP могут иметь одинаковые имена.

organization

string

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

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

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

pool_purpose

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

Тип пула: WWNN или WWPN.

Также обязателен для absent — пулы WWNN и WWNP могут иметь одинаковые имена.

state

string

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

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

Варианты:

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

tags

list / элементы=словарь

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

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

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

Варианты:

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

Примеры

- name: Create WWNN pool
  cisco.intersight.intersight_wwn_pool:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: wwn_pool_1
    description: "Test WWNN pool description"
    assignment_order: sequential
    tags:
      - "Key": "Site"
        "Value": "tag1"
    pool_purpose: "WWNN"
    id_blocks:
      - "wwn_from": "20:00:00:25:B5:00:00:00"
        "size": 100
      - "wwn_from": "20:00:00:25:B5:FF:00:00"
        "size": 100

- name: Create WWPN pool
  cisco.intersight.intersight_wwn_pool:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: wwn_pool_2
    description: "Test WWPN pool description"
    tags:
      - "Key": "Site"
        "Value": "tag2"
    pool_purpose: "WWPN"
    id_blocks:
      - "wwn_from": "20:00:00:25:B5:00:FF:00"
        "size": 200
      - "wwn_from": "20:00:00:25:B5:FF:FF:00"
        "size": 200

- name: Delete WWN pool
  cisco.intersight.intersight_wwn_pool:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: wwn_pool_1
    pool_purpose: "WWPN"
    state: absent

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

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

Ключ

Описание

api_response

dictionary

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

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

Пример: {"api_response": {"IdBlocks": [{"ClassId": "fcpool.Block", "From": "20:00:00:25:B5:00:00:00", "ObjectType": "fcpool.Block", "Size": 100, "To": "20:00:00:25:B5:00:00:63"}, {"ClassId": "fcpool.Block", "From": "20:00:00:25:B5:FF:00:00", "ObjectType": "fcpool.Block", "Size": 100, "To": "20:00:00:25:B5:FF:00:63"}], "Name": "wwn_pool_1", "ObjectType": "fcpool.Pool", "PoolPurpose": "WWNN  ", "Tags": [{"Key": "Site", "Value": "tag1"}, {"Key": "Site2", "Value": "tag2"}]}}

Авторы

  • Shahar Golshani (@sgolshan)

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

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

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

Spec-Zone.ru

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