Модуль community.vmware.vmware_vspan_session — создание или удаление сеанса зеркалирования портов.

Примечание

Этот модуль входит в коллекцию community.vmware (версия 6.2.0).

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

Чтобы установить её, используйте: ansible-galaxy collection install community.vmware.

Чтобы использовать её в плейбуке, укажите: community.vmware.vmware_vspan_session.

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

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

Этот модуль позволяет создавать, удалять или изменять различные типы сеансов зеркалирования портов.

Параметры

Параметр	Комментарии
description string	Описание сеанса.
destination_port string	Порт назначения, получающий зеркалируемые пакеты. Кроме того, любой порт, указанный в значении этого свойства, не может совпадать с исходным портом ни в одном сеансе зеркалирования распределённых портов.
destination_vm dictionary	Этот параметр позволяет добавить сетевой адаптер виртуальной машины в сеанс зеркалирования портов.
name string	Имя виртуальной машины.
nic_label string	Метка используемого сетевого адаптера.
enabled boolean	Включён ли сеанс. Варианты: `false` `true` ← (по умолчанию)
encapsulation_vlan_id integer	Идентификатор VLAN, используемый для инкапсуляции зеркалируемого трафика.
hostname string	Имя хоста или IP-адрес сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_HOST`.
mirrored_packet_length integer	Целое число, задающее, какая часть каждого кадра будет зеркалироваться. Если значение не задано, будет зеркалироваться весь кадр. Это свойство полезно задать меньшим, если потребитель анализирует только заголовки. Значение не может быть меньше 60.
name string / обязательно	Имя сеанса.
normal_traffic_allowed boolean	Могут ли порты назначения отправлять и принимать «обычный» трафик. Если задать значение false, порты зеркалирования будут использоваться только для зеркалирования и не будут выполнять роль обычных портов доступа. Варианты: `false` `true`
password псевдонимы: pass, pwd string	Пароль сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PASSWORD`.
port integer	Номер порта сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PORT`. По умолчанию: `443`
proxy_host string	Адрес прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Укажите имя хоста или IP-адрес. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PROXY_HOST`.
proxy_port integer	Порт HTTP-прокси-сервера, который будет получать и перенаправлять все HTTPS-запросы. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_PROXY_PORT`.
sampling_rate integer	Частота выборки пакетов для сеанса. Если её значение равно n, зеркалируется каждый n-й пакет. Допустимые значения: от 1 до 65535.
session_type string	Выберите тип зеркалирования. В сеансе `encapsulatedRemoteMirrorSource` распределённые порты можно использовать как исходные объекты, а IP-адреса — как объекты назначения. В сеансе `remoteMirrorDest` идентификаторы VLAN можно использовать как исходные объекты, а распределённые порты — как объекты назначения. В сеансе `remoteMirrorSource` распределённые порты можно использовать как исходные объекты, а имена портов восходящей линии связи — как объекты назначения. В сеансе `dvPortMirror` распределённые порты можно использовать как исходные и целевые объекты. Варианты: `"encapsulatedRemoteMirrorSource"` `"remoteMirrorDest"` `"remoteMirrorSource"` `"dvPortMirror"` ← (по умолчанию)
source_port_received string	Исходный порт, для которого зеркалируются полученные пакеты.
source_port_transmitted string	Исходный порт, для которого зеркалируются отправленные пакеты.
source_vm_received dictionary	Этот параметр позволяет добавить сетевой адаптер виртуальной машины в сеанс зеркалирования портов.
name string	Имя виртуальной машины.
nic_label string	Метка используемого сетевого адаптера.
source_vm_transmitted dictionary	Этот параметр позволяет добавить сетевой адаптер виртуальной машины в сеанс зеркалирования портов.
name string	Имя виртуальной машины.
nic_label string	Метка используемого сетевого адаптера.
state string / обязательно	Создать или удалить сеанс. Варианты: `"present"` `"absent"`
strip_original_vlan boolean	Удалять ли исходный тег VLAN. Если значение равно false, исходный тег VLAN будет сохранён в зеркалируемом трафике. Если задано `encapsulation_vlan_id` и это свойство имеет значение `false`, кадры будут помечены двумя тегами: исходный идентификатор VLAN будет внутренним тегом. Варианты: `false` `true`
switch псевдонимы: switch_name string / обязательно	Имя распределённого виртуального коммутатора, на котором нужно добавить или удалить сеанс зеркалирования.
username псевдонимы: admin, user string	Имя пользователя сервера vSphere vCenter. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_USER`.
validate_certs boolean	Разрешает подключение при недействительных SSL-сертификатах. Задайте значение `false`, если сертификаты не являются доверенными. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды `VMWARE_VALIDATE_CERTS`. Варианты: `false` `true` ← (по умолчанию)

Примечания

Примечание

Для всех модулей требуется доступ на запись через API, поэтому они не поддерживаются бесплатной лицензией ESXi.
Все переменные и имена объектов VMware чувствительны к регистру.
Модули могут использовать библиотеку Python ‘requests’, которая по умолчанию не использует системное хранилище сертификатов. Указать хранилище сертификатов можно, задав переменную среды REQUESTS_CA_BUNDLE. Учтите, что наличие этой переменной в некоторых случаях может привести к тому, что значение ‘false’ параметра ‘validate_certs’ будет проигнорировано. Пример: ‘export REQUESTS_CA_BUNDLE=/path/to/your/ca_bundle.pem’

Примеры

- name: Create distributed mirroring session.
  community.vmware.vmware_vspan_session:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch_name: dvSwitch
    state: present
    name: Basic Session
    enabled: true
    description: "Example description"
    source_port_transmitted: 817
    source_port_received: 817
    destination_port: 815
  delegate_to: localhost

- name: Create remote destination mirroring session.
  community.vmware.vmware_vspan_session:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch_name: dvSwitch
    state: present
    name: Remote Session
    enabled: true
    description: "Example description"
    source_port_received: 105
    destination_port: 815
    session_type: "remoteMirrorDest"
  delegate_to: localhost

- name: Delete remote destination mirroring session.
  community.vmware.vmware_vspan_session:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    switch_name: dvSwitch
    state: absent
    name: Remote Session
  delegate_to: localhost

Авторы

Peter Gyorgy (@gyorgypeter)

Ссылки на коллекцию

© 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/community/vmware/vmware_vspan_session_module.html