api-support-tiers-mapping.adoc

Mapping API tiers to API groups

For each API tier defined by Red Hat, we provide a mapping table for specific API groups where the upstream communities are committed to maintain forward compatibility. Any API group that does not specify an explicit compatibility level and is not specifically discussed below is assigned API tier 3 by default except for v1alpha1 APIs which are assigned tier 4 by default.

Support for Kubernetes API groups

API groups that end with the suffix *.k8s.io or have the form version.<name> with no suffix are governed by the Kubernetes deprecation policy and follow a general mapping between API version exposed and corresponding support tier unless otherwise specified.

API version example	API tier
v1	Tier 1
v1beta1	Tier 2
v1alpha1	Tier 4

Support for OpenShift API groups

API groups that end with the suffix *.openshift.io are governed by the {product-title} deprecation policy and follow a general mapping between API version exposed and corresponding compatibility level unless otherwise specified.

API version example	API tier
apps.openshift.io/v1	Tier 1
authorization.openshift.io/v1	Tier 1, some tier 1 deprecated
build.openshift.io/v1	Tier 1, some tier 1 deprecated
config.openshift.io/v1	Tier 1
image.openshift.io/v1	Tier 1
network.openshift.io/v1	Tier 1
network.operator.openshift.io/v1	Tier 1
oauth.openshift.io/v1	Tier 1
imagecontentsourcepolicy.operator.openshift.io/v1alpha1	Tier 1
project.openshift.io/v1	Tier 1
quota.openshift.io/v1	Tier 1
route.openshift.io/v1	Tier 1
quota.openshift.io/v1	Tier 1
security.openshift.io/v1	Tier 1 except for RangeAllocation (tier 4) and *Reviews (tier 2)
template.openshift.io/v1	Tier 1
console.openshift.io/v1	Tier 2

Support for Monitoring API groups

API groups that end with the suffix monitoring.coreos.com have the following mapping:

API version example	API tier
v1	Tier 1

Support for Operator Lifecycle Manager API groups

Operator Lifecycle Manager (OLM) provides APIs that include API groups with the suffix operators.coreos.com. These APIs have the following mapping:

API version example	API tier
v2	Tier 1
v1	Tier 1
v1alpha1	Tier 1