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

# Ciclo de Vida

> Iniciando, parando e reiniciando uma database

Os três métodos abaixo controlam o container da database sem apagar seus dados. O volume de dados persiste entre `stop` e `start`.

## Iniciar

```ts theme={null}
await sonder.databases.start(databaseId);
// { status: 'RUNNING' }
```

Inicia uma database que está parada (`status: 'FAILED'`, usado internamente como estado "parada").

## Parar

```ts theme={null}
await sonder.databases.stop(databaseId);
// { status: 'STOPPED' }
```

> [!NOTE]
>
> Parar a database interrompe todas as conexões ativas. Aplicações que dependem dela vão falhar ao tentar conectar até que ela seja reiniciada.

## Reiniciar

```ts theme={null}
await sonder.databases.restart(databaseId);
// { status: 'RUNNING' }
```

Equivalente a `stop` seguido de `start`, em uma única chamada.

## Verificando o estado atual

Nenhum dos três métodos aceita polling embutido — eles retornam assim que a ação é disparada no container. Para confirmar que a database está de fato respondendo, combine com [`get()`](https://docs.sondercloud.app/sdk/databases/visao-geral#obter-detalhes-e-credenciais) ou [`stats()`](https://docs.sondercloud.app/sdk/databases/logs-e-estatisticas#estatísticas-de-uso):

```ts theme={null}
await sonder.databases.restart(databaseId);

const stats = await sonder.databases.stats(databaseId);
if (!stats.running) {
  // ainda subindo — tente novamente em alguns segundos
}
```

## Referência de métodos

| Método | Rota | Descrição |
| - | - | - |
| `databases.start(id)` | `POST /v1/databases/:id/start` | Inicia uma database parada. |
| `databases.stop(id)` | `POST /v1/databases/:id/stop` | Para uma database em execução. |
| `databases.restart(id)` | `POST /v1/databases/:id/restart` | Reinicia uma database. |


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