Feature
core/period-budget
Bounds what the traffic through an AI gateway may consume over a period. Once what the gateway has counted over period exceeds limit, it refuses further model requests until the count falls back under the limit. unit names what is counted, a cost in US dollars or tokens, and scope names whose traffic one limit covers: everything the gateway serves, each caller apart, or each model apart. The developer attaches it in the Aggregate, writing unit and scope in values; the operator sizes that attachment in the Release, writing limit and period in infra under the same attachment name on the Release's entry for the component. It attaches to a component in the request path that declares it can keep such a budget (dataplane.aggrega.ai/period-budget, whichever value). Each realization says how its gateway counts a period, and refuses a unit, a scope or a period its gateway cannot keep, naming the value asked for and what the gateway offers, rather than accepting it and counting something else. Each realization writes the budget where its gateway reads one: into the gateway's own configuration, or as a resource the gateway's controller reconciles.
Provenienza
- Digest del contenuto
- sha256:34e5efc21634200007e9767d7ace42cf5a75618e98d67b3fada1e94b93bc5154
- Pubblicato
- 2026-11-10T10:17:14Z
- Identità di firma
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Firma
- Ufficialeapplication/vnd.dev.sigstore.bundle.v0.3+json
https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
sha256:fddd9cabf3068aa98288c748b27780a7edaa1621d99b22b8d10480bfb2d3f515
Riferimento a questa versione
oci://hub.aggrega.ai/feature/core/period-budget:1.0.0- Si applica a
- dataplane.aggrega.ai/period-budget
- In conflitto con
- —
Parametri dello sviluppatore
Valori che lo sviluppatore imposta quando aggancia questa funzionalità.
Estende BaseComponents#/schemas/BaseFeatureParameter
| Nome | Tipo | Predefinito | Obbligatorio | Descrizione |
|---|---|---|---|---|
| scope | string (gateway | caller | model) | — | sì | Whose traffic one limit covers. gateway: everything the gateway serves counts against one limit. caller: each caller the gateway tells apart has a limit of its own. model: each model the gateway serves has a limit of its own. |
| unit | string (usd | total_tokens | prompt_tokens | completion_tokens) | — | sì | What is counted against limit. usd: what the traffic costs in US dollars, as the gateway prices it. total_tokens, prompt_tokens and completion_tokens: the tokens a model reports reading and writing, reading only, or writing only. |
Contratto di output
Valori che questa funzionalità pubblica verso i consumatori.
Nessun valore di output dichiarato.
Annotazioni
Nessuna annotazione dichiarata.
Relazioni
Archi tipizzati da e verso altre entità pubblicate. Un riferimento senza una destinazione pubblicata viene mostrato come arco interrotto anziché come link.
Usa
- si applica asi applica a
dataplane.aggrega.ai/period-budget
core/gateway/agentgateway v1.0.0 →core/gateway/apisix v1.0.0 →core/gateway/azure-api-management v1.0.0 →core/gateway/cloudflare-ai-gateway v1.0.0 →core/gateway/envoy-gateway v1.0.0 →core/gateway/higress v1.0.0 →core/gateway/kong-enterprise v1.0.0 →core/gateway/litellm v1.0.0 →core/gateway/traefik-hub v1.0.0 → - $refestende lo schema (values)
BaseComponents#/schemas/BaseFeatureParameter
Usato da
implementa
implementa
implementa
implementa
implementa
implementa
implementa
implementa
implementa