Pular para o conteúdo

Histórico de heartbeats

GET/tenants/{id}/connections/{connId}/heartbeats

O histórico de disponibilidade da conexão em intervalos de meia hora alinhados ao relógio, do mais antigo ao mais recente; o último é o intervalo atual, ainda parcial. Em cada intervalo, ok é false se algum heartbeat falhou, true se só houve sucessos e null sem dados. Escopo necessário: connections:read.

Ver em Markdown

Parâmetros de caminho

idstring · uuidobrigatório

Identificador do projeto (tenantId).

connIdstring · uuidobrigatório

Identificador da conexão (o número) no projeto.

Parâmetros de consulta

hoursinteger

Quantas horas de histórico, contando o intervalo atual: de 1 a 168 (7 dias).

mínimo 1máximo 168padrão: 24

Respostas

Respostas: código de status, erro e descrição
CódigoErro e descrição
200Os intervalos em buckets (start e ok) e uptimePct.
400FST_ERR_VALIDATIONhours não é um inteiro de 1 a 168, ou id ou connId não é um UUID; message diz o que está errado.
401Sem chave de API, ou com uma chave desconhecida, revogada ou expirada. A chave de um projeto desativado também responde 401.
403A chave não tem o escopo connections:read; a mensagem de erro cita o escopo que falta.
404O projeto ou a conexão não existe, ou não é de quem chama (Tenant not found, Connection not found). A conexão precisa ser do projeto do caminho.
429Requisições demais deste IP de origem, ou autenticações com falha demais: espere os segundos de Retry-After. Veja Limites.Cabeçalho: Retry-After

Detalhes

São hours × 2 intervalos. uptimePct é a porcentagem dos intervalos com dados em que nenhum heartbeat falhou, com uma casa decimal; null quando nenhum intervalo tem dados.

Guia: Projetos e conexões

Esta página ajudou? · Atualizado em 28 set 2026