---
title: VMware First Class Disk
slug: homologacao-atmosphere/vmware-first-class-disk
description: Learn how to effectively manage VMware vSphere first-class disks with this comprehensive module. Discover the necessary requirements for your host, including the PyVmomi library. Explore the various parameters available, such as datacenter name, datastore
docTags: 
createdAt: 2021-12-10T11:26:59.000Z
---

## Sinopse

- Este módulo pode ser usado para gerenciar (criar, excluir, redimensionar) discos de primeira classe VMware vSphere.

## 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\_name                         | string   |                              | O nome do datacenter.                                                                                                                                                                                                                                                                                                                                 |
| datastore\_name -- required              | string   |                              | Nome do armazenamento de dados ou cluster de armazenamento de dados a ser usado para o disco.                                                                                                                                                                                                                                                         |
| disk\_name - required                    | string   |                              | O nome do disco.                                                                                                                                                                                                                                                                                                                                      |
| hostname                                 | string   |                              | O nome do host ou endereço IP 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_HOST` será usado em seu lugar.                                                                                                                                                       |
| 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.<br /><br />Este recurso depende de uma versão do pyvmomi superior a v6.7.1.2018.12 |
| proxy\_port                              | string   |                              | 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.                                                                                                                                   |
| size                                     | string   |                              | Tamanho de armazenamento em disco, um número inteiro mais uma unidade.<br /><br />Não há espaço permitido entre o número do tamanho e a unidade.<br /><br />As unidades permitidas são MB, GB e TB.                                                                                                                                                   |
| state                                    | string   |                              | Se o disco deve estar presente ou ausente.                                                                                                                                                                                                                                                                                                            |
| 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.                                                                                                                                                                   |
| validate\_certs                          | boolean  |                              | 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.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: Create Disk
  vmware_first_class_disk:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    datastore_name: '{{ datastore_name }}'
    disk_name: '1GBDisk'
    size: '1GB'
    state: present
  delegate_to: localhost

- name: Delete Disk
  vmware_first_class_disk:
    hostname: '{{ vcenter_hostname }}'
    username: '{{ vcenter_username }}'
    password: '{{ vcenter_password }}'
    datastore_name: '{{ datastore_name }}'
    disk_name: 'FirstClassDisk'
    state: absent
  delegate_to: localhost
```

## Valores Retornados

| **Chave**          | **Tipo**   | **Retornado quando** | **Descrição**                                                          |
| ------------------ | ---------- | -------------------- | ---------------------------------------------------------------------- |
| first\_class\_disk | dictionary | alterado             | Disco de primeira classe retornado quando criado, excluído ou alterado |