Namespaces et clés

Namespaces

Un namespace est un magasin complet et isolé — son propre WAL, son propre persister et son propre miroir d’object store. Les noms font 1 à 96 caractères parmi [a-z0-9_-], ne commencent pas par - ni _, et sont toujours sous le préfixe de votre compte. La sémantique du cycle de vie est explicite :

État	Comportement
Jamais écrit	Les lectures renvoient `404 namespace_not_found` — seules les écritures créent
Actif	Toutes les opérations dans le périmètre de votre clé
Occupé / pas encore durable côté miroir	La suppression renvoie un `409` réessayable
Supprimé	`410 namespace_deleted`, de façon permanente — un tombstone durable est validé localement et sur le miroir avant la suppression des données, de sorte qu’une restauration périmée ne peut jamais ressusciter des données supprimées

# Inspecter sans ouvrir le magasin
curl -s https://db.conare.ai/v1/namespaces/acme-docs/metadata \
  -H "Authorization: Bearer $CONAREDB_API_KEY"
# → { "name", "approx_row_count", "approx_logical_bytes", "generation", "dims", "index": {"status": "ann"} }

# Suppression permanente (nécessite la permission delete)
curl -s -X DELETE https://db.conare.ai/v1/namespaces/acme-docs \
  -H "Authorization: Bearer $DELETE_KEY"

Clés

Les jetons sk-conare-... sont provisionnés depuis la console. Chaque clé possède :

Périmètre de namespace — noms exacts ou préfixes avec * final. Une clé ne peut accéder qu’à /v1/namespaces/{name}/* lorsque le nom correspond à ses patterns ; tout le reste est un 403.
Permissions indépendantes — read, write et la delete destructrice sont des droits séparés. La suppression physique d’un namespace exige toujours un delete explicite.
Limite de débit — un token bucket de requêtes par seconde par clé avec une seconde de burst ; les requêtes au-delà de la limite reçoivent 429 rate_limited.
Expiration — les clés expirées renvoient 401 expired_key.

Les secrets ne sont affichés qu’une seule fois et stockés uniquement sous forme de condensés SHA-256 ; la comparaison à l’exécution se fait en temps constant.

N’accordez pas delete à une clé d’ingestion quotidienne. Utilisez un identifiant à durée de vie courte distinct pour les opérations destructrices, et séparez le service (clé en lecture seule) des pipelines de reconstruction (clé d’écriture).

Supervision

Endpoint	Auth	Objectif
`GET /health`	aucune	Liveness du processus
`GET /ready`	aucune	Prêt à servir ; `503` pendant un drain ou après un échec du persister — pointez votre load balancer ici
`GET /v1/namespaces/{ns}/metrics`	clé ciblée	Compteurs runtime de votre namespace
`GET /v1/console`	clé ciblée	Métadonnées masquées de la clé, usage et métriques pour vos namespaces uniquement

La disponibilité publique — sondée depuis cinq régions mondiales contre https://db.conare.ai/ready — est publiée sur conare.betteruptime.com. Les journaux et métriques de l’API n’incluent jamais les corps de requêtes ni les jetons Bearer.

Démarrer

Référence

Guides

Namespaces et clés

Namespaces

Clés

Supervision

​Namespaces

​Clés

​Supervision

Namespaces

Clés

Supervision