---
title: VMware Guest Disk Info
slug: homologacao-atmosphere/vmware-guest-disk-info
description: Learn how to gather detailed information about disks belonging to a specific virtual machine with this comprehensive module summary. Discover the requirements for the host system, explore parameter details, default values, and choices for managing instanc
docTags: 
createdAt: 2021-12-13T11:18:27.000Z
---

## Sinopse

- Este módulo pode ser usado para coletar informações sobre os discos pertencentes a determinada máquina virtual.
- Todos os parâmetros e nomes de objetos VMware diferenciam maiúsculas de minúsculas.

## Requisitos

Os requisitos abaixo são necessários no host que executa este módulo.

- PyVmomi

## Parâmetros

| **Parâmetro**                            | **Tipo** | **Escolhas \| Valor Padrão**                   | **Comentários**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| ---------------------------------------- | -------- | ---------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| datacenter - required                    | string   |                                                | O nome do datacenter ao qual a máquina virtual pertence.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| folder                                   | string   |                                                | Pasta de destino, caminho absoluto ou relativo para encontrar um convidado existente.<br /><br />Este é um parâmetro obrigatório, apenas se várias VMs forem encontradas com o mesmo nome.<br /><br />A pasta deve incluir o datacenter. O datacenter da ESX é ha-datacenter<br /><br />Exemplos:<br />pasta: / ha-datacenter / vm<br />pasta: ha-datacenter / vm<br />pasta: / datacenter1 / vm<br />pasta: datacenter1 / vmpasta: / datacenter1 / vm / pasta1<br />pasta: datacenter1 / vm / pasta1<br />pasta: / pasta1 / datacenter1 / vm<br />pasta: pasta1 / datacenter1 / vm<br />pasta: / pasta1 / datacenter1 / vm / pasta2 |
| hostname                                 | string   |                                                | O nome do host ou endereço IP do servidor vSphere vCenter ou ESXi.<br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_HOST` será usado em seu lugar.                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| moid                                     | string   |                                                | O ID do objeto gerenciado da instância a ser gerenciado, se conhecido, é um identificador exclusivo apenas em uma única instância do vCenter.<br /><br />Isso é necessário se nameou uuidnão for fornecido.                                                                                                                                                                                                                                                                                                                                                                                                                          |
| name                                     | string   |                                                | Nome da máquina virtual.<br /><br />Este é o parâmetro obrigatório, se o parâmetro `uuid` ou `moid` não for fornecido.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| password<br /><br />aliases: pass, pwd   | string   |                                                | A senha do servidor vSphere vCenter ou ESXi.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PASSWORD` será usado em seu lugar.                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| port                                     | integer  | Default:<br />443                              | O número da porta do servidor vSphere vCenter ou ESXi.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PORT` será usado em seu lugar.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| proxy\_host                              | string   |                                                | Endereço de um proxy que receberá todas as solicitações HTTPS e as retransmitirá.<br /><br />O formato é um nome de host ou IP.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PROXY_HOST` será usado em seu lugar.                                                                                                                                                                                                                                                                                                                                                                   |
| proxy\_port                              | integer  |                                                | Porta do proxy HTTP que receberá todas as solicitações HTTPS e as retransmitirá.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_PROXY_PORT` será usado em seu lugar.                                                                                                                                                                                                                                                                                                                                                                                                                  |
| use\_instance\_uuid                      | boolean  | Escolas:<br />- "false"(default)<br />- "true" | Se deve usar o UUID da instância do VMware em vez do UUID do BIOS.                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| username<br /><br />aliases: admin, user | string   |                                                | O nome de usuário do servidor vSphere vCenter ou ESXi.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_USER` será usado em seu lugar.                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| uuid                                     | string   |                                                | UUID da instância para coletar informações, se conhecido, este é o identificador exclusivo da VMware.<br /><br />Este é o parâmetro obrigatório, se o parâmetro nameou moidnão for fornecido.                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| validate\_certs                          | boolean  | Escolas:<br />- "false"<br />- "true"(default) | Permite a conexão quando os certificados SSL não são válidos. Definido para `false` quando os certificados não são confiáveis.<br /><br />Se o valor não for especificado na tarefa, o valor da variável de ambiente `VMWARE_VALIDATE_CERTS` será usado em seu lugar.                                                                                                                                                                                                                                                                                                                                                                |




## Notas

Observação

- Testado em vSphere 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

```yaml
- name: Gather disk info from virtual machine using UUID
  vmware_guest_disk_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: ha-datacenter
    validate_certs: no
    uuid: 421e4592-c069-924d-ce20-7e7533fab926
  delegate_to: localhost
  register: disk_info

- name: Gather disk info from virtual machine using name
  vmware_guest_disk_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: ha-datacenter
    validate_certs: no
    name: VM_225
  delegate_to: localhost
  register: disk_info

- name: Gather disk info from virtual machine using moid
  vmware_guest_disk_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: ha-datacenter
    validate_certs: no
    moid: vm-42
  delegate_to: localhost
  register: disk_info
```

## Valores Retornados

