Ya no tienes que investigar más en otros sitios porque estás al sitio correcto, poseemos la respuesta que necesitas hallar pero sin complicaciones.
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 |
|
Los atributos relacionados con el invitado de VM se muestran en la información solo cuando está configurado true . |
show_tagbooleano |
|
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 |
|
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 |
|
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)
¡Haz clic para puntuar esta entrada!
(Votos: 0 Promedio: 0)