Operations pillar · v0.16.0
service-level-agreement ServiceLevelAgreement
SLA + SLO record (one per service).
$id · https://corpospec.com/schemas/v0.16.0/service-level-agreement.schema.json
Fields
| Field | Type | Required | Description |
|---|---|---|---|
| credit_cap_pct | number | yes | Maximum credit per period (% of monthly fee). |
| credit_tiers | SlaCreditTier[] | yes | SLA credit bands (sorted ascending by breach_threshold_pct). |
| effective_from | IsoDate | yes | ISO 8601 date (YYYY-MM-DD). |
| entity | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| exclusions | string[] | yes | Exclusions (planned maintenance, force majeure). |
| id | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| name | string | yes | |
| owner | PathRef | yes | Path-based cross-reference relative to .corpospec/ root. Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$` |
| service | PathRef | yes | PathRef to the service / product. |
| slis | Sli[] | yes | |
| slos | Slo[] | yes | |
| contract_ref | PathRef? | — | PathRef to the underlying contract. |
| customer | PathRef? | — | PathRef to the customer (None ⇒ default SLA for all tiers). |
| effective_to | IsoDate? | — | |
| period_history | SlaPeriodResult[] | — | Last period results. |
Definitions
Shared types referenced within this schema.
ComplianceWindow
Compliance window (rolling vs calendar).
IsoDate
ISO 8601 date (YYYY-MM-DD).
type: string
PathRef
Path-based cross-reference relative to .corpospec/ root.
Pattern: `^[a-z0-9_-]+(/[a-z0-9_.-]+)+$`
pattern: ^[a-z0-9_-]+(/[a-z0-9_.-]+)+$
SlaCreditTier
SLA credit tier.
type: object
SlaPeriodResult
Period result (for last-window report).
type: object
Sli
One SLI definition.
type: object
SliKind
SLI kind.
Slo
One SLO target.
type: object
Reference in your YAML
# yaml-language-server: $schema=https://corpospec.com/schemas/v0.16.0/service-level-agreement.schema.json