модуль cisco.intersight.intersight_ethernet_network_group_policy — настройка политики группы сетей Ethernet для Cisco Intersight
Примечание
Этот модуль входит в коллекцию cisco.intersight (версия 2.18.0).
Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.
Для установки используйте: ansible-galaxy collection install cisco.intersight.
Чтобы использовать коллекцию в плейбуке, укажите: cisco.intersight.intersight_ethernet_network_group_policy.
Краткое описание
- Управляет настройкой политики группы сетей Ethernet в Cisco Intersight.
- Политика для настройки параметров VLAN и туннелирования QinQ (802.1Q-in-802.1Q) для виртуальных интерфейсов Ethernet на серверах, управляемых Cisco Intersight.
- Дополнительную информацию см. в документации Cisco Intersight.
Параметры
Параметр | Комментарии |
|---|---|
allowed_vlans string | Укажите идентификаторы VLAN в виде списка разделённых запятыми идентификаторов VLAN и диапазонов идентификаторов VLAN. Обязателен, если Примеры допустимых форматов: Допустимый диапазон VLAN: 1–4093. |
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. По умолчанию: |
description псевдонимы: descr string | Описание политики группы сетей Ethernet, заданное пользователем. Описание может содержать буквы (a–z, A–Z), цифры (0–9), дефис (-), точку (.), двоеточие (:) или символ подчёркивания (_). |
name string / обязательный | Имя, присвоенное политике группы сетей Ethernet. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_. |
native_vlan integer | Задаёт native VLAN для политики группы сетей Ethernet. Можно использовать с QinQ (если При использовании с Можно указать только одну native VLAN. Допустимый диапазон: 1–4093. |
organization string | Имя организации, которой назначен этот ресурс. Профили, политики и пулы, созданные в пользовательской организации, применимы только к устройствам в этой же организации. По умолчанию: |
qinq_enabled boolean | Включает туннелирование QinQ (802.1Q-in-802.1Q) на vNIC. Если включено, требуется Если отключено, требуется Варианты:
|
qinq_vlan integer | Задаёт номер VLAN QinQ. Обязателен, если Можно указать только одну VLAN QinQ. Допустимый диапазон: 2–4093. |
state string | Если Если Если Варианты:
|
tags list / элементы=dictionary | Список тегов в формате «Ключ:<ключ, заданный пользователем> Значение:<значение, заданное пользователем>». |
use_proxy boolean | Если Варианты:
|
validate_certs boolean | Логический параметр для проверки TLS-сертификата api_uri Варианты:
|
Примеры
- name: Create an Ethernet Network Group Policy with regular VLANs
cisco.intersight.intersight_ethernet_network_group_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "regular-vlans-policy"
description: "Policy with regular VLAN configuration"
qinq_enabled: false
allowed_vlans: "1-8,12,16"
state: present
- name: Create an Ethernet Network Group Policy with QinQ enabled
cisco.intersight.intersight_ethernet_network_group_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
organization: "default"
name: "qinq-policy"
description: "Policy with QinQ configuration"
tags:
- Key: "Environment"
Value: "Production"
qinq_enabled: true
qinq_vlan: 4
native_vlan: 1
state: present
- name: Create an Ethernet Network Group Policy with QinQ enabled (no native VLAN)
cisco.intersight.intersight_ethernet_network_group_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "qinq-no-native-policy"
description: "QinQ policy without native VLAN"
qinq_enabled: true
qinq_vlan: 100
state: present
- name: Create an Ethernet Network Group Policy with single VLAN
cisco.intersight.intersight_ethernet_network_group_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "single-vlan-policy"
description: "Policy with single VLAN"
qinq_enabled: false
allowed_vlans: "50"
state: present
- name: Create an Ethernet Network Group Policy with native VLAN
cisco.intersight.intersight_ethernet_network_group_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "native-vlan-policy"
description: "Policy with allowed VLANs and native VLAN"
qinq_enabled: false
allowed_vlans: "1-100,200-300"
native_vlan: 1
state: present
- name: Delete an Ethernet Network Group Policy
cisco.intersight.intersight_ethernet_network_group_policy:
api_private_key: "{{ api_private_key }}"
api_key_id: "{{ api_key_id }}"
name: "qinq-policy"
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_ethernet_network_group_policy_module.html