FeatureRecipe
period-budget-cloudflare-ai-gateway
Realizes core/period-budget on core/gateway/cloudflare-ai-gateway's terraform Recipe; a Release binds it in its Manifest. It writes one spend-limit rule into the gateway's own resource and emits no file. The gateway counts what its traffic cost in US dollars, priced from the pricing it keeps per model, over a window that moves forward with time: the last period, written as a number of seconds. Once the count reaches limit it answers further model requests with HTTP 429 until the window has moved on. It records a request's cost once the request completes, so concurrent requests can take it past limit before the first refusal, and it counts only models whose pricing it knows. So it honours unit usd, scope gateway and a period of seconds, minutes, hours or days, and refuses tokens, a budget per caller or per model, and calendar months by name. It halts when the attachment is carried by any component other than core/gateway/cloudflare-ai-gateway, and when a gateway carries more rules than the 20 Cloudflare keeps. That the gateway reads the window in seconds, and refuses as described, is Cloudflare's documented behaviour and no build observes it.
Provenance
- Content digest
- sha256:6f38e7756f2b9f186dbd9d365c449e8d035b266c02d54405dc762d9b6fcf85aa
- Published
- 2026-11-10T10:16:46Z
- Signing identity
- https://token.actions.githubusercontent.com/https://github.com/aggrega-ai/aggrega-hub/.github/workflows/catalog-publish-sign.yml@refs/heads/main
Signature
- Officialapplication/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:4f69ad8dbc83038f97e9d7dd5d256ac6c47e5246effd91bd1c0f1d79de5811d4
Reference at this version
oci://hub.aggrega.ai/featurerecipe/terraform/period-budget-cloudflare-ai-gateway:1.0.0- Target
- —
- Implements
- core/period-budget:1.0.0
Provides
Deterministic pointer templates this recipe wires for consumers.
No provides templates declared.
Inject mapping
cloudflare_ai_gateway:
spend_limit_rule.{{ .attachment_name }}: {{ printf "{ id = %q, limit = %v, limit_type = \"cost\", window = %s, technique = \"sliding\" }" .attachment_name .infra.limit .locals.window_seconds | toJson }}
Workload
No workload template declared.
Locals
| Name | Template |
|---|---|
| window_seconds | {{- $count := atoi (regexFind "^[0-9]+" .infra.period) -}} {{- $unit := regexFind "[a-z]+quot; .infra.period -}} {{- $seconds := dict "s" 1 "m" 60 "h" 3600 "d" 86400 -}} {{- if hasKey $seconds $unit -}}{{- mul $count (index $seconds $unit) -}}{{- end -}} |
Values mapping
No values mapping declared.
Relationships
Typed edges to and from other published entities. A reference with no published target renders as a broken edge rather than a link.
Uses
- implementsimplements
core/period-budget:1.0.0
Used by
Nothing in the catalog depends on this entity.