модуль cisco.intersight.intersight_ethernet_network_control_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_control_policy.

Обзор
Параметры
Примеры
Возвращаемые значения

Обзор

Управляет настройкой политики управления сетью Ethernet в Cisco Intersight.
Политика настройки параметров управления сетью для Ethernet-подключений на серверах под управлением Cisco Intersight.
Эта политика применима только к серверам UCS (подключённым к FI).
Дополнительные сведения см. в документации 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"`
cdp_enabled boolean	Включает CDP на интерфейсе. Cisco Discovery Protocol (CDP) — проприетарный протокол канального уровня, разработанный компанией Cisco Systems. Допустимые значения: `false` ← (по умолчанию) `true`
description псевдонимы: descr string	Описание политики управления сетью Ethernet, заданное пользователем. Описание может содержать буквы (a-z, A-Z), цифры (0-9), дефис (-), точку (.), двоеточие (:) или подчёркивание (_).
forge_mac string	Определяет, разрешено или запрещено подменять MAC-адрес на интерфейсе. allow — разрешить подмену MAC-адреса на интерфейсе. deny — запретить подмену MAC-адреса на интерфейсе. Допустимые значения: `"allow"` ← (по умолчанию) `"deny"`
lldp_receive_enabled boolean	Определяет, могут ли интерфейсы коммутатора принимать кадры LLDP. Link Layer Discovery Protocol (LLDP) — независимый от производителя протокол канального уровня. Допустимые значения: `false` ← (по умолчанию) `true`
lldp_transmit_enabled boolean	Определяет, могут ли интерфейсы коммутатора передавать кадры LLDP. Link Layer Discovery Protocol (LLDP) — независимый от производителя протокол канального уровня. Допустимые значения: `false` ← (по умолчанию) `true`
mac_registration_mode string	Определяет, какие MAC-адреса следует зарегистрировать на коммутаторе. nativeVlanOnly — регистрировать только MAC-адреса, изученные в собственной VLAN. allVlans — регистрировать MAC-адреса, изученные во всех VLAN. Допустимые значения: `"nativeVlanOnly"` ← (по умолчанию) `"allVlans"`
name string / обязательный	Имя, присвоенное политике управления сетью Ethernet. Имя должно содержать от 1 до 62 буквенно-цифровых символов; допускаются специальные символы :-_.
organization string	Имя организации, которой назначен этот ресурс. Профили, политики и пулы, созданные в пользовательской организации, применимы только к устройствам в этой же организации. По умолчанию: `"default"`
state string	Если задано `present`, проверяется наличие ресурса и при необходимости он создаётся. Если задано `absent`, проверяется отсутствие ресурса и при необходимости он удаляется. Допустимые значения: `"present"` ← (по умолчанию) `"absent"`
tags list / элементы=словарь	Список тегов в формате Key:<определённый пользователем ключ> Value:<определённое пользователем значение>.
uplink_fail_action string	Определяет состояние виртуального интерфейса (vethernet / vfc) на коммутаторе, если для него не назначен подходящий восходящий канал. linkDown — интерфейс vethernet перейдёт в состояние «не работает». warning — интерфейс vethernet останется активным, и переключение при потере соединения с восходящим каналом не произойдёт. Важно! Если для действия при потере восходящего канала задано значение Warning, коммутатор не переключится при потере соединения с восходящим каналом. Допустимые значения: `"linkDown"` ← (по умолчанию) `"warning"`
use_proxy boolean	Если задано `no`, прокси использоваться не будет, даже если он указан в переменной окружения на целевых узлах. Допустимые значения: `false` `true` ← (по умолчанию)
validate_certs boolean	Логический параметр, управляющий проверкой TLS-сертификата api_uri. Допустимые значения: `false` `true` ← (по умолчанию)

Примеры

- name: Create an Ethernet Network Control Policy with default settings
  cisco.intersight.intersight_ethernet_network_control_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "default-network-control-policy"
    description: "Default Ethernet Network Control policy"
    state: present

- name: Create an Ethernet Network Control Policy with CDP and LLDP enabled
  cisco.intersight.intersight_ethernet_network_control_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    organization: "default"
    name: "discovery-enabled-policy"
    description: "Network Control policy with discovery protocols enabled"
    tags:
      - Key: "Environment"
        Value: "Production"
    cdp_enabled: true
    mac_registration_mode: "allVlans"
    uplink_fail_action: "warning"
    forge_mac: "deny"
    lldp_transmit_enabled: true
    lldp_receive_enabled: true
    state: present

- name: Create an Ethernet Network Control Policy with strict security settings
  cisco.intersight.intersight_ethernet_network_control_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "secure-network-control-policy"
    description: "Secure Network Control policy with MAC forging denied"
    cdp_enabled: false
    mac_registration_mode: "nativeVlanOnly"
    uplink_fail_action: "linkDown"
    forge_mac: "deny"
    lldp_transmit_enabled: false
    lldp_receive_enabled: false
    state: present

- name: Delete an Ethernet Network Control Policy
  cisco.intersight.intersight_ethernet_network_control_policy:
    api_private_key: "{{ api_private_key }}"
    api_key_id: "{{ api_key_id }}"
    name: "secure-network-control-policy"
    state: absent

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

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

Ключ	Описание
api_response dictionary	Данные ответа API, возвращённые для указанного ресурса. Возвращается: всегда Пример: `{"api_response": {"CdpEnabled": true, "ForgeMac": "deny", "LldpSettings": {"ReceiveEnabled": true, "TransmitEnabled": true}, "MacRegistrationMode": "allVlans", "Name": "discovery-enabled-policy", "ObjectType": "fabric.EthNetworkControlPolicy", "Tags": [{"Key": "Environment", "Value": "Production"}], "UplinkFailAction": "warning"}}`

Ключ

Описание

api_response

dictionary

Данные ответа API, возвращённые для указанного ресурса.

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

Пример: {"api_response": {"CdpEnabled": true, "ForgeMac": "deny", "LldpSettings": {"ReceiveEnabled": true, "TransmitEnabled": true}, "MacRegistrationMode": "allVlans", "Name": "discovery-enabled-policy", "ObjectType": "fabric.EthNetworkControlPolicy", "Tags": [{"Key": "Environment", "Value": "Production"}], "UplinkFailAction": "warning"}}

Авторы

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