Skip to main content
GET
List Clusters
string
Filtrar pelo namespace onde o ClusterRegistration está. Sem ele, lista todos os namespaces.
integer
padrão:"1"
Número da página
integer
padrão:"20"
Itens por página (máximo 100)
Role mínima: viewer. Não há filtros por status ou região; use Clusters da federação para filtrar por tier. Campos zerados ou vazios são omitidos (connected sempre aparece).

Autorizações

X-API-Key
string
header
obrigatório

API key sent in the X-API-Key header. Keys are read from the Secret chatcli-operator-secrets, key api-keys (fallback: ConfigMap chatcli-operator-config, key api-keys) in the operator namespace, as a YAML list of {key, role, name, description} (name is the identity recorded on approval decisions); the operator chart creates it only with apiKeys.create: true. Roles: viewer < operator < admin — any other role string is denied everywhere. Changes are picked up within about 30 seconds; deleting both the Secret and the ConfigMap revokes every key. With no keys configured every /api/ call returns 401, unless CHATCLI_OPERATOR_DEV_MODE=true, which grants admin without a key (development only).

Parâmetros de consulta

namespace
string

Kubernetes namespace. Empty means all namespaces.

page
integer
padrão:1

Page number (1-based). Invalid values fall back to 1.

Intervalo obrigatório: x >= 1
pageSize
integer
padrão:20

Items per page. Values above 100 are capped at 100.

Intervalo obrigatório: 1 <= x <= 100

Resposta

Paginated list of clusters

apiVersion
string
Exemplo:

"v1"

kind
string
Exemplo:

"ClusterRegistrationList"

metadata
object
items
object[]