VMware VM Info

5 min

Resumo

Retorna informações básicas pertencentes a um convidado de máquina virtual vSphere ou ESXi. opções

Parâmetros

Parâmetro	Tipo	Escolhas \| Valor Padrão	Comentários
vm_type	string	all vm template	Se definido como C(vm), as informações serão coletadas apenas para máquinas virtuais. Se definido como C(template), as informações são coletadas apenas para modelos de máquinas virtuais. Se definido como C(all), as informações serão reunidas para todas as máquinas virtuais e modelos de máquina virtual.
show_attribute	bool	false true	Atributos relacionados ao convidado da VM mostrados nas informações somente quando isso é definido como C(true).
folder	string		Especifique um local de pasta de VMs para coletar informações
show_tag	bool	false true	As tags relacionadas à máquina virtual são mostradas se definidas como C(True).

Estende fragmentos da documentação do módulo VMware Options.

Notas

Observação

Testado em ESXi 7.0.2
Todos os módulos requerem acesso de gravação API e, portanto, não são suportados em uma licença ESXi gratuita.

Exemplos

- name: Gather all registered virtual machines
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
  delegate_to: localhost
  register: vminfo

- debug:
    var: vminfo.virtual_machines

- name: Gather only registered virtual machine templates
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_type: template
  delegate_to: localhost
  register: template_info

- debug:
    var: template_info.virtual_machines

- name: Gather only registered virtual machines
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    vm_type: vm
  delegate_to: localhost
  register: vm_info

- debug:
    var: vm_info.virtual_machines

- name: Get UUID from given VM Name
  block:
    - name: Get virtual machine info
      community.vmware.vmware_vm_info:
        hostname: '{{ vcenter_hostname }}'
        username: '{{ vcenter_username }}'
        password: '{{ vcenter_password }}'
        folder: "/datacenter/vm/folder"
      delegate_to: localhost
      register: vm_info

    - debug:
        msg: "{{ item.uuid }}"
      with_items:
        - "{{ vm_info.virtual_machines | json_query(query) }}"
      vars:
        query: "[?guest_name=='DC0_H0_VM0']"

- name: Get Tags from given VM Name
  block:
    - name: Get virtual machine info
      community.vmware.vmware_vm_info:
        hostname: '{{ vcenter_hostname }}'
        username: '{{ vcenter_username }}'
        password: '{{ vcenter_password }}'
        folder: "/datacenter/vm/folder"
      delegate_to: localhost
      register: vm_info

    - debug:
        msg: "{{ item.tags }}"
      with_items:
        - "{{ vm_info.virtual_machines | json_query(query) }}"
      vars:
        query: "[?guest_name=='DC0_H0_VM0']"

- name: Gather all VMs from a specific folder
  community.vmware.vmware_vm_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    folder: "/Asia-Datacenter1/vm/prod"
  delegate_to: localhost
  register: vm_info

Valores Retornados

Chave	Tipo	Retornado quando	Descrição
virtual_machines	list	sempre	lista de dicionário de máquinas virtuais e suas informações