| **Parâmetro**                | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários**                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| ---------------------------- | -------- | ---------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| guest\_disk\_info dicionário |          | sempre                       | metadados sobre os discos da máquina virtual<br />Amostra:\{'0': \{'backing\_datastore': 'datastore2', 'backing\_disk\_mode': 'persistent', 'backing\_diskmode': 'persistent', 'backing\_eagerlyscrub': False, 'backing\_filename': '\[datastore2] VM\_225 / VM\_225.vmd , 'backing\_thinprovisioned': False, 'backing\_type': 'FlatVer2', 'backing\_uuid': '200C3A00-f82a-97af-02ff-62a595f0020a', 'backing\_writethrough': Falso, 'capacity\_in\_bytes': 10240\_760, 'capacidade controller\_bus\_number ': 0,' controller\_key ': 1000,' controller\_type ':' paravirtual ',' key ': 2000,' label ':' Hard disk 1 ',' summary ': '10, 240 KB', 'unit\_number': 0} , '1': \{'backing\_datastore': 'datastore3','Backing\_devicename': 'vml.012345678901234567890123456789012345678901234567890123', 'backing\_disk\_mode': 'independent\_persistent', 'backing\_diskmode': 'independent\_persistent', 'backing\_filename': '\[datastore3] VM\_226 / VM\_226.vmdk', 'backing\_lunuuid': '012345678901234567890123456789012345678901234567890123', ' backing\_type ':' RawDiskMappingVer1 ',' backing\_uuid ': Nenhum,' capacity\_in\_bytes ': 15728640,' capacity\_in\_kb ': 15360,' controller\_bus\_number ': 0,' controller\_key ': 1000,' controller\_type ':' paravirtual ',' key ': 2001 , 'rótulo': 'Disco rígido 3', 'resumo': '15, 360 KB ',' número\_unidade ': 1}}012345678901234567890123456789012345678901234567890123' , 'backing\_disk\_mode': 'independent\_persistent', 'backing\_diskmode': 'independent\_persistent', 'backing\_filename': '\[datastore3] VM\_226 / VM\_226.vmdk', 'backing\_lunuuid': '012345678901234567890123456789012345678901234567890123', 'backing\_type': 'RawDiskMappingVer1', 'backing\_uuid': Nenhum, 'capacity\_in\_bytes': 15728640, 'capacity\_in\_kb': 15360, 'controller\_bus\_number': 0, 'controller\_key': 1000, 'controller\_type': 'paravirtual', 'key': 2001, 'label': 'Hard disco 3 ',' resumo ': '15, 360 KB', 'número\_unidade': 1}}012345678901234567890123456789012345678901234567890123' , 'backing\_disk\_mode': 'independent\_persistent', 'backing\_diskmode': 'independent\_persistent', 'backing\_filename': '\[datastore3] VM\_226 / VM\_226.vmdk', 'backing\_lunuuid': '012345678901234567890123456789012345678901234567890123', 'backing\_type': 'RawDiskMappingVer1', 'backing\_uuid': Nenhum, 'capacity\_in\_bytes': 15728640, 'capacity\_in\_kb': 15360, 'controller\_bus\_number': 0, 'controller\_key': 1000, 'controller\_type': 'paravirtual', 'key': 2001, 'label': 'Hard disco 3 ',' resumo ': '15, 360 KB', 'número\_unidade': 1}}backing\_diskmode ':' independent\_persistent ',' backing\_filename ':' \[datastore3] VM\_226 / VM\_226.vmdk ',' backing\_lunuuid ':' 012345678901234567890123456789012345678904567890123\_67890123\_, 'backing\_lunuuid': 'backing\_lunuuid': '012345678901234567890123456789012345678901234567890123\_67890123\_67890123\_:' backing28\_Vering6 ',' backing\_67890123\_67890123\_67890123 ',' backing28\_Vering6 ' 'capacity\_in\_kb': 15360, 'controller\_bus\_number': 0, 'controller\_key': 1000, 'controller\_type': 'paravirtual', 'key': 2001, 'label': 'Hard disk 3', 'summary': '15, 360 KB ' , 'número\_unidade': 1}}backing\_diskmode ':' independent\_persistent ',' backing\_filename ':' \[datastore3] VM\_226 / VM\_226.vmdk ',' backing\_lunuuid ':' 012345678901234567890123456789012345678904567890123\_67890123\_, 'backing\_lunuuid': 'backing\_lunuuid': '012345678901234567890123456789012345678901234567890123\_67890123\_67890123\_:' backing28\_Vering6 ',' backing\_67890123\_67890123\_67890123 ',' backing28\_Vering6 ' 'capacity\_in\_kb': 15360, 'controller\_bus\_number': 0, 'controller\_key': 1000, 'controller\_type': 'paravirtual', 'key': 2001, 'label': 'Hard disk 3', 'summary': '15, 360 KB ' , 'número\_unidade': 1}}RawDiskMappingVer1 ',' backing\_uuid ': Nenhum,' capacity\_in\_bytes ': 15728640,' capacity\_in\_kb ': 15360,' controller\_bus\_number ': 0,' controller\_key ': 1000,' controller\_type ':' paravirtual ',' key ': 2001,' label ' : 'Disco rígido 3', 'resumo': '15, 360 KB ',' número\_unidade ': 1}}RawDiskMappingVer1 ',' backing\_uuid ': Nenhum,' capacity\_in\_bytes ': 15728640,' capacity\_in\_kb ': 15360,' controller\_bus\_number ': 0,' controller\_key ': 1000,' controller\_type ':' paravirtual ',' key ': 2001,' label ' : 'Disco rígido 3', 'resumo': '15, 360 KB ',' número\_unidade ': 1}} |





