Skip to main content

Other Models

V1AWSElasticBlockStoreVolumeSource

  • Represents a Persistent Disk resource in AWS. An AWS EBS disk must exist before mounting to a container. The disk must also be in the same AWS zone as the kubelet. An AWS EBS disk can only be mounted as read/write once. AWS EBS volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly...
partitionnumberpartition is the partition in the volume that you want to mount. If omitted, the default is to mount by volume name. Examples: For volume /dev/sda1, you specify the partition as "1". Similarly, the...
readOnlybooleanreadOnly value true will force the readOnly setting in VolumeMounts. More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore
volumeIDstringvolumeID is unique ID of the persistent disk resource in AWS (Amazon EBS volume). More info: https://kubernetes.io/docs/concepts/storage/volumes#awselasticblockstore

V1Affinity

  • Affinity is a group of affinity scheduling rules.

Source

PropertyTypeDescription
nodeAffinityV1NodeAffinity
podAffinityV1PodAffinity
podAntiAffinityV1PodAntiAffinity

V1AggregationRule

  • AggregationRule describes how to locate ClusterRoles to aggregate into the ClusterRole

Source

PropertyTypeDescription
clusterRoleSelectorsV1LabelSelector[]ClusterRoleSelectors holds a list of selectors which will be used to find ClusterRoles and create the rules. If any of the selectors match, then the ClusterRole's permissions will be added

V1AppArmorProfile

  • AppArmorProfile defines a pod or container's AppArmor settings.

Source

PropertyTypeDescription
localhostProfilestringlocalhostProfile indicates a profile loaded on the node that should be used. The profile must be preconfigured on the node to work. Must match the loaded name of the profile. Must be set if and only...
typestringtype indicates which kind of AppArmor profile will be applied. Valid options are: Localhost - a profile pre-loaded on the node. RuntimeDefault - the container runtime's default profile. ...

V1AttachedVolume

  • AttachedVolume describes a volume attached to a node

Source

PropertyTypeDescription
devicePathstringDevicePath represents the device path where the volume should be available
namestringName of the attached volume

V1AuditAnnotation

  • AuditAnnotation describes how to produce an audit annotation for an API request.

Source

PropertyTypeDescription
keystringkey specifies the audit annotation key. The audit annotation keys of a ValidatingAdmissionPolicy must be unique. The key must be a qualified name ([A-Za-z0-9][-A-Za-z0-9_.]*) no more than 63 bytes in...
valueExpressionstringvalueExpression represents the expression which is evaluated by CEL to produce an audit annotation value. The expression must evaluate to either a string or null value. If the expression evaluates to...

V1AzureDiskVolumeSource

  • AzureDisk represents an Azure Data Disk mount on the host and bind mount to the pod.

Source

PropertyTypeDescription
cachingModestringcachingMode is the Host Caching mode: None, Read Only, Read Write.
diskNamestringdiskName is the Name of the data disk in the blob storage
diskURIstringdiskURI is the URI of data disk in the blob storage
fsTypestringfsType is Filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
kindstringkind expected values are Shared: multiple blob disks per storage account Dedicated: single blob disk per storage account Managed: azure managed data disk (only in managed availability set)....
readOnlybooleanreadOnly Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.

V1AzureFilePersistentVolumeSource

  • AzureFile represents an Azure File Service mount on the host and bind mount to the pod.

Source

PropertyTypeDescription
readOnlybooleanreadOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
secretNamestringsecretName is the name of secret that contains Azure Storage Account Name and Key
secretNamespacestringsecretNamespace is the namespace of the secret that contains Azure Storage Account Name and Key default is the same as the Pod
shareNamestringshareName is the azure Share Name

V1AzureFileVolumeSource

  • AzureFile represents an Azure File Service mount on the host and bind mount to the pod.

Source

PropertyTypeDescription
readOnlybooleanreadOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
secretNamestringsecretName is the name of secret that contains Azure Storage Account Name and Key
shareNamestringshareName is the azure share Name

V1CELDeviceSelector

  • CELDeviceSelector contains a CEL expression for selecting a device.

Source

PropertyTypeDescription
expressionstringExpression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other...

V1Capabilities

  • Adds and removes POSIX capabilities from running containers.

Source

PropertyTypeDescription
addstring[]Added capabilities
dropstring[]Removed capabilities

V1CapacityRequestPolicy

  • CapacityRequestPolicy defines how requests consume device capacity. Must not set more than one ValidRequestValues.

Source

PropertyTypeDescription
_defaultstringDefault specifies how much of this capacity is consumed by a request that does not contain an entry for it in DeviceRequest's Capacity.
validValuesstring[]ValidValues defines a set of acceptable quantity values in consuming requests. Must not contain more than 10 entries. Must be sorted in ascending order. If this field is set, Default must be...
validRangeV1CapacityRequestPolicyRange

V1CapacityRequestPolicyRange

  • CapacityRequestPolicyRange defines a valid range for consumable capacity values. - If the requested amount is less than Min, it is rounded up to the Min value. - If Step is set and the requested amount is between Min and Max but not aligned with Step, it will be rounded up to the next value equal to Min + (n * Step). - If Step is not set, the requested amount is used as-is if it falls within the range Min to Max (if set). - If the requested or rounded amount exceeds Max (if set), the request does not satisfy the policy, and the device cannot be allocated.

Source

PropertyTypeDescription
maxstringMax defines the upper limit for capacity that can be requested. Max must be less than or equal to the capacity value. Min and requestPolicy.default must be less than or equal to the maximum.
minstringMin specifies the minimum capacity allowed for a consumption request. Min must be greater than or equal to zero, and less than or equal to the capacity value. requestPolicy.default must be more than...
stepstringStep defines the step size between valid capacity amounts within the range. Max (if set) and requestPolicy.default must be a multiple of Step. Min + Step must be less than or equal to the capacity...

V1CapacityRequirements

  • CapacityRequirements defines the capacity requirements for a specific device request.

Source

