> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dscloud.pt/llms.txt
> Use this file to discover all available pages before exploring further.

# Consultar estado da aplicação

> Retorna o estado e o consumo atual.

Retorna o estado e o consumo atual. `uptime` é numérico em milissegundos. CPU, RAM, armazenamento e rede são devolvidos como strings formatadas. `running` considera os estados `running` e `starting` da origem.

## Parâmetros

**appId** `string` *required*

ID da aplicação, obtido no painel ou em `response.applications[].id` ao [consultar a conta](https://docs.dscloud.pt/api-reference/endpoint/users/me.md).

## Resposta

HTTP 200. `response` é um objeto. Seus campos também podem aparecer no nível superior por compatibilidade.

```json HTTP 200 theme={null}
{
  "status": "running",
  "code": "SUCCESS",
  "response": {
    "cpu": "0.00%",
    "ram": "12.00MB",
    "status": "running",
    "running": true,
    "storage": "32.00MB",
    "uptime": 120000,
    "network": "0 B 0 B"
  },
  "cpu": "0.00%",
  "ram": "12.00MB",
  "running": true,
  "storage": "32.00MB",
  "uptime": 120000,
  "network": "0 B 0 B",
  "success": true
}
```

## Erros desta operação

| HTTP | Código | Quando ocorre |
| - | - | - |
| 500 | `RESOURCE_FETCH_FAILED` | A consulta de métricas falhou. |

```bash cURL theme={null}
: "${DSCLOUD_API_BASE_URL:=https://api.dscloud.pt/v3}"
curl --proto '=https' --fail-with-body --request GET \
  --header "Authorization: ${DSCLOUD_API_KEY:?Defina DSCLOUD_API_KEY}" \
  "${DSCLOUD_API_BASE_URL%/}/apps/${DSCLOUD_APP_ID:?Defina DSCLOUD_APP_ID}/status"
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.