Protocol Specification
S3v4 REST API & OpenMetrics Reference
Complete compatibility matrix for the Nordic Data Sync S3 gateway (AWS Signature Version 4 over TLS 1.3 HTTP/2 and QUIC HTTP/3) and Prometheus telemetry schema.
| S3 API Operation | HTTP Verb | Conditional & Lock Headers Supported | SLA Latency Target (ARN-1) |
|---|---|---|---|
CreateBucket / HeadBucket | PUT / HEAD | x-amz-bucket-object-lock-enabled | < 25 ms |
PutObject | PUT | If-None-Match, x-amz-checksum-sha256, x-amz-object-lock-mode | < 15 ms (16 MB WAL) |
CreateMultipartUpload / UploadPart | POST / PUT | Up to 10,000 parts (5 MB – 5 GB per part, 5 TB max object) | Wire-speed streaming |
GetObject / HeadObject | GET / HEAD | Range: bytes=..., If-Match, If-Modified-Since | < 8 ms TTFB |
ListObjectsV2 / ListObjectVersions | GET | Prefix, Delimiter, ContinuationToken (NVMe index accelerated) | < 18 ms per 1,000 keys |
PutObjectRetention / PutObjectLegalHold | PUT | GOVERNANCE & hardware-enforced COMPLIANCE | < 12 ms |
Observability Schema
Prometheus OpenMetrics Dictionary
Exported on GET /v1/prometheus/metrics with a scoped read-only bearer token:
| Metric Name | Type | Labels | Description |
|---|---|---|---|
nordic_bucket_stored_bytes | gauge | bucket, region | Total compressed logical bytes stored in bucket |
nordic_bucket_objects_total | gauge | bucket, lock_mode | Object count segmented by WORM retention state |
nordic_bucket_newest_put_timestamp_seconds | gauge | bucket | Unix epoch of latest successful PUT (for dead-man alerts) |
nordic_georep_lag_milliseconds | gauge | bucket, peer_region | Current asynchronous optical replication lag (ARN-1 ↔ HEL-2) |
nordic_s3_requests_total | counter | bucket, op, code, proto | Request counter across HTTP/2 (h2) and QUIC (h3) |