модуль cisco.ucs.ucs_vnic_template — настройка шаблонов vNIC в Cisco UCS Manager
Примечание
Этот модуль входит в коллекцию cisco.ucs (версия 1.16.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.ucs. Для использования этого модуля требуются дополнительные компоненты. Подробности см. в разделе Требования.
Чтобы использовать его в плейбуке, укажите: cisco.ucs.ucs_vnic_template.
Краткое описание
- Настраивает шаблоны vNIC в Cisco UCS Manager.
Требования
Следующие требования необходимо выполнить на хосте, на котором запускается этот модуль.
- ucsmsdk
Параметры
Параметр | Комментарии |
|---|---|
cdn_name string | Имя CDN, используемое, если для cdn_source задано значение user-defined. |
cdn_source string | Поле источника CDN. Допустимы следующие значения: vnic-name — использует имя шаблона vNIC экземпляра vNIC в качестве имени CDN. Это значение используется по умолчанию. user-defined — использует заданное пользователем имя CDN для шаблона vNIC. При выборе этого значения также необходимо указать cdn_name. Варианты:
|
description псевдонимы: descr string | Описание шаблона vNIC, заданное пользователем. Длина — не более 256 символов. Можно использовать любые символы и пробелы, кроме следующих: ` (знак ударения), \ (обратная косая черта), ^ (карет), ” (двойная кавычка), = (знак равенства), > (знак «больше»), < (знак «меньше») или ‘ (одинарная кавычка). |
fabric string | Поле Fabric ID, указывающее фабричную коммутационную матрицу, связанную с интерфейсами vNIC, созданными на основе этого шаблона. Чтобы включить переключение при отказе фабрики для интерфейсов vNIC, созданных на основе этого шаблона, используйте один из следующих вариантов: A-B — использовать Fabric A по умолчанию с включенным переключением при отказе. B-A — использовать Fabric B по умолчанию с включенным переключением при отказе. Не включайте переключение при отказе фабрики для vNIC в следующих случаях: - Если домен Cisco UCS работает в режиме коммутатора Ethernet. В этом режиме переключение при отказе фабрики для vNIC не поддерживается. - Если вы планируете связать один или несколько интерфейсов vNIC, созданных на основе этого шаблона, с сервером, адаптер которого не поддерживает переключение при отказе фабрики. Варианты:
|
hostname string / обязательный | IP-адрес или имя хоста Cisco UCS Manager. Модули можно использовать с эмулятором платформы UCS https://cs.co/ucspe |
mac_pool string | Пул MAC-адресов, который должны использовать интерфейсы vNIC, созданные на основе этого шаблона vNIC. |
mtu string | Поле MTU. Максимальный размер передаваемого блока данных (MTU), или размер пакета, который должны использовать интерфейсы vNIC, созданные на основе этого шаблона vNIC. Введите строку со значением от ‘1500’ до ‘9000’. Если с шаблоном vNIC связана политика QoS, указанное здесь значение MTU должно быть не больше значения MTU, заданного для системного класса QoS. По умолчанию: |
name string / обязательный | Имя шаблона vNIC. Имя должно содержать от 1 до 16 буквенно-цифровых символов. Нельзя использовать пробелы и специальные символы, кроме - (дефиса), “_” (подчеркивания), : (двоеточия) и . (точки). Изменить это имя после создания шаблона нельзя. |
network_control_policy string | Политика сетевого управления, которую должны использовать интерфейсы vNIC, созданные на основе этого шаблона vNIC. |
org_dn string | DN организации (различающееся имя) По умолчанию: |
password string / обязательный | Пароль для аутентификации в Cisco UCS Manager. |
peer_redundancy_template псевдонимы: peer_redundancy_templ string | Шаблон резервирования пары. Имя шаблона vNIC, совместно использующего конфигурацию с этим шаблоном. Если для redundancy_type задано значение primary, необходимо указать имя вторичного шаблона. Если для redundancy_type задано значение secondary, необходимо указать имя первичного шаблона. Вторичные шаблоны могут настраивать только не общие свойства (name, description и mac_pool). |
pin_group string | Группа привязки LAN, которую должны использовать интерфейсы vNIC, созданные на основе этого шаблона vNIC. |
port integer | Номер порта для подключения (по умолчанию используется 443 для HTTPS-подключения и 80 для HTTP-подключения). |
proxy string | Если use_proxy имеет значение no, указывает прокси-сервер для подключения. Например: ‘http://proxy.xy.z:8080’ |
qos_policy string | Политика качества обслуживания (QoS), которую должны использовать интерфейсы vNIC, созданные на основе этого шаблона vNIC. |
redundancy_type string | Тип резервирования, используемый для пар резервирования vNIC при переключении при отказе фабрики. Допустимы следующие значения: primary — создает конфигурации, которыми можно совместно пользоваться со вторичным шаблоном. secondary — наследует все общие конфигурации из первичного шаблона. none — поведение устаревшего шаблона vNIC. Выберите этот вариант, если резервирование не требуется. Варианты:
|
state string | Если задано Если задано Варианты:
|
stats_policy string | Политика сбора статистики, которую должны использовать интерфейсы vNIC, созданные на основе этого шаблона vNIC. |
target string | Возможная целевая система для интерфейсов vNIC, созданных на основе этого шаблона. Целевой тип определяет, будет ли Cisco UCS Manager автоматически создавать профиль порта VM-FEX с параметрами, соответствующими шаблону vNIC. Допустимы следующие значения: adapter — vNIC применяются ко всем адаптерам. При выборе этого варианта профиль порта VM-FEX не создается. vm — vNIC применяются ко всем виртуальным машинам. При выборе этого варианта создается профиль порта VM-FEX. Варианты:
|
template_type string | Поле типа шаблона. Допустимы следующие значения: initial-template — интерфейсы vNIC, созданные на основе этого шаблона, не обновляются при изменении шаблона. updating-template — интерфейсы vNIC, созданные на основе этого шаблона, обновляются при изменении шаблона. Варианты:
|
use_proxy boolean | Если задано Варианты:
|
use_ssl boolean | Если задано Варианты:
|
username string | Имя пользователя для аутентификации в Cisco UCS Manager. По умолчанию: |
vlans_list list / элементы=dictionary | Список VLAN, используемых шаблоном vNIC. |
|
fabric string |
Обратите внимание: этот параметр не используется и предоставляется только для возможности использовать параметры ucs_vlans в vlan_list. Фабричная конфигурация VLAN. Допустимы следующие значения: common — VLAN применяется к обеим фабрикам, для которых используются одинаковые параметры конфигурации. A — VLAN применяется только к фабрике A. B — VLAN применяется только к фабрике B. Варианты:
|
|
id string |
Обратите внимание: этот параметр не используется и предоставляется только для возможности использовать параметры ucs_vlans в vlan_list. Уникальный строковый идентификатор, назначенный VLAN. |
|
multicast_policy string |
Обратите внимание: этот параметр не используется и предоставляется только для возможности использовать параметры ucs_vlans в vlan_list. Политика многоадресной рассылки, связанная с этой VLAN. |
|
name string |
Имя VLAN (обязательно, если для state задано значение present). |
|
native string |
Назначает VLAN роль собственной VLAN. В списке может быть только одна собственная VLAN. Варианты:
|
|
sharing string |
Обратите внимание: этот параметр не используется и предоставляется только для возможности использовать параметры ucs_vlans в vlan_list. Поле типа совместного использования. Определяет, разделена ли эта VLAN на частные или вторичные VLAN. Допустимы следующие значения: none — у этой VLAN нет вторичных или частных VLAN. Это обычная VLAN. primary — у этой VLAN может быть одна или несколько вторичных VLAN, как показано в области «Вторичные VLAN». isolated — это частная VLAN, связанная с первичной VLAN. Эта VLAN является изолированной VLAN. community — эта VLAN может взаимодействовать с другими портами в той же VLAN сообщества, а также с портом с неограниченным доступом. Эта VLAN является VLAN сообщества. Варианты:
|
|
state string |
Если задано значение present, проверяет наличие VLAN в шаблоне. Если задано значение absent, проверяет отсутствие VLAN в шаблоне. Варианты:
|
Примеры
- name: Configure vNIC template
cisco.ucs.ucs_vnic_template:
hostname: 172.16.143.150
username: admin
password: password
name: vNIC-A
fabric: A
vlans_list:
- name: default
native: 'yes'
- name: Configure vNIC template with failover
cisco.ucs.ucs_vnic_template:
hostname: 172.16.143.150
username: admin
password: password
name: vNIC-A-B
fabric: A-B
vlans_list:
- name: default
native: 'yes'
state: present
- name: Remove vNIC template
cisco.ucs.ucs_vnic_template:
hostname: 172.16.143.150
username: admin
password: password
name: vNIC-A
state: absent
- name: Remove another vNIC template
cisco.ucs.ucs_vnic_template:
hostname: 172.16.143.150
username: admin
password: password
name: vNIC-A-B
state: absent
- name: Remove VLAN from template
cisco.ucs.ucs_vnic_template:
hostname: 172.16.143.150
username: admin
password: password
name: vNIC-A-B
fabric: A-B
vlans_list:
- name: default
native: 'yes'
state: absent
Ссылки на коллекцию
© 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/ucs/ucs_vnic_template_module.html