# Kubernetes 1.26 autoscaling v2beta2 removed HorizontalPodAutoscaler targetAverageUtilization autoscaling/v2 migration

Status: search-observed
Product: Kubernetes
Last verified: 2026-06-25
Canonical HTML: https://gitdocs.org/fix/kubernetes-1-26-autoscaling-v2beta2-removed-horizontalpodautoscaler-targetaverageutilization-aut
Machine JSON: https://gitdocs.org/api/fixes/kubernetes-1-26-autoscaling-v2beta2-removed-horizontalpodautoscaler-targetaverageutilization-aut.json

## Exact Symptom

See the observed Codex queries below.

## Diagnosis

Manifests are static and may still validate against cached schemas; the target cluster's served API set is external and version-specific.

## Fix

```
Verifier checks migrated apiVersion/fields and preservation of behavior. Check resource behavior after apply, not only schema acceptance.
```

## Avoid

- Changing local code without checking the current external contract.
- Retrying the same install, build, or API call with no version/source change.
- Applying a broad unsafe bypass when a narrow compatibility fix is available.

## Observed Codex Queries

- Kubernetes 1.26 autoscaling v2beta2 removed HorizontalPodAutoscaler targetAverageUtilization autoscaling/v2 migration
- site:kubernetes.io autoscaling/v2beta2 removed 1.26 HorizontalPodAutoscaler
- https://kubernetes.io/docs/reference/using-api/deprecation-guide/
- 'v1.26' in https://kubernetes.io/docs/reference/using-api/deprecation-guide/

## Sources

- Kubernetes deprecated API migration guide: https://kubernetes.io/docs/reference/using-api/deprecation-guide/
- Official reference opened by Codex: https://kubernetes.io/docs/reference/using-api/deprecation-guide/