IngressClass resource fields and annotations

Written by

Updated at November 11, 2025

IngressClass
ObjectMeta

The IngressClass resource is a class of Ingress resources supporting simultaneous use of multiple ingress controllers, e.g., Application Load Balancer and NGINX. Each IngressClass resource specifies a distinct ingress controller. This enables traffic routing across multiple Ingress controllers within the same application and Managed Service for Kubernetes cluster.

Tip

We recommend using the new Yandex Cloud Gwin controller instead of an Application Load Balancer Ingress controller.

When using multiple ingress controllers, explicitly declare the target controller for each Ingress resource. To do this, specify the relevant controller’s IngressClass in the spec.ingressClassName field of the Ingress resource.

IngressClass is a standard Kubernetes resource. Its fields and annotations are described below. For more information on configuring and using IngressClass resources, see the relevant Kubernetes article. See a GitHub example for configuring Ingress resources and routing traffic across multiple ingress controllers.

IngressClass

apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata: <ObjectMeta>
spec:
  controller: <string>

Field	Value / Type	Description
`apiVersion`	`networking.k8s.io/v1`	This is a required field. Kubernetes API version.
`kind`	`IngressClass`	Resource type
`metadata`	`ObjectMeta`	This is a required field. Resource metadata.
`spec`	`IngressClassSpec`	This is a required field. Resource specification.
`spec.controller`	`string`	This is a required field. Ingress controller name specified by the `IngressClass` resource. The possible values are: `ingress.alb.yc.io/yc-alb-ingress-controller`: Application Load Balancer controller. `k8s.io/ingress-nginx`: NGINX controller.

Example

apiVersion: networking.k8s.io/v1
kind: IngressClass
metadata:
  labels:
    app.kubernetes.io/component: controller
  name: alb
  annotations:
    ingressclass.kubernetes.io/is-default-class: "true"
spec:
  controller: ingress.alb.yc.io/yc-alb-ingress-controller

ObjectMeta

name: <string>
labels:
  <string>: <string>
annotations:
  ingressclass.kubernetes.io/is-default-class: "<bool>"

Field	Value / Type	Description
`name`	`string`	This is a required field. Resource name. For more information about the format, see this Kubernetes guide. This name is also specified in the spec.ingressClassName field of the `Ingress` resource.
`labels`	`map[string]string`	Kubernetes: Metrics for Kubernetes object management and monitoring. We recommend you to specify `app.kubernetes.io/component: controller` in this field.
`annotations`	`map[string]string`	Resource annotations. Available annotation is `ingressclass.kubernetes.io/is-default-class`. The annotation data type is `bool`. This annotation specifies whether the `IngressClass` resource is used by default. When set to `"true"`, this `IngressClass` is automatically used for `Ingress` resources with no `IngressClass` specified.

IngressClass resource fields and annotations

IngressClassIngressClass

ObjectMetaObjectMeta

Was the article helpful?

IngressClass

ObjectMeta