vmware_vspan_session – Создание или удаление сессии отражения портов
Новая в версии 2.8.
Описание
- Этот модуль может использоваться для создания, удаления или изменения различных сессий отражения портов.
Требования
Ниже приведены требования к хосту, на котором выполняется этот модуль.
- python > = 2.6
- PyVmomi
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| description строка | Описание сессии. | |
| destination_port строка | Порт назначения, который получает отраженные пакеты. Также любой порт, указанный в этом свойстве, не может совпадать с портом источника ни в одной из сессий распределенного отражения портов. | |
| destination_vm словарь | С помощью этого параметра можно добавить сетевую карту виртуальной машины в сессию отражения портов. Допустимые атрибуты: - name (строка): Название виртуальной машины- nic_label (логическое значение): Метка сетевой карты, которую нужно использовать. | |
| enabled логическое значение |
| Включена ли сессия. |
| encapsulation_vlan_id целое число | Идентификатор VLAN, используемый для инкапсуляции отраженного трафика. | |
| hostname строка | Имя хоста или IP-адрес сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды VMWARE_HOST. Поддержка переменных среды добавлена в Ansible 2.6. | |
| mirrored_packet_length целое число | Целое число, описывающее, сколько каждого кадра нужно отразить. Если не задано, отражается весь кадр. Установка этого свойства на меньшее значение полезна, когда потребитель будет рассматривать только заголовки. Значение не может быть меньше 60. | |
| name строка / требуется | Имя сессии. | |
| normal_traffic_allowed логическое значение |
| Разрешен ли трафик назначения отправлять и получать «нормальный» трафик. Установка в значение false сделает порты зеркала исключительно для отражения и не будет использовать их как нормальные порты доступа. |
| password строка | Пароль сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды VMWARE_PASSWORD. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: pass, pwd | |
| port целое число добавлен в 2.5 | По умолчанию: 443 | Номер порта сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды VMWARE_PORT. Поддержка переменных среды добавлена в Ansible 2.6. |
| proxy_host строка добавлен в 2.9 | Адрес прокси, который будет получать все запросы HTTPS и пересылать их. Формат — имя хоста или IP-адрес. Если значение не указано в задаче, используется значение переменной среды VMWARE_PROXY_HOST. Эта функция зависит от версии pyvmomi, большей, чем v6.7.1.2018.12 | |
| proxy_port целое число добавлен в 2.9 | Порт HTTP-прокси, который будет получать все запросы HTTPS и пересылать их. Если значение не указано в задаче, используется значение переменной среды VMWARE_PROXY_PORT. | |
| sampling_rate целое число | Частота выборки сессии. Если его значение равно n, один из каждых n пакетов отражается. Допустимые значения от 1 до 65535, значение по умолчанию равно 1. | |
| session_type строка |
| Выберите тип отражения. - encapsulatedRemoteMirrorSource (строка): В сессии encapsulatedRemoteMirrorSource распределенные порты могут использоваться как сущности источника, а IP-адреса — как сущности назначения.- remoteMirrorDest (строка): В сессии remoteMirrorDest идентификаторы VLAN могут использоваться как сущности источника, а распределенные порты — как сущности назначения.- remoteMirrorSource (строка): В сессии remoteMirrorSource распределенные порты могут использоваться как сущности источника, а имена портов uplink — как сущности назначения.- dvPortMirror (строка): В сессии dvPortMirror распределенные порты могут использоваться как сущности источника и назначения. |
| source_port_received строка | Порт источника, для которого отражаются полученные пакеты. | |
| source_port_transmitted строка | Порт источника, для которого отражаются отправленные пакеты. | |
| source_vm_received словарь | С помощью этого параметра можно добавить сетевую карту виртуальной машины в сессию отражения портов. Допустимые атрибуты: - name (строка): Название виртуальной машины- nic_label (логическое значение): Метка сетевой карты, которую нужно использовать. | |
| source_vm_transmitted словарь | С помощью этого параметра можно добавить сетевую карту виртуальной машины в сессию отражения портов. Допустимые атрибуты: - name (строка): Название виртуальной машины- nic_label (логическое значение): Метка сетевой карты, которую нужно использовать. | |
| state строка / требуется |
| Создать или удалить сессию. |
| strip_original_vlan логическое значение |
| Снять исходный тег VLAN. Если false, исходный тег VLAN сохранится в отраженном трафике. Если encapsulationVlanId задано и это свойство равно false, кадры будут иметь двойной тег с исходным идентификатором VLAN как внутренним тегом. |
| switch строка / требуется | Имя распределенного vSwitch, на котором необходимо добавить или удалить сессию отражения. псевдонимы: switch_name | |
| username строка | Имя пользователя сервера vCenter или ESXi vSphere. Если значение не указано в задаче, используется значение переменной среды VMWARE_USER. Поддержка переменных среды добавлена в Ansible 2.6. псевдонимы: admin, user | |
| validate_certs логическое значение |
| Разрешает подключение, когда сертификаты SSL недействительны. Установите в false, когда сертификаты не доверяются.Если значение не указано в задаче, используется значение переменной среды VMWARE_VALIDATE_CERTS. Поддержка переменных среды добавлена в Ansible 2.6. Если установлено yes, убедитесь, что на данном компьютере установлен Python >= 2.7.9. |
Примечания
Примечание
- Проверено на vSphere 6.7
Примеры
- name: Create distributed mirroring session.
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.
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: Create remote destination mirroring session.
vmware_vspan_session:
hostname: '{{ vcenter_hostname }}'
username: '{{ vcenter_username }}'
password: '{{ vcenter_password }}'
switch_name: dvSwitch
state: absent
name: Remote Session
delegate_to: localhost
Статус
- Этот модуль не гарантирует обратную совместимость интерфейса. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- Peter Gyorgy (@gyorgypeter)
Подсказка
Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.9/modules/vmware_vspan_session_module.html
