Spec-Zone.ru › Ansible

Модуль 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.

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

assignment_order

string

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

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

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

Варианты:

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

description

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

string

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

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

name

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

Имя, назначенное пулу UUID.

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

organization

string

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

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

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

prefix

string

Префикс UUID, используемый для всех блоков суффиксов UUID.

Для поддержки идемпотентности UUID должен быть записан заглавными буквами.

Префикс должен иметь формат XXXXXXXX-XXXX-XXXX (8-4-4), где X — шестнадцатеричный символ (0-9, A-F).

Этот префикс объединяется с блоками суффиксов, образуя полные UUID.

Обязателен для state=present

state

string

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

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

Варианты:

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

tags

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

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

use_proxy

boolean

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

Варианты:

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

uuid_suffix_blocks

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

Список блоков суффиксов UUID, определяющих диапазон UUID, доступных в пуле.

Каждый блок задаёт начальный суффикс и количество последовательных UUID в этом блоке.

Обязателен для state=present

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

Варианты:

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

Примеры

- 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, возвращённый указанным ресурсом.

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

Пример: {"api_response": {"AccountMoid": "", "Ancestors": [], "Assigned": 0, "AssignmentOrder": "sequential", "ClassId": "uuidpool.Pool", "CreateTime": "", "Description": "UUID Pool for lab use", "DomainGroupMoid": "", "ModTime": "", "Moid": "", "Name": "lab-uuid-pool", "ObjectType": "uuidpool.Pool", "Organization": {}, "Owners": [], "PermissionResources": [], "Prefix": "550E8400-E29B-41D4", "Reservations": [], "Reserved": 0, "ShadowPools": [], "SharedScope": "", "Size": 300, "Tags": [{"Key": "Site", "Value": "RCDN"}], "UuidSuffixBlocks": [{"From": "A716-446655440000", "Size": 100}, {"From": "A716-446655441000", "Size": 200}]}}

Авторы

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

Spec-Zone.ru

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