Spec-Zone.ru › Ansible

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

Обязателен, если qinq_enabled имеет значение false.

Примеры допустимых форматов: 1, 1,2,3,4,8, 1-4,7, 1-8,12,16.

Допустимый диапазон 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.

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

description

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

string

Описание политики группы сетей Ethernet, заданное пользователем.

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

name

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

Имя, присвоенное политике группы сетей Ethernet.

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

native_vlan

integer

Задаёт native VLAN для политики группы сетей Ethernet.

Можно использовать с QinQ (если qinq_enabled имеет значение true) или в обычном режиме VLAN (если qinq_enabled имеет значение false).

При использовании с allowed_vlans native VLAN должна быть включена в список разрешённых VLAN.

Можно указать только одну native VLAN.

Допустимый диапазон: 1–4093.

organization

string

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

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

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

qinq_enabled

boolean

Включает туннелирование QinQ (802.1Q-in-802.1Q) на vNIC.

Если включено, требуется qinq_vlan, а allowed_vlans игнорируется.

Если отключено, требуется allowed_vlans.

Варианты:

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

qinq_vlan

integer

Задаёт номер VLAN QinQ.

Обязателен, если qinq_enabled имеет значение true.

Можно указать только одну VLAN QinQ.

Допустимый диапазон: 2–4093.

state

string

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

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

Если absent, параметры конфигурации VLAN не требуются.

Варианты:

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

tags

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

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

use_proxy

boolean

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

Варианты:

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

validate_certs

boolean

Логический параметр для проверки TLS-сертификата api_uri

Варианты:

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

Примеры

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

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

Пример: {"api_response": {"Name": "regular-vlans-policy", "ObjectType": "fabric.EthNetworkGroupPolicy", "Tags": [{"Key": "Environment", "Value": "Prod"}], "VlanSettings": {"AllowedVlans": "1-5,10,15-20", "ClassId": "fabric.VlanSettings", "ObjectType": "fabric.VlanSettings", "QinqEnabled": false}}}

Авторы

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

Spec-Zone.ru

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