community / community.vmware / 2.10.4 / module / vmware_dvswitch_pvlans Manage Private VLAN configuration of a Distributed Switch Authors: Christian Kotte (@ckotte)community.vmware.vmware_dvswitch_pvlans (2.10.4) — module
Install with ansible-galaxy collection install community.vmware:==2.10.4
collections: - name: community.vmware version: 2.10.4
This module can be used to configure Private VLANs (PVLANs) on a Distributed Switch.
- name: Create PVLANs on a Distributed Switch community.vmware.vmware_dvswitch_pvlans: hostname: '{{ inventory_hostname }}' username: '{{ vcenter_username }}' password: '{{ vcenter_password }}' switch: dvSwitch primary_pvlans: - primary_pvlan_id: 1 - primary_pvlan_id: 4 secondary_pvlans: - primary_pvlan_id: 1 secondary_pvlan_id: 2 pvlan_type: isolated - primary_pvlan_id: 1 secondary_pvlan_id: 3 pvlan_type: community - primary_pvlan_id: 4 secondary_pvlan_id: 5 pvlan_type: community delegate_to: localhost
- name: Create primary PVLAN and secondary promiscuous PVLAN on a Distributed Switch community.vmware.vmware_dvswitch_pvlans: hostname: '{{ inventory_hostname }}' username: '{{ vcenter_username }}' password: '{{ vcenter_password }}' switch: dvSwitch primary_pvlans: - primary_pvlan_id: 1 delegate_to: localhost
- name: Remove all PVLANs from a Distributed Switch community.vmware.vmware_dvswitch_pvlans: hostname: '{{ inventory_hostname }}' username: '{{ vcenter_username }}' password: '{{ vcenter_password }}' switch: dvSwitch primary_pvlans: [] secondary_pvlans: [] delegate_to: localhost
port: default: 443 description: - The port number of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_PORT) will be used instead. - Environment variable support added in Ansible 2.6. type: int switch: aliases: - dvswitch description: - The name of the Distributed Switch. required: true type: str hostname: description: - The hostname or IP address of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_HOST) will be used instead. - Environment variable support added in Ansible 2.6. type: str password: aliases: - pass - pwd description: - The password of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_PASSWORD) will be used instead. - Environment variable support added in Ansible 2.6. type: str username: aliases: - admin - user description: - The username of the vSphere vCenter or ESXi server. - If the value is not specified in the task, the value of environment variable C(VMWARE_USER) will be used instead. - Environment variable support added in Ansible 2.6. type: str proxy_host: description: - Address of a proxy that will receive all HTTPS requests and relay them. - The format is a hostname or a IP. - If the value is not specified in the task, the value of environment variable C(VMWARE_PROXY_HOST) will be used instead. - This feature depends on a version of pyvmomi greater than v6.7.1.2018.12 required: false type: str proxy_port: description: - Port of the HTTP proxy that will receive all HTTPS requests and relay them. - If the value is not specified in the task, the value of environment variable C(VMWARE_PROXY_PORT) will be used instead. required: false type: int primary_pvlans: default: [] description: - A list of VLAN IDs that should be configured as Primary PVLANs. - If C(primary_pvlans) isn't specified, all PVLANs will be deleted if present. - Each member of the list requires primary_pvlan_id (int) set. - The secondary promiscuous PVLAN will be created automatically. - If C(secondary_pvlans) isn't specified, the primary PVLANs and each secondary promiscuous PVLAN will be created. - Please see examples for more information. elements: dict type: list validate_certs: default: true description: - Allows connection when SSL certificates are not valid. Set to C(false) when certificates are not trusted. - If the value is not specified in the task, the value of environment variable C(VMWARE_VALIDATE_CERTS) will be used instead. - Environment variable support added in Ansible 2.6. - If set to C(true), please make sure Python >= 2.7.9 is installed on the given machine. type: bool secondary_pvlans: default: [] description: - A list of VLAN IDs that should be configured as Secondary PVLANs. - C(primary_pvlans) need to be specified to create any Secondary PVLAN. - If C(primary_pvlans) isn't specified, all PVLANs will be deleted if present. - Each member of the list requires primary_pvlan_id (int), secondary_pvlan_id (int), and pvlan_type (str) to be set. - The type of the secondary PVLAN can be isolated or community. The secondary promiscuous PVLAN will be created automatically. - Please see examples for more information. elements: dict type: list
result: description: information about performed operation returned: always sample: changed: true dvswitch: dvSwitch private_vlans: - primary_pvlan_id: 1 pvlan_type: promiscuous secondary_pvlan_id: 1 - primary_pvlan_id: 1 pvlan_type: isolated secondary_pvlan_id: 2 - primary_pvlan_id: 1 pvlan_type: community secondary_pvlan_id: 3 private_vlans_previous: [] result: All private VLANs added type: str