IngressClass resource fields and annotations

Written by

Updated at January 26, 2026

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 resources of different controllers within the same application and Managed Service for Kubernetes cluster.

Tip

We recommend using the new Yandex Cloud Gwin controller instead of an ALB Ingress controller and Gateway API.

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.

IngressClass is a standard Kubernetes resource. We describe its fields and annotations below. For more information on configuring and using IngressClass resources, see this Kubernetes guide. Check out a GitHub example for configuring Ingress resources and routing traffic using 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 managing and monitoring Kubernetes objects. We recommend specifying `app.kubernetes.io/component: controller` in this field.
`annotations`	`map[string]string`	Resource annotations. The 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