# RuntimeClass

RuntimeClassRuntimeClass defines a class of container runtime supported in the cluster.apiVersion: node.k8s.io/v1import "k8s.io/api/node/v1"RuntimeClassRuntimeClass defines a class of container runtime supported in the cluster. The RuntimeClass is used to determine which container runtime is used to run all containers in a pod. RuntimeClasses are manually defined by a user or cluster provisioner, and referenced in the PodSpec. The Kubelet is responsible for resolving the RuntimeClassName reference before running the pod. For more details, see https://kubernetes.io/docs/concepts/containers/runtime-class/apiVersion: node.k8s.io/v1kind: RuntimeClassmetadata (ObjectMeta)More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadatahandler (string), requiredhandler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node & CRI configuration. It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called "runc" might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The Handler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable.overhead (Overhead)overhead represents the resource overhead associated with running a pod for a given RuntimeClass. For more details, see https://kubernetes.io/docs/concepts/scheduling-eviction/pod-overhead/Overhead structure represents the resource overhead associated with running a pod.overhead.podFixed (map[string]Quantity)podFixed represents the fixed resource overhead associated with running a pod.scheduling (Scheduling)scheduling holds the scheduling constraints to ensure that pods running with this RuntimeClass are scheduled to nodes that support it. If scheduling is nil, this RuntimeClass is assumed to be supported by all nodes.Scheduling specifies the scheduling constraints for nodes supporting a RuntimeClass.scheduling.nodeSelector (map[string]string)nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod's existing nodeSelector. Any conflicts will cause the pod to be rejected in admission.scheduling.tolerations ([]Toleration)Atomic: will be replaced during a mergetolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass.The pod this Toleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator .scheduling.tolerations.key (string)Key is the taint key that the toleration applies to. Empty means match all taint keys. If the key is empty, operator must be Exists; this combination means to match all values and all keys.scheduling.tolerations.operator (string)Operator represents a key's relationship to the value. Valid operators are Exists and Equal. Defaults to Equal. Exists is equivalent to wildcard for value, so that a pod can tolerate all taints of a particular category.scheduling.tolerations.value (string)Value is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.scheduling.tolerations.effect (string)Effect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule, PreferNoSchedule and NoExecute.scheduling.tolerations.tolerationSeconds (int64)TolerationSeconds represents the period of time the toleration (which must be of effect NoExecute, otherwise this field is ignored) tolerates the taint. By default, it is not set, which means tolerate the taint forever (do not evict). Zero and negative values will be treated as 0 (evict immediately) by the system.RuntimeClassListRuntimeClassList is a list of RuntimeClass objects.apiVersion: node.k8s.io/v1kind: RuntimeClassListmetadata (ListMeta)Standard list metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadataitems ([]RuntimeClass), requireditems is a list of schema objects.Operationsget read the specified RuntimeClassHTTP RequestGET /apis/node.k8s.io/v1/runtimeclasses/{name}Parametersname (in path): string, requiredname of the RuntimeClasspretty (in query): stringprettyResponse200 (RuntimeClass): OK401: Unauthorizedlist list or watch objects of kind RuntimeClassHTTP RequestGET /apis/node.k8s.io/v1/runtimeclassesParametersallowWatchBookmarks (in query): booleanallowWatchBookmarkscontinue (in query): stringcontinuefieldSelector (in query): stringfieldSelectorlabelSelector (in query): stringlabelSelectorlimit (in query): integerlimitpretty (in query): stringprettyresourceVersion (in query): stringresourceVersionresourceVersionMatch (in query): stringresourceVersionMatchsendInitialEvents (in query): booleansendInitialEventstimeoutSeconds (in query): integertimeoutSecondswatch (in query): booleanwatchResponse200 (RuntimeClassList): OK401: Unauthorizedcreate create a RuntimeClassHTTP RequestPOST /apis/node.k8s.io/v1/runtimeclassesParametersbody: RuntimeClass, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationpretty (in query): stringprettyResponse200 (RuntimeClass): OK201 (RuntimeClass): Created202 (RuntimeClass): Accepted401: Unauthorizedupdate replace the specified RuntimeClassHTTP RequestPUT /apis/node.k8s.io/v1/runtimeclasses/{name}Parametersname (in path): string, requiredname of the RuntimeClassbody: RuntimeClass, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationpretty (in query): stringprettyResponse200 (RuntimeClass): OK201 (RuntimeClass): Created401: Unauthorizedpatch partially update the specified RuntimeClassHTTP RequestPATCH /apis/node.k8s.io/v1/runtimeclasses/{name}Parametersname (in path): string, requiredname of the RuntimeClassbody: Patch, requireddryRun (in query): stringdryRunfieldManager (in query): stringfieldManagerfieldValidation (in query): stringfieldValidationforce (in query): booleanforcepretty (in query): stringprettyResponse200 (RuntimeClass): OK201 (RuntimeClass): Created401: Unauthorizeddelete delete a RuntimeClassHTTP RequestDELETE /apis/node.k8s.io/v1/runtimeclasses/{name}Parametersname (in path): string, requiredname of the RuntimeClassbody: DeleteOptionsdryRun (in query): stringdryRungracePeriodSeconds (in query): integergracePeriodSecondsignoreStoreReadErrorWithClusterBreakingPotential (in query): booleanignoreStoreReadErrorWithClusterBreakingPotentialpretty (in query): stringprettypropagationPolicy (in query): stringpropagationPolicyResponse200 (Status): OK202 (Status): Accepted401: Unauthorizeddeletecollection delete collection of RuntimeClassHTTP RequestDELETE /apis/node.k8s.io/v1/runtimeclassesParametersbody: DeleteOptionscontinue (in query): stringcontinuedryRun (in query): stringdryRunfieldSelector (in query): stringfieldSelectorgracePeriodSeconds (in query): integergracePeriodSecondsignoreStoreReadErrorWithClusterBreakingPotential (in query): booleanignoreStoreReadErrorWithClusterBreakingPotentiallabelSelector (in query): stringlabelSelectorlimit (in query): integerlimitpretty (in query): stringprettypropagationPolicy (in query): stringpropagationPolicyresourceVersion (in query): stringresourceVersionresourceVersionMatch (in query): stringresourceVersionMatchsendInitialEvents (in query): booleansendInitialEventstimeoutSeconds (in query): integertimeoutSecondsResponse200 (Status): OK401: UnauthorizedThis page is automatically generated.If you plan to report an issue with this page, mention that the page is auto-generated in your issue description. The fix may need to happen elsewhere in the Kubernetes project.