Nota

Este complemento es parte del colección community.vmware (versión 1.7.0).

Para instalarlo use: ansible-galaxy collection install community.vmware.

Para usarlo en un libro de jugadas, especifique: community.vmware.vmware_vm_info.

  • Sinopsis
  • Requisitos
  • Parámetros
  • Notas
  • Ejemplos de
  • Valores devueltos

Sinopsis

  • Devuelve información básica relacionada con un invitado de máquina virtual vSphere o ESXi.
  • El nombre del clúster como hecho se agrega en la versión 2.7.
  • Este módulo se llamó vmware_vm_facts antes de Ansible 2.9. El uso no cambió.

Requisitos

Los siguientes requisitos son necesarios en el host que ejecuta este módulo.

  • pitón> = 2.6
  • PyVmomi

Parámetros

Parámetro Opciones / Valores predeterminados Comentarios
carpetastring Especifique una ubicación de carpeta de máquinas virtuales para recopilar información.Ejemplos: carpeta: / ha-datacenter / vmfolder: ha-datacenter / vmfolder: / datacenter1 / vmfolder: datacenter1 / vmfolder: / datacenter1 / vm / folder1folder: datacenter1 / vm / folder1folder: / folder1 / datacenter1 / vmfolder: folder1 / datacenter1 / vmfolder: / folder1 / datacenter1 / vm / folder2
nombre de hoststring El nombre de host o la dirección IP de vSphere vCenter o servidor ESXi. Si el valor no se especifica en la tarea, el valor de la variable de entorno VMWARE_HOST Se utilizará en su lugar. Se agregó compatibilidad con variables de entorno en Ansible 2.6.
contraseñastring La contraseña del servidor vSphere vCenter o ESXi. Si el valor no se especifica en la tarea, el valor de la variable de entorno VMWARE_PASSWORD Se utilizará en su lugar. Se agregó compatibilidad con variables de entorno en Ansible 2.6.
alias: pass, pwd
Puertoentero Defecto:
443
El número de puerto del servidor vSphere vCenter o ESXi. Si el valor no se especifica en la tarea, el valor de la variable de entorno VMWARE_PORT Se utilizará en su lugar. Se agregó compatibilidad con variables de entorno en Ansible 2.6.
proxy_hoststring Dirección de un proxy que recibirá todas las solicitudes HTTPS y las retransmitirá.El formato es un nombre de host o una IP.Si el valor no se especifica en la tarea, el valor de la variable de entorno VMWARE_PROXY_HOST Esta función depende de una versión de pyvmomi superior a la v6.7.1.2018.12
Puerto proxyentero Puerto del proxy HTTP que recibirá todas las solicitudes HTTPS y las retransmitirá. Si el valor no se especifica en la tarea, el valor de la variable de entorno VMWARE_PROXY_PORT se utilizará en su lugar.
show_attributebooleano
    Opciones:

  • no
Los atributos relacionados con el invitado de VM se muestran en la información solo cuando está configurado true.
show_tagbooleano
    Opciones:

  • no
Las etiquetas relacionadas con la máquina virtual se muestran si se configuran en True.
nombre de usuariostring El nombre de usuario del servidor vSphere vCenter o ESXi. Si el valor no se especifica en la tarea, el valor de la variable de entorno VMWARE_USER Se utilizará en su lugar. Se agregó compatibilidad con variables de entorno en Ansible 2.6.
alias: administrador, usuario
validate_certsbooleano
    Opciones:

  • no
Permite la conexión cuando los certificados SSL no son válidos. Ajustado a false cuando los certificados no son de confianza Si el valor no se especifica en la tarea, el valor de la variable de entorno VMWARE_VALIDATE_CERTS Se utilizará en su lugar Soporte de variable de entorno agregado en Ansible 2.6.Si se establece en true, asegúrese de que Python> = 2.7.9 esté instalado en la máquina indicada.
vm_typestring
    Opciones:

  • todos
  • vm
  • plantilla
Si se establece en vm, la información se recopila solo para máquinas virtuales. template, la información se recopila solo para las plantillas de máquinas virtuales. all, luego se recopila información para todas las máquinas virtuales y las plantillas de máquinas virtuales.

Notas

Nota

  • Probado en ESXi 6.7, vSphere 5.5 y vSphere 6.5
  • A partir de 2.8, la información se devuelve como lista de dict en lugar de dict.
  • Hecho sobre moid agregado en la colección de VMware 1.4.0.

Ejemplos de

-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 "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 "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 devueltos

Los valores de retorno comunes están documentados aquí, los siguientes son los campos exclusivos de este módulo:

Llave Devuelto Descripción
maquinas virtualeslista / elementos =string éxito lista de diccionario de máquinas virtuales y su información
Muestra:[‘attributes’: ‘job’: ‘backup-prepare’, ‘cluster’: None, ‘datacenter’: ‘Datacenter-1’, ‘esxi_hostname’: ‘10.76.33.226’, ‘folder’: ‘/Datacenter-1/vm’, ‘guest_fullname’: ‘Ubuntu Linux (64-bit)’, ‘guest_name’: ‘ubuntu_t’, ‘ip_address’: ”, ‘mac_address’: [’00:50:56:87:a5:9a’], ‘moid’: ‘vm-24’, ‘power_state’: ‘poweredOff’, ‘etiquetas’: [‘category_id’: ‘urn:vmomi:InventoryServiceCategory:b316cc45-f1a9-4277-811d-56c7e7975203:GLOBAL’, ‘category_name’: ‘cat_0001’, ‘description’: ”, ‘id’: ‘urn:vmomi:InventoryServiceTag:43737ec0-b832-4abf-abb1-fd2448ce3b26:GLOBAL’, ‘name’: ‘tag_0001’], ‘uuid’: ‘4207072c-edd8-3bd5-64dc-903fd3a0db04’, ‘vm_network’: ’00: 50: 56: 87: a5: 9a ‘: ‘ ipv4 ‘: [‘10.76.33.228’], ‘ipv6’: []]

Autores

  • José Callen (@jcpowermac)
  • Abhijeet Kasurde (@Akasurde)
  • Fedor Vompe (@sumkincpp)