PropertyTypeDescription
requests{ [key: string]: stringRequests represent individual device resource requests for distinct resources, all of which must be provided by the device. This value is used as an additional filtering condition against the...

V1CephFSPersistentVolumeSource

  • Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.

Source

PropertyTypeDescription
monitorsstring[]monitors is Required: Monitors is a collection of Ceph monitors More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
pathstringpath is Optional: Used as the mounted root, rather than the full Ceph tree, default is /
readOnlybooleanreadOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
secretFilestringsecretFile is Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
userstringuser is Optional: User is the rados user name, default is admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
secretRefV1SecretReference

V1CephFSVolumeSource

  • Represents a Ceph Filesystem mount that lasts the lifetime of a pod Cephfs volumes do not support ownership management or SELinux relabeling.

Source

PropertyTypeDescription
monitorsstring[]monitors is Required: Monitors is a collection of Ceph monitors More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
pathstringpath is Optional: Used as the mounted root, rather than the full Ceph tree, default is /
readOnlybooleanreadOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
secretFilestringsecretFile is Optional: SecretFile is the path to key ring for User, default is /etc/ceph/user.secret More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
userstringuser is optional: User is the rados user name, default is admin More info: https://examples.k8s.io/volumes/cephfs/README.md#how-to-use-it
secretRefV1LocalObjectReference

V1CinderPersistentVolumeSource

  • Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
fsTypestringfsType Filesystem type to mount. Must be a filesystem type supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified. More info:...
readOnlybooleanreadOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
volumeIDstringvolumeID used to identify the volume in cinder. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
secretRefV1SecretReference

V1CinderVolumeSource

  • Represents a cinder volume resource in Openstack. A Cinder volume must exist before mounting to a container. The volume must also be in the same region as the kubelet. Cinder volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified....
readOnlybooleanreadOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
volumeIDstringvolumeID used to identify the volume in cinder. More info: https://examples.k8s.io/mysql-cinder-pd/README.md
secretRefV1LocalObjectReference

V1ClientIPConfig

  • ClientIPConfig represents the configurations of Client IP based session affinity.

Source

PropertyTypeDescription
timeoutSecondsnumbertimeoutSeconds specifies the seconds of ClientIP type session sticky time. The value must be >0 && <=86400(for 1 day) if ServiceAffinity == "ClientIP". Default value is 10800(for 3 hours).

V1ClusterTrustBundleProjection

  • ClusterTrustBundleProjection describes how to select a set of ClusterTrustBundle objects and project their contents into the pod filesystem.

Source

PropertyTypeDescription
namestringSelect a single ClusterTrustBundle by object name. Mutually-exclusive with signerName and labelSelector.
optionalbooleanIf true, don't block pod startup if the referenced ClusterTrustBundle(s) aren't available. If using name, then the named ClusterTrustBundle is allowed not to exist. If using signerName, then the...
pathstringRelative path from the volume root to write the bundle.
signerNamestringSelect all ClusterTrustBundles that match this signer name. Mutually-exclusive with name. The contents of all selected ClusterTrustBundles will be unified and deduplicated.
labelSelectorV1LabelSelector

V1Condition

  • Condition contains details for one aspect of the current state of this API Resource.

Source

PropertyTypeDescription
lastTransitionTimeDatelastTransitionTime is the last time the condition transitioned from one status to another. This should be when the underlying condition changed. If that is not known, then using the time when the...
messagestringmessage is a human readable message indicating details about the transition. This may be an empty string.
observedGenerationnumberobservedGeneration represents the .metadata.generation that the condition was set based upon. For instance, if .metadata.generation is currently 12, but the .status.conditions[x].observedGeneration...
reasonstringreason contains a programmatic identifier indicating the reason for the condition's last transition. Producers of specific condition types may define expected values and meanings for this field, and...
statusstringstatus of the condition, one of True, False, Unknown.
typestringtype of condition in CamelCase or in foo.example.com/CamelCase.

V1Container

  • A single application container that you want to run within a pod.

Source

PropertyTypeDescription
argsstring[]Arguments to the entrypoint. The container image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be...
commandstring[]Entrypoint array. Not executed within a shell. The container image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a...
envV1EnvVar[]List of environment variables to set in the container. Cannot be updated.
envFromV1EnvFromSource[]List of sources to populate environment variables in the container. The keys defined within a source may consist of any printable ASCII characters except '='. When a key exists in multiple sources,...
imagestringContainer image name. More info: https://kubernetes.io/docs/concepts/containers/images This field is optional to allow higher level config management to default or override container images in...
imagePullPolicystringImage pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info:...
namestringName of the container specified as a DNS_LABEL. Each container in a pod must have a unique name (DNS_LABEL). Cannot be updated.
portsV1ContainerPort[]List of ports to expose from the container. Not specifying a port here DOES NOT prevent that port from being exposed. Any port which is listening on the default "0.0.0.0" address inside a container...
resizePolicyV1ContainerResizePolicy[]Resources resize policy for the container. This field cannot be set on ephemeral containers.
restartPolicystringRestartPolicy defines the restart behavior of individual containers in a pod. This overrides the pod-level restart policy. When this field is not specified, the restart behavior is defined by the...
restartPolicyRulesV1ContainerRestartRule[]Represents a list of rules to be checked to determine if the container should be restarted on exit. The rules are evaluated in order. Once a rule matches a container exit condition, the remaining...
stdinbooleanWhether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false.
stdinOncebooleanWhether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If...
terminationMessagePathstringOptional: Path at which the file to which the container's termination message will be written is mounted into the container's filesystem. Message written is intended to be brief final status, such...
terminationMessagePolicystringIndicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure....
ttybooleanWhether this container should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
volumeDevicesV1VolumeDevice[]volumeDevices is the list of block devices to be used by the container.
volumeMountsV1VolumeMount[]Pod volumes to mount into the container's filesystem. Cannot be updated.
workingDirstringContainer's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
lifecycleV1Lifecycle
livenessProbeV1Probe
readinessProbeV1Probe
resourcesV1ResourceRequirements
securityContextV1SecurityContext
startupProbeV1Probe

V1ContainerExtendedResourceRequest

  • ContainerExtendedResourceRequest has the mapping of container name, extended resource name to the device request name.

Source

PropertyTypeDescription
containerNamestringThe name of the container requesting resources.
requestNamestringThe name of the request in the special ResourceClaim which corresponds to the extended resource.
resourceNamestringThe name of the extended resource in that container which gets backed by DRA.

V1ContainerImage

  • Describe a container image

Source

PropertyTypeDescription
namesstring[]Names by which this image is known. e.g. ["kubernetes.example/hyperkube:v1.0.7", "cloud-vendor.registry.example/cloud-vendor/hyperkube:v1.0.7"]
sizeBytesnumberThe size of the image in bytes.

V1ContainerPort

  • ContainerPort represents a network port in a single container.

Source

PropertyTypeDescription
containerPortnumberNumber of port to expose on the pod's IP address. This must be a valid port number, 0 < x < 65536.
hostIPstringWhat host IP to bind the external port to.
hostPortnumberNumber of port to expose on the host. If specified, this must be a valid port number, 0 < x < 65536. If HostNetwork is specified, this must match ContainerPort. Most containers do not need this.
namestringIf specified, this must be an IANA_SVC_NAME and unique within the pod. Each named port in a pod must have a unique name. Name for the port that can be referred to by services.
protocolstringProtocol for port. Must be UDP, TCP, or SCTP. Defaults to "TCP".

V1ContainerResizePolicy

  • ContainerResizePolicy represents resource resize policy for the container.

Source

PropertyTypeDescription
resourceNamestringName of the resource to which this resource resize policy applies. Supported values: cpu, memory.
restartPolicystringRestart policy to apply when specified resource is resized. If not specified, it defaults to NotRequired.

V1ContainerRestartRule

  • ContainerRestartRule describes how a container exit is handled.

Source

PropertyTypeDescription
actionstringSpecifies the action taken on a container exit if the requirements are satisfied. The only possible value is "Restart" to restart the container.
exitCodesV1ContainerRestartRuleOnExitCodes

V1ContainerRestartRuleOnExitCodes

  • ContainerRestartRuleOnExitCodes describes the condition for handling an exited container based on its exit codes.

Source

PropertyTypeDescription
operatorstringRepresents the relationship between the container exit code(s) and the specified values. Possible values are: - In: the requirement is satisfied if the container exit code is in the set of...
valuesnumber[]Specifies the set of values to check for container exit codes. At most 255 elements are allowed.

V1ContainerState

  • ContainerState holds a possible state of container. Only one of its members may be specified. If none of them is specified, the default one is ContainerStateWaiting.

Source

PropertyTypeDescription
runningV1ContainerStateRunning
terminatedV1ContainerStateTerminated
waitingV1ContainerStateWaiting

V1ContainerStateRunning

  • ContainerStateRunning is a running state of a container.

Source

PropertyTypeDescription
startedAtDateTime at which the container was last (re-)started

V1ContainerStateTerminated

  • ContainerStateTerminated is a terminated state of a container.

Source

PropertyTypeDescription
containerIDstringContainer's ID in the format '://<container_id>'
exitCodenumberExit status from the last termination of the container
finishedAtDateTime at which the container last terminated
messagestringMessage regarding the last termination of the container
reasonstring(brief) reason from the last termination of the container
signalnumberSignal from the last termination of the container
startedAtDateTime at which previous execution of the container started

V1ContainerStateWaiting

  • ContainerStateWaiting is a waiting state of a container.

Source

PropertyTypeDescription
messagestringMessage regarding why the container is not yet running.
reasonstring(brief) reason the container is not yet running.

V1ContainerStatus

  • ContainerStatus contains details for the current status of this container.

Source

PropertyTypeDescription
allocatedResources{ [key: string]: stringAllocatedResources represents the compute resources allocated for this container by the node. Kubelet sets this value to Container.Resources.Requests upon successful pod admission and after...
allocatedResourcesStatusV1ResourceStatus[]AllocatedResourcesStatus represents the status of various resources allocated for this Pod.
containerIDstringContainerID is the ID of the container in the format '://<container_id>'. Where type is a container runtime identifier, returned from Version call of CRI API (for example "containerd").
imagestringImage is the name of container image that the container is running. The container image may not match the image used in the PodSpec, as it may have been resolved by the runtime. More info:...
imageIDstringImageID is the image ID of the container's image. The image ID may not match the image ID of the image used in the PodSpec, as it may have been resolved by the runtime.
namestringName is a DNS_LABEL representing the unique name of the container. Each container in a pod must have a unique name across all container types. Cannot be updated.
readybooleanReady specifies whether the container is currently passing its readiness check. The value will change as readiness probes keep executing. If no readiness probes are specified, this field defaults to...
restartCountnumberRestartCount holds the number of times the container has been restarted. Kubelet makes an effort to always increment the value, but there are cases when the state may be lost due to node restarts and...
startedbooleanStarted indicates whether the container has finished its postStart lifecycle hook and passed its startup probe. Initialized as false, becomes true after startupProbe is considered successful. Resets...
stopSignalstringStopSignal reports the effective stop signal for this container
volumeMountsV1VolumeMountStatus[]Status of volume mounts.
lastStateV1ContainerState
resourcesV1ResourceRequirements
stateV1ContainerState
userV1ContainerUser

V1ContainerUser

  • ContainerUser represents user identity information

Source

PropertyTypeDescription
linuxV1LinuxContainerUser

V1Counter

  • Counter describes a quantity associated with a device.

Source

PropertyTypeDescription
valuestringValue defines how much of a certain device counter is available.

V1CounterSet

  • CounterSet defines a named set of counters that are available to be used by devices defined in the ResourcePool. The counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.

Source

PropertyTypeDescription
counters{ [key: string]: V1CounterCounters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label. The maximum number of counters is 32.
namestringName defines the name of the counter set. It must be a DNS label.

V1CrossVersionObjectReference

  • CrossVersionObjectReference contains enough information to let you identify the referred resource.

Source

PropertyTypeDescription
apiVersionstringapiVersion is the API version of the referent
kindstringkind is the kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
namestringname is the name of the referent; More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

V1CustomResourceColumnDefinition

  • CustomResourceColumnDefinition specifies a column for server side printing.

Source

PropertyTypeDescription
descriptionstringdescription is a human readable description of this column.
formatstringformat is an optional OpenAPI type definition for this column. The 'name' format is applied to the primary identifier column to assist in clients identifying column is the resource name. See...
jsonPathstringjsonPath is a simple JSON path (i.e. with array notation) which is evaluated against each custom resource to produce the value for this column.
namestringname is a human readable name for the column.
prioritynumberpriority is an integer defining the relative importance of this column compared to others. Lower numbers are considered higher priority. Columns that may be omitted in limited space scenarios should...
typestringtype is an OpenAPI type definition for this column. See https://github.com/OAI/OpenAPI-Specification/blob/master/versions/2.0.md#data-types for details.

V1CustomResourceConversion

  • CustomResourceConversion describes how to convert different versions of a CR.

Source

PropertyTypeDescription
strategystringstrategy specifies how custom resources are converted between versions. Allowed values are: - \"None\": The converter only change the apiVersion and would not touch any other field in the custom...
webhookV1WebhookConversion

V1CustomResourceSubresourceScale

  • CustomResourceSubresourceScale defines how to serve the scale subresource for CustomResources.

Source

PropertyTypeDescription
labelSelectorPathstringlabelSelectorPath defines the JSON path inside of a custom resource that corresponds to Scale status.selector. Only JSON paths without the array notation are allowed. Must be a JSON Path under...
specReplicasPathstringspecReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale spec.replicas. Only JSON paths without the array notation are allowed. Must be a JSON Path under...
statusReplicasPathstringstatusReplicasPath defines the JSON path inside of a custom resource that corresponds to Scale status.replicas. Only JSON paths without the array notation are allowed. Must be a JSON Path under...

V1CustomResourceSubresources

  • CustomResourceSubresources defines the status and scale subresources for CustomResources.

Source

PropertyTypeDescription
statusanystatus indicates the custom resource should serve a /status subresource. When enabled: 1. requests to the custom resource primary endpoint ignore changes to the status stanza of the object. 2....
scaleV1CustomResourceSubresourceScale

V1CustomResourceValidation

  • CustomResourceValidation is a list of validation methods for CustomResources.

Source

PropertyTypeDescription
openAPIV3SchemaV1JSONSchemaProps

V1DaemonEndpoint

  • DaemonEndpoint contains information about a single Daemon endpoint.

Source

PropertyTypeDescription
PortnumberPort number of the given endpoint.

V1DeleteOptions

  • DeleteOptions may be provided when deleting an API object.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
dryRunstring[]When present, indicates that modifications should not be persisted. An invalid or unrecognized dryRun directive will result in an error response and no further processing of the request. Valid values...
gracePeriodSecondsnumberThe duration in seconds before the object should be deleted. Value must be non-negative integer. The value zero indicates delete immediately. If this value is nil, the default grace period for the...
ignoreStoreReadErrorWithClusterBreakingPotentialbooleanif set to true, it will trigger an unsafe deletion of the resource in case the normal deletion flow fails with a corrupt object error. A resource is considered corrupt if it can not be retrieved from...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
orphanDependentsbooleanDeprecated: please use the PropagationPolicy, this field will be deprecated in 1.7. Should the dependent objects be orphaned. If true/false, the "orphan" finalizer will be added to/removed from the...
propagationPolicystringWhether and how garbage collection will be performed. Either this field or OrphanDependents may be set, but not both. The default policy is decided by the existing finalizer set in the...
preconditionsV1Preconditions

Used by: AdmissionregistrationV1alpha1Api.deleteCollectionMutatingAdmissionPolicy · AdmissionregistrationV1alpha1Api.deleteCollectionMutatingAdmissionPolicyBinding · AdmissionregistrationV1alpha1Api.deleteMutatingAdmissionPolicy · AdmissionregistrationV1Api.deleteCollectionMutatingWebhookConfiguration · AdmissionregistrationV1Api.deleteCollectionValidatingAdmissionPolicy · AdmissionregistrationV1Api.deleteMutatingWebhookConfiguration · AdmissionregistrationV1beta1Api.deleteCollectionMutatingAdmissionPolicy · AdmissionregistrationV1beta1Api.deleteCollectionMutatingAdmissionPolicyBinding · AdmissionregistrationV1beta1Api.deleteMutatingAdmissionPolicy · ApiextensionsV1Api.deleteCollectionCustomResourceDefinition · ApiextensionsV1Api.deleteCustomResourceDefinition · ApiregistrationV1Api.deleteAPIService · ApiregistrationV1Api.deleteCollectionAPIService · AppsV1Api.deleteCollectionNamespacedControllerRevision · AppsV1Api.deleteCollectionNamespacedDaemonSet · AppsV1Api.deleteNamespacedControllerRevision · AutoscalingV1Api.deleteCollectionNamespacedHorizontalPodAutoscaler · AutoscalingV1Api.deleteNamespacedHorizontalPodAutoscaler · AutoscalingV2Api.deleteCollectionNamespacedHorizontalPodAutoscaler · AutoscalingV2Api.deleteNamespacedHorizontalPodAutoscaler

and 92 more…

BatchV1Api.deleteCollectionNamespacedCronJob · BatchV1Api.deleteCollectionNamespacedJob · BatchV1Api.deleteNamespacedCronJob · CertificatesV1alpha1Api.deleteClusterTrustBundle · CertificatesV1alpha1Api.deleteCollectionClusterTrustBundle · CertificatesV1Api.deleteCertificateSigningRequest · CertificatesV1Api.deleteCollectionCertificateSigningRequest · CertificatesV1beta1Api.deleteClusterTrustBundle · CertificatesV1beta1Api.deleteCollectionClusterTrustBundle · CertificatesV1beta1Api.deleteCollectionNamespacedPodCertificateRequest · CoordinationV1alpha2Api.deleteCollectionNamespacedLeaseCandidate · CoordinationV1alpha2Api.deleteNamespacedLeaseCandidate · CoordinationV1Api.deleteCollectionNamespacedLease · CoordinationV1Api.deleteNamespacedLease · CoordinationV1beta1Api.deleteCollectionNamespacedLeaseCandidate · CoordinationV1beta1Api.deleteNamespacedLeaseCandidate · CoreV1Api.deleteCollectionNamespacedConfigMap · CoreV1Api.deleteCollectionNamespacedEndpoints · CoreV1Api.deleteCollectionNamespacedEvent · CoreV1Api.deleteCollectionNamespacedLimitRange · CoreV1Api.deleteCollectionNamespacedPersistentVolumeClaim · CoreV1Api.deleteCollectionNamespacedPod · CoreV1Api.deleteCollectionNamespacedPodTemplate · CoreV1Api.deleteCollectionNamespacedReplicationController · CoreV1Api.deleteCollectionNamespacedResourceQuota · CoreV1Api.deleteCollectionNamespacedSecret · CoreV1Api.deleteCollectionNamespacedService · CoreV1Api.deleteCollectionNamespacedServiceAccount · CoreV1Api.deleteCollectionNode · CoreV1Api.deleteCollectionPersistentVolume · CoreV1Api.deleteNamespace · CoreV1Api.deleteNamespacedConfigMap · CoreV1Api.deleteNamespacedEndpoints · CoreV1Api.deleteNamespacedEvent · CoreV1Api.deleteNamespacedLimitRange · CoreV1Api.deleteNamespacedPersistentVolumeClaim · CoreV1Api.deleteNamespacedPod · CoreV1Api.deleteNamespacedPodTemplate · CoreV1Api.deleteNamespacedReplicationController · CoreV1Api.deleteNamespacedResourceQuota · CoreV1Api.deleteNamespacedSecret · CoreV1Api.deleteNamespacedService · CoreV1Api.deleteNamespacedServiceAccount · CoreV1Api.deleteNode · CoreV1Api.deletePersistentVolume · CustomObjectsApi.deleteClusterCustomObject · CustomObjectsApi.deleteCollectionClusterCustomObject · CustomObjectsApi.deleteCollectionNamespacedCustomObject · DiscoveryV1Api.deleteCollectionNamespacedEndpointSlice · DiscoveryV1Api.deleteNamespacedEndpointSlice · EventsV1Api.deleteCollectionNamespacedEvent · EventsV1Api.deleteNamespacedEvent · FlowcontrolApiserverV1Api.deleteCollectionFlowSchema · FlowcontrolApiserverV1Api.deleteCollectionPriorityLevelConfiguration · FlowcontrolApiserverV1Api.deleteFlowSchema · InternalApiserverV1alpha1Api.deleteCollectionStorageVersion · InternalApiserverV1alpha1Api.deleteStorageVersion · NetworkingV1Api.deleteCollectionIngressClass · NetworkingV1Api.deleteCollectionIPAddress · NetworkingV1Api.deleteIPAddress · NetworkingV1beta1Api.deleteCollectionIPAddress · NetworkingV1beta1Api.deleteCollectionServiceCIDR · NetworkingV1beta1Api.deleteIPAddress · NodeV1Api.deleteCollectionRuntimeClass · NodeV1Api.deleteRuntimeClass · PolicyV1Api.deleteCollectionNamespacedPodDisruptionBudget · PolicyV1Api.deleteNamespacedPodDisruptionBudget · RbacAuthorizationV1Api.deleteClusterRole · RbacAuthorizationV1Api.deleteClusterRoleBinding · RbacAuthorizationV1Api.deleteCollectionClusterRole · ResourceV1alpha3Api.deleteCollectionDeviceTaintRule · ResourceV1alpha3Api.deleteDeviceTaintRule · ResourceV1Api.deleteCollectionDeviceClass · ResourceV1Api.deleteCollectionNamespacedResourceClaim · ResourceV1Api.deleteDeviceClass · ResourceV1beta1Api.deleteCollectionDeviceClass · ResourceV1beta1Api.deleteCollectionNamespacedResourceClaim · ResourceV1beta1Api.deleteDeviceClass · ResourceV1beta2Api.deleteCollectionDeviceClass · ResourceV1beta2Api.deleteCollectionNamespacedResourceClaim · ResourceV1beta2Api.deleteDeviceClass · SchedulingV1alpha1Api.deleteCollectionNamespacedWorkload · SchedulingV1alpha1Api.deleteNamespacedWorkload · SchedulingV1Api.deleteCollectionPriorityClass · SchedulingV1Api.deletePriorityClass · StoragemigrationV1beta1Api.deleteCollectionStorageVersionMigration · StoragemigrationV1beta1Api.deleteStorageVersionMigration · StorageV1Api.deleteCollectionCSIDriver · StorageV1Api.deleteCSIDriver · StorageV1Api.deleteCSINode · StorageV1beta1Api.deleteCollectionVolumeAttributesClass · StorageV1beta1Api.deleteVolumeAttributesClass

V1Device

  • Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.

Source

PropertyTypeDescription
allNodesbooleanAllNodes indicates that all nodes have access to the device. Must only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.
allowMultipleAllocationsbooleanAllowMultipleAllocations marks whether the device is allowed to be allocated to multiple DeviceRequests. If AllowMultipleAllocations is set to true, the device can be allocated more than once, and...
attributes{ [key: string]: V1DeviceAttributeAttributes defines the set of attributes for this device. The name of each attribute must be unique in that set. The maximum number of attributes and capacities combined is 32.
bindingConditionsstring[]BindingConditions defines the conditions for proceeding with binding. All of these conditions must be set in the per-device status conditions with a value of True to proceed with binding the pod to...
bindingFailureConditionsstring[]BindingFailureConditions defines the conditions for binding failure. They may be set in the per-device status conditions. If any is set to "True", a binding failure occurred. The maximum number of...
bindsToNodebooleanBindsToNode indicates if the usage of an allocation involving this device has to be limited to exactly the node that was chosen when allocating the claim. If set to true, the scheduler will set the...
capacity{ [key: string]: V1DeviceCapacityCapacity defines the set of capacities for this device. The name of each capacity must be unique in that set. The maximum number of attributes and capacities combined is 32.
consumesCountersV1DeviceCounterConsumption[]ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets. There can only be a single entry per counterSet. The...
namestringName is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.
nodeNamestringNodeName identifies the node where the device is available. Must only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.
taintsV1DeviceTaint[]If specified, these are the driver-defined taints. The maximum number of taints is 16. If taints are set for any device in a ResourceSlice, then the maximum number of allowed devices per...
nodeSelectorV1NodeSelector

V1DeviceAttribute

  • DeviceAttribute must have exactly one field set.

Source

PropertyTypeDescription
boolbooleanBoolValue is a true/false value.
_intnumberIntValue is a number.
stringstringStringValue is a string. Must not be longer than 64 characters.
versionstringVersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.

V1DeviceCapacity

  • DeviceCapacity describes a quantity associated with a device.

Source

PropertyTypeDescription
valuestringValue defines how much of a certain capacity that device has. This field reflects the fixed total capacity and does not change. The consumed amount is tracked separately by scheduler and does not...
requestPolicyV1CapacityRequestPolicy

V1DeviceClaim

  • DeviceClaim defines how to request devices with a ResourceClaim.

Source

PropertyTypeDescription
configV1DeviceClaimConfiguration[]This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.
constraintsV1DeviceConstraint[]These constraints must be satisfied by the set of devices that get allocated for the claim.
requestsV1DeviceRequest[]Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.

V1DeviceClaimConfiguration

  • DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.

Source

PropertyTypeDescription
requestsstring[]Requests lists the names of requests where the configuration applies. If empty, it applies to all requests. References to subrequests must include the name of the main request and may include the...
opaqueV1OpaqueDeviceConfiguration

V1DeviceClass

  • DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1DeviceClassSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1Api);

const body: k8s.V1DeviceClass = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createDeviceClass({ body });
console.log(res.metadata?.name);

Used by: ResourceV1Api.createDeviceClass · ResourceV1Api.patchDeviceClass · ResourceV1Api.readDeviceClass

V1DeviceClassConfiguration

  • DeviceClassConfiguration is used in DeviceClass.

Source

PropertyTypeDescription
opaqueV1OpaqueDeviceConfiguration

V1DeviceClassList

  • DeviceClassList is a collection of classes.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1DeviceClass[]Items is the list of resource classes.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1Api);

const res: k8s.V1DeviceClassList = await api.listDeviceClass({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1Api.listDeviceClass

V1DeviceClassSpec

  • DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.

Source

PropertyTypeDescription
configV1DeviceClassConfiguration[]Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor...
extendedResourceNamestringExtendedResourceName is the extended resource name for the devices of this class. The devices of this class can be used to satisfy a pod's extended resource requests. It has the same format as the...
selectorsV1DeviceSelector[]Each selector must be satisfied by a device which is claimed via this class.

V1DeviceConstraint

  • DeviceConstraint must have exactly one field set besides Requests.

Source

PropertyTypeDescription
distinctAttributestringDistinctAttribute requires that all devices in question have this attribute and that its type and value are unique across those devices. This acts as the inverse of MatchAttribute. This constraint...
matchAttributestringMatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices. For example, if you specified "dra.example.com/numa" (a...
requestsstring[]Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint....

V1DeviceCounterConsumption

  • DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.

Source

PropertyTypeDescription
counterSetstringCounterSet is the name of the set from which the counters defined will be consumed.
counters{ [key: string]: V1CounterCounters defines the counters that will be consumed by the device. The maximum number of counters is 32.

V1DeviceRequest

  • DeviceRequest is a request for devices required for a claim. This is typically a request for a single resource like a device, but can also ask for several identical devices. With FirstAvailable it is also possible to provide a prioritized list of requests.

Source

PropertyTypeDescription
firstAvailableV1DeviceSubRequest[]FirstAvailable contains subrequests, of which exactly one will be selected by the scheduler. It tries to satisfy them in the order in which they are listed here. So if there are two entries in the...
namestringName can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim. References using the name in the DeviceRequest will uniquely identify a...
exactlyV1ExactDeviceRequest

V1DeviceSelector

  • DeviceSelector must have exactly one field set.

Source

PropertyTypeDescription
celV1CELDeviceSelector

V1DeviceSubRequest

  • DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices. DeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.

Source

PropertyTypeDescription
allocationModestringAllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are: - ExactCount: This request is for a specific number of devices. This is the...
countnumberCount is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
deviceClassNamestringDeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest. A class is required. Which classes are available...
namestringName can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format
/. Must be a DNS label.
selectorsV1DeviceSelector[]Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.
tolerationsV1DeviceToleration[]If specified, the request's tolerations. Tolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute. In addition, should any of...
capacityV1CapacityRequirements

V1DeviceTaint

  • The device this taint is attached to has the "effect" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.

Source

PropertyTypeDescription
effectstringThe effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are None, NoSchedule and NoExecute. PreferNoSchedule as used for nodes...
keystringThe taint key to be applied to a device. Must be a label name.
timeAddedDateTimeAdded represents the time at which the taint was added. Added automatically during create or update if not set.
valuestringThe taint value corresponding to the taint key. Must be a label value.

V1DeviceToleration

  • The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator .

Source

PropertyTypeDescription
effectstringEffect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.
keystringKey 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. Must be a...
operatorstringOperator 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 ResourceClaim can tolerate all...
tolerationSecondsnumberTolerationSeconds 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...
valuestringValue is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.

V1DownwardAPIProjection

  • Represents downward API info for projecting into a projected volume. Note that this is identical to a downwardAPI volume source without the default mode.

Source

PropertyTypeDescription
itemsV1DownwardAPIVolumeFile[]Items is a list of DownwardAPIVolume file

V1DownwardAPIVolumeFile

  • DownwardAPIVolumeFile represents information to create the file containing the pod field

Source

PropertyTypeDescription
modenumberOptional: mode bits used to set permissions on this file, must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON requires...
pathstringRequired: Path is the relative path name of the file to be created. Must not be absolute or contain the '..' path. Must be utf-8 encoded. The first item of the relative path must not start with...
fieldRefV1ObjectFieldSelector
resourceFieldRefV1ResourceFieldSelector

V1DownwardAPIVolumeSource

  • DownwardAPIVolumeSource represents a volume containing downward API info. Downward API volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
defaultModenumberOptional: mode bits to use on created files by default. Must be a Optional: mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal...
itemsV1DownwardAPIVolumeFile[]Items is a list of downward API volume file

V1EmptyDirVolumeSource

  • Represents an empty directory for a pod. Empty directory volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
mediumstringmedium represents what type of storage medium should back this directory. The default is "" which means to use the node's default medium. Must be an empty string (default) or Memory. More info:...
sizeLimitstringsizeLimit is the total amount of local storage required for this EmptyDir volume. The size limit is also applicable for memory medium. The maximum usage on memory medium EmptyDir would be the minimum...

V1EnvFromSource

  • EnvFromSource represents the source of a set of ConfigMaps or Secrets

Source

PropertyTypeDescription
prefixstringOptional text to prepend to the name of each environment variable. May consist of any printable ASCII characters except '='.
configMapRefV1ConfigMapEnvSource
secretRefV1SecretEnvSource

V1EnvVar

  • EnvVar represents an environment variable present in a Container.

Source

PropertyTypeDescription
namestringName of the environment variable. May consist of any printable ASCII characters except '='.
valuestringVariable references $(VAR_NAME) are expanded using the previously defined environment variables in the container and any service environment variables. If a variable cannot be resolved, the reference...
valueFromV1EnvVarSource

V1EnvVarSource

  • EnvVarSource represents a source for the value of an EnvVar.

Source

PropertyTypeDescription
configMapKeyRefV1ConfigMapKeySelector
fieldRefV1ObjectFieldSelector
fileKeyRefV1FileKeySelector
resourceFieldRefV1ResourceFieldSelector
secretKeyRefV1SecretKeySelector

V1EphemeralContainer

  • An EphemeralContainer is a temporary container that you may add to an existing Pod for user-initiated activities such as debugging. Ephemeral containers have no resource or scheduling guarantees, and they will not be restarted when they exit or when a Pod is removed or restarted. The kubelet may evict a Pod if an ephemeral container causes the Pod to exceed its resource allocation. To add an ephemeral container, use the ephemeralcontainers subresource of an existing Pod. Ephemeral containers may not be removed or restarted.

Source

PropertyTypeDescription
argsstring[]Arguments to the entrypoint. The image's CMD is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable cannot be resolved, the...
commandstring[]Entrypoint array. Not executed within a shell. The image's ENTRYPOINT is used if this is not provided. Variable references $(VAR_NAME) are expanded using the container's environment. If a variable...
envV1EnvVar[]List of environment variables to set in the container. Cannot be updated.
envFromV1EnvFromSource[]List of sources to populate environment variables in the container. The keys defined within a source may consist of any printable ASCII characters except '='. When a key exists in multiple sources,...
imagestringContainer image name. More info: https://kubernetes.io/docs/concepts/containers/images
imagePullPolicystringImage pull policy. One of Always, Never, IfNotPresent. Defaults to Always if :latest tag is specified, or IfNotPresent otherwise. Cannot be updated. More info:...
namestringName of the ephemeral container specified as a DNS_LABEL. This name must be unique among all containers, init containers and ephemeral containers.
portsV1ContainerPort[]Ports are not allowed for ephemeral containers.
resizePolicyV1ContainerResizePolicy[]Resources resize policy for the container.
restartPolicystringRestart policy for the container to manage the restart behavior of each container within a pod. You cannot set this field on ephemeral containers.
restartPolicyRulesV1ContainerRestartRule[]Represents a list of rules to be checked to determine if the container should be restarted on exit. You cannot set this field on ephemeral containers.
stdinbooleanWhether this container should allocate a buffer for stdin in the container runtime. If this is not set, reads from stdin in the container will always result in EOF. Default is false.
stdinOncebooleanWhether the container runtime should close the stdin channel after it has been opened by a single attach. When stdin is true the stdin stream will remain open across multiple attach sessions. If...
targetContainerNamestringIf set, the name of the container from PodSpec that this ephemeral container targets. The ephemeral container will be run in the namespaces (IPC, PID, etc) of this container. If not set then the...
terminationMessagePathstringOptional: Path at which the file to which the container's termination message will be written is mounted into the container's filesystem. Message written is intended to be brief final status, such...
terminationMessagePolicystringIndicate how the termination message should be populated. File will use the contents of terminationMessagePath to populate the container status message on both success and failure....
ttybooleanWhether this container should allocate a TTY for itself, also requires 'stdin' to be true. Default is false.
volumeDevicesV1VolumeDevice[]volumeDevices is the list of block devices to be used by the container.
volumeMountsV1VolumeMount[]Pod volumes to mount into the container's filesystem. Subpath mounts are not allowed for ephemeral containers. Cannot be updated.
workingDirstringContainer's working directory. If not specified, the container runtime's default will be used, which might be configured in the container image. Cannot be updated.
lifecycleV1Lifecycle
livenessProbeV1Probe
readinessProbeV1Probe
resourcesV1ResourceRequirements
securityContextV1SecurityContext
startupProbeV1Probe

V1EphemeralVolumeSource

  • Represents an ephemeral volume that is handled by a normal storage driver.

Source

PropertyTypeDescription
volumeClaimTemplateV1PersistentVolumeClaimTemplate

V1Eviction

  • Eviction evicts a pod from its node subject to certain policies and safety constraints. This is a subresource of Pod. A request to cause such an eviction is created by POSTing to .../pods//evictions.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
deleteOptionsV1DeleteOptions
metadataV1ObjectMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CoreV1Api);

const body: k8s.V1Eviction = {
metadata: { name: 'example' },
};
const res = await api.createNamespacedPodEviction({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: CoreV1Api.createNamespacedPodEviction

V1ExactDeviceRequest

  • ExactDeviceRequest is a request for one or more identical devices.

Source

PropertyTypeDescription
adminAccessbooleanAdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They...
allocationModestringAllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are: - ExactCount: This request is for a specific number of devices. This is the...
countnumberCount is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
deviceClassNamestringDeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request. A DeviceClassName is required. Administrators may use...
selectorsV1DeviceSelector[]Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.
tolerationsV1DeviceToleration[]If specified, the request's tolerations. Tolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute. In addition, should any of...
capacityV1CapacityRequirements

V1ExecAction

  • ExecAction describes a "run in container" action.

Source

PropertyTypeDescription
commandstring[]Command is the command line to execute inside the container, the working directory for the command is root ('/') in the container's filesystem. The command is simply exec'd, it is not run inside...

V1ExemptPriorityLevelConfiguration

  • ExemptPriorityLevelConfiguration describes the configurable aspects of the handling of exempt requests. In the mandatory exempt configuration object the values in the fields here can be modified by authorized users, unlike the rest of the spec.

Source

PropertyTypeDescription
lendablePercentnumberlendablePercent prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. This value of this field must be between 0 and 100, inclusive, and it defaults to...
nominalConcurrencySharesnumbernominalConcurrencyShares (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats nominally reserved for this priority...

V1ExpressionWarning

  • ExpressionWarning is a warning information that targets a specific expression.

Source

PropertyTypeDescription
fieldRefstringThe path to the field that refers the expression. For example, the reference to the expression of the first item of validations is "spec.validations[0].expression"
warningstringThe content of type checking information in a human-readable form. Each line of the warning contains the type that the expression is checked against, followed by the type check error from the...

V1ExternalDocumentation

  • ExternalDocumentation allows referencing an external resource for extended documentation.

Source

PropertyTypeDescription
descriptionstring
urlstring

V1FCVolumeSource

  • Represents a Fibre Channel volume. Fibre Channel volumes can only be mounted as read/write once. Fibre Channel volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
lunnumberlun is Optional: FC target lun number
readOnlybooleanreadOnly is Optional: Defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
targetWWNsstring[]targetWWNs is Optional: FC target worldwide names (WWNs)
wwidsstring[]wwids Optional: FC volume world wide identifiers (wwids) Either wwids or combination of targetWWNs and lun must be set, but not both simultaneously.

V1FieldSelectorAttributes

  • FieldSelectorAttributes indicates a field limited access. Webhook authors are encouraged to * ensure rawSelector and requirements are not both set * consider the requirements field if set * not try to parse or consider the rawSelector field if set. This is to avoid another CVE-2022-2880 (i.e. getting different systems to agree on how exactly to parse a query is not something we want), see https://www.oxeye.io/resources/golang-parameter-smuggling-attack for more details. For the *SubjectAccessReview endpoints of the kube-apiserver: * If rawSelector is empty and requirements are empty, the request is not limited. * If rawSelector is present and requirements are empty, the rawSelector will be parsed and limited if the parsing succeeds. * If rawSelector is empty and requirements are present, the requirements should be honored * If rawSelector is present and requirements are present, the request is invalid.

Source

PropertyTypeDescription
rawSelectorstringrawSelector is the serialization of a field selector that would be included in a query parameter. Webhook implementations are encouraged to ignore rawSelector. The kube-apiserver's...
requirementsV1FieldSelectorRequirement[]requirements is the parsed interpretation of a field selector. All requirements must be met for a resource instance to match the selector. Webhook implementations should handle requirements, but how...

V1FieldSelectorRequirement

  • FieldSelectorRequirement is a selector that contains values, a key, and an operator that relates the key and values.

Source

PropertyTypeDescription
keystringkey is the field selector key that the requirement applies to.
operatorstringoperator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist. The list of operators may grow in the future.
valuesstring[]values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty.

V1FileKeySelector

  • FileKeySelector selects a key of the env file.

Source

PropertyTypeDescription
keystringThe key within the env file. An invalid key will prevent the pod from starting. The keys defined within a source may consist of any printable ASCII characters except '='. During Alpha stage of the...
optionalbooleanSpecify whether the file or its key must be defined. If the file or key does not exist, then the env var is not published. If optional is set to true and the specified key does not exist, the...
pathstringThe path within the volume from which to select the file. Must be relative and may not contain the '..' path or start with '..'.
volumeNamestringThe name of the volume mount containing the env file.

V1FlexPersistentVolumeSource

  • FlexPersistentVolumeSource represents a generic persistent volume resource that is provisioned/attached using an exec based plugin.

Source

PropertyTypeDescription
driverstringdriver is the name of the driver to use for this volume.
fsTypestringfsType is the Filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default filesystem depends on FlexVolume script.
options{ [key: string]: stringoptions is Optional: this field holds extra command options if any.
readOnlybooleanreadOnly is Optional: defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
secretRefV1SecretReference

V1FlexVolumeSource

  • FlexVolume represents a generic volume resource that is provisioned/attached using an exec based plugin.

Source

PropertyTypeDescription
driverstringdriver is the name of the driver to use for this volume.
fsTypestringfsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default filesystem depends on FlexVolume script.
options{ [key: string]: stringoptions is Optional: this field holds extra command options if any.
readOnlybooleanreadOnly is Optional: defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
secretRefV1LocalObjectReference

V1FlockerVolumeSource

  • Represents a Flocker volume mounted by the Flocker agent. One and only one of datasetName and datasetUUID should be set. Flocker volumes do not support ownership management or SELinux relabeling.

Source

PropertyTypeDescription
datasetNamestringdatasetName is Name of the dataset stored as metadata -> name on the dataset for Flocker should be considered as deprecated
datasetUUIDstringdatasetUUID is the UUID of the dataset. This is unique identifier of a Flocker dataset

V1FlowDistinguisherMethod

  • FlowDistinguisherMethod specifies the method of a flow distinguisher.

Source

PropertyTypeDescription
typestringtype is the type of flow distinguisher method The supported types are "ByUser" and "ByNamespace". Required.

V1ForNode

  • ForNode provides information about which nodes should consume this endpoint.

Source

PropertyTypeDescription
namestringname represents the name of the node.

V1ForZone

  • ForZone provides information about which zones should consume this endpoint.

Source

PropertyTypeDescription
namestringname represents the name of the zone.

V1GCEPersistentDiskVolumeSource

  • Represents a Persistent Disk resource in Google Compute Engine. A GCE PD must exist before mounting to a container. The disk must also be in the same GCE project and zone as the kubelet. A GCE PD can only be mounted as read/write once or read-only many times. GCE PDs support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
fsTypestringfsType is filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly...
partitionnumberpartition is the partition in the volume that you want to mount. If omitted, the default is to mount by volume name. Examples: For volume /dev/sda1, you specify the partition as "1". Similarly, the...
pdNamestringpdName is unique name of the PD resource in GCE. Used to identify the disk in GCE. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk
readOnlybooleanreadOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#gcepersistentdisk

V1GRPCAction

  • GRPCAction specifies an action involving a GRPC service.

Source

PropertyTypeDescription
portnumberPort number of the gRPC service. Number must be in the range 1 to 65535.
servicestringService is the name of the service to place in the gRPC HealthCheckRequest (see https://github.com/grpc/grpc/blob/master/doc/health-checking.md). If this is not specified, the default behavior is...

V1GitRepoVolumeSource

  • Represents a volume that is populated with the contents of a git repository. Git repo volumes do not support ownership management. Git repo volumes support SELinux relabeling. DEPRECATED: GitRepo is deprecated. To provision a container with a git repo, mount an EmptyDir into an InitContainer that clones the repo using git, then mount the EmptyDir into the Pod's container.

Source

PropertyTypeDescription
directorystringdirectory is the target directory name. Must not contain or start with '..'. If '.' is supplied, the volume directory will be the git repository. Otherwise, if specified, the volume will...
repositorystringrepository is the URL
revisionstringrevision is the commit hash for the specified revision.

V1GlusterfsPersistentVolumeSource

  • Represents a Glusterfs mount that lasts the lifetime of a pod. Glusterfs volumes do not support ownership management or SELinux relabeling.

Source

PropertyTypeDescription
endpointsstringendpoints is the endpoint name that details Glusterfs topology. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
endpointsNamespacestringendpointsNamespace is the namespace that contains Glusterfs endpoint. If this field is empty, the EndpointNamespace defaults to the same namespace as the bound PVC. More info:...
pathstringpath is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
readOnlybooleanreadOnly here will force the Glusterfs volume to be mounted with read-only permissions. Defaults to false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

V1GlusterfsVolumeSource

  • Represents a Glusterfs mount that lasts the lifetime of a pod. Glusterfs volumes do not support ownership management or SELinux relabeling.

Source

PropertyTypeDescription
endpointsstringendpoints is the endpoint name that details Glusterfs topology.
pathstringpath is the Glusterfs volume path. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod
readOnlybooleanreadOnly here will force the Glusterfs volume to be mounted with read-only permissions. Defaults to false. More info: https://examples.k8s.io/volumes/glusterfs/README.md#create-a-pod

V1GroupResource

  • GroupResource specifies a Group and a Resource, but does not force a version. This is useful for identifying concepts during lookup stages without having partially valid types

Source

PropertyTypeDescription
groupstring
resourcestring

V1HTTPGetAction

  • HTTPGetAction describes an action based on HTTP Get requests.

Source

PropertyTypeDescription
hoststringHost name to connect to, defaults to the pod IP. You probably want to set "Host" in httpHeaders instead.
httpHeadersV1HTTPHeader[]Custom headers to set in the request. HTTP allows repeated headers.
pathstringPath to access on the HTTP server.
portIntOrStringIntOrString is a type that can hold an int32 or a string. When used in JSON or YAML marshalling and unmarshalling, it produces or consumes the inner type. This allows you to have, for example, a...
schemestringScheme to use for connecting to the host. Defaults to HTTP.

V1HTTPHeader

  • HTTPHeader describes a custom header to be used in HTTP probes

Source

PropertyTypeDescription
namestringThe header field name. This will be canonicalized upon output, so case-variant names will be understood as the same header.
valuestringThe header field value

V1HTTPIngressPath

  • HTTPIngressPath associates a path with a backend. Incoming urls matching the path are forwarded to the backend.

Source

PropertyTypeDescription
pathstringpath is matched against the path of an incoming request. Currently it can contain characters disallowed from the conventional "path" part of a URL as defined by RFC 3986. Paths must begin with a...
pathTypestringpathType determines the interpretation of the path matching. PathType can be one of the following values: * Exact: Matches the URL path exactly. * Prefix: Matches based on a URL path prefix split by...
backendV1IngressBackend

V1HTTPIngressRuleValue

  • HTTPIngressRuleValue is a list of http selectors pointing to backends. In the example: http:///? -> backend where where parts of the url correspond to RFC 3986, this resource will be used to match against everything after the last '/' and before the first '?' or '#'.

Source

PropertyTypeDescription
pathsV1HTTPIngressPath[]paths is a collection of paths that map requests to backends.

V1HostAlias

  • HostAlias holds the mapping between IP and hostnames that will be injected as an entry in the pod's hosts file.

Source

PropertyTypeDescription
hostnamesstring[]Hostnames for the above IP address.
ipstringIP address of the host file entry.

V1HostIP

  • HostIP represents a single IP address allocated to the host.

Source

PropertyTypeDescription
ipstringIP is the IP address assigned to the host

V1HostPathVolumeSource

  • Represents a host path mapped into a pod. Host path volumes do not support ownership management or SELinux relabeling.

Source

PropertyTypeDescription
pathstringpath of the directory on the host. If the path is a symlink, it will follow the link to the real path. More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath
typestringtype for HostPath Volume Defaults to "" More info: https://kubernetes.io/docs/concepts/storage/volumes#hostpath

V1IPBlock

  • IPBlock describes a particular CIDR (Ex. "192.168.1.0/24","2001:db8::/64") that is allowed to the pods matched by a NetworkPolicySpec's podSelector. The except entry describes CIDRs that should not be included within this rule.

Source

PropertyTypeDescription
cidrstringcidr is a string representing the IPBlock Valid examples are "192.168.1.0/24" or "2001:db8::/64"
exceptstring[]except is a slice of CIDRs that should not be included within an IPBlock Valid examples are "192.168.1.0/24" or "2001:db8::/64" Except values will be rejected if they are outside the cidr range

V1ISCSIPersistentVolumeSource

  • ISCSIPersistentVolumeSource represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
chapAuthDiscoverybooleanchapAuthDiscovery defines whether support iSCSI Discovery CHAP authentication
chapAuthSessionbooleanchapAuthSession defines whether support iSCSI Session CHAP authentication
fsTypestringfsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly...
initiatorNamestringinitiatorName is the custom iSCSI Initiator Name. If initiatorName is specified with iscsiInterface simultaneously, new iSCSI interface : will be created for the...
iqnstringiqn is Target iSCSI Qualified Name.
iscsiInterfacestringiscsiInterface is the interface Name that uses an iSCSI transport. Defaults to 'default' (tcp).
lunnumberlun is iSCSI Target Lun number.
portalsstring[]portals is the iSCSI Target Portal List. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
readOnlybooleanreadOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false.
targetPortalstringtargetPortal is iSCSI Target Portal. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
secretRefV1SecretReference

V1ISCSIVolumeSource

  • Represents an ISCSI disk. ISCSI volumes can only be mounted as read/write once. ISCSI volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
chapAuthDiscoverybooleanchapAuthDiscovery defines whether support iSCSI Discovery CHAP authentication
chapAuthSessionbooleanchapAuthSession defines whether support iSCSI Session CHAP authentication
fsTypestringfsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly...
initiatorNamestringinitiatorName is the custom iSCSI Initiator Name. If initiatorName is specified with iscsiInterface simultaneously, new iSCSI interface : will be created for the...
iqnstringiqn is the target iSCSI Qualified Name.
iscsiInterfacestringiscsiInterface is the interface Name that uses an iSCSI transport. Defaults to 'default' (tcp).
lunnumberlun represents iSCSI Target Lun number.
portalsstring[]portals is the iSCSI Target Portal List. The portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
readOnlybooleanreadOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false.
targetPortalstringtargetPortal is iSCSI Target Portal. The Portal is either an IP or ip_addr:port if the port is other than default (typically TCP ports 860 and 3260).
secretRefV1LocalObjectReference

V1ImageVolumeSource

  • ImageVolumeSource represents a image volume resource.

Source

PropertyTypeDescription
pullPolicystringPolicy for pulling OCI objects. Possible values are: Always: the kubelet always attempts to pull the reference. Container creation will fail If the pull fails. Never: the kubelet never pulls the...
referencestringRequired: Image or artifact reference to be used. Behaves in the same way as pod.spec.containers[*].image. Pull secrets will be assembled in the same way as for the container image by looking up node...

V1JSONSchemaProps

Source

PropertyTypeDescription
additionalItemsanyJSONSchemaPropsOrBool represents JSONSchemaProps or a boolean value. Defaults to true for the boolean property.
additionalPropertiesanyJSONSchemaPropsOrBool represents JSONSchemaProps or a boolean value. Defaults to true for the boolean property.
_defaultanydefault is a default value for undefined object fields. Defaulting is a beta feature under the CustomResourceDefaulting feature gate. Defaulting requires spec.preserveUnknownFields to be false.
exampleanyJSON represents any valid JSON value. These types are supported: bool, int64, float64, string, []interface{}, map[string]interface{} and nil.
formatstringformat is an OpenAPI v3 format string. Unknown formats are ignored. The following formats are validated: - bsonobjectid: a bson object ID, i.e. a 24 characters hex string - uri: an URI as parsed by...
itemsanyJSONSchemaPropsOrArray represents a value that can either be a JSONSchemaProps or an array of JSONSchemaProps. Mainly here for serialization purposes.
x_kubernetes_embedded_resourcebooleanx-kubernetes-embedded-resource defines that the value is an embedded Kubernetes runtime.Object, with TypeMeta and ObjectMeta. The type must be object. It is allowed to further restrict the embedded...
x_kubernetes_int_or_stringbooleanx-kubernetes-int-or-string specifies that this value is either an integer or a string. If this is true, an empty type is allowed and type as child of anyOf is permitted if following one of the...
x_kubernetes_list_map_keysstring[]x-kubernetes-list-map-keys annotates an array with the x-kubernetes-list-type map by specifying the keys used as the index of the map. This tag MUST only be used on lists that have the...
x_kubernetes_list_typestringx-kubernetes-list-type annotates an array to further describe its topology. This extension must only be used on lists and may have 3 possible values: 1) atomic: the list is treated as a single...
x_kubernetes_map_typestringx-kubernetes-map-type annotates an object to further describe its topology. This extension must only be used when type is object and may have 2 possible values: 1) granular: These maps are...
x_kubernetes_preserve_unknown_fieldsbooleanx-kubernetes-preserve-unknown-fields stops the API server decoding step from pruning fields which are not specified in the validation schema. This affects fields recursively, but switches back to...
x_kubernetes_validationsV1ValidationRule[]x-kubernetes-validations describes a list of validation rules written in the CEL expression language.
refstring
schemastring
allOfV1JSONSchemaProps[]
anyOfV1JSONSchemaProps[]
definitions{ [key: string]: V1JSONSchemaProps
dependencies{ [key: string]: any
descriptionstring
_enumany[]
exclusiveMaximumboolean
exclusiveMinimumboolean
externalDocsV1ExternalDocumentation
idstring
maxItemsnumber
maxLengthnumber
maxPropertiesnumber
maximumnumber
minItemsnumber
minLengthnumber
minPropertiesnumber
minimumnumber
multipleOfnumber
notV1JSONSchemaProps
nullableboolean
oneOfV1JSONSchemaProps[]
patternstring
patternProperties{ [key: string]: V1JSONSchemaProps
properties{ [key: string]: V1JSONSchemaProps
requiredstring[]
titlestring
typestring
uniqueItemsboolean

V1KeyToPath

  • Maps a string key to a path within a volume.

Source

PropertyTypeDescription
keystringkey is the key to project.
modenumbermode is Optional: mode bits used to set permissions on this file. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and decimal values, JSON...
pathstringpath is the relative path of the file to map the key to. May not be an absolute path. May not contain the path element '..'. May not start with the string '..'.

V1LabelSelector

  • A label selector is a label query over a set of resources. The result of matchLabels and matchExpressions are ANDed. An empty label selector matches all objects. A null label selector matches no objects.

Source

PropertyTypeDescription
matchExpressionsV1LabelSelectorRequirement[]matchExpressions is a list of label selector requirements. The requirements are ANDed.
matchLabels{ [key: string]: stringmatchLabels is a map of {key,value} pairs. A single {key,value} in the matchLabels map is equivalent to an element of matchExpressions, whose key field is "key", the operator is "In", and the...

V1LabelSelectorAttributes

  • LabelSelectorAttributes indicates a label limited access. Webhook authors are encouraged to * ensure rawSelector and requirements are not both set * consider the requirements field if set * not try to parse or consider the rawSelector field if set. This is to avoid another CVE-2022-2880 (i.e. getting different systems to agree on how exactly to parse a query is not something we want), see https://www.oxeye.io/resources/golang-parameter-smuggling-attack for more details. For the *SubjectAccessReview endpoints of the kube-apiserver: * If rawSelector is empty and requirements are empty, the request is not limited. * If rawSelector is present and requirements are empty, the rawSelector will be parsed and limited if the parsing succeeds. * If rawSelector is empty and requirements are present, the requirements should be honored * If rawSelector is present and requirements are present, the request is invalid.

Source

PropertyTypeDescription
rawSelectorstringrawSelector is the serialization of a field selector that would be included in a query parameter. Webhook implementations are encouraged to ignore rawSelector. The kube-apiserver's...
requirementsV1LabelSelectorRequirement[]requirements is the parsed interpretation of a label selector. All requirements must be met for a resource instance to match the selector. Webhook implementations should handle requirements, but how...

V1LabelSelectorRequirement

  • A label selector requirement is a selector that contains values, a key, and an operator that relates the key and values.

Source

PropertyTypeDescription
keystringkey is the label key that the selector applies to.
operatorstringoperator represents a key's relationship to a set of values. Valid operators are In, NotIn, Exists and DoesNotExist.
valuesstring[]values is an array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is...

V1Lifecycle

  • Lifecycle describes actions that the management system should take in response to container lifecycle events. For the PostStart and PreStop lifecycle handlers, management of the container blocks until the action is complete, unless the container process fails, in which case the handler is aborted.

Source

PropertyTypeDescription
stopSignalstringStopSignal defines which signal will be sent to a container when it is being stopped. If not specified, the default is defined by the container runtime in use. StopSignal can only be set for Pods...
postStartV1LifecycleHandler
preStopV1LifecycleHandler

V1LifecycleHandler

  • LifecycleHandler defines a specific action that should be taken in a lifecycle hook. One and only one of the fields, except TCPSocket must be specified.

Source

PropertyTypeDescription
execV1ExecAction
httpGetV1HTTPGetAction
sleepV1SleepAction
tcpSocketV1TCPSocketAction

V1LimitResponse

  • LimitResponse defines how to handle requests that can not be executed right now.

Source

PropertyTypeDescription
typestringtype is "Queue" or "Reject". "Queue" means that requests that can not be executed upon arrival are held in a queue until they can be executed or a queuing limit is reached. "Reject" means...
queuingV1QueuingConfiguration

V1LimitedPriorityLevelConfiguration

  • LimitedPriorityLevelConfiguration specifies how to handle requests that are subject to limits. It addresses two issues: - How are requests for this priority level limited? - What should be done with requests that exceed the limit?

Source

PropertyTypeDescription
borrowingLimitPercentnumberborrowingLimitPercent, if present, configures a limit on how many seats this priority level can borrow from other priority levels. The limit is known as this level's BorrowingConcurrencyLimit...
lendablePercentnumberlendablePercent prescribes the fraction of the level's NominalCL that can be borrowed by other priority levels. The value of this field must be between 0 and 100, inclusive, and it defaults to 0....
nominalConcurrencySharesnumbernominalConcurrencyShares (NCS) contributes to the computation of the NominalConcurrencyLimit (NominalCL) of this level. This is the number of execution seats available at this priority level. This...
limitResponseV1LimitResponse

V1LinuxContainerUser

  • LinuxContainerUser represents user identity information in Linux containers

Source

PropertyTypeDescription
gidnumberGID is the primary gid initially attached to the first process in the container
supplementalGroupsnumber[]SupplementalGroups are the supplemental groups initially attached to the first process in the container
uidnumberUID is the primary uid initially attached to the first process in the container

V1ListMeta

  • ListMeta describes metadata that synthetic resources must have, including lists and various status objects. A resource may have only one of {ObjectMeta, ListMeta}.

Source

PropertyTypeDescription
_continuestringcontinue may be set if the user set a limit on the number of items returned, and indicates that the server has more data available. The value is opaque and may be used to issue another request to the...
remainingItemCountnumberremainingItemCount is the number of subsequent items in the list which are not included in this list response. If the list request contained label or field selectors, then the number of remaining...
resourceVersionstringString that identifies the server's internal version of this object that can be used by clients to determine when objects have changed. Value must be treated as opaque by clients and passed...
selfLinkstringDeprecated: selfLink is a legacy read-only field that is no longer populated by the system.

V1LoadBalancerIngress

  • LoadBalancerIngress represents the status of a load-balancer ingress point: traffic intended for the service should be sent to an ingress point.

Source

PropertyTypeDescription
hostnamestringHostname is set for load-balancer ingress points that are DNS based (typically AWS load-balancers)
ipstringIP is set for load-balancer ingress points that are IP based (typically GCE or OpenStack load-balancers)
ipModestringIPMode specifies how the load-balancer IP behaves, and may only be specified when the ip field is specified. Setting this to "VIP" indicates that traffic is delivered to the node with the...
portsV1PortStatus[]Ports is a list of records of service ports If used, every port defined in the service should have an entry in it

V1LoadBalancerStatus

  • LoadBalancerStatus represents the status of a load-balancer.

Source

PropertyTypeDescription
ingressV1LoadBalancerIngress[]Ingress is a list containing ingress points for the load-balancer. Traffic intended for the service should be sent to these ingress points.

V1LocalObjectReference

  • LocalObjectReference contains enough information to let you locate the referenced object inside the same namespace.

Source

PropertyTypeDescription
namestringName of the referent. This field is effectively required, but due to backwards compatibility is allowed to be empty. Instances of this type with an empty value here are almost certainly wrong. More...

V1LocalVolumeSource

  • Local represents directly-attached storage with node affinity

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type to mount. It applies only when the Path is a block device. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". The default...
pathstringpath of the full path to the volume on the node. It can be either a directory or block device (disk, partition, ...).

V1ManagedFieldsEntry

  • ManagedFieldsEntry is a workflow-id, a FieldSet and the group version of the resource that the fieldset applies to.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the version of this resource that this field set applies to. The format is "group/version" just like the top-level APIVersion field. It is necessary to track the version of a...
fieldsTypestringFieldsType is the discriminator for the different fields format and version. There is currently only one possible value: "FieldsV1"
fieldsV1anyFieldsV1 holds the first JSON version format as described in the "FieldsV1" type.
managerstringManager is an identifier of the workflow managing these fields.
operationstringOperation is the type of operation which lead to this ManagedFieldsEntry being created. The only valid values for this field are 'Apply' and 'Update'.
subresourcestringSubresource is the name of the subresource used to update that object, or empty string if the object was updated through the main resource. The value of this field is used to distinguish between...
timeDateTime is the timestamp of when the ManagedFields entry was added. The timestamp will also be updated if a field is added, the manager changes any of the owned fields value or removes a field. The...

V1MatchCondition

  • MatchCondition represents a condition which must by fulfilled for a request to be sent to a webhook.

Source

PropertyTypeDescription
expressionstringExpression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL...
namestringName is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the...

V1MatchResources

  • MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)

Source

PropertyTypeDescription
excludeResourceRulesV1NamedRuleWithOperations[]ExcludeResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy should not care about. The exclude rules take precedence over include rules (if a resource...
matchPolicystringmatchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent". - Exact: match a request only if it exactly matches a...
resourceRulesV1NamedRuleWithOperations[]ResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy matches. The policy cares about an operation if it matches any Rule.
namespaceSelectorV1LabelSelector
objectSelectorV1LabelSelector

V1ModifyVolumeStatus

  • ModifyVolumeStatus represents the status object of ControllerModifyVolume operation

Source

PropertyTypeDescription
statusstringstatus is the status of the ControllerModifyVolume operation. It can be in any of following states: - Pending Pending indicates that the PersistentVolumeClaim cannot be modified due to unmet...
targetVolumeAttributesClassNamestringtargetVolumeAttributesClassName is the name of the VolumeAttributesClass the PVC currently being reconciled

V1MutatingWebhook

  • MutatingWebhook describes an admission webhook and the resources and operations it applies to.

Source

PropertyTypeDescription
admissionReviewVersionsstring[]AdmissionReviewVersions is an ordered list of preferred AdmissionReview versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions...
failurePolicystringFailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Fail.
matchConditionsV1MatchCondition[]MatchConditions is a list of conditions that must be met for a request to be sent to this webhook. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and...
matchPolicystringmatchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent". - Exact: match a request only if it exactly matches a specified rule....
namestringThe name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the...
reinvocationPolicystringreinvocationPolicy indicates whether this webhook should be called multiple times as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded". Never: the webhook will not...
rulesV1RuleWithOperations[]Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches any Rule. However, in order to prevent...
sideEffectsstringSideEffects states whether this webhook has side effects. Acceptable values are: None, NoneOnDryRun (webhooks created via v1beta1 may also specify Some or Unknown). Webhooks with side effects MUST...
timeoutSecondsnumberTimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be...
clientConfigAdmissionregistrationV1WebhookClientConfig
namespaceSelectorV1LabelSelector
objectSelectorV1LabelSelector

V1NFSVolumeSource

  • Represents an NFS mount that lasts the lifetime of a pod. NFS volumes do not support ownership management or SELinux relabeling.

Source

PropertyTypeDescription
pathstringpath that is exported by the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
readOnlybooleanreadOnly here will force the NFS export to be mounted with read-only permissions. Defaults to false. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs
serverstringserver is the hostname or IP address of the NFS server. More info: https://kubernetes.io/docs/concepts/storage/volumes#nfs

V1NamedRuleWithOperations

  • NamedRuleWithOperations is a tuple of Operations and Resources with ResourceNames.

Source

PropertyTypeDescription
apiGroupsstring[]APIGroups is the API groups the resources belong to. '' is all groups. If '' is present, the length of the slice must be one. Required.
apiVersionsstring[]APIVersions is the API versions the resources belong to. '' is all versions. If '' is present, the length of the slice must be one. Required.
operationsstring[]Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or * for all of those operations and any future admission operations that are added. If '*' is present,...
resourceNamesstring[]ResourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
resourcesstring[]Resources is a list of resources this rule applies to. For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '' means all resources, but not subresources. 'pods/_'...
scopestringscope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "*" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are...

V1NonResourceAttributes

  • NonResourceAttributes includes the authorization attributes available for non-resource requests to the Authorizer interface

Source

PropertyTypeDescription
pathstringPath is the URL path of the request
verbstringVerb is the standard HTTP verb

V1NonResourcePolicyRule

  • NonResourcePolicyRule is a predicate that matches non-resource requests according to their verb and the target non-resource URL. A NonResourcePolicyRule matches a request if and only if both (a) at least one member of verbs matches the request and (b) at least one member of nonResourceURLs matches the request.

Source

PropertyTypeDescription
nonResourceURLsstring[]nonResourceURLs is a set of url prefixes that a user should have access to and may not be empty. For example: - "/healthz" is legal - "/hea*" is illegal - "/hea" is legal but matches...
verbsstring[]verbs is a list of matching verbs and may not be empty. "*" matches all verbs. If it is present, it must be the only entry. Required.

V1NonResourceRule

  • NonResourceRule holds information that describes a rule for the non-resource

Source

PropertyTypeDescription
nonResourceURLsstring[]NonResourceURLs is a set of partial urls that a user should have access to. s are allowed, but only as the full, final step in the path. "" means all.
verbsstring[]Verb is a list of kubernetes non-resource API verbs, like: get, post, put, delete, patch, head, options. "*" means all.

V1ObjectFieldSelector

  • ObjectFieldSelector selects an APIVersioned field of an object.

Source

PropertyTypeDescription
apiVersionstringVersion of the schema the FieldPath is written in terms of, defaults to "v1".
fieldPathstringPath of the field to select in the specified API version.

V1ObjectMeta

  • ObjectMeta is metadata that all persisted resources must have, which includes all objects users must create.

Source

PropertyTypeDescription
annotations{ [key: string]: stringAnnotations is an unstructured key value map stored with a resource that may be set by external tools to store and retrieve arbitrary metadata. They are not queryable and should be preserved when...
creationTimestampDateCreationTimestamp is a timestamp representing the server time when this object was created. It is not guaranteed to be set in happens-before order across separate operations. Clients may not set this...
deletionGracePeriodSecondsnumberNumber of seconds allowed for this object to gracefully terminate before it will be removed from the system. Only set when deletionTimestamp is also set. May only be shortened. Read-only.
deletionTimestampDateDeletionTimestamp is RFC 3339 date and time at which this resource will be deleted. This field is set by the server when a graceful deletion is requested by the user, and is not directly settable by...
finalizersstring[]Must be empty before the object is deleted from the registry. Each entry is an identifier for the responsible component that will remove the entry from the list. If the deletionTimestamp of the...
generateNamestringGenerateName is an optional prefix, used by the server, to generate a unique name ONLY IF the Name field has not been provided. If this field is used, the name returned to the client will be...
generationnumberA sequence number representing a specific generation of the desired state. Populated by the system. Read-only.
labels{ [key: string]: stringMap of string keys and values that can be used to organize and categorize (scope and select) objects. May match selectors of replication controllers and services. More info:...
managedFieldsV1ManagedFieldsEntry[]ManagedFields maps workflow-id and version to the set of fields that are managed by that workflow. This is mostly for internal housekeeping, and users typically shouldn't need to set or understand...
namestringName must be unique within a namespace. Is required when creating resources, although some resources may allow a client to request the generation of an appropriate name automatically. Name is...
namespacestringNamespace defines the space within which each name must be unique. An empty namespace is equivalent to the "default" namespace, but "default" is the canonical representation. Not all objects are...
ownerReferencesV1OwnerReference[]List of objects depended by this object. If ALL objects in the list have been deleted, this object will be garbage collected. If this object is managed by a controller, then an entry in this list...
resourceVersionstringAn opaque value that represents the internal version of this object that can be used by clients to determine when objects have changed. May be used for optimistic concurrency, change detection, and...
selfLinkstringDeprecated: selfLink is a legacy read-only field that is no longer populated by the system.
uidstringUID is the unique in time and space value for this object. It is typically generated by the server on successful creation of a resource and is not allowed to change on PUT operations. Populated by...

V1ObjectReference

  • ObjectReference contains enough information to let you inspect or modify the referred object.

Source

PropertyTypeDescription
apiVersionstringAPI version of the referent.
fieldPathstringIf referring to a piece of an object instead of an entire object, this string should contain a valid JSON/Go field access statement, such as desiredState.manifest.containers[2]. For example, if the...
kindstringKind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
namestringName of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
namespacestringNamespace of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces/
resourceVersionstringSpecific resourceVersion to which this reference is made, if any. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency
uidstringUID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#uids

V1OpaqueDeviceConfiguration

  • OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.

Source

PropertyTypeDescription
driverstringDriver is used to determine which kubelet plugin needs to be passed these configuration parameters. An admission policy provided by the driver developer could use this to decide whether it needs to...
parametersanyParameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version ("kind" +...

V1Overhead

  • Overhead structure represents the resource overhead associated with running a pod.

Source

PropertyTypeDescription
podFixed{ [key: string]: stringpodFixed represents the fixed resource overhead associated with running a pod.

V1OwnerReference

  • OwnerReference contains enough information to let you identify an owning object. An owning object must be in the same namespace as the dependent, or be cluster-scoped, so there is no namespace field.

Source

PropertyTypeDescription
apiVersionstringAPI version of the referent.
blockOwnerDeletionbooleanIf true, AND if the owner has the "foregroundDeletion" finalizer, then the owner cannot be deleted from the key-value store until this reference is removed. See...
controllerbooleanIf true, this reference points to the managing controller.
kindstringKind of the referent. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
namestringName of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names
uidstringUID of the referent. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids

V1ParamKind

  • ParamKind is a tuple of Group Kind and Version.

Source

PropertyTypeDescription
apiVersionstringAPIVersion is the API group version the resources belong to. In format of "group/version". Required.
kindstringKind is the API kind the resources belong to. Required.

V1ParamRef

  • ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.

Source

PropertyTypeDescription
namestringname is the name of the resource being referenced. One of name or selector must be set, but name and selector are mutually exclusive properties. If one is set, the other must be unset. A...
namespacestringnamespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both name and selector fields. A per-namespace parameter may be...
parameterNotFoundActionstringparameterNotFoundAction controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to...
selectorV1LabelSelector

V1ParentReference

  • ParentReference describes a reference to a parent object.

Source

PropertyTypeDescription
groupstringGroup is the group of the object being referenced.
namestringName is the name of the object being referenced.
namespacestringNamespace is the namespace of the object being referenced.
resourcestringResource is the resource of the object being referenced.

V1PhotonPersistentDiskVolumeSource

  • Represents a Photon Controller persistent disk resource.

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
pdIDstringpdID is the ID that identifies Photon Controller persistent disk

V1PolicyRule

  • PolicyRule holds information that describes a policy rule, but does not contain information about who the rule applies to or which namespace the rule applies to.

Source

PropertyTypeDescription
apiGroupsstring[]APIGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be...
nonResourceURLsstring[]NonResourceURLs is a set of partial urls that a user should have access to. *s are allowed, but only as the full, final step in the path Since non-resource URLs are not namespaced, this field is...
resourceNamesstring[]ResourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
resourcesstring[]Resources is a list of resources this rule applies to. '*' represents all resources.
verbsstring[]Verbs is a list of Verbs that apply to ALL the ResourceKinds contained in this rule. '*' represents all verbs.

V1PolicyRulesWithSubjects

  • PolicyRulesWithSubjects prescribes a test that applies to a request to an apiserver. The test considers the subject making the request, the verb being requested, and the resource to be acted upon. This PolicyRulesWithSubjects matches a request if and only if both (a) at least one member of subjects matches the request and (b) at least one member of resourceRules or nonResourceRules matches the request.

Source

PropertyTypeDescription
nonResourceRulesV1NonResourcePolicyRule[]nonResourceRules is a list of NonResourcePolicyRules that identify matching requests according to their verb and the target non-resource URL.
resourceRulesV1ResourcePolicyRule[]resourceRules is a slice of ResourcePolicyRules that identify matching requests according to their verb and the target resource. At least one of resourceRules and nonResourceRules has to be...
subjectsFlowcontrolV1Subject[]subjects is the list of normal user, serviceaccount, or group that this rule cares about. There must be at least one member in this slice. A slice that includes both the system:authenticated and...

V1PortStatus

  • PortStatus represents the error condition of a service port

Source

PropertyTypeDescription
errorstringError is to record the problem with the service port The format of the error shall comply with the following rules: - built-in error values shall be specified in this file and those shall use ...
portnumberPort is the port number of the service port of which status is recorded here
protocolstringProtocol is the protocol of the service port of which status is recorded here The supported values are: "TCP", "UDP", "SCTP"

V1PortworxVolumeSource

  • PortworxVolumeSource represents a Portworx volume resource.

Source

PropertyTypeDescription
fsTypestringfSType represents the filesystem type to mount Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs". Implicitly inferred to be "ext4" if unspecified.
readOnlybooleanreadOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
volumeIDstringvolumeID uniquely identifies a Portworx volume

V1Preconditions

  • Preconditions must be fulfilled before an operation (update, delete, etc.) is carried out.

Source

PropertyTypeDescription
resourceVersionstringSpecifies the target ResourceVersion
uidstringSpecifies the target UID.

V1PreferredSchedulingTerm

  • An empty preferred scheduling term matches all objects with implicit weight 0 (i.e. it's a no-op). A null preferred scheduling term matches no objects (i.e. is also a no-op).

Source

PropertyTypeDescription
weightnumberWeight associated with matching the corresponding nodeSelectorTerm, in the range 1-100.
preferenceV1NodeSelectorTerm

V1Probe

  • Probe describes a health check to be performed against a container to determine whether it is alive or ready to receive traffic.

Source

PropertyTypeDescription
failureThresholdnumberMinimum consecutive failures for the probe to be considered failed after having succeeded. Defaults to 3. Minimum value is 1.
initialDelaySecondsnumberNumber of seconds after the container has started before liveness probes are initiated. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
periodSecondsnumberHow often (in seconds) to perform the probe. Default to 10 seconds. Minimum value is 1.
successThresholdnumberMinimum consecutive successes for the probe to be considered successful after having failed. Defaults to 1. Must be 1 for liveness and startup. Minimum value is 1.
terminationGracePeriodSecondsnumberOptional duration in seconds the pod needs to terminate gracefully upon probe failure. The grace period is the duration in seconds after the processes running in the pod are sent a termination signal...
timeoutSecondsnumberNumber of seconds after which the probe times out. Defaults to 1 second. Minimum value is 1. More info: https://kubernetes.io/docs/concepts/workloads/pods/pod-lifecycle#container-probes
execV1ExecAction
grpcV1GRPCAction
httpGetV1HTTPGetAction
tcpSocketV1TCPSocketAction

V1ProjectedVolumeSource

  • Represents a projected volume source

Source

PropertyTypeDescription
defaultModenumberdefaultMode are the mode bits used to set permissions on created files by default. Must be an octal value between 0000 and 0777 or a decimal value between 0 and 511. YAML accepts both octal and...
sourcesV1VolumeProjection[]sources is the list of volume projections. Each entry in this list handles one source.

V1QueuingConfiguration

  • QueuingConfiguration holds the configuration parameters for queuing

Source

PropertyTypeDescription
handSizenumberhandSize is a small positive number that configures the shuffle sharding of requests into queues. When enqueuing a request at this priority level the request's flow identifier (a string pair) is...
queueLengthLimitnumberqueueLengthLimit is the maximum number of requests allowed to be waiting in a given queue of this priority level at a time; excess requests are rejected. This value must be positive. If not...
queuesnumberqueues is the number of queues for this priority level. The queues exist independently at each apiserver. The value must be positive. Setting it to 1 effectively precludes shufflesharding and thus...

V1QuobyteVolumeSource

  • Represents a Quobyte mount that lasts the lifetime of a pod. Quobyte volumes do not support ownership management or SELinux relabeling.

Source

PropertyTypeDescription
groupstringgroup to map volume access to Default is no group
readOnlybooleanreadOnly here will force the Quobyte volume to be mounted with read-only permissions. Defaults to false.
registrystringregistry represents a single or multiple Quobyte Registry services specified as a string as host:port pair (multiple entries are separated with commas) which acts as the central registry for volumes
tenantstringtenant owning the given Quobyte volume in the Backend Used with dynamically provisioned Quobyte volumes, value is set by the plugin
userstringuser to map volume access to Defaults to serivceaccount user
volumestringvolume is a string that references an already created Quobyte volume by name.

V1RBDPersistentVolumeSource

  • Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly...
imagestringimage is the rados image name. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
keyringstringkeyring is the path to key ring for RBDUser. Default is /etc/ceph/keyring. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
monitorsstring[]monitors is a collection of Ceph monitors. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
poolstringpool is the rados pool name. Default is rbd. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
readOnlybooleanreadOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
userstringuser is the rados user name. Default is admin. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
secretRefV1SecretReference

V1RBDVolumeSource

  • Represents a Rados Block Device mount that lasts the lifetime of a pod. RBD volumes support ownership management and SELinux relabeling.

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type of the volume that you want to mount. Tip: Ensure that the filesystem type is supported by the host operating system. Examples: "ext4", "xfs", "ntfs". Implicitly...
imagestringimage is the rados image name. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
keyringstringkeyring is the path to key ring for RBDUser. Default is /etc/ceph/keyring. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
monitorsstring[]monitors is a collection of Ceph monitors. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
poolstringpool is the rados pool name. Default is rbd. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
readOnlybooleanreadOnly here will force the ReadOnly setting in VolumeMounts. Defaults to false. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
userstringuser is the rados user name. Default is admin. More info: https://examples.k8s.io/volumes/rbd/README.md#how-to-use-it
secretRefV1LocalObjectReference

V1ResourceAttributes

  • ResourceAttributes includes the authorization attributes available for resource requests to the Authorizer interface

Source

PropertyTypeDescription
groupstringGroup is the API Group of the Resource. "*" means all.
namestringName is the name of the resource being requested for a "get" or deleted for a "delete". "" (empty) means all.
namespacestringNamespace is the namespace of the action being requested. Currently, there is no distinction between no namespace and all namespaces "" (empty) is defaulted for LocalSubjectAccessReviews ""...
resourcestringResource is one of the existing resource types. "*" means all.
subresourcestringSubresource is one of the existing resource types. "" means none.
verbstringVerb is a kubernetes resource API verb, like: get, list, watch, create, update, delete, proxy. "*" means all.
versionstringVersion is the API Version of the Resource. "*" means all.
fieldSelectorV1FieldSelectorAttributes
labelSelectorV1LabelSelectorAttributes

V1ResourceClaim

  • ResourceClaim references one entry in PodSpec.ResourceClaims.

Source

PropertyTypeDescription
namestringName must match the name of one entry in pod.spec.resourceClaims of the Pod where this field is used. It makes that resource available inside a container.
requeststringRequest is the name chosen for a request in the referenced claim. If empty, everything from the claim is made available, otherwise only the result of this request.

V1ResourceClaimList

  • ResourceClaimList is a collection of claims.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsResourceV1ResourceClaim[]Items is the list of resource claims.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1Api);

const res: k8s.V1ResourceClaimList = await api.listNamespacedResourceClaim({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1Api.listNamespacedResourceClaim · ResourceV1Api.listResourceClaimForAllNamespaces

V1ResourceClaimSpec

  • ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.

Source

PropertyTypeDescription
devicesV1DeviceClaim

V1ResourceClaimTemplate

  • ResourceClaimTemplate is used to produce ResourceClaim objects. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1ResourceClaimTemplateSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1Api);

const body: k8s.V1ResourceClaimTemplate = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedResourceClaimTemplate({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: ResourceV1Api.createNamespacedResourceClaimTemplate · ResourceV1Api.patchNamespacedResourceClaimTemplate · ResourceV1Api.readNamespacedResourceClaimTemplate

V1ResourceClaimTemplateList

  • ResourceClaimTemplateList is a collection of claim templates.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1ResourceClaimTemplate[]Items is the list of resource claim templates.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1Api);

const res: k8s.V1ResourceClaimTemplateList = await api.listNamespacedResourceClaimTemplate({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1Api.listNamespacedResourceClaimTemplate · ResourceV1Api.listResourceClaimTemplateForAllNamespaces

V1ResourceClaimTemplateSpec

  • ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.

Source

PropertyTypeDescription
metadataV1ObjectMeta
specV1ResourceClaimSpec

V1ResourceFieldSelector

  • ResourceFieldSelector represents container resources (cpu, memory) and their output format

Source

PropertyTypeDescription
containerNamestringContainer name: required for volumes, optional for env vars
divisorstringSpecifies the output format of the exposed resources, defaults to "1"
resourcestringRequired: resource to select

V1ResourceHealth

  • ResourceHealth represents the health of a resource. It has the latest device health information. This is a part of KEP https://kep.k8s.io/4680.

Source

PropertyTypeDescription
healthstringHealth of the resource. can be one of: - Healthy: operates as normal - Unhealthy: reported unhealthy. We consider this a temporary health issue since we do not have a mechanism today...
resourceIDstringResourceID is the unique identifier of the resource. See the ResourceID type for more information.

V1ResourcePolicyRule

  • ResourcePolicyRule is a predicate that matches some resource requests, testing the request's verb and the target resource. A ResourcePolicyRule matches a resource request if and only if: (a) at least one member of verbs matches the request, (b) at least one member of apiGroups matches the request, (c) at least one member of resources matches the request, and (d) either (d1) the request does not specify a namespace (i.e., Namespace==\"\") and clusterScope is true or (d2) the request specifies a namespace and least one member of namespaces matches the request's namespace.

Source

PropertyTypeDescription
apiGroupsstring[]apiGroups is a list of matching API groups and may not be empty. "*" matches all API groups and, if present, must be the only entry. Required.
clusterScopebooleanclusterScope indicates whether to match requests that do not specify a namespace (which happens either because the resource is not namespaced or the request targets all namespaces). If this field...
namespacesstring[]namespaces is a list of target namespaces that restricts matches. A request that specifies a target namespace matches only if either (a) this list contains that target namespace or (b) this list...
resourcesstring[]resources is a list of matching resources (i.e., lowercase and plural) with, if desired, subresource. For example, [ "services", "nodes/status" ]. This list may not be empty. "*" matches...
verbsstring[]verbs is a list of matching verbs and may not be empty. "*" matches all verbs and, if present, must be the only entry. Required.

V1ResourcePool

  • ResourcePool describes the pool that ResourceSlices belong to.

Source

PropertyTypeDescription
generationnumberGeneration tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part...
namestringName is used to identify the pool. For node-local devices, this is often the node name, but this is not required. It must not be longer than 253 characters and must consist of one or more DNS...
resourceSliceCountnumberResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero. Consumers can use this to check whether they have seen all ResourceSlices...

V1ResourceRequirements

  • ResourceRequirements describes the compute resource requirements.

Source

PropertyTypeDescription
claimsCoreV1ResourceClaim[]Claims lists the names of resources, defined in spec.resourceClaims, that are used by this container. This field depends on the DynamicResourceAllocation feature gate. This field is immutable. It...
limits{ [key: string]: stringLimits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
requests{ [key: string]: stringRequests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an...

V1ResourceRule

  • ResourceRule is the list of actions the subject is allowed to perform on resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.

Source

PropertyTypeDescription
apiGroupsstring[]APIGroups is the name of the APIGroup that contains the resources. If multiple API groups are specified, any action requested against one of the enumerated resources in any API group will be...
resourceNamesstring[]ResourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed. "*" means all.
resourcesstring[]Resources is a list of resources this rule applies to. "" means all in the specified apiGroups. "_/foo" represents the subresource 'foo' for all resources in the specified apiGroups.
verbsstring[]Verb is a list of kubernetes resource API verbs, like: get, list, watch, create, update, delete, proxy. "*" means all.

V1ResourceSlice

  • ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver. At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple , , . Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others. When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool. For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1ResourceSliceSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1Api);

const body: k8s.V1ResourceSlice = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createResourceSlice({ body });
console.log(res.metadata?.name);

Used by: ResourceV1Api.createResourceSlice · ResourceV1Api.patchResourceSlice · ResourceV1Api.readResourceSlice

V1ResourceSliceList

  • ResourceSliceList is a collection of ResourceSlices.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1ResourceSlice[]Items is the list of resource ResourceSlices.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1Api);

const res: k8s.V1ResourceSliceList = await api.listResourceSlice({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1Api.listResourceSlice

V1ResourceSliceSpec

  • ResourceSliceSpec contains the information published by the driver in one ResourceSlice.

Source

PropertyTypeDescription
allNodesbooleanAllNodes indicates that all nodes have access to the resources in the pool. Exactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.
devicesV1Device[]Devices lists some or all of the devices in this pool. Must not have more than 128 entries. If any device uses taints or consumes counters the limit is 64. Only one of Devices and SharedCounters...
driverstringDriver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name. Must be a DNS subdomain and should...
nodeNamestringNodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node. This field can be used to limit...
perDeviceNodeSelectionbooleanPerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice...
sharedCountersV1CounterSet[]SharedCounters defines a list of counter sets, each of which has a name and a list of counters available. The names of the counter sets must be unique in the ResourcePool. Only one of Devices and...
nodeSelectorV1NodeSelector
poolV1ResourcePool

V1ResourceStatus

  • ResourceStatus represents the status of a single resource allocated to a Pod.

Source

PropertyTypeDescription
namestringName of the resource. Must be unique within the pod and in case of non-DRA resource, match one of the resources from the pod spec. For DRA resources, the value must be...
resourcesV1ResourceHealth[]List of unique resources health. Each element in the list contains an unique resource ID and its health. At a minimum, for the lifetime of a Pod, resource ID must uniquely identify the resource...

V1RollingUpdateDaemonSet

  • Spec to control the desired behavior of daemon set rolling update.

Source

PropertyTypeDescription
maxSurgeIntOrStringIntOrString is a type that can hold an int32 or a string. When used in JSON or YAML marshalling and unmarshalling, it produces or consumes the inner type. This allows you to have, for example, a...
maxUnavailableIntOrStringIntOrString is a type that can hold an int32 or a string. When used in JSON or YAML marshalling and unmarshalling, it produces or consumes the inner type. This allows you to have, for example, a...

V1RollingUpdateDeployment

  • Spec to control the desired behavior of rolling update.

Source

PropertyTypeDescription
maxSurgeIntOrStringIntOrString is a type that can hold an int32 or a string. When used in JSON or YAML marshalling and unmarshalling, it produces or consumes the inner type. This allows you to have, for example, a...
maxUnavailableIntOrStringIntOrString is a type that can hold an int32 or a string. When used in JSON or YAML marshalling and unmarshalling, it produces or consumes the inner type. This allows you to have, for example, a...

V1RollingUpdateStatefulSetStrategy

  • RollingUpdateStatefulSetStrategy is used to communicate parameter for RollingUpdateStatefulSetStrategyType.

Source

PropertyTypeDescription
maxUnavailableIntOrStringIntOrString is a type that can hold an int32 or a string. When used in JSON or YAML marshalling and unmarshalling, it produces or consumes the inner type. This allows you to have, for example, a...
partitionnumberPartition indicates the ordinal at which the StatefulSet should be partitioned for updates. During a rolling update, all pods from ordinal Replicas-1 to Partition are updated. All pods from ordinal...

V1RuleWithOperations

  • RuleWithOperations is a tuple of Operations and Resources. It is recommended to make sure that all the tuple expansions are valid.

Source

PropertyTypeDescription
apiGroupsstring[]APIGroups is the API groups the resources belong to. '' is all groups. If '' is present, the length of the slice must be one. Required.
apiVersionsstring[]APIVersions is the API versions the resources belong to. '' is all versions. If '' is present, the length of the slice must be one. Required.
operationsstring[]Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or * for all of those operations and any future admission operations that are added. If '*' is present,...
resourcesstring[]Resources is a list of resources this rule applies to. For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '' means all resources, but not subresources. 'pods/_'...
scopestringscope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "*" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are...

V1RuntimeClass

  • RuntimeClass 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/

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
handlerstringhandler 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...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
overheadV1Overhead
schedulingV1Scheduling

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.NodeV1Api);

const body: k8s.V1RuntimeClass = {
metadata: { name: 'example' },
};
const res = await api.createRuntimeClass({ body });
console.log(res.metadata?.name);

Used by: NodeV1Api.createRuntimeClass · NodeV1Api.patchRuntimeClass · NodeV1Api.readRuntimeClass

V1RuntimeClassList

  • RuntimeClassList is a list of RuntimeClass objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1RuntimeClass[]items is a list of schema objects.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.NodeV1Api);

const res: k8s.V1RuntimeClassList = await api.listRuntimeClass({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: NodeV1Api.listRuntimeClass

V1SELinuxOptions

  • SELinuxOptions are the labels to be applied to the container

Source

PropertyTypeDescription
levelstringLevel is SELinux level label that applies to the container.
rolestringRole is a SELinux role label that applies to the container.
typestringType is a SELinux type label that applies to the container.
userstringUser is a SELinux user label that applies to the container.

V1ScopeSelector

  • A scope selector represents the AND of the selectors represented by the scoped-resource selector requirements.

Source

PropertyTypeDescription
matchExpressionsV1ScopedResourceSelectorRequirement[]A list of scope selector requirements by scope of the resources.

V1ScopedResourceSelectorRequirement

  • A scoped-resource selector requirement is a selector that contains values, a scope name, and an operator that relates the scope name and values.

Source

PropertyTypeDescription
operatorstringRepresents a scope's relationship to a set of values. Valid operators are In, NotIn, Exists, DoesNotExist.
scopeNamestringThe name of the scope that the selector applies to.
valuesstring[]An array of string values. If the operator is In or NotIn, the values array must be non-empty. If the operator is Exists or DoesNotExist, the values array must be empty. This array is replaced during...

V1SeccompProfile

  • SeccompProfile defines a pod/container's seccomp profile settings. Only one profile source may be set.

Source

PropertyTypeDescription
localhostProfilestringlocalhostProfile indicates a profile defined in a file on the node should be used. The profile must be preconfigured on the node to work. Must be a descending path, relative to the kubelet's...
typestringtype indicates which kind of seccomp profile will be applied. Valid options are: Localhost - a profile defined in a file on the node should be used. RuntimeDefault - the container runtime default...

V1SecurityContext

  • SecurityContext holds security configuration that will be applied to a container. Some fields are present in both SecurityContext and PodSecurityContext. When both are set, the values in SecurityContext take precedence.

Source

PropertyTypeDescription
allowPrivilegeEscalationbooleanAllowPrivilegeEscalation controls whether a process can gain more privileges than its parent process. This bool directly controls if the no_new_privs flag will be set on the container process....
privilegedbooleanRun container in privileged mode. Processes in privileged containers are essentially equivalent to root on the host. Defaults to false. Note that this field cannot be set when spec.os.name is windows.
procMountstringprocMount denotes the type of proc mount to use for the containers. The default value is Default which uses the container runtime defaults for readonly paths and masked paths. This requires the...
readOnlyRootFilesystembooleanWhether this container has a read-only root filesystem. Default is false. Note that this field cannot be set when spec.os.name is windows.
runAsGroupnumberThe GID to run the entrypoint of the container process. Uses runtime default if unset. May also be set in PodSecurityContext. If set in both SecurityContext and PodSecurityContext, the value...
runAsNonRootbooleanIndicates that the container must run as a non-root user. If true, the Kubelet will validate the image at runtime to ensure that it does not run as UID 0 (root) and fail to start the container if it...
runAsUsernumberThe UID to run the entrypoint of the container process. Defaults to user specified in image metadata if unspecified. May also be set in PodSecurityContext. If set in both SecurityContext and...
appArmorProfileV1AppArmorProfile
capabilitiesV1Capabilities
seLinuxOptionsV1SELinuxOptions
seccompProfileV1SeccompProfile
windowsOptionsV1WindowsSecurityContextOptions

V1SelectableField

  • SelectableField specifies the JSON path of a field that may be used with field selectors.

Source

PropertyTypeDescription
jsonPathstringjsonPath is a simple JSON path which is evaluated against each custom resource to produce a field selector value. Only JSON paths without the array notation are allowed. Must point to a field of type...

V1SelfSubjectReview

  • SelfSubjectReview contains the user information that the kube-apiserver has about the user making this request. When using impersonation, users will receive the user info of the user being impersonated. If impersonation or request header authentication is used, any extra keys will have their case ignored and returned as lowercase.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
statusV1SelfSubjectReviewStatus

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AuthenticationV1Api);

const body: k8s.V1SelfSubjectReview = {
metadata: { name: 'example' },
};
const res = await api.createSelfSubjectReview({ body });
console.log(res.metadata?.name);

Used by: AuthenticationV1Api.createSelfSubjectReview

V1SelfSubjectReviewStatus

  • SelfSubjectReviewStatus is filled by the kube-apiserver and sent back to a user.

Source

PropertyTypeDescription
userInfoV1UserInfo

V1SessionAffinityConfig

  • SessionAffinityConfig represents the configurations of session affinity.

Source

PropertyTypeDescription
clientIPV1ClientIPConfig

V1SleepAction

  • SleepAction describes a "sleep" action.

Source

PropertyTypeDescription
secondsnumberSeconds is the number of seconds to sleep.

V1Status

  • Status is a return value for calls that don't return other objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
codenumberSuggested HTTP return code for this status, 0 if not set.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
messagestringA human-readable description of the status of this operation.
reasonstringA machine-readable description of why this operation is in the "Failure" status. If this value is empty there is no information available. A Reason clarifies an HTTP status code but does not...
statusstringStatus of the operation. One of: "Success" or "Failure". More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
detailsV1StatusDetails
metadataV1ListMeta

Used by: AdmissionregistrationV1alpha1Api.deleteCollectionMutatingAdmissionPolicy · AdmissionregistrationV1alpha1Api.deleteCollectionMutatingAdmissionPolicyBinding · AdmissionregistrationV1alpha1Api.deleteMutatingAdmissionPolicy · AdmissionregistrationV1Api.deleteCollectionMutatingWebhookConfiguration · AdmissionregistrationV1Api.deleteCollectionValidatingAdmissionPolicy · AdmissionregistrationV1Api.deleteMutatingWebhookConfiguration · AdmissionregistrationV1beta1Api.deleteCollectionMutatingAdmissionPolicy · AdmissionregistrationV1beta1Api.deleteCollectionMutatingAdmissionPolicyBinding · AdmissionregistrationV1beta1Api.deleteMutatingAdmissionPolicy · ApiextensionsV1Api.deleteCollectionCustomResourceDefinition · ApiextensionsV1Api.deleteCustomResourceDefinition · ApiregistrationV1Api.deleteAPIService · ApiregistrationV1Api.deleteCollectionAPIService · AppsV1Api.deleteCollectionNamespacedControllerRevision · AppsV1Api.deleteCollectionNamespacedDaemonSet · AppsV1Api.deleteNamespacedControllerRevision · AutoscalingV1Api.deleteCollectionNamespacedHorizontalPodAutoscaler · AutoscalingV1Api.deleteNamespacedHorizontalPodAutoscaler · AutoscalingV2Api.deleteCollectionNamespacedHorizontalPodAutoscaler · AutoscalingV2Api.deleteNamespacedHorizontalPodAutoscaler

and 80 more…

BatchV1Api.deleteCollectionNamespacedCronJob · BatchV1Api.deleteCollectionNamespacedJob · BatchV1Api.deleteNamespacedCronJob · CertificatesV1alpha1Api.deleteClusterTrustBundle · CertificatesV1alpha1Api.deleteCollectionClusterTrustBundle · CertificatesV1Api.deleteCertificateSigningRequest · CertificatesV1Api.deleteCollectionCertificateSigningRequest · CertificatesV1beta1Api.deleteClusterTrustBundle · CertificatesV1beta1Api.deleteCollectionClusterTrustBundle · CertificatesV1beta1Api.deleteCollectionNamespacedPodCertificateRequest · CoordinationV1alpha2Api.deleteCollectionNamespacedLeaseCandidate · CoordinationV1alpha2Api.deleteNamespacedLeaseCandidate · CoordinationV1Api.deleteCollectionNamespacedLease · CoordinationV1Api.deleteNamespacedLease · CoordinationV1beta1Api.deleteCollectionNamespacedLeaseCandidate · CoordinationV1beta1Api.deleteNamespacedLeaseCandidate · CoreV1Api.deleteCollectionNamespacedConfigMap · CoreV1Api.deleteCollectionNamespacedEndpoints · CoreV1Api.deleteCollectionNamespacedEvent · CoreV1Api.deleteCollectionNamespacedLimitRange · CoreV1Api.deleteCollectionNamespacedPersistentVolumeClaim · CoreV1Api.deleteCollectionNamespacedPod · CoreV1Api.deleteCollectionNamespacedPodTemplate · CoreV1Api.deleteCollectionNamespacedReplicationController · CoreV1Api.deleteCollectionNamespacedResourceQuota · CoreV1Api.deleteCollectionNamespacedSecret · CoreV1Api.deleteCollectionNamespacedService · CoreV1Api.deleteCollectionNamespacedServiceAccount · CoreV1Api.deleteCollectionNode · CoreV1Api.deleteCollectionPersistentVolume · CoreV1Api.deleteNamespace · CoreV1Api.deleteNamespacedConfigMap · CoreV1Api.deleteNamespacedEndpoints · CoreV1Api.deleteNamespacedEvent · CoreV1Api.deleteNamespacedLimitRange · CoreV1Api.deleteNamespacedReplicationController · CoreV1Api.deleteNamespacedSecret · CoreV1Api.deleteNode · DiscoveryV1Api.deleteCollectionNamespacedEndpointSlice · DiscoveryV1Api.deleteNamespacedEndpointSlice · EventsV1Api.deleteCollectionNamespacedEvent · EventsV1Api.deleteNamespacedEvent · FlowcontrolApiserverV1Api.deleteCollectionFlowSchema · FlowcontrolApiserverV1Api.deleteCollectionPriorityLevelConfiguration · FlowcontrolApiserverV1Api.deleteFlowSchema · InternalApiserverV1alpha1Api.deleteCollectionStorageVersion · InternalApiserverV1alpha1Api.deleteStorageVersion · NetworkingV1Api.deleteCollectionIngressClass · NetworkingV1Api.deleteCollectionIPAddress · NetworkingV1Api.deleteIPAddress · NetworkingV1beta1Api.deleteCollectionIPAddress · NetworkingV1beta1Api.deleteCollectionServiceCIDR · NetworkingV1beta1Api.deleteIPAddress · NodeV1Api.deleteCollectionRuntimeClass · NodeV1Api.deleteRuntimeClass · PolicyV1Api.deleteCollectionNamespacedPodDisruptionBudget · PolicyV1Api.deleteNamespacedPodDisruptionBudget · RbacAuthorizationV1Api.deleteClusterRole · RbacAuthorizationV1Api.deleteClusterRoleBinding · RbacAuthorizationV1Api.deleteCollectionClusterRole · ResourceV1alpha3Api.deleteCollectionDeviceTaintRule · ResourceV1Api.deleteCollectionDeviceClass · ResourceV1Api.deleteCollectionNamespacedResourceClaim · ResourceV1Api.deleteCollectionNamespacedResourceClaimTemplate · ResourceV1beta1Api.deleteCollectionDeviceClass · ResourceV1beta1Api.deleteCollectionNamespacedResourceClaim · ResourceV1beta1Api.deleteCollectionNamespacedResourceClaimTemplate · ResourceV1beta2Api.deleteCollectionDeviceClass · ResourceV1beta2Api.deleteCollectionNamespacedResourceClaim · ResourceV1beta2Api.deleteCollectionNamespacedResourceClaimTemplate · SchedulingV1alpha1Api.deleteCollectionNamespacedWorkload · SchedulingV1alpha1Api.deleteNamespacedWorkload · SchedulingV1Api.deleteCollectionPriorityClass · SchedulingV1Api.deletePriorityClass · StoragemigrationV1beta1Api.deleteCollectionStorageVersionMigration · StoragemigrationV1beta1Api.deleteStorageVersionMigration · StorageV1Api.deleteCollectionCSIDriver · StorageV1Api.deleteCollectionCSINode · StorageV1Api.deleteCollectionNamespacedCSIStorageCapacity · StorageV1beta1Api.deleteCollectionVolumeAttributesClass

V1StatusCause

  • StatusCause provides more information about an api.Status failure, including cases when multiple errors are encountered.

Source

PropertyTypeDescription
fieldstringThe field of the resource that has caused this error, as named by its JSON serialization. May include dot and postfix notation for nested attributes. Arrays are zero-indexed. Fields may appear more...
messagestringA human-readable description of the cause of the error. This field may be presented as-is to a reader.
reasonstringA machine-readable description of the cause of the error. If this value is empty there is no information available.

V1StatusDetails

  • StatusDetails is a set of additional properties that MAY be set by the server to provide additional information about a response. The Reason field of a Status object defines what attributes will be set. Clients must ignore fields that do not match the defined type of each attribute, and should assume that any attribute may be empty, invalid, or under defined.

Source

PropertyTypeDescription
causesV1StatusCause[]The Causes array includes more details associated with the StatusReason failure. Not all StatusReasons may provide detailed causes.
groupstringThe group attribute of the resource associated with the status StatusReason.
kindstringThe kind attribute of the resource associated with the status StatusReason. On some operations may differ from the requested resource Kind. More info:...
namestringThe name attribute of the resource associated with the status StatusReason (when there is a single name which can be described).
retryAfterSecondsnumberIf specified, the time in seconds before the operation should be retried. Some errors may indicate the client must take an alternate action - for those errors this field may indicate how long to wait...
uidstringUID of the resource. (when there is a single resource which can be described). More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids

V1StorageOSPersistentVolumeSource

  • Represents a StorageOS persistent volume resource.

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
readOnlybooleanreadOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
volumeNamestringvolumeName is the human-readable name of the StorageOS volume. Volume names are only unique within a namespace.
volumeNamespacestringvolumeNamespace specifies the scope of the volume within StorageOS. If no namespace is specified then the Pod's namespace will be used. This allows the Kubernetes name scoping to be mirrored...
secretRefV1ObjectReference

V1StorageOSVolumeSource

  • Represents a StorageOS persistent volume resource.

Source

PropertyTypeDescription
fsTypestringfsType is the filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
readOnlybooleanreadOnly defaults to false (read/write). ReadOnly here will force the ReadOnly setting in VolumeMounts.
volumeNamestringvolumeName is the human-readable name of the StorageOS volume. Volume names are only unique within a namespace.
volumeNamespacestringvolumeNamespace specifies the scope of the volume within StorageOS. If no namespace is specified then the Pod's namespace will be used. This allows the Kubernetes name scoping to be mirrored...
secretRefV1LocalObjectReference

V1SubjectRulesReviewStatus

  • SubjectRulesReviewStatus contains the result of a rules check. This check can be incomplete depending on the set of authorizers the server is configured with and any errors experienced during evaluation. Because authorization rules are additive, if a rule appears in a list it's safe to assume the subject has that permission, even if that list is incomplete.

Source

PropertyTypeDescription
evaluationErrorstringEvaluationError can appear in combination with Rules. It indicates an error occurred during rule evaluation, such as an authorizer that doesn't support rule evaluation, and that ResourceRules and/or...
incompletebooleanIncomplete is true when the rules returned by this call are incomplete. This is most commonly encountered when an authorizer, such as an external authorizer, doesn't support rules evaluation.
nonResourceRulesV1NonResourceRule[]NonResourceRules is the list of actions the subject is allowed to perform on non-resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.
resourceRulesV1ResourceRule[]ResourceRules is the list of actions the subject is allowed to perform on resources. The list ordering isn't significant, may contain duplicates, and possibly be incomplete.

V1SuccessPolicy

  • SuccessPolicy describes when a Job can be declared as succeeded based on the success of some indexes.

Source

PropertyTypeDescription
rulesV1SuccessPolicyRule[]rules represents the list of alternative rules for the declaring the Jobs as successful before .status.succeeded >= .spec.completions. Once any of the rules are met, the "SuccessCriteriaMet"...

V1SuccessPolicyRule

  • SuccessPolicyRule describes rule for declaring a Job as succeeded. Each rule must have at least one of the "succeededIndexes" or "succeededCount" specified.

Source

PropertyTypeDescription
succeededCountnumbersucceededCount specifies the minimal required size of the actual set of the succeeded indexes for the Job. When succeededCount is used along with succeededIndexes, the check is constrained only to...
succeededIndexesstringsucceededIndexes specifies the set of indexes which need to be contained in the actual set of the succeeded indexes for the Job. The list of indexes must be within 0 to ".spec.completions-1" and...

V1Sysctl

  • Sysctl defines a kernel parameter to be set

Source

PropertyTypeDescription
namestringName of a property to set
valuestringValue of a property to set

V1TCPSocketAction

  • TCPSocketAction describes an action based on opening a socket

Source

PropertyTypeDescription
hoststringOptional: Host name to connect to, defaults to the pod IP.
portIntOrStringIntOrString is a type that can hold an int32 or a string. When used in JSON or YAML marshalling and unmarshalling, it produces or consumes the inner type. This allows you to have, for example, a...

V1Taint

  • The node this Taint is attached to has the "effect" on any pod that does not tolerate the Taint.

Source

PropertyTypeDescription
effectstringRequired. The effect of the taint on pods that do not tolerate the taint. Valid effects are NoSchedule, PreferNoSchedule and NoExecute.
keystringRequired. The taint key to be applied to a node.
timeAddedDateTimeAdded represents the time at which the taint was added.
valuestringThe taint value corresponding to the taint key.

V1Toleration

  • The pod this Toleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator .

Source

PropertyTypeDescription
effectstringEffect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule, PreferNoSchedule and NoExecute.
keystringKey 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.
operatorstringOperator represents a key's relationship to the value. Valid operators are Exists, Equal, Lt, and Gt. Defaults to Equal. Exists is equivalent to wildcard for value, so that a pod can tolerate all...
tolerationSecondsnumberTolerationSeconds 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...
valuestringValue is the taint value the toleration matches to. If the operator is Exists, the value should be empty, otherwise just a regular string.

V1TopologySelectorLabelRequirement

  • A topology selector requirement is a selector that matches given label. This is an alpha feature and may change in the future.

Source

PropertyTypeDescription
keystringThe label key that the selector applies to.
valuesstring[]An array of string values. One value must match the label to be selected. Each entry in Values is ORed.

V1TopologySelectorTerm

  • A topology selector term represents the result of label queries. A null or empty topology selector term matches no objects. The requirements of them are ANDed. It provides a subset of functionality as NodeSelectorTerm. This is an alpha feature and may change in the future.

Source

PropertyTypeDescription
matchLabelExpressionsV1TopologySelectorLabelRequirement[]A list of topology selector requirements by labels.

V1TopologySpreadConstraint

  • TopologySpreadConstraint specifies how to spread matching pods among the given topology.

Source

PropertyTypeDescription
matchLabelKeysstring[]MatchLabelKeys is a set of pod label keys to select the pods over which spreading will be calculated. The keys are used to lookup values from the incoming pod labels, those key-value labels are ANDed...
maxSkewnumberMaxSkew describes the degree to which pods may be unevenly distributed. When whenUnsatisfiable=DoNotSchedule, it is the maximum permitted difference between the number of matching pods in the...
minDomainsnumberMinDomains indicates a minimum number of eligible domains. When the number of eligible domains with matching topology keys is less than minDomains, Pod Topology Spread treats "global minimum" as 0,...
nodeAffinityPolicystringNodeAffinityPolicy indicates how we will treat Pod's nodeAffinity/nodeSelector when calculating pod topology spread skew. Options are: - Honor: only nodes matching nodeAffinity/nodeSelector are...
nodeTaintsPolicystringNodeTaintsPolicy indicates how we will treat node taints when calculating pod topology spread skew. Options are: - Honor: nodes without taints, along with tainted nodes for which the incoming pod has...
topologyKeystringTopologyKey is the key of node labels. Nodes that have a label with this key and identical values are considered to be in the same topology. We consider each <key, value> as a "bucket", and try to...
whenUnsatisfiablestringWhenUnsatisfiable indicates how to deal with a pod if it doesn't satisfy the spread constraint. - DoNotSchedule (default) tells the scheduler not to schedule it. - ScheduleAnyway tells the scheduler...
labelSelectorV1LabelSelector

V1TypeChecking

  • TypeChecking contains results of type checking the expressions in the ValidatingAdmissionPolicy

Source

PropertyTypeDescription
expressionWarningsV1ExpressionWarning[]The type checking warnings for each expression.

V1TypedLocalObjectReference

  • TypedLocalObjectReference contains enough information to let you locate the typed referenced object inside the same namespace.

Source

PropertyTypeDescription
apiGroupstringAPIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
kindstringKind is the type of resource being referenced
namestringName is the name of resource being referenced

V1TypedObjectReference

  • TypedObjectReference contains enough information to let you locate the typed referenced object

Source

PropertyTypeDescription
apiGroupstringAPIGroup is the group for the resource being referenced. If APIGroup is not specified, the specified Kind must be in the core API group. For any other third-party types, APIGroup is required.
kindstringKind is the type of resource being referenced
namestringName is the name of resource being referenced
namespacestringNamespace is the namespace of resource being referenced Note that when a namespace is specified, a gateway.networking.k8s.io/ReferenceGrant object is required in the referent namespace to allow that...

V1UncountedTerminatedPods

  • UncountedTerminatedPods holds UIDs of Pods that have terminated but haven't been accounted in Job status counters.

Source

PropertyTypeDescription
failedstring[]failed holds UIDs of failed Pods.
succeededstring[]succeeded holds UIDs of succeeded Pods.

V1UserInfo

  • UserInfo holds the information about the user needed to implement the user.Info interface.

Source

PropertyTypeDescription
extra{ [key: string]: string[]Any additional information provided by the authenticator.
groupsstring[]The names of groups this user is a part of.
uidstringA unique value that identifies this user across time. If this user is deleted and another user by the same name is added, they will have different UIDs.
usernamestringThe name that uniquely identifies this user among all active users.

V1ValidatingWebhook

  • ValidatingWebhook describes an admission webhook and the resources and operations it applies to.

Source

PropertyTypeDescription
admissionReviewVersionsstring[]AdmissionReviewVersions is an ordered list of preferred AdmissionReview versions the Webhook expects. API server will try to use first version in the list which it supports. If none of the versions...
failurePolicystringFailurePolicy defines how unrecognized errors from the admission endpoint are handled - allowed values are Ignore or Fail. Defaults to Fail.
matchConditionsV1MatchCondition[]MatchConditions is a list of conditions that must be met for a request to be sent to this webhook. Match conditions filter requests that have already been matched by the rules, namespaceSelector, and...
matchPolicystringmatchPolicy defines how the "rules" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent". - Exact: match a request only if it exactly matches a specified rule....
namestringThe name of the admission webhook. Name should be fully qualified, e.g., imagepolicy.kubernetes.io, where "imagepolicy" is the name of the webhook, and kubernetes.io is the name of the...
rulesV1RuleWithOperations[]Rules describes what operations on what resources/subresources the webhook cares about. The webhook cares about an operation if it matches any Rule. However, in order to prevent...
sideEffectsstringSideEffects states whether this webhook has side effects. Acceptable values are: None, NoneOnDryRun (webhooks created via v1beta1 may also specify Some or Unknown). Webhooks with side effects MUST...
timeoutSecondsnumberTimeoutSeconds specifies the timeout for this webhook. After the timeout passes, the webhook call will be ignored or the API call will fail based on the failure policy. The timeout value must be...
clientConfigAdmissionregistrationV1WebhookClientConfig
namespaceSelectorV1LabelSelector
objectSelectorV1LabelSelector

V1Validation

  • Validation specifies the CEL expression which is used to apply the validation.

Source

PropertyTypeDescription
expressionstringExpression represents the expression which will be evaluated by CEL. ref: https://github.com/google/cel-spec CEL expressions have access to the contents of the API request/response, organized into...
messagestringMessage represents the message displayed when validation fails. The message is required if the Expression contains line breaks. The message must not contain line breaks. If unset, the message is...
messageExpressionstringmessageExpression declares a CEL expression that evaluates to the validation failure message that is returned when this rule fails. Since messageExpression is used as a failure message, it must...
reasonstringReason represents a machine-readable description of why this validation failed. If this is the first validation in the list to fail, this reason, as well as the corresponding HTTP response code, are...

V1ValidationRule

  • ValidationRule describes a validation rule written in the CEL expression language.

Source

PropertyTypeDescription
fieldPathstringfieldPath represents the field path returned when the validation fails. It must be a relative JSON path (i.e. with array notation) scoped to the location of this x-kubernetes-validations extension in...
messagestringMessage represents the message displayed when validation fails. The message is required if the Rule contains line breaks. The message must not contain line breaks. If unset, the message is "failed...
messageExpressionstringMessageExpression declares a CEL expression that evaluates to the validation failure message that is returned when this rule fails. Since messageExpression is used as a failure message, it must...
optionalOldSelfbooleanoptionalOldSelf is used to opt a transition rule into evaluation even when the object is first created, or if the old object is missing the value. When enabled oldSelf will be a CEL optional whose...
reasonstringreason provides a machine-readable validation failure reason that is returned to the caller when a request fails this validation rule. The HTTP status code returned to the caller will match the...
rulestringRule represents the expression which will be evaluated by CEL. ref: https://github.com/google/cel-spec The Rule is scoped to the location of the x-kubernetes-validations extension in the schema. The...

V1Variable

  • Variable is the definition of a variable that is used for composition. A variable is defined as a named expression.

Source

PropertyTypeDescription
expressionstringExpression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
namestringName is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through variables For example, if name is...

V1Volume

  • Volume represents a named volume in a pod that may be accessed by any container in the pod.

Source

PropertyTypeDescription
namestringname of the volume. Must be a DNS_LABEL and unique within the pod. More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names
awsElasticBlockStoreV1AWSElasticBlockStoreVolumeSource
azureDiskV1AzureDiskVolumeSource
azureFileV1AzureFileVolumeSource
cephfsV1CephFSVolumeSource
cinderV1CinderVolumeSource
configMapV1ConfigMapVolumeSource
csiV1CSIVolumeSource
downwardAPIV1DownwardAPIVolumeSource
emptyDirV1EmptyDirVolumeSource
ephemeralV1EphemeralVolumeSource
fcV1FCVolumeSource
flexVolumeV1FlexVolumeSource
flockerV1FlockerVolumeSource
gcePersistentDiskV1GCEPersistentDiskVolumeSource
gitRepoV1GitRepoVolumeSource
glusterfsV1GlusterfsVolumeSource
hostPathV1HostPathVolumeSource
imageV1ImageVolumeSource
iscsiV1ISCSIVolumeSource
nfsV1NFSVolumeSource
persistentVolumeClaimV1PersistentVolumeClaimVolumeSource
photonPersistentDiskV1PhotonPersistentDiskVolumeSource
portworxVolumeV1PortworxVolumeSource
projectedV1ProjectedVolumeSource
quobyteV1QuobyteVolumeSource
rbdV1RBDVolumeSource
scaleIOV1ScaleIOVolumeSource
secretV1SecretVolumeSource
storageosV1StorageOSVolumeSource
vsphereVolumeV1VsphereVirtualDiskVolumeSource

V1VolumeAttributesClass

  • VolumeAttributesClass represents a specification of mutable volume attributes defined by the CSI driver. The class can be specified during dynamic provisioning of PersistentVolumeClaims, and changed in the PersistentVolumeClaim spec after provisioning.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
driverNamestringName of the CSI driver This field is immutable.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
parameters{ [key: string]: stringparameters hold volume attributes defined by the CSI driver. These values are opaque to the Kubernetes and are passed directly to the CSI driver. The underlying storage provider supports changing...
metadataV1ObjectMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.StorageV1Api);

const body: k8s.V1VolumeAttributesClass = {
metadata: { name: 'example' },
};
const res = await api.createVolumeAttributesClass({ body });
console.log(res.metadata?.name);

Used by: StorageV1Api.createVolumeAttributesClass · StorageV1Api.patchVolumeAttributesClass · StorageV1Api.readVolumeAttributesClass

V1VolumeAttributesClassList

  • VolumeAttributesClassList is a collection of VolumeAttributesClass objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1VolumeAttributesClass[]items is the list of VolumeAttributesClass objects.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.StorageV1Api);

const res: k8s.V1VolumeAttributesClassList = await api.listVolumeAttributesClass({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: StorageV1Api.listVolumeAttributesClass

V1VolumeDevice

  • volumeDevice describes a mapping of a raw block device within a container.

Source

PropertyTypeDescription
devicePathstringdevicePath is the path inside of the container that the device will be mapped to.
namestringname must match the name of a persistentVolumeClaim in the pod

V1VolumeError

  • VolumeError captures an error encountered during a volume operation.

Source

PropertyTypeDescription
errorCodenumbererrorCode is a numeric gRPC code representing the error encountered during Attach or Detach operations. This is an optional, beta field that requires the MutableCSINodeAllocatableCount feature gate...
messagestringmessage represents the error encountered during Attach or Detach operation. This string may be logged, so it should not contain sensitive information.
timeDatetime represents the time the error was encountered.

V1VolumeMount

  • VolumeMount describes a mounting of a Volume within a container.

Source

PropertyTypeDescription
mountPathstringPath within the container at which the volume should be mounted. Must not contain ':'.
mountPropagationstringmountPropagation determines how mounts are propagated from the host to container and the other way around. When not set, MountPropagationNone is used. This field is beta in 1.10. When...
namestringThis must match the Name of a Volume.
readOnlybooleanMounted read-only if true, read-write otherwise (false or unspecified). Defaults to false.
recursiveReadOnlystringRecursiveReadOnly specifies whether read-only mounts should be handled recursively. If ReadOnly is false, this field has no meaning and must be unspecified. If ReadOnly is true, and this field is...
subPathstringPath within the volume from which the container's volume should be mounted. Defaults to "" (volume's root).
subPathExprstringExpanded path within the volume from which the container's volume should be mounted. Behaves similarly to SubPath but environment variable references $(VAR_NAME) are expanded using the container's...

V1VolumeMountStatus

  • VolumeMountStatus shows status of volume mounts.

Source

PropertyTypeDescription
mountPathstringMountPath corresponds to the original VolumeMount.
namestringName corresponds to the name of the original VolumeMount.
readOnlybooleanReadOnly corresponds to the original VolumeMount.
recursiveReadOnlystringRecursiveReadOnly must be set to Disabled, Enabled, or unspecified (for non-readonly mounts). An IfPossible value in the original VolumeMount must be translated to Disabled or Enabled, depending on...

V1VolumeNodeAffinity

  • VolumeNodeAffinity defines constraints that limit what nodes this volume can be accessed from.

Source

PropertyTypeDescription
requiredV1NodeSelector

V1VolumeNodeResources

  • VolumeNodeResources is a set of resource limits for scheduling of volumes.

Source

PropertyTypeDescription
countnumbercount indicates the maximum number of unique volumes managed by the CSI driver that can be used on a node. A volume that is both attached and mounted on a node is considered to be used once, not...

V1VolumeProjection

  • Projection that may be projected along with other supported volume types. Exactly one of these fields must be set.

Source

PropertyTypeDescription
clusterTrustBundleV1ClusterTrustBundleProjection
configMapV1ConfigMapProjection
downwardAPIV1DownwardAPIProjection
podCertificateV1PodCertificateProjection
secretV1SecretProjection
serviceAccountTokenV1ServiceAccountTokenProjection

V1VolumeResourceRequirements

  • VolumeResourceRequirements describes the storage resource requirements for a volume.

Source

PropertyTypeDescription
limits{ [key: string]: stringLimits describes the maximum amount of compute resources allowed. More info: https://kubernetes.io/docs/concepts/configuration/manage-resources-containers/
requests{ [key: string]: stringRequests describes the minimum amount of compute resources required. If Requests is omitted for a container, it defaults to Limits if that is explicitly specified, otherwise to an...

V1VsphereVirtualDiskVolumeSource

  • Represents a vSphere volume resource.

Source

PropertyTypeDescription
fsTypestringfsType is filesystem type to mount. Must be a filesystem type supported by the host operating system. Ex. "ext4", "xfs", "ntfs". Implicitly inferred to be "ext4" if unspecified.
storagePolicyIDstringstoragePolicyID is the storage Policy Based Management (SPBM) profile ID associated with the StoragePolicyName.
storagePolicyNamestringstoragePolicyName is the storage Policy Based Management (SPBM) profile name.
volumePathstringvolumePath is the path that identifies vSphere volume vmdk

V1WebhookConversion

  • WebhookConversion describes how to call a conversion webhook

Source

PropertyTypeDescription
conversionReviewVersionsstring[]conversionReviewVersions is an ordered list of preferred ConversionReview versions the Webhook expects. The API server will use the first version in the list which it supports. If none of the...
clientConfigApiextensionsV1WebhookClientConfig

V1WeightedPodAffinityTerm

  • The weights of all of the matched WeightedPodAffinityTerm fields are added per-node to find the most preferred node(s)

Source

PropertyTypeDescription
weightnumberweight associated with matching the corresponding podAffinityTerm, in the range 1-100.
podAffinityTermV1PodAffinityTerm

V1WindowsSecurityContextOptions

  • WindowsSecurityContextOptions contain Windows-specific options and credentials.

Source

PropertyTypeDescription
gmsaCredentialSpecstringGMSACredentialSpec is where the GMSA admission webhook (https://github.com/kubernetes-sigs/windows-gmsa) inlines the contents of the GMSA credential spec named by the GMSACredentialSpecName field.
gmsaCredentialSpecNamestringGMSACredentialSpecName is the name of the GMSA credential spec to use.
hostProcessbooleanHostProcess determines if a container should be run as a 'Host Process' container. All of a Pod's containers must have the same effective HostProcess value (it is not allowed to have a mix of...
runAsUserNamestringThe UserName in Windows to run the entrypoint of the container process. Defaults to the user specified in image metadata if unspecified. May also be set in PodSecurityContext. If set in both...

V1WorkloadReference

  • WorkloadReference identifies the Workload object and PodGroup membership that a Pod belongs to. The scheduler uses this information to apply workload-aware scheduling semantics.

Source

PropertyTypeDescription
namestringName defines the name of the Workload object this Pod belongs to. Workload must be in the same namespace as the Pod. If it doesn't match any existing Workload, the Pod will remain unschedulable...
podGroupstringPodGroup is the name of the PodGroup within the Workload that this Pod belongs to. If it doesn't match any existing PodGroup within the Workload, the Pod will remain unschedulable until the Workload...
podGroupReplicaKeystringPodGroupReplicaKey specifies the replica key of the PodGroup to which this Pod belongs. It is used to distinguish pods belonging to different replicas of the same pod group. The pod group policy is...

V1alpha1ApplyConfiguration

  • ApplyConfiguration defines the desired configuration values of an object.

Source

PropertyTypeDescription
expressionstringexpression will be evaluated by CEL to create an apply configuration. ref: https://github.com/google/cel-spec Apply configurations are declared in CEL using object initialization. For example, this...

V1alpha1ClusterTrustBundle

  • ClusterTrustBundle is a cluster-scoped container for X.509 trust anchors (root certificates). ClusterTrustBundle objects are considered to be readable by any authenticated user in the cluster, because they can be mounted by pods using the clusterTrustBundle projection. All service accounts have read access to ClusterTrustBundles by default. Users who only have namespace-level access to a cluster can read ClusterTrustBundles by impersonating a serviceaccount that they have access to. It can be optionally associated with a particular assigner, in which case it contains one valid set of trust anchors for that signer. Signers may have multiple associated ClusterTrustBundles; each is an independent set of trust anchors for that signer. Admission control is used to enforce that only users with permissions on the signer can create or modify the corresponding bundle.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1alpha1ClusterTrustBundleSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CertificatesV1alpha1Api);

const body: k8s.V1alpha1ClusterTrustBundle = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createClusterTrustBundle({ body });
console.log(res.metadata?.name);

Used by: CertificatesV1alpha1Api.createClusterTrustBundle · CertificatesV1alpha1Api.patchClusterTrustBundle · CertificatesV1alpha1Api.readClusterTrustBundle

V1alpha1ClusterTrustBundleList

  • ClusterTrustBundleList is a collection of ClusterTrustBundle objects

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1alpha1ClusterTrustBundle[]items is a collection of ClusterTrustBundle objects
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CertificatesV1alpha1Api);

const res: k8s.V1alpha1ClusterTrustBundleList = await api.listClusterTrustBundle({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: CertificatesV1alpha1Api.listClusterTrustBundle

V1alpha1ClusterTrustBundleSpec

  • ClusterTrustBundleSpec contains the signer and trust anchors.

Source

PropertyTypeDescription
signerNamestringsignerName indicates the associated signer, if any. In order to create or update a ClusterTrustBundle that sets signerName, you must have the following cluster-scoped permission:...
trustBundlestringtrustBundle contains the individual X.509 trust anchors for this bundle, as PEM bundle of PEM-wrapped, DER-formatted X.509 certificates. The data must consist only of PEM certificate blocks that...

V1alpha1GangSchedulingPolicy

  • GangSchedulingPolicy defines the parameters for gang scheduling.

Source

PropertyTypeDescription
minCountnumberMinCount is the minimum number of pods that must be schedulable or scheduled at the same time for the scheduler to admit the entire group. It must be a positive integer.

V1alpha1JSONPatch

  • JSONPatch defines a JSON Patch.

Source

PropertyTypeDescription
expressionstringexpression will be evaluated by CEL to create a JSON patch. ref: https://github.com/google/cel-spec expression must return an array of JSONPatch values. For example, this...

V1alpha1MatchCondition

Source

PropertyTypeDescription
expressionstringExpression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL...
namestringName is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the...

V1alpha1MatchResources

  • MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)

Source

PropertyTypeDescription
excludeResourceRulesV1alpha1NamedRuleWithOperations[]ExcludeResourceRules describes what operations on what resources/subresources the policy should not care about. The exclude rules take precedence over include rules (if a resource matches both, it is...
matchPolicystringmatchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent". - Exact: match a request only if it exactly matches a...
resourceRulesV1alpha1NamedRuleWithOperations[]ResourceRules describes what operations on what resources/subresources the admission policy matches. The policy cares about an operation if it matches any Rule.
namespaceSelectorV1LabelSelector
objectSelectorV1LabelSelector

V1alpha1MutatingAdmissionPolicy

  • MutatingAdmissionPolicy describes the definition of an admission mutation policy that mutates the object coming into admission chain.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1alpha1MutatingAdmissionPolicySpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AdmissionregistrationV1alpha1Api);

const body: k8s.V1alpha1MutatingAdmissionPolicy = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createMutatingAdmissionPolicy({ body });
console.log(res.metadata?.name);

Used by: AdmissionregistrationV1alpha1Api.createMutatingAdmissionPolicy · AdmissionregistrationV1alpha1Api.patchMutatingAdmissionPolicy · AdmissionregistrationV1alpha1Api.readMutatingAdmissionPolicy

V1alpha1MutatingAdmissionPolicyBinding

  • MutatingAdmissionPolicyBinding binds the MutatingAdmissionPolicy with parametrized resources. MutatingAdmissionPolicyBinding and the optional parameter resource together define how cluster administrators configure policies for clusters. For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding. Each evaluation is constrained by a runtime cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1alpha1MutatingAdmissionPolicyBindingSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AdmissionregistrationV1alpha1Api);

const body: k8s.V1alpha1MutatingAdmissionPolicyBinding = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createMutatingAdmissionPolicyBinding({ body });
console.log(res.metadata?.name);

Used by: AdmissionregistrationV1alpha1Api.createMutatingAdmissionPolicyBinding · AdmissionregistrationV1alpha1Api.patchMutatingAdmissionPolicyBinding · AdmissionregistrationV1alpha1Api.readMutatingAdmissionPolicyBinding

V1alpha1MutatingAdmissionPolicyBindingList

  • MutatingAdmissionPolicyBindingList is a list of MutatingAdmissionPolicyBinding.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1alpha1MutatingAdmissionPolicyBinding[]List of PolicyBinding.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AdmissionregistrationV1alpha1Api);

const res: k8s.V1alpha1MutatingAdmissionPolicyBindingList = await api.listMutatingAdmissionPolicyBinding({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: AdmissionregistrationV1alpha1Api.listMutatingAdmissionPolicyBinding

V1alpha1MutatingAdmissionPolicyBindingSpec

  • MutatingAdmissionPolicyBindingSpec is the specification of the MutatingAdmissionPolicyBinding.

Source

PropertyTypeDescription
policyNamestringpolicyName references a MutatingAdmissionPolicy name which the MutatingAdmissionPolicyBinding binds to. If the referenced resource does not exist, this binding is considered invalid and will be...
matchResourcesV1alpha1MatchResources
paramRefV1alpha1ParamRef

V1alpha1MutatingAdmissionPolicyList

  • MutatingAdmissionPolicyList is a list of MutatingAdmissionPolicy.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1alpha1MutatingAdmissionPolicy[]List of ValidatingAdmissionPolicy.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AdmissionregistrationV1alpha1Api);

const res: k8s.V1alpha1MutatingAdmissionPolicyList = await api.listMutatingAdmissionPolicy({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: AdmissionregistrationV1alpha1Api.listMutatingAdmissionPolicy

V1alpha1MutatingAdmissionPolicySpec

  • MutatingAdmissionPolicySpec is the specification of the desired behavior of the admission policy.

Source

PropertyTypeDescription
failurePolicystringfailurePolicy defines how to handle failures for the admission policy. Failures can occur from CEL expression parse errors, type check errors, runtime errors and invalid or mis-configured policy...
matchConditionsV1alpha1MatchCondition[]matchConditions is a list of conditions that must be met for a request to be validated. Match conditions filter requests that have already been matched by the matchConstraints. An empty list of...
mutationsV1alpha1Mutation[]mutations contain operations to perform on matching objects. mutations may not be empty; a minimum of one mutation is required. mutations are evaluated in order, and are reinvoked according to the...
reinvocationPolicystringreinvocationPolicy indicates whether mutations may be called multiple times per MutatingAdmissionPolicyBinding as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded"....
variablesV1alpha1Variable[]variables contain definitions of variables that can be used in composition of other expressions. Each variable is defined as a named CEL expression. The variables defined here will be available under...
matchConstraintsV1alpha1MatchResources
paramKindV1alpha1ParamKind

V1alpha1Mutation

  • Mutation specifies the CEL expression which is used to apply the Mutation.

Source

PropertyTypeDescription
patchTypestringpatchType indicates the patch strategy used. Allowed values are "ApplyConfiguration" and "JSONPatch". Required.
applyConfigurationV1alpha1ApplyConfiguration
jsonPatchV1alpha1JSONPatch

V1alpha1NamedRuleWithOperations

  • NamedRuleWithOperations is a tuple of Operations and Resources with ResourceNames.

Source

PropertyTypeDescription
apiGroupsstring[]APIGroups is the API groups the resources belong to. '' is all groups. If '' is present, the length of the slice must be one. Required.
apiVersionsstring[]APIVersions is the API versions the resources belong to. '' is all versions. If '' is present, the length of the slice must be one. Required.
operationsstring[]Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or * for all of those operations and any future admission operations that are added. If '*' is present,...
resourceNamesstring[]ResourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
resourcesstring[]Resources is a list of resources this rule applies to. For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '' means all resources, but not subresources. 'pods/_'...
scopestringscope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "*" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are...

V1alpha1ParamKind

  • ParamKind is a tuple of Group Kind and Version.

Source

PropertyTypeDescription
apiVersionstringAPIVersion is the API group version the resources belong to. In format of "group/version". Required.
kindstringKind is the API kind the resources belong to. Required.

V1alpha1ParamRef

  • ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.

Source

PropertyTypeDescription
namestringname is the name of the resource being referenced. name and selector are mutually exclusive properties. If one is set, the other must be unset.
namespacestringnamespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both name and selector fields. A per-namespace parameter may be...
parameterNotFoundActionstringparameterNotFoundAction controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to...
selectorV1LabelSelector

V1alpha1PodGroup

  • PodGroup represents a set of pods with a common scheduling policy.

Source

PropertyTypeDescription
namestringName is a unique identifier for the PodGroup within the Workload. It must be a DNS label. This field is immutable.
policyV1alpha1PodGroupPolicy

V1alpha1PodGroupPolicy

  • PodGroupPolicy defines the scheduling configuration for a PodGroup.

Source

PropertyTypeDescription
basicanyBasic specifies that the pods in this group should be scheduled using standard Kubernetes scheduling behavior.
gangV1alpha1GangSchedulingPolicy

V1alpha1ServerStorageVersion

  • An API server instance reports the version it can decode and the version it encodes objects to when persisting objects in the backend.

Source

PropertyTypeDescription
apiServerIDstringThe ID of the reporting API server.
decodableVersionsstring[]The API server can decode objects encoded in these versions. The encodingVersion must be included in the decodableVersions.
encodingVersionstringThe API server encodes the object to this version when persisting it in the backend (e.g., etcd).
servedVersionsstring[]The API server can serve these versions. DecodableVersions must include all ServedVersions.

V1alpha1StorageVersion

  • Storage version of a specific resource.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
specanySpec is an empty spec. It is here to comply with Kubernetes API style.
metadataV1ObjectMeta
statusV1alpha1StorageVersionStatus

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.InternalApiserverV1alpha1Api);

const body: k8s.V1alpha1StorageVersion = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createStorageVersion({ body });
console.log(res.metadata?.name);

Used by: InternalApiserverV1alpha1Api.createStorageVersion · InternalApiserverV1alpha1Api.readStorageVersion · InternalApiserverV1alpha1Api.readStorageVersionStatus

V1alpha1StorageVersionCondition

  • Describes the state of the storageVersion at a certain point.

Source

PropertyTypeDescription
lastTransitionTimeDateLast time the condition transitioned from one status to another.
messagestringA human readable message indicating details about the transition.
observedGenerationnumberIf set, this represents the .metadata.generation that the condition was set based upon.
reasonstringThe reason for the condition's last transition.
statusstringStatus of the condition, one of True, False, Unknown.
typestringType of the condition.

V1alpha1StorageVersionList

  • A list of StorageVersions.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1alpha1StorageVersion[]Items holds a list of StorageVersion
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.InternalApiserverV1alpha1Api);

const res: k8s.V1alpha1StorageVersionList = await api.listStorageVersion({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: InternalApiserverV1alpha1Api.listStorageVersion

V1alpha1StorageVersionStatus

  • API server instances report the versions they can decode and the version they encode objects to when persisting objects in the backend.

Source

PropertyTypeDescription
commonEncodingVersionstringIf all API server instances agree on the same encoding storage version, then this field is set to that version. Otherwise this field is left empty. API servers should finish updating its...
conditionsV1alpha1StorageVersionCondition[]The latest available observations of the storageVersion's state.
storageVersionsV1alpha1ServerStorageVersion[]The reported versions per API server instance.

V1alpha1TypedLocalObjectReference

  • TypedLocalObjectReference allows to reference typed object inside the same namespace.

Source

PropertyTypeDescription
apiGroupstringAPIGroup is the group for the resource being referenced. If APIGroup is empty, the specified Kind must be in the core API group. For any other third-party types, setting APIGroup is required. It must...
kindstringKind is the type of resource being referenced. It must be a path segment name.
namestringName is the name of resource being referenced. It must be a path segment name.

V1alpha1Variable

  • Variable is the definition of a variable that is used for composition.

Source

PropertyTypeDescription
expressionstringExpression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
namestringName is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through variables For example, if name is...

V1alpha1Workload

  • Workload allows for expressing scheduling constraints that should be used when managing lifecycle of workloads from scheduling perspective, including scheduling, preemption, eviction and other phases.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1alpha1WorkloadSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.SchedulingV1alpha1Api);

const body: k8s.V1alpha1Workload = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedWorkload({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: SchedulingV1alpha1Api.createNamespacedWorkload · SchedulingV1alpha1Api.patchNamespacedWorkload · SchedulingV1alpha1Api.readNamespacedWorkload

V1alpha1WorkloadList

  • WorkloadList contains a list of Workload resources.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1alpha1Workload[]Items is the list of Workloads.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.SchedulingV1alpha1Api);

const res: k8s.V1alpha1WorkloadList = await api.listNamespacedWorkload({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: SchedulingV1alpha1Api.listNamespacedWorkload · SchedulingV1alpha1Api.listWorkloadForAllNamespaces

V1alpha1WorkloadSpec

  • WorkloadSpec defines the desired state of a Workload.

Source

PropertyTypeDescription
podGroupsV1alpha1PodGroup[]PodGroups is the list of pod groups that make up the Workload. The maximum number of pod groups is 8. This field is immutable.
controllerRefV1alpha1TypedLocalObjectReference

V1alpha2LeaseCandidate

  • LeaseCandidate defines a candidate for a Lease object. Candidates are created such that coordinated leader election will pick the best leader from the list of candidates.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1alpha2LeaseCandidateSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CoordinationV1alpha2Api);

const body: k8s.V1alpha2LeaseCandidate = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedLeaseCandidate({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: CoordinationV1alpha2Api.createNamespacedLeaseCandidate · CoordinationV1alpha2Api.patchNamespacedLeaseCandidate · CoordinationV1alpha2Api.readNamespacedLeaseCandidate

V1alpha2LeaseCandidateList

  • LeaseCandidateList is a list of Lease objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1alpha2LeaseCandidate[]items is a list of schema objects.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CoordinationV1alpha2Api);

const res: k8s.V1alpha2LeaseCandidateList = await api.listNamespacedLeaseCandidate({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: CoordinationV1alpha2Api.listLeaseCandidateForAllNamespaces · CoordinationV1alpha2Api.listNamespacedLeaseCandidate

V1alpha2LeaseCandidateSpec

  • LeaseCandidateSpec is a specification of a Lease.

Source

PropertyTypeDescription
binaryVersionstringBinaryVersion is the binary version. It must be in a semver format without leading v. This field is required.
emulationVersionstringEmulationVersion is the emulation version. It must be in a semver format without leading v. EmulationVersion must be less than or equal to BinaryVersion. This field is required when strategy is...
leaseNamestringLeaseName is the name of the lease for which this candidate is contending. This field is immutable.
pingTimeV1MicroTimeMicroTime is version of Time with microsecond level precision.
renewTimeV1MicroTimeMicroTime is version of Time with microsecond level precision.
strategystringStrategy is the strategy that coordinated leader election will use for picking the leader. If multiple candidates for the same Lease return different strategies, the strategy provided by the...

V1alpha3DeviceTaint

  • The device this taint is attached to has the "effect" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.

Source

PropertyTypeDescription
effectstringThe effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are None, NoSchedule and NoExecute. PreferNoSchedule as used for nodes...
keystringThe taint key to be applied to a device. Must be a label name.
timeAddedDateTimeAdded represents the time at which the taint was added. Added automatically during create or update if not set.
valuestringThe taint value corresponding to the taint key. Must be a label value.

V1alpha3DeviceTaintRule

  • DeviceTaintRule adds one taint to all devices which match the selector. This has the same effect as if the taint was specified directly in the ResourceSlice by the DRA driver.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1alpha3DeviceTaintRuleSpec
statusV1alpha3DeviceTaintRuleStatus

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1alpha3Api);

const body: k8s.V1alpha3DeviceTaintRule = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createDeviceTaintRule({ body });
console.log(res.metadata?.name);

Used by: ResourceV1alpha3Api.createDeviceTaintRule · ResourceV1alpha3Api.readDeviceTaintRule · ResourceV1alpha3Api.readDeviceTaintRuleStatus

V1alpha3DeviceTaintRuleList

  • DeviceTaintRuleList is a collection of DeviceTaintRules.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1alpha3DeviceTaintRule[]Items is the list of DeviceTaintRules.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1alpha3Api);

const res: k8s.V1alpha3DeviceTaintRuleList = await api.listDeviceTaintRule({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1alpha3Api.listDeviceTaintRule

V1alpha3DeviceTaintRuleSpec

  • DeviceTaintRuleSpec specifies the selector and one taint.

Source

PropertyTypeDescription
deviceSelectorV1alpha3DeviceTaintSelector
taintV1alpha3DeviceTaint

V1alpha3DeviceTaintRuleStatus

  • DeviceTaintRuleStatus provides information about an on-going pod eviction.

Source

PropertyTypeDescription
conditionsV1Condition[]Conditions provide information about the state of the DeviceTaintRule and the cluster at some point in time, in a machine-readable and human-readable format. The following condition is currently...

V1alpha3DeviceTaintSelector

  • DeviceTaintSelector defines which device(s) a DeviceTaintRule applies to. The empty selector matches all devices. Without a selector, no devices are matched.

Source

PropertyTypeDescription
devicestringIf device is set, only devices with that name are selected. This field corresponds to slice.spec.devices[].name. Setting also driver and pool may be required to avoid ambiguity, but is not required.
driverstringIf driver is set, only devices from that driver are selected. This fields corresponds to slice.spec.driver.
poolstringIf pool is set, only devices in that pool are selected. Also setting the driver name may be useful to avoid ambiguity when different drivers use the same pool name, but this is not required because...

V1beta1AllocatedDeviceStatus

  • AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information. The combination of Driver, Pool, Device, and ShareID must match the corresponding key in Status.Allocation.Devices.

Source

PropertyTypeDescription
conditionsV1Condition[]Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the Ready condition should be True. Must...
dataanyData contains arbitrary driver-specific data. The length of the raw data must be smaller or equal to 10 Ki.
devicestringDevice references one device instance via its name in the driver's resource pool. It must be a DNS label.
driverstringDriver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node. Must be a DNS subdomain and should end with a DNS...
poolstringThis name together with the driver name and the device name field identify which device was allocated (<driver name>/<pool name>/<device name>). Must not be longer than 253 characters and may...
shareIDstringShareID uniquely identifies an individual allocation share of the device.
networkDataV1beta1NetworkDeviceData

V1beta1AllocationResult

  • AllocationResult contains attributes of an allocated resource.

Source

PropertyTypeDescription
allocationTimestampDateAllocationTimestamp stores the time when the resources were allocated. This field is not guaranteed to be set, in which case that time is unknown. This is an alpha field and requires enabling the...
devicesV1beta1DeviceAllocationResult
nodeSelectorV1NodeSelector

V1beta1ApplyConfiguration

  • ApplyConfiguration defines the desired configuration values of an object.

Source

PropertyTypeDescription
expressionstringexpression will be evaluated by CEL to create an apply configuration. ref: https://github.com/google/cel-spec Apply configurations are declared in CEL using object initialization. For example, this...

V1beta1BasicDevice

  • BasicDevice defines one device instance.

Source

PropertyTypeDescription
allNodesbooleanAllNodes indicates that all nodes have access to the device. Must only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.
allowMultipleAllocationsbooleanAllowMultipleAllocations marks whether the device is allowed to be allocated to multiple DeviceRequests. If AllowMultipleAllocations is set to true, the device can be allocated more than once, and...
attributes{ [key: string]: V1beta1DeviceAttributeAttributes defines the set of attributes for this device. The name of each attribute must be unique in that set. The maximum number of attributes and capacities combined is 32.
bindingConditionsstring[]BindingConditions defines the conditions for proceeding with binding. All of these conditions must be set in the per-device status conditions with a value of True to proceed with binding the pod to...
bindingFailureConditionsstring[]BindingFailureConditions defines the conditions for binding failure. They may be set in the per-device status conditions. If any is true, a binding failure occurred. The maximum number of binding...
bindsToNodebooleanBindsToNode indicates if the usage of an allocation involving this device has to be limited to exactly the node that was chosen when allocating the claim. If set to true, the scheduler will set the...
capacity{ [key: string]: V1beta1DeviceCapacityCapacity defines the set of capacities for this device. The name of each capacity must be unique in that set. The maximum number of attributes and capacities combined is 32.
consumesCountersV1beta1DeviceCounterConsumption[]ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets. There can only be a single entry per counterSet. The...
nodeNamestringNodeName identifies the node where the device is available. Must only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.
taintsV1beta1DeviceTaint[]If specified, these are the driver-defined taints. The maximum number of taints is 16. If taints are set for any device in a ResourceSlice, then the maximum number of allowed devices per...
nodeSelectorV1NodeSelector

V1beta1CELDeviceSelector

  • CELDeviceSelector contains a CEL expression for selecting a device.

Source

PropertyTypeDescription
expressionstringExpression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other...

V1beta1CapacityRequestPolicy

  • CapacityRequestPolicy defines how requests consume device capacity. Must not set more than one ValidRequestValues.

Source

PropertyTypeDescription
_defaultstringDefault specifies how much of this capacity is consumed by a request that does not contain an entry for it in DeviceRequest's Capacity.
validValuesstring[]ValidValues defines a set of acceptable quantity values in consuming requests. Must not contain more than 10 entries. Must be sorted in ascending order. If this field is set, Default must be...
validRangeV1beta1CapacityRequestPolicyRange

V1beta1CapacityRequestPolicyRange

  • CapacityRequestPolicyRange defines a valid range for consumable capacity values. - If the requested amount is less than Min, it is rounded up to the Min value. - If Step is set and the requested amount is between Min and Max but not aligned with Step, it will be rounded up to the next value equal to Min + (n * Step). - If Step is not set, the requested amount is used as-is if it falls within the range Min to Max (if set). - If the requested or rounded amount exceeds Max (if set), the request does not satisfy the policy, and the device cannot be allocated.

Source

PropertyTypeDescription
maxstringMax defines the upper limit for capacity that can be requested. Max must be less than or equal to the capacity value. Min and requestPolicy.default must be less than or equal to the maximum.
minstringMin specifies the minimum capacity allowed for a consumption request. Min must be greater than or equal to zero, and less than or equal to the capacity value. requestPolicy.default must be more than...
stepstringStep defines the step size between valid capacity amounts within the range. Max (if set) and requestPolicy.default must be a multiple of Step. Min + Step must be less than or equal to the capacity...

V1beta1CapacityRequirements

  • CapacityRequirements defines the capacity requirements for a specific device request.

Source

PropertyTypeDescription
requests{ [key: string]: stringRequests represent individual device resource requests for distinct resources, all of which must be provided by the device. This value is used as an additional filtering condition against the...

V1beta1ClusterTrustBundle

  • ClusterTrustBundle is a cluster-scoped container for X.509 trust anchors (root certificates). ClusterTrustBundle objects are considered to be readable by any authenticated user in the cluster, because they can be mounted by pods using the clusterTrustBundle projection. All service accounts have read access to ClusterTrustBundles by default. Users who only have namespace-level access to a cluster can read ClusterTrustBundles by impersonating a serviceaccount that they have access to. It can be optionally associated with a particular assigner, in which case it contains one valid set of trust anchors for that signer. Signers may have multiple associated ClusterTrustBundles; each is an independent set of trust anchors for that signer. Admission control is used to enforce that only users with permissions on the signer can create or modify the corresponding bundle.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1ClusterTrustBundleSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CertificatesV1beta1Api);

const body: k8s.V1beta1ClusterTrustBundle = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createClusterTrustBundle({ body });
console.log(res.metadata?.name);

Used by: CertificatesV1beta1Api.createClusterTrustBundle · CertificatesV1beta1Api.patchClusterTrustBundle · CertificatesV1beta1Api.readClusterTrustBundle

V1beta1ClusterTrustBundleList

  • ClusterTrustBundleList is a collection of ClusterTrustBundle objects

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1ClusterTrustBundle[]items is a collection of ClusterTrustBundle objects
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CertificatesV1beta1Api);

const res: k8s.V1beta1ClusterTrustBundleList = await api.listClusterTrustBundle({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: CertificatesV1beta1Api.listClusterTrustBundle

V1beta1ClusterTrustBundleSpec

  • ClusterTrustBundleSpec contains the signer and trust anchors.

Source

PropertyTypeDescription
signerNamestringsignerName indicates the associated signer, if any. In order to create or update a ClusterTrustBundle that sets signerName, you must have the following cluster-scoped permission:...
trustBundlestringtrustBundle contains the individual X.509 trust anchors for this bundle, as PEM bundle of PEM-wrapped, DER-formatted X.509 certificates. The data must consist only of PEM certificate blocks that...

V1beta1Counter

  • Counter describes a quantity associated with a device.

Source

PropertyTypeDescription
valuestringValue defines how much of a certain device counter is available.

V1beta1CounterSet

  • CounterSet defines a named set of counters that are available to be used by devices defined in the ResourcePool. The counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.

Source

PropertyTypeDescription
counters{ [key: string]: V1beta1CounterCounters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label. The maximum number of counters is 32.
namestringName defines the name of the counter set. It must be a DNS label.

V1beta1Device

  • Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.

Source

PropertyTypeDescription
namestringName is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.
basicV1beta1BasicDevice

V1beta1DeviceAllocationConfiguration

  • DeviceAllocationConfiguration gets embedded in an AllocationResult.

Source

PropertyTypeDescription
requestsstring[]Requests lists the names of requests where the configuration applies. If empty, its applies to all requests. References to subrequests must include the name of the main request and may include the...
sourcestringSource records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.
opaqueV1beta1OpaqueDeviceConfiguration

V1beta1DeviceAllocationResult

  • DeviceAllocationResult is the result of allocating devices.

Source

PropertyTypeDescription
configV1beta1DeviceAllocationConfiguration[]This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag. This includes configuration parameters for drivers which have...
resultsV1beta1DeviceRequestAllocationResult[]Results lists all allocated devices.

V1beta1DeviceAttribute

  • DeviceAttribute must have exactly one field set.

Source

PropertyTypeDescription
boolbooleanBoolValue is a true/false value.
_intnumberIntValue is a number.
stringstringStringValue is a string. Must not be longer than 64 characters.
versionstringVersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.

V1beta1DeviceCapacity

  • DeviceCapacity describes a quantity associated with a device.

Source

PropertyTypeDescription
valuestringValue defines how much of a certain capacity that device has. This field reflects the fixed total capacity and does not change. The consumed amount is tracked separately by scheduler and does not...
requestPolicyV1beta1CapacityRequestPolicy

V1beta1DeviceClaim

  • DeviceClaim defines how to request devices with a ResourceClaim.

Source

PropertyTypeDescription
configV1beta1DeviceClaimConfiguration[]This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.
constraintsV1beta1DeviceConstraint[]These constraints must be satisfied by the set of devices that get allocated for the claim.
requestsV1beta1DeviceRequest[]Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.

V1beta1DeviceClaimConfiguration

  • DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.

Source

PropertyTypeDescription
requestsstring[]Requests lists the names of requests where the configuration applies. If empty, it applies to all requests. References to subrequests must include the name of the main request and may include the...
opaqueV1beta1OpaqueDeviceConfiguration

V1beta1DeviceClass

  • DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1DeviceClassSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta1Api);

const body: k8s.V1beta1DeviceClass = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createDeviceClass({ body });
console.log(res.metadata?.name);

Used by: ResourceV1beta1Api.createDeviceClass · ResourceV1beta1Api.patchDeviceClass · ResourceV1beta1Api.readDeviceClass

V1beta1DeviceClassConfiguration

  • DeviceClassConfiguration is used in DeviceClass.

Source

PropertyTypeDescription
opaqueV1beta1OpaqueDeviceConfiguration

V1beta1DeviceClassList

  • DeviceClassList is a collection of classes.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1DeviceClass[]Items is the list of resource classes.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta1Api);

const res: k8s.V1beta1DeviceClassList = await api.listDeviceClass({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1beta1Api.listDeviceClass

V1beta1DeviceClassSpec

  • DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.

Source

PropertyTypeDescription
configV1beta1DeviceClassConfiguration[]Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor...
extendedResourceNamestringExtendedResourceName is the extended resource name for the devices of this class. The devices of this class can be used to satisfy a pod's extended resource requests. It has the same format as the...
selectorsV1beta1DeviceSelector[]Each selector must be satisfied by a device which is claimed via this class.

V1beta1DeviceConstraint

  • DeviceConstraint must have exactly one field set besides Requests.

Source

PropertyTypeDescription
distinctAttributestringDistinctAttribute requires that all devices in question have this attribute and that its type and value are unique across those devices. This acts as the inverse of MatchAttribute. This constraint...
matchAttributestringMatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices. For example, if you specified "dra.example.com/numa" (a...
requestsstring[]Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint....

V1beta1DeviceCounterConsumption

  • DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.

Source

PropertyTypeDescription
counterSetstringCounterSet is the name of the set from which the counters defined will be consumed.
counters{ [key: string]: V1beta1CounterCounters defines the counters that will be consumed by the device. The maximum number of counters is 32.

V1beta1DeviceRequest

  • DeviceRequest is a request for devices required for a claim. This is typically a request for a single resource like a device, but can also ask for several identical devices.

Source

PropertyTypeDescription
adminAccessbooleanAdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They...
allocationModestringAllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are: - ExactCount: This request is for a specific number of devices. This is the...
countnumberCount is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one. This field can only be set...
deviceClassNamestringDeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request. A class is required if no subrequests are specified in the...
firstAvailableV1beta1DeviceSubRequest[]FirstAvailable contains subrequests, of which exactly one will be satisfied by the scheduler to satisfy this request. It tries to satisfy them in the order in which they are listed here. So if there...
namestringName can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim. Must be a DNS label and unique among all DeviceRequests in a...
selectorsV1beta1DeviceSelector[]Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered. This...
tolerationsV1beta1DeviceToleration[]If specified, the request's tolerations. Tolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute. In addition, should any of...
capacityV1beta1CapacityRequirements

V1beta1DeviceRequestAllocationResult

  • DeviceRequestAllocationResult contains the allocation result for one request.

Source

PropertyTypeDescription
adminAccessbooleanAdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode. This is an alpha field and requires enabling the...
bindingConditionsstring[]BindingConditions contains a copy of the BindingConditions from the corresponding ResourceSlice at the time of allocation. This is an alpha field and requires enabling the DRADeviceBindingConditions...
bindingFailureConditionsstring[]BindingFailureConditions contains a copy of the BindingFailureConditions from the corresponding ResourceSlice at the time of allocation. This is an alpha field and requires enabling the...
consumedCapacity{ [key: string]: stringConsumedCapacity tracks the amount of capacity consumed per device as part of the claim request. The consumed amount may differ from the requested amount: it is rounded up to the nearest valid value...
devicestringDevice references one device instance via its name in the driver's resource pool. It must be a DNS label.
driverstringDriver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node. Must be a DNS subdomain and should end with a DNS...
poolstringThis name together with the driver name and the device name field identify which device was allocated (<driver name>/<pool name>/<device name>). Must not be longer than 253 characters and may...
requeststringRequest is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the...
shareIDstringShareID uniquely identifies an individual allocation share of the device, used when the device supports multiple simultaneous allocations. It serves as an additional map key to differentiate...
tolerationsV1beta1DeviceToleration[]A copy of all tolerations specified in the request at the time when the device got allocated. The maximum number of tolerations is 16. This is an alpha field and requires enabling the...

V1beta1DeviceSelector

  • DeviceSelector must have exactly one field set.

Source

PropertyTypeDescription
celV1beta1CELDeviceSelector

V1beta1DeviceSubRequest

  • DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices. DeviceSubRequest is similar to Request, but doesn't expose the AdminAccess or FirstAvailable fields, as those can only be set on the top-level request. AdminAccess is not supported for requests with a prioritized list, and recursive FirstAvailable fields are not supported.

Source

PropertyTypeDescription
allocationModestringAllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are: - ExactCount: This request is for a specific number of devices. This is the...
countnumberCount is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
deviceClassNamestringDeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest. A class is required. Which classes are available...
namestringName can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format
/. Must be a DNS label.
selectorsV1beta1DeviceSelector[]Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.
tolerationsV1beta1DeviceToleration[]If specified, the request's tolerations. Tolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute. In addition, should any of...
capacityV1beta1CapacityRequirements

V1beta1DeviceTaint

  • The device this taint is attached to has the "effect" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.

Source

PropertyTypeDescription
effectstringThe effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are None, NoSchedule and NoExecute. PreferNoSchedule as used for nodes...
keystringThe taint key to be applied to a device. Must be a label name.
timeAddedDateTimeAdded represents the time at which the taint was added. Added automatically during create or update if not set.
valuestringThe taint value corresponding to the taint key. Must be a label value.

V1beta1DeviceToleration

  • The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator .

Source

PropertyTypeDescription
effectstringEffect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.
keystringKey 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. Must be a...
operatorstringOperator 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 ResourceClaim can tolerate all...
tolerationSecondsnumberTolerationSeconds 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...
valuestringValue is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.

V1beta1IPAddress

  • IPAddress represents a single IP of a single IP Family. The object is designed to be used by APIs that operate on IP addresses. The object is used by the Service core API for allocation of IP addresses. An IP address can be represented in different formats, to guarantee the uniqueness of the IP, the name of the object is the IP address in canonical format, four decimal digits separated by dots suppressing leading zeros for IPv4 and the representation defined by RFC 5952 for IPv6. Valid: 192.168.1.5 or 2001:db8::1 or 2001:db8:aaaa:bbbb:cccc:dddd:eeee:1 Invalid: 10.01.2.3 or 2001:db8:0:0:0::1

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1IPAddressSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.NetworkingV1beta1Api);

const body: k8s.V1beta1IPAddress = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createIPAddress({ body });
console.log(res.metadata?.name);

Used by: NetworkingV1beta1Api.createIPAddress · NetworkingV1beta1Api.patchIPAddress · NetworkingV1beta1Api.readIPAddress

V1beta1IPAddressList

  • IPAddressList contains a list of IPAddress.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1IPAddress[]items is the list of IPAddresses.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.NetworkingV1beta1Api);

const res: k8s.V1beta1IPAddressList = await api.listIPAddress({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: NetworkingV1beta1Api.listIPAddress

V1beta1IPAddressSpec

  • IPAddressSpec describe the attributes in an IP Address.

Source

PropertyTypeDescription
parentRefV1beta1ParentReference

V1beta1JSONPatch

  • JSONPatch defines a JSON Patch.

Source

PropertyTypeDescription
expressionstringexpression will be evaluated by CEL to create a JSON patch. ref: https://github.com/google/cel-spec expression must return an array of JSONPatch values. For example, this...

V1beta1LeaseCandidate

  • LeaseCandidate defines a candidate for a Lease object. Candidates are created such that coordinated leader election will pick the best leader from the list of candidates.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1LeaseCandidateSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CoordinationV1beta1Api);

const body: k8s.V1beta1LeaseCandidate = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedLeaseCandidate({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: CoordinationV1beta1Api.createNamespacedLeaseCandidate · CoordinationV1beta1Api.patchNamespacedLeaseCandidate · CoordinationV1beta1Api.readNamespacedLeaseCandidate

V1beta1LeaseCandidateList

  • LeaseCandidateList is a list of Lease objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1LeaseCandidate[]items is a list of schema objects.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CoordinationV1beta1Api);

const res: k8s.V1beta1LeaseCandidateList = await api.listNamespacedLeaseCandidate({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: CoordinationV1beta1Api.listLeaseCandidateForAllNamespaces · CoordinationV1beta1Api.listNamespacedLeaseCandidate

V1beta1LeaseCandidateSpec

  • LeaseCandidateSpec is a specification of a Lease.

Source

PropertyTypeDescription
binaryVersionstringBinaryVersion is the binary version. It must be in a semver format without leading v. This field is required.
emulationVersionstringEmulationVersion is the emulation version. It must be in a semver format without leading v. EmulationVersion must be less than or equal to BinaryVersion. This field is required when strategy is...
leaseNamestringLeaseName is the name of the lease for which this candidate is contending. The limits on this field are the same as on Lease.name. Multiple lease candidates may reference the same Lease.name. This...
pingTimeV1MicroTimeMicroTime is version of Time with microsecond level precision.
renewTimeV1MicroTimeMicroTime is version of Time with microsecond level precision.
strategystringStrategy is the strategy that coordinated leader election will use for picking the leader. If multiple candidates for the same Lease return different strategies, the strategy provided by the...

V1beta1MatchCondition

  • MatchCondition represents a condition which must be fulfilled for a request to be sent to a webhook.

Source

PropertyTypeDescription
expressionstringExpression represents the expression which will be evaluated by CEL. Must evaluate to bool. CEL expressions have access to the contents of the AdmissionRequest and Authorizer, organized into CEL...
namestringName is an identifier for this match condition, used for strategic merging of MatchConditions, as well as providing an identifier for logging purposes. A good name should be descriptive of the...

V1beta1MatchResources

  • MatchResources decides whether to run the admission control policy on an object based on whether it meets the match criteria. The exclude rules take precedence over include rules (if a resource matches both, it is excluded)

Source

PropertyTypeDescription
excludeResourceRulesV1beta1NamedRuleWithOperations[]ExcludeResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy should not care about. The exclude rules take precedence over include rules (if a resource...
matchPolicystringmatchPolicy defines how the "MatchResources" list is used to match incoming requests. Allowed values are "Exact" or "Equivalent". - Exact: match a request only if it exactly matches a...
resourceRulesV1beta1NamedRuleWithOperations[]ResourceRules describes what operations on what resources/subresources the ValidatingAdmissionPolicy matches. The policy cares about an operation if it matches any Rule.
namespaceSelectorV1LabelSelector
objectSelectorV1LabelSelector

V1beta1MutatingAdmissionPolicy

  • MutatingAdmissionPolicy describes the definition of an admission mutation policy that mutates the object coming into admission chain.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1MutatingAdmissionPolicySpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AdmissionregistrationV1beta1Api);

const body: k8s.V1beta1MutatingAdmissionPolicy = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createMutatingAdmissionPolicy({ body });
console.log(res.metadata?.name);

Used by: AdmissionregistrationV1beta1Api.createMutatingAdmissionPolicy · AdmissionregistrationV1beta1Api.patchMutatingAdmissionPolicy · AdmissionregistrationV1beta1Api.readMutatingAdmissionPolicy

V1beta1MutatingAdmissionPolicyBinding

  • MutatingAdmissionPolicyBinding binds the MutatingAdmissionPolicy with parametrized resources. MutatingAdmissionPolicyBinding and the optional parameter resource together define how cluster administrators configure policies for clusters. For a given admission request, each binding will cause its policy to be evaluated N times, where N is 1 for policies/bindings that don't use params, otherwise N is the number of parameters selected by the binding. Each evaluation is constrained by a runtime cost budget. Adding/removing policies, bindings, or params can not affect whether a given (policy, binding, param) combination is within its own CEL budget.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1MutatingAdmissionPolicyBindingSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AdmissionregistrationV1beta1Api);

const body: k8s.V1beta1MutatingAdmissionPolicyBinding = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createMutatingAdmissionPolicyBinding({ body });
console.log(res.metadata?.name);

Used by: AdmissionregistrationV1beta1Api.createMutatingAdmissionPolicyBinding · AdmissionregistrationV1beta1Api.patchMutatingAdmissionPolicyBinding · AdmissionregistrationV1beta1Api.readMutatingAdmissionPolicyBinding

V1beta1MutatingAdmissionPolicyBindingList

  • MutatingAdmissionPolicyBindingList is a list of MutatingAdmissionPolicyBinding.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1MutatingAdmissionPolicyBinding[]List of PolicyBinding.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AdmissionregistrationV1beta1Api);

const res: k8s.V1beta1MutatingAdmissionPolicyBindingList = await api.listMutatingAdmissionPolicyBinding({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: AdmissionregistrationV1beta1Api.listMutatingAdmissionPolicyBinding

V1beta1MutatingAdmissionPolicyBindingSpec

  • MutatingAdmissionPolicyBindingSpec is the specification of the MutatingAdmissionPolicyBinding.

Source

PropertyTypeDescription
policyNamestringpolicyName references a MutatingAdmissionPolicy name which the MutatingAdmissionPolicyBinding binds to. If the referenced resource does not exist, this binding is considered invalid and will be...
matchResourcesV1beta1MatchResources
paramRefV1beta1ParamRef

V1beta1MutatingAdmissionPolicyList

  • MutatingAdmissionPolicyList is a list of MutatingAdmissionPolicy.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1MutatingAdmissionPolicy[]List of ValidatingAdmissionPolicy.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AdmissionregistrationV1beta1Api);

const res: k8s.V1beta1MutatingAdmissionPolicyList = await api.listMutatingAdmissionPolicy({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: AdmissionregistrationV1beta1Api.listMutatingAdmissionPolicy

V1beta1MutatingAdmissionPolicySpec

  • MutatingAdmissionPolicySpec is the specification of the desired behavior of the admission policy.

Source

PropertyTypeDescription
failurePolicystringfailurePolicy defines how to handle failures for the admission policy. Failures can occur from CEL expression parse errors, type check errors, runtime errors and invalid or mis-configured policy...
matchConditionsV1beta1MatchCondition[]matchConditions is a list of conditions that must be met for a request to be validated. Match conditions filter requests that have already been matched by the matchConstraints. An empty list of...
mutationsV1beta1Mutation[]mutations contain operations to perform on matching objects. mutations may not be empty; a minimum of one mutation is required. mutations are evaluated in order, and are reinvoked according to the...
reinvocationPolicystringreinvocationPolicy indicates whether mutations may be called multiple times per MutatingAdmissionPolicyBinding as part of a single admission evaluation. Allowed values are "Never" and "IfNeeded"....
variablesV1beta1Variable[]variables contain definitions of variables that can be used in composition of other expressions. Each variable is defined as a named CEL expression. The variables defined here will be available under...
matchConstraintsV1beta1MatchResources
paramKindV1beta1ParamKind

V1beta1Mutation

  • Mutation specifies the CEL expression which is used to apply the Mutation.

Source

PropertyTypeDescription
patchTypestringpatchType indicates the patch strategy used. Allowed values are "ApplyConfiguration" and "JSONPatch". Required.
applyConfigurationV1beta1ApplyConfiguration
jsonPatchV1beta1JSONPatch

V1beta1NamedRuleWithOperations

  • NamedRuleWithOperations is a tuple of Operations and Resources with ResourceNames.

Source

PropertyTypeDescription
apiGroupsstring[]APIGroups is the API groups the resources belong to. '' is all groups. If '' is present, the length of the slice must be one. Required.
apiVersionsstring[]APIVersions is the API versions the resources belong to. '' is all versions. If '' is present, the length of the slice must be one. Required.
operationsstring[]Operations is the operations the admission hook cares about - CREATE, UPDATE, DELETE, CONNECT or * for all of those operations and any future admission operations that are added. If '*' is present,...
resourceNamesstring[]ResourceNames is an optional white list of names that the rule applies to. An empty set means that everything is allowed.
resourcesstring[]Resources is a list of resources this rule applies to. For example: 'pods' means pods. 'pods/log' means the log subresource of pods. '' means all resources, but not subresources. 'pods/_'...
scopestringscope specifies the scope of this rule. Valid values are "Cluster", "Namespaced", and "*" "Cluster" means that only cluster-scoped resources will match this rule. Namespace API objects are...

V1beta1NetworkDeviceData

  • NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.

Source

PropertyTypeDescription
hardwareAddressstringHardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface. Must not be longer than 128 characters.
interfaceNamestringInterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod. Must...
ipsstring[]IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the...

V1beta1OpaqueDeviceConfiguration

  • OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.

Source

PropertyTypeDescription
driverstringDriver is used to determine which kubelet plugin needs to be passed these configuration parameters. An admission policy provided by the driver developer could use this to decide whether it needs to...
parametersanyParameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version ("kind" +...

V1beta1ParamKind

  • ParamKind is a tuple of Group Kind and Version.

Source

PropertyTypeDescription
apiVersionstringAPIVersion is the API group version the resources belong to. In format of "group/version". Required.
kindstringKind is the API kind the resources belong to. Required.

V1beta1ParamRef

  • ParamRef describes how to locate the params to be used as input to expressions of rules applied by a policy binding.

Source

PropertyTypeDescription
namestringname is the name of the resource being referenced. One of name or selector must be set, but name and selector are mutually exclusive properties. If one is set, the other must be unset. A...
namespacestringnamespace is the namespace of the referenced resource. Allows limiting the search for params to a specific namespace. Applies to both name and selector fields. A per-namespace parameter may be...
parameterNotFoundActionstringparameterNotFoundAction controls the behavior of the binding when the resource exists, and name or selector is valid, but there are no parameters matched by the binding. If the value is set to...
selectorV1LabelSelector

V1beta1ParentReference

  • ParentReference describes a reference to a parent object.

Source

PropertyTypeDescription
groupstringGroup is the group of the object being referenced.
namestringName is the name of the object being referenced.
namespacestringNamespace is the namespace of the object being referenced.
resourcestringResource is the resource of the object being referenced.

V1beta1PodCertificateRequest

  • PodCertificateRequest encodes a pod requesting a certificate from a given signer. Kubelets use this API to implement podCertificate projected volumes

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1PodCertificateRequestSpec
statusV1beta1PodCertificateRequestStatus

V1beta1PodCertificateRequestList

  • PodCertificateRequestList is a collection of PodCertificateRequest objects

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1PodCertificateRequest[]items is a collection of PodCertificateRequest objects
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.CertificatesV1beta1Api);

const res: k8s.V1beta1PodCertificateRequestList = await api.listNamespacedPodCertificateRequest({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: CertificatesV1beta1Api.listNamespacedPodCertificateRequest · CertificatesV1beta1Api.listPodCertificateRequestForAllNamespaces

V1beta1PodCertificateRequestSpec

  • PodCertificateRequestSpec describes the certificate request. All fields are immutable after creation.

Source

PropertyTypeDescription
maxExpirationSecondsnumbermaxExpirationSeconds is the maximum lifetime permitted for the certificate. If omitted, kube-apiserver will set it to 86400(24 hours). kube-apiserver will reject values shorter than 3600 (1 hour). ...
nodeNamestringnodeName is the name of the node the pod is assigned to.
nodeUIDstringnodeUID is the UID of the node the pod is assigned to.
pkixPublicKeystringpkixPublicKey is the PKIX-serialized public key the signer will issue the certificate to. The key must be one of RSA3072, RSA4096, ECDSAP256, ECDSAP384, ECDSAP521, or ED25519. Note that this list...
podNamestringpodName is the name of the pod into which the certificate will be mounted.
podUIDstringpodUID is the UID of the pod into which the certificate will be mounted.
proofOfPossessionstringproofOfPossession proves that the requesting kubelet holds the private key corresponding to pkixPublicKey. It is contructed by signing the ASCII bytes of the pod's UID using pkixPublicKey. ...
serviceAccountNamestringserviceAccountName is the name of the service account the pod is running as.
serviceAccountUIDstringserviceAccountUID is the UID of the service account the pod is running as.
signerNamestringsignerName indicates the requested signer. All signer names beginning with kubernetes.io are reserved for use by the Kubernetes project. There is currently one well-known signer documented by the...
unverifiedUserAnnotations{ [key: string]: stringunverifiedUserAnnotations allow pod authors to pass additional information to the signer implementation. Kubernetes does not restrict or validate this metadata in any way. Entries are subject to...

V1beta1PodCertificateRequestStatus

  • PodCertificateRequestStatus describes the status of the request, and holds the certificate data if the request is issued.

Source

PropertyTypeDescription
beginRefreshAtDatebeginRefreshAt is the time at which the kubelet should begin trying to refresh the certificate. This field is set via the /status subresource, and must be set at the same time as certificateChain. ...
certificateChainstringcertificateChain is populated with an issued certificate by the signer. This field is set via the /status subresource. Once populated, this field is immutable. If the certificate signing request is...
conditionsV1Condition[]conditions applied to the request. The types "Issued", "Denied", and "Failed" have special handling. At most one of these conditions may be present, and they must have status "True". If...
notAfterDatenotAfter is the time at which the certificate expires. The value must be the same as the notAfter value in the leaf certificate in certificateChain. This field is set via the /status subresource. ...
notBeforeDatenotBefore is the time at which the certificate becomes valid. The value must be the same as the notBefore value in the leaf certificate in certificateChain. This field is set via the /status...

V1beta1ResourceClaim

  • ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1ResourceClaimSpec
statusV1beta1ResourceClaimStatus

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta1Api);

const body: k8s.V1beta1ResourceClaim = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedResourceClaim({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: ResourceV1beta1Api.createNamespacedResourceClaim · ResourceV1beta1Api.readNamespacedResourceClaim · ResourceV1beta1Api.readNamespacedResourceClaimStatus

V1beta1ResourceClaimConsumerReference

  • ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.

Source

PropertyTypeDescription
apiGroupstringAPIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
namestringName is the name of resource being referenced.
resourcestringResource is the type of resource being referenced, for example "pods".
uidstringUID identifies exactly one incarnation of the resource.

V1beta1ResourceClaimList

  • ResourceClaimList is a collection of claims.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1ResourceClaim[]Items is the list of resource claims.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta1Api);

const res: k8s.V1beta1ResourceClaimList = await api.listNamespacedResourceClaim({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1beta1Api.listNamespacedResourceClaim · ResourceV1beta1Api.listResourceClaimForAllNamespaces

V1beta1ResourceClaimSpec

  • ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.

Source

PropertyTypeDescription
devicesV1beta1DeviceClaim

V1beta1ResourceClaimStatus

  • ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.

Source

PropertyTypeDescription
devicesV1beta1AllocatedDeviceStatus[]Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.
reservedForV1beta1ResourceClaimConsumerReference[]ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or...
allocationV1beta1AllocationResult

V1beta1ResourceClaimTemplate

  • ResourceClaimTemplate is used to produce ResourceClaim objects. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1ResourceClaimTemplateSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta1Api);

const body: k8s.V1beta1ResourceClaimTemplate = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedResourceClaimTemplate({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: ResourceV1beta1Api.createNamespacedResourceClaimTemplate · ResourceV1beta1Api.patchNamespacedResourceClaimTemplate · ResourceV1beta1Api.readNamespacedResourceClaimTemplate

V1beta1ResourceClaimTemplateList

  • ResourceClaimTemplateList is a collection of claim templates.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1ResourceClaimTemplate[]Items is the list of resource claim templates.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta1Api);

const res: k8s.V1beta1ResourceClaimTemplateList = await api.listNamespacedResourceClaimTemplate({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1beta1Api.listNamespacedResourceClaimTemplate · ResourceV1beta1Api.listResourceClaimTemplateForAllNamespaces

V1beta1ResourceClaimTemplateSpec

  • ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.

Source

PropertyTypeDescription
metadataV1ObjectMeta
specV1beta1ResourceClaimSpec

V1beta1ResourcePool

  • ResourcePool describes the pool that ResourceSlices belong to.

Source

PropertyTypeDescription
generationnumberGeneration tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part...
namestringName is used to identify the pool. For node-local devices, this is often the node name, but this is not required. It must not be longer than 253 characters and must consist of one or more DNS...
resourceSliceCountnumberResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero. Consumers can use this to check whether they have seen all ResourceSlices...

V1beta1ResourceSlice

  • ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver. At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple , , . Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others. When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool. For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1ResourceSliceSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta1Api);

const body: k8s.V1beta1ResourceSlice = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createResourceSlice({ body });
console.log(res.metadata?.name);

Used by: ResourceV1beta1Api.createResourceSlice · ResourceV1beta1Api.patchResourceSlice · ResourceV1beta1Api.readResourceSlice

V1beta1ResourceSliceList

  • ResourceSliceList is a collection of ResourceSlices.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1ResourceSlice[]Items is the list of resource ResourceSlices.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta1Api);

const res: k8s.V1beta1ResourceSliceList = await api.listResourceSlice({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1beta1Api.listResourceSlice

V1beta1ResourceSliceSpec

  • ResourceSliceSpec contains the information published by the driver in one ResourceSlice.

Source

PropertyTypeDescription
allNodesbooleanAllNodes indicates that all nodes have access to the resources in the pool. Exactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.
devicesV1beta1Device[]Devices lists some or all of the devices in this pool. Must not have more than 128 entries. If any device uses taints or consumes counters the limit is 64. Only one of Devices and SharedCounters...
driverstringDriver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name. Must be a DNS subdomain and should...
nodeNamestringNodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node. This field can be used to limit...
perDeviceNodeSelectionbooleanPerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice...
sharedCountersV1beta1CounterSet[]SharedCounters defines a list of counter sets, each of which has a name and a list of counters available. The names of the counter sets must be unique in the ResourcePool. Only one of Devices and...
nodeSelectorV1NodeSelector
poolV1beta1ResourcePool

V1beta1ServiceCIDR

  • ServiceCIDR defines a range of IP addresses using CIDR format (e.g. 192.168.0.0/24 or 2001:db2::/64). This range is used to allocate ClusterIPs to Service objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1ServiceCIDRSpec
statusV1beta1ServiceCIDRStatus

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.NetworkingV1beta1Api);

const body: k8s.V1beta1ServiceCIDR = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createServiceCIDR({ body });
console.log(res.metadata?.name);

Used by: NetworkingV1beta1Api.createServiceCIDR · NetworkingV1beta1Api.readServiceCIDR · NetworkingV1beta1Api.readServiceCIDRStatus

V1beta1ServiceCIDRList

  • ServiceCIDRList contains a list of ServiceCIDR objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1ServiceCIDR[]items is the list of ServiceCIDRs.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.NetworkingV1beta1Api);

const res: k8s.V1beta1ServiceCIDRList = await api.listServiceCIDR({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: NetworkingV1beta1Api.listServiceCIDR

V1beta1ServiceCIDRSpec

  • ServiceCIDRSpec define the CIDRs the user wants to use for allocating ClusterIPs for Services.

Source

PropertyTypeDescription
cidrsstring[]CIDRs defines the IP blocks in CIDR notation (e.g. "192.168.0.0/24" or "2001:db8::/64") from which to assign service cluster IPs. Max of two CIDRs is allowed, one of each IP family. This field is...

V1beta1ServiceCIDRStatus

  • ServiceCIDRStatus describes the current state of the ServiceCIDR.

Source

PropertyTypeDescription
conditionsV1Condition[]conditions holds an array of metav1.Condition that describe the state of the ServiceCIDR. Current service state

V1beta1StorageVersionMigration

  • StorageVersionMigration represents a migration of stored data to the latest storage version.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta1StorageVersionMigrationSpec
statusV1beta1StorageVersionMigrationStatus

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.StoragemigrationV1beta1Api);

const body: k8s.V1beta1StorageVersionMigration = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createStorageVersionMigration({ body });
console.log(res.metadata?.name);

Used by: StoragemigrationV1beta1Api.createStorageVersionMigration · StoragemigrationV1beta1Api.readStorageVersionMigration · StoragemigrationV1beta1Api.readStorageVersionMigrationStatus

V1beta1StorageVersionMigrationList

  • StorageVersionMigrationList is a collection of storage version migrations.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1StorageVersionMigration[]Items is the list of StorageVersionMigration
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.StoragemigrationV1beta1Api);

const res: k8s.V1beta1StorageVersionMigrationList = await api.listStorageVersionMigration({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: StoragemigrationV1beta1Api.listStorageVersionMigration

V1beta1StorageVersionMigrationSpec

  • Spec of the storage version migration.

Source

PropertyTypeDescription
resourceV1GroupResource

V1beta1StorageVersionMigrationStatus

  • Status of the storage version migration.

Source

PropertyTypeDescription
conditionsV1Condition[]The latest available observations of the migration's current state.
resourceVersionstringResourceVersion to compare with the GC cache for performing the migration. This is the current resource version of given group, version and resource when kube-controller-manager first observes this...

V1beta1Variable

  • Variable is the definition of a variable that is used for composition. A variable is defined as a named expression.

Source

PropertyTypeDescription
expressionstringExpression is the expression that will be evaluated as the value of the variable. The CEL expression has access to the same identifiers as the CEL expressions in Validation.
namestringName is the name of the variable. The name must be a valid CEL identifier and unique among all variables. The variable can be accessed in other expressions through variables For example, if name is...

V1beta1VolumeAttributesClass

  • VolumeAttributesClass represents a specification of mutable volume attributes defined by the CSI driver. The class can be specified during dynamic provisioning of PersistentVolumeClaims, and changed in the PersistentVolumeClaim spec after provisioning.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
driverNamestringName of the CSI driver This field is immutable.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
parameters{ [key: string]: stringparameters hold volume attributes defined by the CSI driver. These values are opaque to the Kubernetes and are passed directly to the CSI driver. The underlying storage provider supports changing...
metadataV1ObjectMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.StorageV1beta1Api);

const body: k8s.V1beta1VolumeAttributesClass = {
metadata: { name: 'example' },
};
const res = await api.createVolumeAttributesClass({ body });
console.log(res.metadata?.name);

Used by: StorageV1beta1Api.createVolumeAttributesClass · StorageV1beta1Api.patchVolumeAttributesClass · StorageV1beta1Api.readVolumeAttributesClass

V1beta1VolumeAttributesClassList

  • VolumeAttributesClassList is a collection of VolumeAttributesClass objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta1VolumeAttributesClass[]items is the list of VolumeAttributesClass objects.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.StorageV1beta1Api);

const res: k8s.V1beta1VolumeAttributesClassList = await api.listVolumeAttributesClass({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: StorageV1beta1Api.listVolumeAttributesClass

V1beta2AllocatedDeviceStatus

  • AllocatedDeviceStatus contains the status of an allocated device, if the driver chooses to report it. This may include driver-specific information. The combination of Driver, Pool, Device, and ShareID must match the corresponding key in Status.Allocation.Devices.

Source

PropertyTypeDescription
conditionsV1Condition[]Conditions contains the latest observation of the device's state. If the device has been configured according to the class and claim config references, the Ready condition should be True. Must...
dataanyData contains arbitrary driver-specific data. The length of the raw data must be smaller or equal to 10 Ki.
devicestringDevice references one device instance via its name in the driver's resource pool. It must be a DNS label.
driverstringDriver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node. Must be a DNS subdomain and should end with a DNS...
poolstringThis name together with the driver name and the device name field identify which device was allocated (<driver name>/<pool name>/<device name>). Must not be longer than 253 characters and may...
shareIDstringShareID uniquely identifies an individual allocation share of the device.
networkDataV1beta2NetworkDeviceData

V1beta2AllocationResult

  • AllocationResult contains attributes of an allocated resource.

Source

PropertyTypeDescription
allocationTimestampDateAllocationTimestamp stores the time when the resources were allocated. This field is not guaranteed to be set, in which case that time is unknown. This is an alpha field and requires enabling the...
devicesV1beta2DeviceAllocationResult
nodeSelectorV1NodeSelector

V1beta2CELDeviceSelector

  • CELDeviceSelector contains a CEL expression for selecting a device.

Source

PropertyTypeDescription
expressionstringExpression is a CEL expression which evaluates a single device. It must evaluate to true when the device under consideration satisfies the desired criteria, and false when it does not. Any other...

V1beta2CapacityRequestPolicy

  • CapacityRequestPolicy defines how requests consume device capacity. Must not set more than one ValidRequestValues.

Source

PropertyTypeDescription
_defaultstringDefault specifies how much of this capacity is consumed by a request that does not contain an entry for it in DeviceRequest's Capacity.
validValuesstring[]ValidValues defines a set of acceptable quantity values in consuming requests. Must not contain more than 10 entries. Must be sorted in ascending order. If this field is set, Default must be...
validRangeV1beta2CapacityRequestPolicyRange

V1beta2CapacityRequestPolicyRange

  • CapacityRequestPolicyRange defines a valid range for consumable capacity values. - If the requested amount is less than Min, it is rounded up to the Min value. - If Step is set and the requested amount is between Min and Max but not aligned with Step, it will be rounded up to the next value equal to Min + (n * Step). - If Step is not set, the requested amount is used as-is if it falls within the range Min to Max (if set). - If the requested or rounded amount exceeds Max (if set), the request does not satisfy the policy, and the device cannot be allocated.

Source

PropertyTypeDescription
maxstringMax defines the upper limit for capacity that can be requested. Max must be less than or equal to the capacity value. Min and requestPolicy.default must be less than or equal to the maximum.
minstringMin specifies the minimum capacity allowed for a consumption request. Min must be greater than or equal to zero, and less than or equal to the capacity value. requestPolicy.default must be more than...
stepstringStep defines the step size between valid capacity amounts within the range. Max (if set) and requestPolicy.default must be a multiple of Step. Min + Step must be less than or equal to the capacity...

V1beta2CapacityRequirements

  • CapacityRequirements defines the capacity requirements for a specific device request.

Source

PropertyTypeDescription
requests{ [key: string]: stringRequests represent individual device resource requests for distinct resources, all of which must be provided by the device. This value is used as an additional filtering condition against the...

V1beta2Counter

  • Counter describes a quantity associated with a device.

Source

PropertyTypeDescription
valuestringValue defines how much of a certain device counter is available.

V1beta2CounterSet

  • CounterSet defines a named set of counters that are available to be used by devices defined in the ResourcePool. The counters are not allocatable by themselves, but can be referenced by devices. When a device is allocated, the portion of counters it uses will no longer be available for use by other devices.

Source

PropertyTypeDescription
counters{ [key: string]: V1beta2CounterCounters defines the set of counters for this CounterSet The name of each counter must be unique in that set and must be a DNS label. The maximum number of counters is 32.
namestringName defines the name of the counter set. It must be a DNS label.

V1beta2Device

  • Device represents one individual hardware instance that can be selected based on its attributes. Besides the name, exactly one field must be set.

Source

PropertyTypeDescription
allNodesbooleanAllNodes indicates that all nodes have access to the device. Must only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.
allowMultipleAllocationsbooleanAllowMultipleAllocations marks whether the device is allowed to be allocated to multiple DeviceRequests. If AllowMultipleAllocations is set to true, the device can be allocated more than once, and...
attributes{ [key: string]: V1beta2DeviceAttributeAttributes defines the set of attributes for this device. The name of each attribute must be unique in that set. The maximum number of attributes and capacities combined is 32.
bindingConditionsstring[]BindingConditions defines the conditions for proceeding with binding. All of these conditions must be set in the per-device status conditions with a value of True to proceed with binding the pod to...
bindingFailureConditionsstring[]BindingFailureConditions defines the conditions for binding failure. They may be set in the per-device status conditions. If any is set to "True", a binding failure occurred. The maximum number of...
bindsToNodebooleanBindsToNode indicates if the usage of an allocation involving this device has to be limited to exactly the node that was chosen when allocating the claim. If set to true, the scheduler will set the...
capacity{ [key: string]: V1beta2DeviceCapacityCapacity defines the set of capacities for this device. The name of each capacity must be unique in that set. The maximum number of attributes and capacities combined is 32.
consumesCountersV1beta2DeviceCounterConsumption[]ConsumesCounters defines a list of references to sharedCounters and the set of counters that the device will consume from those counter sets. There can only be a single entry per counterSet. The...
namestringName is unique identifier among all devices managed by the driver in the pool. It must be a DNS label.
nodeNamestringNodeName identifies the node where the device is available. Must only be set if Spec.PerDeviceNodeSelection is set to true. At most one of NodeName, NodeSelector and AllNodes can be set.
taintsV1beta2DeviceTaint[]If specified, these are the driver-defined taints. The maximum number of taints is 16. If taints are set for any device in a ResourceSlice, then the maximum number of allowed devices per...
nodeSelectorV1NodeSelector

V1beta2DeviceAllocationConfiguration

  • DeviceAllocationConfiguration gets embedded in an AllocationResult.

Source

PropertyTypeDescription
requestsstring[]Requests lists the names of requests where the configuration applies. If empty, its applies to all requests. References to subrequests must include the name of the main request and may include the...
sourcestringSource records whether the configuration comes from a class and thus is not something that a normal user would have been able to set or from a claim.
opaqueV1beta2OpaqueDeviceConfiguration

V1beta2DeviceAllocationResult

  • DeviceAllocationResult is the result of allocating devices.

Source

PropertyTypeDescription
configV1beta2DeviceAllocationConfiguration[]This field is a combination of all the claim and class configuration parameters. Drivers can distinguish between those based on a flag. This includes configuration parameters for drivers which have...
resultsV1beta2DeviceRequestAllocationResult[]Results lists all allocated devices.

V1beta2DeviceAttribute

  • DeviceAttribute must have exactly one field set.

Source

PropertyTypeDescription
boolbooleanBoolValue is a true/false value.
_intnumberIntValue is a number.
stringstringStringValue is a string. Must not be longer than 64 characters.
versionstringVersionValue is a semantic version according to semver.org spec 2.0.0. Must not be longer than 64 characters.

V1beta2DeviceCapacity

  • DeviceCapacity describes a quantity associated with a device.

Source

PropertyTypeDescription
valuestringValue defines how much of a certain capacity that device has. This field reflects the fixed total capacity and does not change. The consumed amount is tracked separately by scheduler and does not...
requestPolicyV1beta2CapacityRequestPolicy

V1beta2DeviceClaim

  • DeviceClaim defines how to request devices with a ResourceClaim.

Source

PropertyTypeDescription
configV1beta2DeviceClaimConfiguration[]This field holds configuration for multiple potential drivers which could satisfy requests in this claim. It is ignored while allocating the claim.
constraintsV1beta2DeviceConstraint[]These constraints must be satisfied by the set of devices that get allocated for the claim.
requestsV1beta2DeviceRequest[]Requests represent individual requests for distinct devices which must all be satisfied. If empty, nothing needs to be allocated.

V1beta2DeviceClaimConfiguration

  • DeviceClaimConfiguration is used for configuration parameters in DeviceClaim.

Source

PropertyTypeDescription
requestsstring[]Requests lists the names of requests where the configuration applies. If empty, it applies to all requests. References to subrequests must include the name of the main request and may include the...
opaqueV1beta2OpaqueDeviceConfiguration

V1beta2DeviceClass

  • DeviceClass is a vendor- or admin-provided resource that contains device configuration and selectors. It can be referenced in the device requests of a claim to apply these presets. Cluster scoped. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta2DeviceClassSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta2Api);

const body: k8s.V1beta2DeviceClass = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createDeviceClass({ body });
console.log(res.metadata?.name);

Used by: ResourceV1beta2Api.createDeviceClass · ResourceV1beta2Api.patchDeviceClass · ResourceV1beta2Api.readDeviceClass

V1beta2DeviceClassConfiguration

  • DeviceClassConfiguration is used in DeviceClass.

Source

PropertyTypeDescription
opaqueV1beta2OpaqueDeviceConfiguration

V1beta2DeviceClassList

  • DeviceClassList is a collection of classes.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta2DeviceClass[]Items is the list of resource classes.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta2Api);

const res: k8s.V1beta2DeviceClassList = await api.listDeviceClass({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1beta2Api.listDeviceClass

V1beta2DeviceClassSpec

  • DeviceClassSpec is used in a [DeviceClass] to define what can be allocated and how to configure it.

Source

PropertyTypeDescription
configV1beta2DeviceClassConfiguration[]Config defines configuration parameters that apply to each device that is claimed via this class. Some classses may potentially be satisfied by multiple drivers, so each instance of a vendor...
extendedResourceNamestringExtendedResourceName is the extended resource name for the devices of this class. The devices of this class can be used to satisfy a pod's extended resource requests. It has the same format as the...
selectorsV1beta2DeviceSelector[]Each selector must be satisfied by a device which is claimed via this class.

V1beta2DeviceConstraint

  • DeviceConstraint must have exactly one field set besides Requests.

Source

PropertyTypeDescription
distinctAttributestringDistinctAttribute requires that all devices in question have this attribute and that its type and value are unique across those devices. This acts as the inverse of MatchAttribute. This constraint...
matchAttributestringMatchAttribute requires that all devices in question have this attribute and that its type and value are the same across those devices. For example, if you specified "dra.example.com/numa" (a...
requestsstring[]Requests is a list of the one or more requests in this claim which must co-satisfy this constraint. If a request is fulfilled by multiple devices, then all of the devices must satisfy the constraint....

V1beta2DeviceCounterConsumption

  • DeviceCounterConsumption defines a set of counters that a device will consume from a CounterSet.

Source

PropertyTypeDescription
counterSetstringCounterSet is the name of the set from which the counters defined will be consumed.
counters{ [key: string]: V1beta2CounterCounters defines the counters that will be consumed by the device. The maximum number of counters is 32.

V1beta2DeviceRequest

  • DeviceRequest is a request for devices required for a claim. This is typically a request for a single resource like a device, but can also ask for several identical devices. With FirstAvailable it is also possible to provide a prioritized list of requests.

Source

PropertyTypeDescription
firstAvailableV1beta2DeviceSubRequest[]FirstAvailable contains subrequests, of which exactly one will be selected by the scheduler. It tries to satisfy them in the order in which they are listed here. So if there are two entries in the...
namestringName can be used to reference this request in a pod.spec.containers[].resources.claims entry and in a constraint of the claim. References using the name in the DeviceRequest will uniquely identify a...
exactlyV1beta2ExactDeviceRequest

V1beta2DeviceRequestAllocationResult

  • DeviceRequestAllocationResult contains the allocation result for one request.

Source

PropertyTypeDescription
adminAccessbooleanAdminAccess indicates that this device was allocated for administrative access. See the corresponding request field for a definition of mode. This is an alpha field and requires enabling the...
bindingConditionsstring[]BindingConditions contains a copy of the BindingConditions from the corresponding ResourceSlice at the time of allocation. This is an alpha field and requires enabling the DRADeviceBindingConditions...
bindingFailureConditionsstring[]BindingFailureConditions contains a copy of the BindingFailureConditions from the corresponding ResourceSlice at the time of allocation. This is an alpha field and requires enabling the...
consumedCapacity{ [key: string]: stringConsumedCapacity tracks the amount of capacity consumed per device as part of the claim request. The consumed amount may differ from the requested amount: it is rounded up to the nearest valid value...
devicestringDevice references one device instance via its name in the driver's resource pool. It must be a DNS label.
driverstringDriver specifies the name of the DRA driver whose kubelet plugin should be invoked to process the allocation once the claim is needed on a node. Must be a DNS subdomain and should end with a DNS...
poolstringThis name together with the driver name and the device name field identify which device was allocated (<driver name>/<pool name>/<device name>). Must not be longer than 253 characters and may...
requeststringRequest is the name of the request in the claim which caused this device to be allocated. If it references a subrequest in the firstAvailable list on a DeviceRequest, this field must include both the...
shareIDstringShareID uniquely identifies an individual allocation share of the device, used when the device supports multiple simultaneous allocations. It serves as an additional map key to differentiate...
tolerationsV1beta2DeviceToleration[]A copy of all tolerations specified in the request at the time when the device got allocated. The maximum number of tolerations is 16. This is an alpha field and requires enabling the...

V1beta2DeviceSelector

  • DeviceSelector must have exactly one field set.

Source

PropertyTypeDescription
celV1beta2CELDeviceSelector

V1beta2DeviceSubRequest

  • DeviceSubRequest describes a request for device provided in the claim.spec.devices.requests[].firstAvailable array. Each is typically a request for a single resource like a device, but can also ask for several identical devices. DeviceSubRequest is similar to ExactDeviceRequest, but doesn't expose the AdminAccess field as that one is only supported when requesting a specific device.

Source

PropertyTypeDescription
allocationModestringAllocationMode and its related fields define how devices are allocated to satisfy this subrequest. Supported values are: - ExactCount: This request is for a specific number of devices. This is the...
countnumberCount is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
deviceClassNamestringDeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this subrequest. A class is required. Which classes are available...
namestringName can be used to reference this subrequest in the list of constraints or the list of configurations for the claim. References must use the format
/. Must be a DNS label.
selectorsV1beta2DeviceSelector[]Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this subrequest. All selectors must be satisfied for a device to be considered.
tolerationsV1beta2DeviceToleration[]If specified, the request's tolerations. Tolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute. In addition, should any of...
capacityV1beta2CapacityRequirements

V1beta2DeviceTaint

  • The device this taint is attached to has the "effect" on any claim which does not tolerate the taint and, through the claim, to pods using the claim.

Source

PropertyTypeDescription
effectstringThe effect of the taint on claims that do not tolerate the taint and through such claims on the pods using them. Valid effects are None, NoSchedule and NoExecute. PreferNoSchedule as used for nodes...
keystringThe taint key to be applied to a device. Must be a label name.
timeAddedDateTimeAdded represents the time at which the taint was added. Added automatically during create or update if not set.
valuestringThe taint value corresponding to the taint key. Must be a label value.

V1beta2DeviceToleration

  • The ResourceClaim this DeviceToleration is attached to tolerates any taint that matches the triple <key,value,effect> using the matching operator .

Source

PropertyTypeDescription
effectstringEffect indicates the taint effect to match. Empty means match all taint effects. When specified, allowed values are NoSchedule and NoExecute.
keystringKey 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. Must be a...
operatorstringOperator 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 ResourceClaim can tolerate all...
tolerationSecondsnumberTolerationSeconds 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...
valuestringValue is the taint value the toleration matches to. If the operator is Exists, the value must be empty, otherwise just a regular string. Must be a label value.

V1beta2ExactDeviceRequest

  • ExactDeviceRequest is a request for one or more identical devices.

Source

PropertyTypeDescription
adminAccessbooleanAdminAccess indicates that this is a claim for administrative access to the device(s). Claims with AdminAccess are expected to be used for monitoring or other management services for a device. They...
allocationModestringAllocationMode and its related fields define how devices are allocated to satisfy this request. Supported values are: - ExactCount: This request is for a specific number of devices. This is the...
countnumberCount is used only when the count mode is "ExactCount". Must be greater than zero. If AllocationMode is ExactCount and this field is not specified, the default is one.
deviceClassNamestringDeviceClassName references a specific DeviceClass, which can define additional configuration and selectors to be inherited by this request. A DeviceClassName is required. Administrators may use...
selectorsV1beta2DeviceSelector[]Selectors define criteria which must be satisfied by a specific device in order for that device to be considered for this request. All selectors must be satisfied for a device to be considered.
tolerationsV1beta2DeviceToleration[]If specified, the request's tolerations. Tolerations for NoSchedule are required to allocate a device which has a taint with that effect. The same applies to NoExecute. In addition, should any of...
capacityV1beta2CapacityRequirements

V1beta2NetworkDeviceData

  • NetworkDeviceData provides network-related details for the allocated device. This information may be filled by drivers or other components to configure or identify the device within a network context.

Source

PropertyTypeDescription
hardwareAddressstringHardwareAddress represents the hardware address (e.g. MAC Address) of the device's network interface. Must not be longer than 128 characters.
interfaceNamestringInterfaceName specifies the name of the network interface associated with the allocated device. This might be the name of a physical or virtual network interface being configured in the pod. Must...
ipsstring[]IPs lists the network addresses assigned to the device's network interface. This can include both IPv4 and IPv6 addresses. The IPs are in the CIDR notation, which includes both the address and the...

V1beta2OpaqueDeviceConfiguration

  • OpaqueDeviceConfiguration contains configuration parameters for a driver in a format defined by the driver vendor.

Source

PropertyTypeDescription
driverstringDriver is used to determine which kubelet plugin needs to be passed these configuration parameters. An admission policy provided by the driver developer could use this to decide whether it needs to...
parametersanyParameters can contain arbitrary data. It is the responsibility of the driver developer to handle validation and versioning. Typically this includes self-identification and a version ("kind" +...

V1beta2ResourceClaim

  • ResourceClaim describes a request for access to resources in the cluster, for use by workloads. For example, if a workload needs an accelerator device with specific properties, this is how that request is expressed. The status stanza tracks whether this claim has been satisfied and what specific resources have been allocated. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta2ResourceClaimSpec
statusV1beta2ResourceClaimStatus

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta2Api);

const body: k8s.V1beta2ResourceClaim = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedResourceClaim({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: ResourceV1beta2Api.createNamespacedResourceClaim · ResourceV1beta2Api.readNamespacedResourceClaim · ResourceV1beta2Api.readNamespacedResourceClaimStatus

V1beta2ResourceClaimConsumerReference

  • ResourceClaimConsumerReference contains enough information to let you locate the consumer of a ResourceClaim. The user must be a resource in the same namespace as the ResourceClaim.

Source

PropertyTypeDescription
apiGroupstringAPIGroup is the group for the resource being referenced. It is empty for the core API. This matches the group in the APIVersion that is used when creating the resources.
namestringName is the name of resource being referenced.
resourcestringResource is the type of resource being referenced, for example "pods".
uidstringUID identifies exactly one incarnation of the resource.

V1beta2ResourceClaimList

  • ResourceClaimList is a collection of claims.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta2ResourceClaim[]Items is the list of resource claims.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta2Api);

const res: k8s.V1beta2ResourceClaimList = await api.listNamespacedResourceClaim({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1beta2Api.listNamespacedResourceClaim · ResourceV1beta2Api.listResourceClaimForAllNamespaces

V1beta2ResourceClaimSpec

  • ResourceClaimSpec defines what is being requested in a ResourceClaim and how to configure it.

Source

PropertyTypeDescription
devicesV1beta2DeviceClaim

V1beta2ResourceClaimStatus

  • ResourceClaimStatus tracks whether the resource has been allocated and what the result of that was.

Source

PropertyTypeDescription
devicesV1beta2AllocatedDeviceStatus[]Devices contains the status of each device allocated for this claim, as reported by the driver. This can include driver-specific information. Entries are owned by their respective drivers.
reservedForV1beta2ResourceClaimConsumerReference[]ReservedFor indicates which entities are currently allowed to use the claim. A Pod which references a ResourceClaim which is not reserved for that Pod will not be started. A claim that is in use or...
allocationV1beta2AllocationResult

V1beta2ResourceClaimTemplate

  • ResourceClaimTemplate is used to produce ResourceClaim objects. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta2ResourceClaimTemplateSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta2Api);

const body: k8s.V1beta2ResourceClaimTemplate = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedResourceClaimTemplate({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: ResourceV1beta2Api.createNamespacedResourceClaimTemplate · ResourceV1beta2Api.patchNamespacedResourceClaimTemplate · ResourceV1beta2Api.readNamespacedResourceClaimTemplate

V1beta2ResourceClaimTemplateList

  • ResourceClaimTemplateList is a collection of claim templates.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta2ResourceClaimTemplate[]Items is the list of resource claim templates.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta2Api);

const res: k8s.V1beta2ResourceClaimTemplateList = await api.listNamespacedResourceClaimTemplate({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1beta2Api.listNamespacedResourceClaimTemplate · ResourceV1beta2Api.listResourceClaimTemplateForAllNamespaces

V1beta2ResourceClaimTemplateSpec

  • ResourceClaimTemplateSpec contains the metadata and fields for a ResourceClaim.

Source

PropertyTypeDescription
metadataV1ObjectMeta
specV1beta2ResourceClaimSpec

V1beta2ResourcePool

  • ResourcePool describes the pool that ResourceSlices belong to.

Source

PropertyTypeDescription
generationnumberGeneration tracks the change in a pool over time. Whenever a driver changes something about one or more of the resources in a pool, it must change the generation in all ResourceSlices which are part...
namestringName is used to identify the pool. For node-local devices, this is often the node name, but this is not required. It must not be longer than 253 characters and must consist of one or more DNS...
resourceSliceCountnumberResourceSliceCount is the total number of ResourceSlices in the pool at this generation number. Must be greater than zero. Consumers can use this to check whether they have seen all ResourceSlices...

V1beta2ResourceSlice

  • ResourceSlice represents one or more resources in a pool of similar resources, managed by a common driver. A pool may span more than one ResourceSlice, and exactly how many ResourceSlices comprise a pool is determined by the driver. At the moment, the only supported resources are devices with attributes and capacities. Each device in a given pool, regardless of how many ResourceSlices, must have a unique name. The ResourceSlice in which a device gets published may change over time. The unique identifier for a device is the tuple , , . Whenever a driver needs to update a pool, it increments the pool.Spec.Pool.Generation number and updates all ResourceSlices with that new number and new resource definitions. A consumer must only use ResourceSlices with the highest generation number and ignore all others. When allocating all resources in a pool matching certain criteria or when looking for the best solution among several different alternatives, a consumer should check the number of ResourceSlices in a pool (included in each ResourceSlice) to determine whether its view of a pool is complete and if not, should wait until the driver has completed updating the pool. For resources that are not local to a node, the node name is not set. Instead, the driver may use a node selector to specify where the devices are available. This is an alpha type and requires enabling the DynamicResourceAllocation feature gate.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV1beta2ResourceSliceSpec

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta2Api);

const body: k8s.V1beta2ResourceSlice = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createResourceSlice({ body });
console.log(res.metadata?.name);

Used by: ResourceV1beta2Api.createResourceSlice · ResourceV1beta2Api.patchResourceSlice · ResourceV1beta2Api.readResourceSlice

V1beta2ResourceSliceList

  • ResourceSliceList is a collection of ResourceSlices.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV1beta2ResourceSlice[]Items is the list of resource ResourceSlices.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.ResourceV1beta2Api);

const res: k8s.V1beta2ResourceSliceList = await api.listResourceSlice({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: ResourceV1beta2Api.listResourceSlice

V1beta2ResourceSliceSpec

  • ResourceSliceSpec contains the information published by the driver in one ResourceSlice.

Source

PropertyTypeDescription
allNodesbooleanAllNodes indicates that all nodes have access to the resources in the pool. Exactly one of NodeName, NodeSelector, AllNodes, and PerDeviceNodeSelection must be set.
devicesV1beta2Device[]Devices lists some or all of the devices in this pool. Must not have more than 128 entries. If any device uses taints or consumes counters the limit is 64. Only one of Devices and SharedCounters...
driverstringDriver identifies the DRA driver providing the capacity information. A field selector can be used to list only ResourceSlice objects with a certain driver name. Must be a DNS subdomain and should...
nodeNamestringNodeName identifies the node which provides the resources in this pool. A field selector can be used to list only ResourceSlice objects belonging to a certain node. This field can be used to limit...
perDeviceNodeSelectionbooleanPerDeviceNodeSelection defines whether the access from nodes to resources in the pool is set on the ResourceSlice level or on each device. If it is set to true, every device defined the ResourceSlice...
sharedCountersV1beta2CounterSet[]SharedCounters defines a list of counter sets, each of which has a name and a list of counters available. The names of the counter sets must be unique in the ResourcePool. Only one of Devices and...
nodeSelectorV1NodeSelector
poolV1beta2ResourcePool

V2ContainerResourceMetricSource

  • ContainerResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory). The values will be averaged together before being compared to the target. Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source. Only one "target" type should be set.

Source

PropertyTypeDescription
containerstringcontainer is the name of the container in the pods of the scaling target
namestringname is the name of the resource in question.
targetV2MetricTarget

V2ContainerResourceMetricStatus

  • ContainerResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing a single container in each pod in the current scale target (e.g. CPU or memory). Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.

Source

PropertyTypeDescription
containerstringcontainer is the name of the container in the pods of the scaling target
namestringname is the name of the resource in question.
currentV2MetricValueStatus

V2CrossVersionObjectReference

  • CrossVersionObjectReference contains enough information to let you identify the referred resource.

Source

PropertyTypeDescription
apiVersionstringapiVersion is the API version of the referent
kindstringkind is the kind of the referent; More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
namestringname is the name of the referent; More info: https://kubernetes.io/docs/concepts/overview/working-with-objects/names/#names

V2ExternalMetricSource

  • ExternalMetricSource indicates how to scale on a metric not associated with any Kubernetes object (for example length of queue in cloud messaging service, or QPS from loadbalancer running outside of cluster).

Source

PropertyTypeDescription
metricV2MetricIdentifier
targetV2MetricTarget

V2ExternalMetricStatus

  • ExternalMetricStatus indicates the current value of a global metric not associated with any Kubernetes object.

Source

PropertyTypeDescription
currentV2MetricValueStatus
metricV2MetricIdentifier

V2HPAScalingPolicy

  • HPAScalingPolicy is a single policy which must hold true for a specified past interval.

Source

PropertyTypeDescription
periodSecondsnumberperiodSeconds specifies the window of time for which the policy should hold true. PeriodSeconds must be greater than zero and less than or equal to 1800 (30 min).
typestringtype is used to specify the scaling policy.
valuenumbervalue contains the amount of change which is permitted by the policy. It must be greater than zero

V2HPAScalingRules

  • HPAScalingRules configures the scaling behavior for one direction via scaling Policy Rules and a configurable metric tolerance. Scaling Policy Rules are applied after calculating DesiredReplicas from metrics for the HPA. They can limit the scaling velocity by specifying scaling policies. They can prevent flapping by specifying the stabilization window, so that the number of replicas is not set instantly, instead, the safest value from the stabilization window is chosen. The tolerance is applied to the metric values and prevents scaling too eagerly for small metric variations. (Note that setting a tolerance requires the beta HPAConfigurableTolerance feature gate to be enabled.)

Source

PropertyTypeDescription
policiesV2HPAScalingPolicy[]policies is a list of potential scaling polices which can be used during scaling. If not set, use the default values: - For scale up: allow doubling the number of pods, or an absolute change of 4...
selectPolicystringselectPolicy is used to specify which policy should be used. If not set, the default value Max is used.
stabilizationWindowSecondsnumberstabilizationWindowSeconds is the number of seconds for which past recommendations should be considered while scaling up or scaling down. StabilizationWindowSeconds must be greater than or equal to...
tolerancestringtolerance is the tolerance on the ratio between the current and desired metric value under which no updates are made to the desired number of replicas (e.g. 0.01 for 1%). Must be greater than or...

V2HorizontalPodAutoscaler

  • HorizontalPodAutoscaler is the configuration for a horizontal pod autoscaler, which automatically manages the replica count of any resource implementing the scale subresource based on the metrics specified.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ObjectMeta
specV2HorizontalPodAutoscalerSpec
statusV2HorizontalPodAutoscalerStatus

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AutoscalingV2Api);

const body: k8s.V2HorizontalPodAutoscaler = {
metadata: { name: 'example' },
spec: { /* ... */ },
};
const res = await api.createNamespacedHorizontalPodAutoscaler({ namespace: 'default', body });
console.log(res.metadata?.name);

Used by: AutoscalingV2Api.createNamespacedHorizontalPodAutoscaler · AutoscalingV2Api.readNamespacedHorizontalPodAutoscaler · AutoscalingV2Api.readNamespacedHorizontalPodAutoscalerStatus

V2HorizontalPodAutoscalerBehavior

  • HorizontalPodAutoscalerBehavior configures the scaling behavior of the target in both Up and Down directions (scaleUp and scaleDown fields respectively).

Source

PropertyTypeDescription
scaleDownV2HPAScalingRules
scaleUpV2HPAScalingRules

V2HorizontalPodAutoscalerCondition

  • HorizontalPodAutoscalerCondition describes the state of a HorizontalPodAutoscaler at a certain point.

Source

PropertyTypeDescription
lastTransitionTimeDatelastTransitionTime is the last time the condition transitioned from one status to another
messagestringmessage is a human-readable explanation containing details about the transition
reasonstringreason is the reason for the condition's last transition.
statusstringstatus is the status of the condition (True, False, Unknown)
typestringtype describes the current condition

V2HorizontalPodAutoscalerList

  • HorizontalPodAutoscalerList is a list of horizontal pod autoscaler objects.

Source

PropertyTypeDescription
apiVersionstringAPIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info:...
itemsV2HorizontalPodAutoscaler[]items is the list of horizontal pod autoscaler objects.
kindstringKind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info:...
metadataV1ListMeta

Example

import * as k8s from '@kubernetes/client-node';

const kc = new k8s.KubeConfig();
kc.loadFromDefault();
const api = kc.makeApiClient(k8s.AutoscalingV2Api);

const res: k8s.V2HorizontalPodAutoscalerList = await api.listNamespacedHorizontalPodAutoscaler({ namespace: 'default' });
for (const item of res.items) {
console.log(item.metadata?.name);
}

Used by: AutoscalingV2Api.listHorizontalPodAutoscalerForAllNamespaces · AutoscalingV2Api.listNamespacedHorizontalPodAutoscaler

V2HorizontalPodAutoscalerSpec

  • HorizontalPodAutoscalerSpec describes the desired functionality of the HorizontalPodAutoscaler.

Source

PropertyTypeDescription
maxReplicasnumbermaxReplicas is the upper limit for the number of replicas to which the autoscaler can scale up. It cannot be less that minReplicas.
metricsV2MetricSpec[]metrics contains the specifications for which to use to calculate the desired replica count (the maximum replica count across all metrics will be used). The desired replica count is calculated...
minReplicasnumberminReplicas is the lower limit for the number of replicas to which the autoscaler can scale down. It defaults to 1 pod. minReplicas is allowed to be 0 if the alpha feature gate HPAScaleToZero is...
behaviorV2HorizontalPodAutoscalerBehavior
scaleTargetRefV2CrossVersionObjectReference

V2HorizontalPodAutoscalerStatus

  • HorizontalPodAutoscalerStatus describes the current status of a horizontal pod autoscaler.

Source

PropertyTypeDescription
conditionsV2HorizontalPodAutoscalerCondition[]conditions is the set of conditions required for this autoscaler to scale its target, and indicates whether or not those conditions are met.
currentMetricsV2MetricStatus[]currentMetrics is the last read state of the metrics used by this autoscaler.
currentReplicasnumbercurrentReplicas is current number of replicas of pods managed by this autoscaler, as last seen by the autoscaler.
desiredReplicasnumberdesiredReplicas is the desired number of replicas of pods managed by this autoscaler, as last calculated by the autoscaler.
lastScaleTimeDatelastScaleTime is the last time the HorizontalPodAutoscaler scaled the number of pods, used by the autoscaler to control how often the number of pods is changed.
observedGenerationnumberobservedGeneration is the most recent generation observed by this autoscaler.

V2MetricIdentifier

  • MetricIdentifier defines the name and optionally selector for a metric

Source

PropertyTypeDescription
namestringname is the name of the given metric
selectorV1LabelSelector

V2MetricSpec

  • MetricSpec specifies how to scale based on a single metric (only type and one other matching field should be set at once).

Source

PropertyTypeDescription
typestringtype is the type of metric source. It should be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each mapping to a matching field in the object.
containerResourceV2ContainerResourceMetricSource
externalV2ExternalMetricSource
objectV2ObjectMetricSource
podsV2PodsMetricSource
resourceV2ResourceMetricSource

V2MetricStatus

  • MetricStatus describes the last-read state of a single metric.

Source

PropertyTypeDescription
typestringtype is the type of metric source. It will be one of "ContainerResource", "External", "Object", "Pods" or "Resource", each corresponds to a matching field in the object.
containerResourceV2ContainerResourceMetricStatus
externalV2ExternalMetricStatus
objectV2ObjectMetricStatus
podsV2PodsMetricStatus
resourceV2ResourceMetricStatus

V2MetricTarget

  • MetricTarget defines the target value, average value, or average utilization of a specific metric

Source

PropertyTypeDescription
averageUtilizationnumberaverageUtilization is the target value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods. Currently only...
averageValuestringaverageValue is the target value of the average of the metric across all relevant pods (as a quantity)
typestringtype represents whether the metric type is Utilization, Value, or AverageValue
valuestringvalue is the target value of the metric (as a quantity).

V2MetricValueStatus

  • MetricValueStatus holds the current value for a metric

Source

PropertyTypeDescription
averageUtilizationnumbercurrentAverageUtilization is the current value of the average of the resource metric across all relevant pods, represented as a percentage of the requested value of the resource for the pods.
averageValuestringaverageValue is the current value of the average of the metric across all relevant pods (as a quantity)
valuestringvalue is the current value of the metric (as a quantity).

V2ObjectMetricSource

  • ObjectMetricSource indicates how to scale on a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).

Source

PropertyTypeDescription
describedObjectV2CrossVersionObjectReference
metricV2MetricIdentifier
targetV2MetricTarget

V2ObjectMetricStatus

  • ObjectMetricStatus indicates the current value of a metric describing a kubernetes object (for example, hits-per-second on an Ingress object).

Source

PropertyTypeDescription
currentV2MetricValueStatus
describedObjectV2CrossVersionObjectReference
metricV2MetricIdentifier

V2PodsMetricSource

  • PodsMetricSource indicates how to scale on a metric describing each pod in the current scale target (for example, transactions-processed-per-second). The values will be averaged together before being compared to the target value.

Source

PropertyTypeDescription
metricV2MetricIdentifier
targetV2MetricTarget

V2PodsMetricStatus

  • PodsMetricStatus indicates the current value of a metric describing each pod in the current scale target (for example, transactions-processed-per-second).

Source

PropertyTypeDescription
currentV2MetricValueStatus
metricV2MetricIdentifier

V2ResourceMetricSource

  • ResourceMetricSource indicates how to scale on a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory). The values will be averaged together before being compared to the target. Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source. Only one "target" type should be set.

Source

PropertyTypeDescription
namestringname is the name of the resource in question.
targetV2MetricTarget

V2ResourceMetricStatus

  • ResourceMetricStatus indicates the current value of a resource metric known to Kubernetes, as specified in requests and limits, describing each pod in the current scale target (e.g. CPU or memory). Such metrics are built in to Kubernetes, and have special scaling options on top of those available to normal per-pod metrics using the "pods" source.

Source

PropertyTypeDescription
namestringname is the name of the resource in question.
currentV2MetricValueStatus