community.vmware.vmware_host_vmhba_facts (1.18.2) — module

Install collection

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

Add to requirements.yml

  collections:
    - name: community.vmware
      version: 1.18.2

Description

This module can be used to gather facts about vmhbas available on the given ESXi host.

If C(cluster_name) is provided, then vmhba facts about all hosts from given cluster will be returned.

If C(esxi_hostname) is provided, then vmhba facts about given host system will be returned.

Requirements

• python >= 2.6
• PyVmomi

Usage examples

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Gather facts about vmhbas of all ESXi Host in the given Cluster
  community.vmware.vmware_host_vmhba_facts:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: '{{ cluster_name }}'
  delegate_to: localhost
  register: cluster_host_vmhbas

Scanned by Steampunk Spotter

• Success
  Steampunk Spotter scan finished with no errors, warnings or hints.

- name: Gather facts about vmhbas of an ESXi Host
  community.vmware.vmware_host_vmhba_facts:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
  delegate_to: localhost
  register: host_vmhbas

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 C(VMWARE_PORT)
      will be used instead.
    - Environment variable support added in Ansible 2.6.
    type: int

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

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

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

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

Outputs

hosts_vmhbas_facts:
  description:
  - dict with hostname as key and dict with vmhbas facts as value.
  returned: hosts_vmhbas_facts
  sample:
    10.76.33.204:
      vmhba_details:
      - adapter: HPE Smart Array P440ar
        bus: 3
        device: vmhba0
        driver: nhpsa
        location: '0000:03:00.0'
        model: Smart Array P440ar
        node_wwn: 50:01:43:80:37:18:9e:a0
        status: unknown
        type: SAS
      - adapter: QLogic Corp ISP2532-based 8Gb Fibre Channel to PCI Express HBA
        bus: 5
        device: vmhba1
        driver: qlnativefc
        location: '0000:05:00.0'
        model: ISP2532-based 8Gb Fibre Channel to PCI Express HBA
        node_wwn: 57:64:96:32:15:90:23:95:82
        port_type: unknown
        port_wwn: 57:64:96:32:15:90:23:95:82
        speed: 8
        status: online
        type: Fibre Channel
      - adapter: QLogic Corp ISP2532-based 8Gb Fibre Channel to PCI Express HBA
        bus: 8
        device: vmhba2
        driver: qlnativefc
        location: '0000:08:00.0'
        model: ISP2532-based 8Gb Fibre Channel to PCI Express HBA
        node_wwn: 57:64:96:32:15:90:23:95:21
        port_type: unknown
        port_wwn: 57:64:96:32:15:90:23:95:21
        speed: 8
        status: online
        type: Fibre Channel
  type: dict