# Kubernetes API catalog

Find the Kubernetes resource that owns the configuration or status you need. Kedify resources extend the KEDA model; generated resources remain owned by their controllers. [Configuration reference](https://docs.kedify.io/reference/) also covers chart values, annotations, triggers and metrics.

## Kedify Custom Types

The references below list served API versions, fields, validation and status. Check the installed CRD and controller version before using a field.

## KedifyConfiguration

[KedifyConfiguration API reference](https://docs.kedify.io/reference/kubernetes-api/kedifyconfiguration/) contains the exact contract. [Kedify Agent and data collection](https://docs.kedify.io/concepts/kedify-agent/) explains its use and setup. Keep its desired configuration under one owner.

## PodResourceProfile

[PodResourceProfile API reference](https://docs.kedify.io/reference/kubernetes-api/podresourceprofile/) contains the exact contract. [Pod Resource Profiles (PRP)](https://docs.kedify.io/features/pod-resource-profiles/) explains its use and setup. Keep its desired configuration under one owner.

## PodResourceAutoscaler

[PodResourceAutoscaler API reference](https://docs.kedify.io/reference/kubernetes-api/podresourceautoscaler/) contains the exact contract. [Pod Resource Autoscaler (PRA)](https://docs.kedify.io/features/pod-resource-autoscaler/) explains its use and setup. Keep its desired configuration under one owner.

## DistributedScaledObject

[DistributedScaledObject API reference](https://docs.kedify.io/reference/kubernetes-api/distributedscaledobject/) contains the exact contract. [Distributed multi-cluster scaling](https://docs.kedify.io/features/multi-cluster-scaling/) explains its use and setup. Keep its desired configuration under one owner.

## DistributedScaledJob

[DistributedScaledJob API reference](https://docs.kedify.io/reference/kubernetes-api/distributedscaledjob/) contains the exact contract. [Distributed multi-cluster scaling](https://docs.kedify.io/features/multi-cluster-scaling/) explains its use and setup. Keep its desired configuration under one owner.

## ScaleAdapter

[ScaleAdapter API reference](https://docs.kedify.io/reference/kubernetes-api/scaleadapter/) contains the exact contract. [Scale Adapter: custom scaling targets](https://docs.kedify.io/features/scale-adapter/) explains its use and setup. Keep its desired configuration under one owner.

## ScalingPolicy

[ScalingPolicy API reference](https://docs.kedify.io/reference/kubernetes-api/scalingpolicy/) contains the exact contract. [Scaling Policy: scheduled configuration](https://docs.kedify.io/features/scaling-policy/) explains its use and setup. Keep its desired configuration under one owner.

## ScalingGroup

[ScalingGroup API reference](https://docs.kedify.io/reference/kubernetes-api/scalinggroup/) contains the exact contract. [Scaling Groups: shared replica capacity](https://docs.kedify.io/features/scaling-groups/) explains its use and setup. Keep its desired configuration under one owner.

## MetricPredictor

[MetricPredictor API reference](https://docs.kedify.io/reference/kubernetes-api/metricpredictor/) contains the exact contract. [Predictive scaling](https://docs.kedify.io/scalers/predictive-scaler/) explains its use and setup. Keep its desired configuration under one owner.

## KedifyPodAutoscaler

[KedifyPodAutoscaler API reference](https://docs.kedify.io/reference/kubernetes-api/kedifypodautoscaler/) contains the exact contract. [Kedify Pod Autoscaler (KPA)](https://docs.kedify.io/features/kedify-pod-autoscaler/) explains its use and setup. This resource is generated from the ScaledObject; do not author it directly.

## KEDA Types

Use the upstream documentation for your installed KEDA minor version. These links use 2.18 as a versioned reference, not an assertion that every Kedify bundle uses that version.

### ScaledObject

Maps demand signals to a scalable target. [ScaledObject specification](https://keda.sh/docs/latest/reference/scaledobject-spec/) owns activation, min/max replicas, triggers and advanced HPA settings. Start with [horizontal demand signals](https://docs.kedify.io/scalers/) or the [event-source configuration](https://docs.kedify.io/scalers/keda-scalers/).

### ScaledJob

Creates finite jobs from event demand. [ScaledJob specification](https://keda.sh/docs/latest/reference/scaledjob-spec/) owns job templates, concurrency and scaling strategy. Job retries and completion differ from a long-lived worker Deployment.

### TriggerAuthentication

Namespaced trigger credentials and identity settings: [KEDA authentication](https://keda.sh/docs/latest/concepts/authentication/). Keep secret values out of examples and logs.

### ClusterTriggerAuthentication

Cluster-scoped authentication has broader sharing implications; use the same [versioned authentication contract](https://keda.sh/docs/latest/concepts/authentication/) and explicit access ownership.

## Generated HTTP and pod autoscaler resources

Author the `ScaledObject` for [Kedify HTTP scaling](https://docs.kedify.io/scalers/http-scaler/); the Agent manages its `HTTPScaledObject` and routing integration. KEDA generates HPA or [KPA](https://docs.kedify.io/reference/kubernetes-api/kedifypodautoscaler/) according to controller selection. Do not treat a generated resource as a second desired-state owner.

---
Canonical: https://docs.kedify.io/concepts/kedify-custom-resource-definitions/
Source: src/content/docs/concepts/kedify-custom-resource-definitions.md
Documentation index: https://docs.kedify.io/llms.txt