модуль cisco.intersight.intersight_vnic_template_info — сбор информации о шаблонах vNIC в Cisco Intersight

Примечание

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

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

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

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

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

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

Получение подробной информации о шаблонах vNIC из Cisco Intersight.
Запрос шаблонов по организации, имени шаблона и другим фильтрам.
Возвращает структурированные данные с метаданными шаблонов и связями с политиками.
Если фильтры не заданы, возвращаются все шаблоны vNIC.
Шаблоны vNIC используются для определения стандартизированных конфигураций сетевых интерфейсов для развертываний с подключением к FI.

Параметры

Параметр	Комментарии
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"`
name string	Точное имя шаблона vNIC, сведения о котором требуется получить. Если указано, будет возвращён только соответствующий шаблон.
organization string	Имя организации, по которой следует отфильтровать шаблоны vNIC. Для организации по умолчанию используйте «default». Если указано, будут возвращены только шаблоны из этой организации.
use_proxy boolean	Если `no`, прокси использоваться не будет, даже если он задан в переменной окружения на целевых узлах. Варианты: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр для проверки TLS-сертификата api_uri. Варианты: `false` `true` ← (по умолчанию)

Примеры

# Basic Usage Examples
- name: Fetch all vNIC Templates from all organizations
  cisco.intersight.intersight_vnic_template_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
  register: all_vnic_templates

- name: Display all template names
  debug:
    msg: "Template: {{ item.Name }}"
  loop: "{{ all_vnic_templates.api_response }}"
  when: all_vnic_templates.api_response is iterable

# Organization-specific Examples
- name: Fetch all vNIC Templates from the default organization
  cisco.intersight.intersight_vnic_template_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
  register: default_org_templates

- name: Fetch all vNIC Templates from a custom organization
  cisco.intersight.intersight_vnic_template_info:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "Engineering"
  register: engineering_templates

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

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

Ключ	Описание
api_response dictionary	Ответ API, содержащий сведения о шаблоне vNIC. Возвращает словарь, если запрашивается один шаблон или шаблоны не найдены. Возвращает список, если найдено несколько шаблонов. Возвращается: всегда Пример: {"Cdn": {"Source": "vnic"}, "Description": "Production vNIC template for FI-attached servers", "EnableOverride": false, "EthAdapterPolicy": {"Moid": "adapter12345678901234567890", "Name": "default-adapter-policy", "ObjectType": "vnic.EthAdapterPolicy"}, "EthQosPolicy": {"Moid": "qos12345678901234567890", "Name": "default-qos-policy", "ObjectType": "vnic.EthQosPolicy"}, "FabricEthNetworkControlPolicy": {"Moid": "netcontrol12345678901234567890", "Name": "default-network-control", "ObjectType": "fabric.EthNetworkControlPolicy"}, "FabricEthNetworkGroupPolicy": [{"Moid": "netgroup12345678901234567890", "Name": "default-network-group", "ObjectType": "fabric.EthNetworkGroupPolicy"}], "FailoverEnabled": false, "MacPool": {"Moid": "macpool12345678901234567890", "Name": "default-mac-pool", "ObjectType": "macpool.Pool"}, "Moid": "12345678901234567890abcd", "Name": "production-vnic-template", "ObjectType": "vnic.VnicTemplate", "Organization": {"Moid": "org12345678901234567890", "Name": "default", "ObjectType": "organization.Organization"}, "SriovSettings": {"CompCountPerVf": 5, "Enabled": true, "IntCountPerVf": 8, "RxCountPerVf": 4, "TxCountPerVf": 1, "VfCount": 64}, "SwitchId": "A", "Tags": [{"Key": "Environment", "Value": "Production"}, {"Key": "Site", "Value": "DataCenter-A"}]}

Ключ

Описание

api_response

dictionary

Ответ API, содержащий сведения о шаблоне vNIC.

Возвращает словарь, если запрашивается один шаблон или шаблоны не найдены.

Возвращает список, если найдено несколько шаблонов.

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

Пример: {"Cdn": {"Source": "vnic"}, "Description": "Production vNIC template for FI-attached servers", "EnableOverride": false, "EthAdapterPolicy": {"Moid": "adapter12345678901234567890", "Name": "default-adapter-policy", "ObjectType": "vnic.EthAdapterPolicy"}, "EthQosPolicy": {"Moid": "qos12345678901234567890", "Name": "default-qos-policy", "ObjectType": "vnic.EthQosPolicy"}, "FabricEthNetworkControlPolicy": {"Moid": "netcontrol12345678901234567890", "Name": "default-network-control", "ObjectType": "fabric.EthNetworkControlPolicy"}, "FabricEthNetworkGroupPolicy": [{"Moid": "netgroup12345678901234567890", "Name": "default-network-group", "ObjectType": "fabric.EthNetworkGroupPolicy"}], "FailoverEnabled": false, "MacPool": {"Moid": "macpool12345678901234567890", "Name": "default-mac-pool", "ObjectType": "macpool.Pool"}, "Moid": "12345678901234567890abcd", "Name": "production-vnic-template", "ObjectType": "vnic.VnicTemplate", "Organization": {"Moid": "org12345678901234567890", "Name": "default", "ObjectType": "organization.Organization"}, "SriovSettings": {"CompCountPerVf": 5, "Enabled": true, "IntCountPerVf": 8, "RxCountPerVf": 4, "TxCountPerVf": 1, "VfCount": 64}, "SwitchId": "A", "Tags": [{"Key": "Environment", "Value": "Production"}, {"Key": "Site", "Value": "DataCenter-A"}]}

Авторы

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_vnic_template_info_module.html