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

# Obter status da aplicação

> Obtenha CPU, RAM, armazenamento, rede e uptime ao vivo de uma aplicação com GET /v2/apps/{app_id}/status. Passe rawData=true para números em vez de strings.

<ParamField header="Authorization" type="string" placeholder="Chave da API" required>
  A chave da API para sua conta. Você pode encontrá-la nas [configurações da conta](https://squarecloud.app/pt-br/account/security).
</ParamField>

Requer uma chave de API com o [escopo](/pt-br/api-reference/authentication#escopos) `apps:read`.

Retorna os valores atuais de CPU, RAM, armazenamento, rede e uptime da aplicação, formatados por padrão como strings legíveis por humanos (ex.: `"120.4MB"`, `"602 KB ↑ 134 KB ↓"`). Passe `rawData=true` para obter os mesmos campos como números brutos, o que é mais fácil de trabalhar se você mesmo estiver plotando os valores em um gráfico.

Se você também tiver uma conexão de [Logs em tempo real](/pt-br/api-reference/endpoint/apps/realtime) aberta para a mesma aplicação, prefira os eventos `status` desse stream: enquanto uma conexão em tempo real estiver ativa, os números deste endpoint podem ficar até cerca de um minuto desatualizados. Para verificar todas as aplicações de uma vez em vez de uma por vez, veja [Status de todas as aplicações](/pt-br/api-reference/endpoint/apps/status-all).

## Parâmetros

<ParamField path="app_id" type="string" placeholder="ID da Aplicação" required>
  O ID da aplicação. Você pode encontrá-lo na URL da sua aplicação no dashboard.
</ParamField>

<ParamField query="rawData" type="boolean" placeholder="true ou false">
  Quando `true`, `cpu`, `ram` e os demais valores vêm como números em vez de strings formatadas.
</ParamField>

## Resposta

<ResponseField name="status" type="string">
  Indica se a chamada foi bem-sucedida: `success` se foi, `error` se não.
</ResponseField>

<ResponseField name="response" type="object">
  O conteúdo da resposta.

  <Expandable title="Alternar objeto">
    <ResponseField name="cpu" type="string">
      O uso de CPU da aplicação.
    </ResponseField>

    <ResponseField name="ram" type="string">
      A RAM em uso, por exemplo `"120.4MB"`. Não inclui o limite alocado.
    </ResponseField>

    <ResponseField name="status" type="string">
      O status da aplicação.
    </ResponseField>

    <ResponseField name="running" type="boolean">
      Indica se a aplicação está atualmente em execução.
    </ResponseField>

    <ResponseField name="storage" type="string">
      O armazenamento usado pela aplicação.
    </ResponseField>

    <ResponseField name="network" type="object">
      <Expandable title="Alternar objeto">
        <ResponseField name="total" type="string">
          O uso total de rede da aplicação.
        </ResponseField>

        <ResponseField name="now" type="string">
          O uso de rede atual da aplicação.
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="uptime" type="number">
      O tempo de atividade (uptime) da aplicação em milissegundos.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={"system"}
  {
      "status": "success",
      "response": {
          "cpu": "0.01%",
          "ram": "120.4MB",
          "status": "running",
          "running": true,
          "storage": "2.72MB",
          "network": {
              "total": "602 KB ↑ 134 KB ↓",
              "now": "14 KB ↑ 3.3 KB ↓"
          },
          "uptime": 1662927833666
      }
  }
  ```
</ResponseExample>

## Erros comuns

| Código | HTTP | Significado |
| - | - | - |
| `APP_NOT_FOUND` | 404 | A aplicação não existe ou não pertence a quem fez a requisição. |

## Relacionados

* CLI: [`squarecloud app status`](/pt-br/cli-reference/status-and-metrics#squarecloud-app-status)
* SDKs: [`api.apps.status()`](/pt-br/sdks/js/managing_application) (JavaScript), [`client.apps.status()`](/pt-br/sdks/py/managing_application) (Python), [`c.Apps.Status()`](/pt-br/sdks/go/managing_application) (Go)


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