ansible / ansible.builtin / v2.9.24 / module / vmware_dvs_portgroup_info Gathers info DVS portgroup configurations | "added in version" 2.9 of ansible.builtin" Authors: Abhijeet Kasurde (@Akasurde) preview | supported by communityansible.builtin.vmware_dvs_portgroup_info (v2.9.24) — module
pip
Install with pip install ansible==2.9.24
This module can be used to gather information about DVS portgroup configurations.
- name: Get info about DVPG vmware_dvs_portgroup_info: hostname: "{{ vcenter_server }}" username: "{{ vcenter_user }}" password: "{{ vcenter_pass }}" validate_certs: no datacenter: "{{ datacenter_name }}" register: dvpg_info
- name: Get number of ports for portgroup 'dvpg_001' in 'dvs_001' debug: msg: "{{ item.num_ports }}" with_items: - "{{ dvpg_info.dvs_portgroup_info['dvs_001'] | json_query(query) }}" vars: query: "[?portgroup_name=='dvpg_001']"
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 dvswitch: description: - Name of a dvswitch to look for. required: false type: str version_added: '2.9' version_added_collection: ansible.builtin 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 datacenter: description: - Name of the datacenter. required: true 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 show_vlan_info: default: false description: - Show or hide vlan information of the DVS portgroup. type: bool version_added: '2.9' version_added_collection: ansible.builtin 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 show_port_policy: default: true description: - Show or hide port policies of DVS portgroup. type: bool show_network_policy: default: true description: - Show or hide network policies of DVS portgroup. type: bool show_teaming_policy: default: true description: - Show or hide teaming policies of DVS portgroup. type: bool
dvs_portgroup_info: description: metadata about DVS portgroup configuration returned: on success sample: dvs_0: - description: null dvswitch_name: dvs_001 network_policy: forged_transmits: false mac_changes: false promiscuous: false num_ports: 8 port_policy: block_override: true ipfix_override: false live_port_move: false network_rp_override: false port_config_reset_at_disconnect: true security_override: false shaping_override: false traffic_filter_override: false uplink_teaming_override: false vendor_config_override: false vlan_override: false portgroup_name: dvpg_001 teaming_policy: inbound_policy: true notify_switches: true policy: loadbalance_srcid rolling_order: false type: earlyBinding vlan_info: pvlan: false trunk: false vlan_id: 0 type: dict