---
title: vCenter VM Manage
slug: homologacao-atmosphere/vcenter-vm-manage
description: Learn about the vCenter API actions and their parameters, including action type, password, scheme, server IP, username, and VM ID. Discover how to execute actions in the vCenter API with a helpful example. Find out how to retrieve the status of vCenter ch
docTags: 
createdAt: 2021-03-25T20:39:45.000Z
---

## Resumo

- Executar ações na API do vCenter.

## Parâmetros

| **Parâmetro**         | **Tipo** | **Escolhas \| Valor Padrão**                                         | **Comentários**             |
| --------------------- | -------- | -------------------------------------------------------------------- | --------------------------- |
| action                | string   | Escolhas:<br />- "start"<br />(default)<br />- "stop"<br />- "reset" | A ação a ser realizada.     |
| password - r*equired* | string   |                                                                      | Senha do vCenter.           |
| scheme                | string   | Escolhas:<br />- "http"<br />- "https"<br />(default)                | Protocolo da requisição.    |
| server - r*equired*   | string   |                                                                      | IP do vCenter.              |
| username - r*equired* | string   |                                                                      | Nome de usuário do vCenter. |
| vm\_id - r*equired*   | string   |                                                                      | ID de uma máquina virtual.  |



## Exemplos

```yaml
# Exemplos: Executar ação na API do vCenter
- vcenter_vm_manage:
    server: "localhost"
    username: username
    password: pssw
    vm_id: asasd
    action: start
```



## Valores retornados

| **Chave** | **Tipo** | **Retornado quando** | **Descrição**                  |
| --------- | -------- | -------------------- | ------------------------------ |
| changed   | boolean  | sempre               | Status da alteração do vCenter |