---
title: VMware Guest Snapshot Info
slug: homologacao-atmosphere/vmware-guest-snapshot-info
description: Learn how to use the "vmware_guest_snapshot_info" module effectively with this comprehensive document. Discover the various parameters and explore real-life examples to collect valuable information about snapshots of your virtual machine. Gain insights in
docTags: 
createdAt: 2021-12-14T12:17:07.000Z
---

## [](k)Resumo

- Este módulo pode ser usado para coletar informações sobre os snapshots de uma máquina virtual.

## Parâmetros

| **Parâmetro**           | **Tipo** | **Escolhas \| Valor Padrão**                      | **Comentários**                                                                                                                                                                                                   |
| ----------------------- | -------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| datacenter - *required* | string   |                                                   | Nome do datacenter.<br />                                                                                                                                                                                         |
| folder                  | string   |                                                   | Pasta de destino, caminho absoluto ou relativo para encontrar um guest existente. Este é um parâmetro obrigatório, caso o nome seja fornecido. Datacenters ESX's tem por padrão o caminho "/ha-datacenter/"<br /> |
| moid                    | string   |                                                   | ID do objeto gerenciado da instância a ser gerenciado, se conhecido, é um identificador exclusivo apenas em uma única instância do vCenter. Isso é necessário se o nome ou uuid não for fornecido.<br />          |
| name                    | string   |                                                   | Nome da VM com a qual trabalhar. Isso é necessário se uuid ou moid não for fornecido.<br />                                                                                                                       |
| use\_instance\_uuid     | boolean  | Escolhas:<br />- false<br />(default)<br />- true | Se deve usar o UUID da instância do VMware em vez do UUID do BIOS.                                                                                                                                                |
| uuid                    | string   |                                                   | UUID da instância a ser gerenciada, se conhecido, é o UUID do BIOS da VMware por padrão. Isso é necessário se o parâmetro nome ou moid não for fornecido.                                                         |

Estende fragmentos da documentação do módulo VMware Options.&#x20;


## Exemplos

```yaml
# Exemplo: Reúna informações de snapshots sobre a máquina virtual no vCenter fornecido
- vmware_guest_snapshot_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    folder: "/{{ datacenter_name }}/vm/"
    name: "{{ guest_name }}"
  register: snapshot_info

# Exemplo: Reúna informações de snapshots sobre a máquina virtual usando MoID
- vmware_guest_snapshot_info:
    hostname: "{{ vcenter_hostname }}"
    username: "{{ vcenter_username }}"
    password: "{{ vcenter_password }}"
    datacenter: "{{ datacenter_name }}"
    moid: vm-42
  register: snapshot_info
```



## Valores retornados

| **Chave**         | **Tipo**   | **Retornado quando** | **Descrição**                               |
| ----------------- | ---------- | -------------------- | ------------------------------------------- |
| guest\_snapshots  | dictionary | Sempre               | Metadados sobre as informações do snapshot. |