---
title: VMware Host Capability Info
slug: homologacao-atmosphere/vmware-host-capability-info
description: Learn how to retrieve capacity information from an ESXi host or cluster with this comprehensive document. It covers essential parameters for specifying cluster or host names and provides practical command usage examples. Discover the valuable metadata inc
docTags: 
createdAt: 2022-01-28T12:10:15.000Z
---

## Resumo

- Obtenha informações de capacidade de um host ESXi, quando o nome do host ESXi ou o nome do cluster é fornecido.

## Parâmetros

| **Parâmetro**   | **Tipo** | **Escolhas \| Valor Padrão** | **Comentários**                                                                                                                                      |
| --------------- | -------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| cluster\_name   | string   |                              | Nome do cluster de todos os sistemas host a serem usados para coleta de fatos. Se esxi\_hostname não for fornecido, este parâmetro será obrigatório. |
| esxi\_hostname  | string   |                              | Nome do host ESXi para coletar fatos. Se cluster\_name não for fornecido, esse parâmetro será obrigatório.                                           |



## Exemplos

```yaml
# Exemplo: Obtenha informações de capacidade sobre todos os hosts ESXi em determinado cluster
- vmware_host_capability_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    cluster_name: cluster_name

# Exemplo: Obtenha informações de capacidade sobre o ESXi Host
- vmware_host_capability_info:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    esxi_hostname: '{{ esxi_hostname }}'
```



## Valores retornados

| **Chave**                 | **Tipo**   | **Retornado quando** | **Descrição**                                         |
| ------------------------- | ---------- | -------------------- | ----------------------------------------------------- |
| hosts\_capability\_facts  | dictionary | Sempre               | Metadados sobre as informações de capacidade do host. |