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.
Procedência
- Digest do conteúdo
- sha256:34e5efc21634200007e9767d7ace42cf5a75618e98d67b3fada1e94b93bc5154
- Publicado
- 2026-11-10T10:17:14Z
- Identidade de assinatura
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Assinatura
- Oficialapplication/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
Referência nesta versão
oci://hub.aggrega.ai/feature/core/period-budget:1.0.0- Aplica-se a
- dataplane.aggrega.ai/period-budget
- Conflita com
- —
Parâmetros do desenvolvedor
Valores que o desenvolvedor define ao acoplar esta funcionalidade.
Estende BaseComponents#/schemas/BaseFeatureParameter
| Nome | Tipo | Padrão | Obrigatório | Descrição |
|---|---|---|---|---|
| scope | string (gateway | caller | model) | — | sim | 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) | — | sim | 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. |
Contrato de saída
Valores que esta funcionalidade publica para os consumidores.
Nenhum valor de saída declarado.
Anotações
Nenhuma anotação declarada.
Relações
Arestas tipadas de e para outras entidades publicadas. Uma referência sem destino publicado é exibida como uma aresta quebrada em vez de um link.
Usa
- aplica-se aaplica-se 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 o esquema (values)
BaseComponents#/schemas/BaseFeatureParameter
Usado por
implementa
implementa
implementa
implementa
implementa
implementa
implementa
implementa
implementa