/ home / community / community.vmware / 4.2.0 / module / vmware_host_vmnic_info

community.vmware.vmware_host_vmnic_info (4.2.0) — module

Gathers info about vmnics available on the given ESXi host

Authors: Abhijeet Kasurde (@Akasurde), Christian Kotte (@ckotte)

Install collection

Install with ansible-galaxy collection install community.vmware:==4.2.0

Add to requirements.yml

  collections:
    - name: community.vmware
      version: 4.2.0

Description

This module can be used to gather information about vmnics available on the given ESXi host.

If O(cluster_name) is provided, then vmnic information about all hosts from given cluster will be returned.

If O(esxi_hostname) is provided, then vmnic information about given host system will be returned.

Usage examples

Scanned by Steampunk Spotter

- name: Gather info about vmnics of all ESXi Host in the given Cluster
  community.vmware.vmware_host_vmnic_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
  delegate_to: localhost
  register: cluster_host_vmnics

Scanned by Steampunk Spotter

- name: Gather info about vmnics of an ESXi Host
  community.vmware.vmware_host_vmnic_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
  delegate_to: localhost
  register: host_vmnics

Inputs

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 E(VMWARE_PORT)
will be used instead.
type: int

sriov:
default: false
description:
- Gather information about SR-IOV capabilities and configuration.
type: bool

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 E(VMWARE_HOST)
will be used instead.
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 E(VMWARE_PASSWORD)
will be used instead.
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 E(VMWARE_USER)
will be used instead.
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 E(VMWARE_PROXY_HOST)
will be used instead.
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 E(VMWARE_PROXY_PORT)
will be used instead.
required: false
type: int

capabilities:
default: false
description:
- Gather information about general capabilities (Auto negotiation, Wake On LAN, and
Network I/O Control).
type: bool

cluster_name:
description:
- Name of the cluster from which all host systems will be used.
- Vmnic information about each ESXi server will be returned for the given cluster.
- This parameter is required if O(esxi_hostname) is not specified.
type: str

directpath_io:
default: false
description:
- Gather information about DirectPath I/O capabilities and configuration.
type: bool

esxi_hostname:
description:
- Name of the host system to work with.
- Vmnic information about this ESXi server will be returned.
- This parameter is required if O(cluster_name) is not specified.
type: str

validate_certs:
default: true
description:
- Allows connection when SSL certificates are not valid. Set to V(false) when certificates
are not trusted.
- If the value is not specified in the task, the value of environment variable E(VMWARE_VALIDATE_CERTS)
will be used instead.
type: bool

Outputs

hosts_vmnics_info:
  description:
  - dict with hostname as key and dict with vmnics information as value.
  - for C(num_vmnics), only NICs starting with vmnic are counted. NICs like vusb*
    are not counted.
  returned: hosts_vmnics_info
  sample:
    10.76.33.204:
      all:
      - vmnic0
      - vmnic1
      available: []
      dvswitch:
        dvs_0002:
        - vmnic1
      num_vmnics: 2
      used:
      - vmnic1
      - vmnic0
      vmnic_details:
      - actual_duplex: Full Duplex
        actual_speed: 10000
        adapter: Intel(R) 82599 10 Gigabit Dual Port Network Connection
        configured_duplex: Auto negotiate
        configured_speed: Auto negotiate
        device: vmnic0
        driver: ixgbe
        lldp_info:
          Aggregated Port ID: '0'
          Aggregation Status: '1'
          Enabled Capabilities:
            _vimtype: vim.host.PhysicalNic.CdpDeviceCapability
            host: false
            igmpEnabled: false
            networkSwitch: false
            repeater: false
            router: true
            sourceRouteBridge: false
            transparentBridge: true
          MTU: '9216'
          Port Description: switch port description
          Samples: 18814
          System Description: omitted from output
          System Name: sw1
          TimeOut: 30
          Vlan ID: '1'
        location: '0000:01:00.0'
        mac: aa:bb:cc:dd:ee:ff
        status: Connected
      - actual_duplex: Full Duplex
        actual_speed: 10000
        adapter: Intel(R) 82599 10 Gigabit Dual Port Network Connection
        configured_duplex: Auto negotiate
        configured_speed: Auto negotiate
        device: vmnic1
        driver: ixgbe
        lldp_info: N/A
        location: '0000:01:00.1'
        mac: ab:ba:cc:dd:ee:ff
        status: Connected
      vswitch:
        vSwitch0:
        - vmnic0
  type: dict