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

# Falhas de recursos

> O array de falhas ativas, como os códigos são deduplicados e como a gravidade é mapeada para o status do recurso.

Recursos que executam trabalho em segundo plano sempre incluem `faults`: um array de falhas ativas, ou `[]` quando nenhuma permanece. O campo singular `fault` não é mais retornado. Leia cada entrada; mais de um código pode estar ativo ao mesmo tempo. As entradas são ordenadas por `last_at`, mais recente primeiro, com uma ordem estável para os empates.

Veja [Recursos de referência](/pt/reference-resolution) para saber como buscar o próprio recurso.

<a id="the-fault-object" />

## O objeto Fault

Cada entrada inclui `code`, `severity` (`error` ou `warning`), `message`, `details` (um objeto ou `null`), `first_at`, `last_at`, e `occurrences`. Os carimbos de data e hora identificam a primeira e a última observação na série ativa.

`details` é um contexto estruturado, não uma string. O texto de forma livre legado é preservado sob `legacy_text` dentro desse objeto.

Um recurso saudável:

```json theme={null}
{
  "faults": []
}
```

Um recurso com um erro ativo:

```json theme={null}
{
  "faults": [
    {
      "code": "START_FAILED",
      "severity": "error",
      "message": "The instance did not reach running.",
      "details": null,
      "first_at": "2026-09-14T03:12:00Z",
      "last_at": "2026-09-14T03:12:00Z",
      "occurrences": 1
    }
  ]
}
```

<a id="deduplication-and-occurrences" />

## Desduplicação e ocorrências

Uma observação repetida do mesmo código no mesmo recurso preserva `first_at`, atualiza `message`, `details` e `last_at`, e incrementa `occurrences` a partir de um. Não adiciona uma segunda linha. Um código que se repete após a resolução inicia uma nova série.

<a id="recovery" />

## Recuperação

Uma operação de sucesso resolve apenas os códigos que possui. Um erro independente permanece visível e pode manter o recurso em um estado de erro. Limpar uma falha não é prova de que todos os problemas foram recuperados.

As linhas migradas das cadeias de erros por recurso anteriores carregam `LEGACY_FAILURE_STATE`. A operação que agora possui essa falha resolve-a da mesma forma que resolve seus próprios códigos.

<a id="severity-and-status" />

## Gravidade e status

Um `error` ativo define `current_state` para `error` em instâncias, `status` para `error` em outros recursos, e `failed` em backups. Um `warning` não altera por si só o estado do ciclo de vida.

Duas superfícies são apenas de aviso: a falha de DNS de um desafio de certificado nunca move `verified`, e uma falha de política de instantâneo nunca move `enabled` ou relata `error`.

As falhas resolvidas desaparecem deste array. Não é um feed de histórico e não há nenhum ponto de extremidade público de histórico de falhas.

Os códigos específicos de serviço e a recuperação estão nas páginas que descrevem esses recursos: [compute](/pt/compute), [storage](/pt/storage), [certificates](/pt/certificates) e [load balancers](/pt/load-balancers).


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