
s3-orchestrator go api reference
Core
Multi-backend S3 object orchestration with quota enforcement, replication, and rebalancing.
PostgreSQL metadata store with circuit breaker wrapper and role-based interfaces.
S3-compatible storage client abstraction with circuit breaker wrapper.
YAML configuration loading, defaults, and validation.
Per-backend usage tracking with local atomic and Redis backends.
Envelope encryption with AES-256-GCM and pluggable key providers.
In-memory LRU object data cache with size-aware eviction.
Generic three-state circuit breaker state machine.
Transport
S3-compatible HTTP API with SigV4 authentication, rate limiting, and admission control.
Admin API handler for operational control endpoints.
Built-in web dashboard for storage management.
SigV4 request signing, presigned URLs, and credential validation.
TLS certificate hot-reload, client IP extraction, and login throttle.
Background Services
Background workers for replication, rebalancing, cleanup, scrubbing, and reconciliation.
Webhook notification delivery with durable outbox and retry.
Background service manager with panic recovery and graceful shutdown.
Observability
Prometheus metrics, OpenTelemetry tracing, and in-memory log buffer.
Request ID propagation and structured audit logging.
Notification event type constants and emit hook.