Namespaces & Schlüssel

Namespaces

Ein Namespace ist ein vollständig isolierter Store – mit eigenem WAL, Persister und Objektspeicher-Mirror. Namen bestehen aus 1–96 Zeichen [a-z0-9_-], beginnen nicht mit - oder _ und liegen immer unter dem Präfix Ihres Kontos. Die Lebenszyklus-Semantik ist explizit:

Zustand	Verhalten
Nie geschrieben	Lesevorgänge geben `404 namespace_not_found` zurück – nur Schreibvorgänge erzeugen
Aktiv	Alle Operationen im Rahmen des Schlüssels
Beschäftigt / noch nicht mirror-durabel	Löschung gibt ein wiederholbares `409` zurück
Gelöscht	`410 namespace_deleted`, permanent – ein durabler Tombstone wird lokal und im Mirror vor der Datenentfernung committet, damit ein veralteter Restore niemals gelöschte Daten wiederherstellen kann

# Ohne den Store zu öffnen prüfen
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"} }

# Permanente Löschung (erfordert die delete-Berechtigung)
curl -s -X DELETE https://db.conare.ai/v1/namespaces/acme-docs \
  -H "Authorization: Bearer $DELETE_KEY"

Schlüssel

sk-conare-...-Bearer werden aus der Konsole bereitgestellt. Jeder Schlüssel hat:

Namespace-Scope – exakte Namen oder Präfixe mit * am Ende. Ein Schlüssel kann nur /v1/namespaces/{name}/* erreichen, wenn der Name auf seine Muster passt; alles andere ist 403.
Unabhängige Berechtigungen – read, write und destruktives delete sind separate Grants. Das physische Löschen eines Namespaces erfordert immer ein explizites delete.
Rate-Limit – ein Token-Bucket mit Requests pro Sekunde je Schlüssel und einem Burst von einer Sekunde; Anfragen über dem Limit erhalten 429 rate_limited.
Ablauf – abgelaufene Schlüssel geben 401 expired_key zurück.

Geheimnisse werden einmal angezeigt und nur als SHA-256-Digests gespeichert; der Laufzeitvergleich erfolgt in konstanter Zeit.

Erteilen Sie einem alltäglichen Ingestion-Schlüssel kein delete. Verwenden Sie für destruktive Operationen separate, kurzlebige Anmeldedaten und trennen Sie das Ausliefern (Read-only-Schlüssel) von Rebuild-Pipelines (Write-Schlüssel).

Monitoring

Endpunkt	Auth	Zweck
`GET /health`	keine	Prozess-Lebendigkeit
`GET /ready`	keine	Bereit zum Ausliefern; `503` während des Drainens oder nach einem Persister-Fehler – lassen Sie Ihren Load Balancer hierhin zeigen
`GET /v1/namespaces/{ns}/metrics`	scoped Schlüssel	Laufzeit-Counter Ihres Namespaces
`GET /v1/console`	scoped Schlüssel	Maskierte Schlüssel-Metadaten, Nutzung und Metriken nur für Ihre Namespaces

Die öffentliche Verfügbarkeit – geprüft aus fünf globalen Regionen gegen https://db.conare.ai/ready – wird auf conare.betteruptime.com veröffentlicht. API-Logs und Metriken enthalten niemals Request-Bodies oder Bearer-Tokens.

Erste Schritte

Referenz

Anleitungen

Namespaces & Schlüssel

Namespaces

Schlüssel

Monitoring

​Namespaces

​Schlüssel

​Monitoring

Namespaces

Schlüssel

Monitoring