Модуль cisco.intersight.intersight_uuid_pool — настройка пула UUID для Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Чтобы установить её, используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать её в плейбуке, укажите: cisco.intersight.intersight_uuid_pool.
Краткое описание
- Настройка пула UUID для Cisco Intersight.
- Используется для настройки параметров пулов UUID на устройствах под управлением 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. По умолчанию: |
assignment_order string | Порядок назначения определяет, в каком порядке выделяется следующий идентификатор. Если Если Варианты:
|
description псевдонимы: descr string | Описание пула UUID, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или подчёркивание (_). |
name string / обязательный | Имя, назначенное пулу UUID. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_. |
organization string | Имя организации, которой назначен этот ресурс. Профили, политики и пулы, созданные в пользовательской организации, применяются только к устройствам в той же организации. По умолчанию: |
prefix string | Префикс UUID, используемый для всех блоков суффиксов UUID. Для поддержки идемпотентности UUID должен быть записан заглавными буквами. Префикс должен иметь формат XXXXXXXX-XXXX-XXXX (8-4-4), где X — шестнадцатеричный символ (0-9, A-F). Этот префикс объединяется с блоками суффиксов, образуя полные UUID. Обязателен для |
state string | Если Если Варианты:
|
tags list / элементы=dictionary | Список тегов в формате «Ключ:<заданный пользователем ключ> Значение:<заданное пользователем значение>». |
use_proxy boolean | Если Варианты:
|
uuid_suffix_blocks list / элементы=dictionary | Список блоков суффиксов UUID, определяющих диапазон UUID, доступных в пуле. Каждый блок задаёт начальный суффикс и количество последовательных UUID в этом блоке. Обязателен для |
|
from string |
Начальный суффикс UUID для этого блока. Для поддержки идемпотентности UUID должен быть записан заглавными буквами. Суффикс должен иметь формат XXXX-XXXXXXXXXXXX (4-12), где X — шестнадцатеричный символ (0-9, A-F). Этот суффикс объединяется с префиксом пула, образуя полные UUID. |
|
size integer |
Количество последовательных UUID в этом блоке. Должно быть положительным целым числом, указывающим, сколько UUID доступно начиная с суффикса ‘from’. |
validate_certs boolean | Управляет проверкой TLS-сертификата api_uri Варианты:
|
Примеры
- name: Configure UUID Pool
cisco.intersight.intersight_uuid_pool:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: DevNet
name: lab-uuid-pool
description: UUID Pool for lab use
assignment_order: sequential
prefix: "550E8400-E29B-41D4"
uuid_suffix_blocks:
- from: "A716-446655440000"
size: 100
- from: "A716-446655441000"
size: 200
tags:
- Key: Site
Value: RCDN
- name: Delete UUID Pool
cisco.intersight.intersight_uuid_pool:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: DevNet
name: lab-uuid-pool
state: absent
Возвращаемые значения
Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:
Ключ | Описание |
|---|---|
api_response dictionary | Результат ответа API, возвращённый указанным ресурсом. Возвращается: всегда Пример: |
Ссылки на коллекцию
© 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_uuid_pool_module.html