Node APIs
Reference guide for node APIs
Abstract
Chapter 1. Node APIs
1.1. Node [v1]
- Description
- Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
- Type
-
object
1.2. PerformanceProfile [performance.openshift.io/v2]
- Description
- PerformanceProfile is the Schema for the performanceprofiles API
- Type
-
object
1.3. Profile [tuned.openshift.io/v1]
- Description
- Profile is a specification for a Profile resource.
- Type
-
object
1.4. RuntimeClass [node.k8s.io/v1]
- Description
- 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/
- Type
-
object
1.5. Tuned [tuned.openshift.io/v1]
- Description
- Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs. These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
- Type
-
object
Chapter 2. Node [v1]
- Description
- Node is a worker node in Kubernetes. Each node will have a unique identifier in the cache (i.e. in etcd).
- Type
-
object
2.1. Specification
Property | Type | Description |
---|---|---|
|
| APIVersion 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| Kind 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| NodeSpec describes the attributes that a node is created with. |
|
| NodeStatus is information about the current status of a node. |
2.1.1. .spec
- Description
- NodeSpec describes the attributes that a node is created with.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22 |
|
| Deprecated. Not all kubelets will set this field. Remove field after 1.13. see: https://issues.k8s.io/61966 |
|
| PodCIDR represents the pod IP range assigned to the node. |
|
| podCIDRs represents the IP ranges assigned to the node for usage by Pods on that node. If this field is specified, the 0th entry must match the podCIDR field. It may contain at most 1 value for each of IPv4 and IPv6. |
|
| ID of the node assigned by the cloud provider in the format: <ProviderName>://<ProviderSpecificNodeID> |
|
| If specified, the node’s taints. |
|
| The node this Taint is attached to has the "effect" on any pod that does not tolerate the Taint. |
|
| Unschedulable controls node schedulability of new pods. By default, node is schedulable. More info: https://kubernetes.io/docs/concepts/nodes/node/#manual-node-administration |
2.1.2. .spec.configSource
- Description
- NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22
- Type
-
object
Property | Type | Description |
---|---|---|
|
| ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration |
2.1.3. .spec.configSource.configMap
- Description
- ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
- Type
-
object
- Required
-
namespace
-
name
-
kubeletConfigKey
-
Property | Type | Description |
---|---|---|
|
| KubeletConfigKey declares which key of the referenced ConfigMap corresponds to the KubeletConfiguration structure This field is required in all cases. |
|
| Name is the metadata.name of the referenced ConfigMap. This field is required in all cases. |
|
| Namespace is the metadata.namespace of the referenced ConfigMap. This field is required in all cases. |
|
| ResourceVersion is the metadata.ResourceVersion of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status. |
|
| UID is the metadata.UID of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status. |
2.1.4. .spec.taints
- Description
- If specified, the node’s taints.
- Type
-
array
2.1.5. .spec.taints[]
- Description
- The node this Taint is attached to has the "effect" on any pod that does not tolerate the Taint.
- Type
-
object
- Required
-
key
-
effect
-
Property | Type | Description |
---|---|---|
|
| Required. The effect of the taint on pods that do not tolerate the taint. Valid effects are NoSchedule, PreferNoSchedule and NoExecute.
Possible enum values: - |
|
| Required. The taint key to be applied to a node. |
| TimeAdded represents the time at which the taint was added. It is only written for NoExecute taints. | |
|
| The taint value corresponding to the taint key. |
2.1.6. .status
- Description
- NodeStatus is information about the current status of a node.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| List of addresses reachable to the node. Queried from cloud provider, if available. More info: https://kubernetes.io/docs/concepts/nodes/node/#addresses Note: This field is declared as mergeable, but the merge key is not sufficiently unique, which can cause data corruption when it is merged. Callers should instead use a full-replacement patch. See https://pr.k8s.io/79391 for an example. Consumers should assume that addresses can change during the lifetime of a Node. However, there are some exceptions where this may not be possible, such as Pods that inherit a Node’s address in its own status or consumers of the downward API (status.hostIP). |
|
| NodeAddress contains information for the node’s address. |
| Allocatable represents the resources of a node that are available for scheduling. Defaults to Capacity. | |
| Capacity represents the total resources of a node. More info: https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity | |
|
| Conditions is an array of current observed node conditions. More info: https://kubernetes.io/docs/concepts/nodes/node/#condition |
|
| NodeCondition contains condition information for a node. |
|
| NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource. |
|
| NodeDaemonEndpoints lists ports opened by daemons running on the Node. |
|
| List of container images on this node |
|
| Describe a container image |
|
| NodeSystemInfo is a set of ids/uuids to uniquely identify the node. |
|
| NodePhase is the recently observed lifecycle phase of the node. More info: https://kubernetes.io/docs/concepts/nodes/node/#phase The field is never populated, and now is deprecated.
Possible enum values: - |
|
| The available runtime handlers. |
|
| NodeRuntimeHandler is a set of runtime handler information. |
|
| List of volumes that are attached to the node. |
|
| AttachedVolume describes a volume attached to a node |
|
| List of attachable volumes in use (mounted) by the node. |
2.1.7. .status.addresses
- Description
- List of addresses reachable to the node. Queried from cloud provider, if available. More info: https://kubernetes.io/docs/concepts/nodes/node/#addresses Note: This field is declared as mergeable, but the merge key is not sufficiently unique, which can cause data corruption when it is merged. Callers should instead use a full-replacement patch. See https://pr.k8s.io/79391 for an example. Consumers should assume that addresses can change during the lifetime of a Node. However, there are some exceptions where this may not be possible, such as Pods that inherit a Node’s address in its own status or consumers of the downward API (status.hostIP).
- Type
-
array
2.1.8. .status.addresses[]
- Description
- NodeAddress contains information for the node’s address.
- Type
-
object
- Required
-
type
-
address
-
Property | Type | Description |
---|---|---|
|
| The node address. |
|
| Node address type, one of Hostname, ExternalIP or InternalIP. |
2.1.9. .status.conditions
- Description
- Conditions is an array of current observed node conditions. More info: https://kubernetes.io/docs/concepts/nodes/node/#condition
- Type
-
array
2.1.10. .status.conditions[]
- Description
- NodeCondition contains condition information for a node.
- Type
-
object
- Required
-
type
-
status
-
Property | Type | Description |
---|---|---|
| Last time we got an update on a given condition. | |
| Last time the condition transit from one status to another. | |
|
| Human readable message indicating details about last transition. |
|
| (brief) reason for the condition’s last transition. |
|
| Status of the condition, one of True, False, Unknown. |
|
| Type of node condition. |
2.1.11. .status.config
- Description
- NodeConfigStatus describes the status of the config assigned by Node.Spec.ConfigSource.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22 |
|
| NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22 |
|
| Error describes any problems reconciling the Spec.ConfigSource to the Active config. Errors may occur, for example, attempting to checkpoint Spec.ConfigSource to the local Assigned record, attempting to checkpoint the payload associated with Spec.ConfigSource, attempting to load or validate the Assigned config, etc. Errors may occur at different points while syncing config. Earlier errors (e.g. download or checkpointing errors) will not result in a rollback to LastKnownGood, and may resolve across Kubelet retries. Later errors (e.g. loading or validating a checkpointed config) will result in a rollback to LastKnownGood. In the latter case, it is usually possible to resolve the error by fixing the config assigned in Spec.ConfigSource. You can find additional information for debugging by searching the error message in the Kubelet log. Error is a human-readable description of the error state; machines can check whether or not Error is empty, but should not rely on the stability of the Error text across Kubelet versions. |
|
| NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22 |
2.1.12. .status.config.active
- Description
- NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22
- Type
-
object
Property | Type | Description |
---|---|---|
|
| ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration |
2.1.13. .status.config.active.configMap
- Description
- ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
- Type
-
object
- Required
-
namespace
-
name
-
kubeletConfigKey
-
Property | Type | Description |
---|---|---|
|
| KubeletConfigKey declares which key of the referenced ConfigMap corresponds to the KubeletConfiguration structure This field is required in all cases. |
|
| Name is the metadata.name of the referenced ConfigMap. This field is required in all cases. |
|
| Namespace is the metadata.namespace of the referenced ConfigMap. This field is required in all cases. |
|
| ResourceVersion is the metadata.ResourceVersion of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status. |
|
| UID is the metadata.UID of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status. |
2.1.14. .status.config.assigned
- Description
- NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22
- Type
-
object
Property | Type | Description |
---|---|---|
|
| ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration |
2.1.15. .status.config.assigned.configMap
- Description
- ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
- Type
-
object
- Required
-
namespace
-
name
-
kubeletConfigKey
-
Property | Type | Description |
---|---|---|
|
| KubeletConfigKey declares which key of the referenced ConfigMap corresponds to the KubeletConfiguration structure This field is required in all cases. |
|
| Name is the metadata.name of the referenced ConfigMap. This field is required in all cases. |
|
| Namespace is the metadata.namespace of the referenced ConfigMap. This field is required in all cases. |
|
| ResourceVersion is the metadata.ResourceVersion of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status. |
|
| UID is the metadata.UID of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status. |
2.1.16. .status.config.lastKnownGood
- Description
- NodeConfigSource specifies a source of node configuration. Exactly one subfield (excluding metadata) must be non-nil. This API is deprecated since 1.22
- Type
-
object
Property | Type | Description |
---|---|---|
|
| ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration |
2.1.17. .status.config.lastKnownGood.configMap
- Description
- ConfigMapNodeConfigSource contains the information to reference a ConfigMap as a config source for the Node. This API is deprecated since 1.22: https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
- Type
-
object
- Required
-
namespace
-
name
-
kubeletConfigKey
-
Property | Type | Description |
---|---|---|
|
| KubeletConfigKey declares which key of the referenced ConfigMap corresponds to the KubeletConfiguration structure This field is required in all cases. |
|
| Name is the metadata.name of the referenced ConfigMap. This field is required in all cases. |
|
| Namespace is the metadata.namespace of the referenced ConfigMap. This field is required in all cases. |
|
| ResourceVersion is the metadata.ResourceVersion of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status. |
|
| UID is the metadata.UID of the referenced ConfigMap. This field is forbidden in Node.Spec, and required in Node.Status. |
2.1.18. .status.daemonEndpoints
- Description
- NodeDaemonEndpoints lists ports opened by daemons running on the Node.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| DaemonEndpoint contains information about a single Daemon endpoint. |
2.1.19. .status.daemonEndpoints.kubeletEndpoint
- Description
- DaemonEndpoint contains information about a single Daemon endpoint.
- Type
-
object
- Required
-
Port
-
Property | Type | Description |
---|---|---|
|
| Port number of the given endpoint. |
2.1.20. .status.images
- Description
- List of container images on this node
- Type
-
array
2.1.21. .status.images[]
- Description
- Describe a container image
- Type
-
object
Property | Type | Description |
---|---|---|
|
| 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"] |
|
| The size of the image in bytes. |
2.1.22. .status.nodeInfo
- Description
- NodeSystemInfo is a set of ids/uuids to uniquely identify the node.
- Type
-
object
- Required
-
machineID
-
systemUUID
-
bootID
-
kernelVersion
-
osImage
-
containerRuntimeVersion
-
kubeletVersion
-
kubeProxyVersion
-
operatingSystem
-
architecture
-
Property | Type | Description |
---|---|---|
|
| The Architecture reported by the node |
|
| Boot ID reported by the node. |
|
| ContainerRuntime Version reported by the node through runtime remote API (e.g. containerd://1.4.2). |
|
| Kernel Version reported by the node from 'uname -r' (e.g. 3.16.0-0.bpo.4-amd64). |
|
| KubeProxy Version reported by the node. |
|
| Kubelet Version reported by the node. |
|
| MachineID reported by the node. For unique machine identification in the cluster this field is preferred. Learn more from man(5) machine-id: http://man7.org/linux/man-pages/man5/machine-id.5.html |
|
| The Operating System reported by the node |
|
| OS Image reported by the node from /etc/os-release (e.g. Debian GNU/Linux 7 (wheezy)). |
|
| SystemUUID reported by the node. For unique machine identification MachineID is preferred. This field is specific to Red Hat hosts https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/rhsm/uuid |
2.1.23. .status.runtimeHandlers
- Description
- The available runtime handlers.
- Type
-
array
2.1.24. .status.runtimeHandlers[]
- Description
- NodeRuntimeHandler is a set of runtime handler information.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| NodeRuntimeHandlerFeatures is a set of runtime features. |
|
| Runtime handler name. Empty for the default runtime handler. |
2.1.25. .status.runtimeHandlers[].features
- Description
- NodeRuntimeHandlerFeatures is a set of runtime features.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| RecursiveReadOnlyMounts is set to true if the runtime handler supports RecursiveReadOnlyMounts. |
2.1.26. .status.volumesAttached
- Description
- List of volumes that are attached to the node.
- Type
-
array
2.1.27. .status.volumesAttached[]
- Description
- AttachedVolume describes a volume attached to a node
- Type
-
object
- Required
-
name
-
devicePath
-
Property | Type | Description |
---|---|---|
|
| DevicePath represents the device path where the volume should be available |
|
| Name of the attached volume |
2.2. API endpoints
The following API endpoints are available:
/api/v1/nodes
-
DELETE
: delete collection of Node -
GET
: list or watch objects of kind Node -
POST
: create a Node
-
/api/v1/watch/nodes
-
GET
: watch individual changes to a list of Node. deprecated: use the 'watch' parameter with a list operation instead.
-
/api/v1/nodes/{name}
-
DELETE
: delete a Node -
GET
: read the specified Node -
PATCH
: partially update the specified Node -
PUT
: replace the specified Node
-
/api/v1/watch/nodes/{name}
-
GET
: watch changes to an object of kind Node. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.
-
/api/v1/nodes/{name}/status
-
GET
: read status of the specified Node -
PATCH
: partially update status of the specified Node -
PUT
: replace status of the specified Node
-
2.2.1. /api/v1/nodes
- HTTP method
-
DELETE
- Description
- delete collection of Node
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- list or watch objects of kind Node
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
POST
- Description
- create a Node
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
2.2.2. /api/v1/watch/nodes
- HTTP method
-
GET
- Description
- watch individual changes to a list of Node. deprecated: use the 'watch' parameter with a list operation instead.
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
2.2.3. /api/v1/nodes/{name}
Parameter | Type | Description |
---|---|---|
|
| name of the Node |
- HTTP method
-
DELETE
- Description
- delete a Node
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- read the specified Node
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PATCH
- Description
- partially update the specified Node
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
- HTTP method
-
PUT
- Description
- replace the specified Node
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
2.2.4. /api/v1/watch/nodes/{name}
Parameter | Type | Description |
---|---|---|
|
| name of the Node |
- HTTP method
-
GET
- Description
- watch changes to an object of kind Node. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
2.2.5. /api/v1/nodes/{name}/status
Parameter | Type | Description |
---|---|---|
|
| name of the Node |
- HTTP method
-
GET
- Description
- read status of the specified Node
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PATCH
- Description
- partially update status of the specified Node
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
- HTTP method
-
PUT
- Description
- replace status of the specified Node
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
Chapter 3. PerformanceProfile [performance.openshift.io/v2]
- Description
- PerformanceProfile is the Schema for the performanceprofiles API
- Type
-
object
3.1. Specification
Property | Type | Description |
---|---|---|
|
| APIVersion 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| Kind 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| PerformanceProfileSpec defines the desired state of PerformanceProfile. |
|
| PerformanceProfileStatus defines the observed state of PerformanceProfile. |
3.1.1. .spec
- Description
- PerformanceProfileSpec defines the desired state of PerformanceProfile.
- Type
-
object
- Required
-
cpu
-
nodeSelector
-
Property | Type | Description |
---|---|---|
|
| Additional kernel arguments. |
|
| CPU defines a set of CPU related parameters. |
|
| GloballyDisableIrqLoadBalancing toggles whether IRQ load balancing will be disabled for the Isolated CPU set. When the option is set to "true" it disables IRQs load balancing for the Isolated CPU set. Setting the option to "false" allows the IRQs to be balanced across all CPUs, however the IRQs load balancing can be disabled per pod CPUs when using irq-load-balancing.crio.io/cpu-quota.crio.io annotations. Defaults to "false" |
|
| HardwareTuning defines a set of CPU frequencies for isolated and reserved cpus. |
|
| HugePages defines a set of huge pages related parameters. It is possible to set huge pages with multiple size values at the same time. For example, hugepages can be set with 1G and 2M, both values will be set on the node by the Performance Profile Controller. It is important to notice that setting hugepages default size to 1G will remove all 2M related folders from the node and it will be impossible to configure 2M hugepages under the node. |
|
| MachineConfigLabel defines the label to add to the MachineConfigs the operator creates. It has to be used in the MachineConfigSelector of the MachineConfigPool which targets this performance profile. Defaults to "machineconfiguration.openshift.io/role=<same role as in NodeSelector label key>" |
|
| MachineConfigPoolSelector defines the MachineConfigPool label to use in the MachineConfigPoolSelector of resources like KubeletConfigs created by the operator. Defaults to "machineconfiguration.openshift.io/role=<same role as in NodeSelector label key>" |
|
| Net defines a set of network related features |
|
| NodeSelector defines the Node label to use in the NodeSelectors of resources like Tuned created by the operator. It most likely should, but does not have to match the node label in the NodeSelector of the MachineConfigPool which targets this performance profile. In the case when machineConfigLabels or machineConfigPoolSelector are not set, we are expecting a certain NodeSelector format <domain>/<role>: "" in order to be able to calculate the default values for the former mentioned fields. |
|
| NUMA defines options related to topology aware affinities |
|
| RealTimeKernel defines a set of real time kernel related parameters. RT kernel won’t be installed when not set. |
|
| WorkloadHints defines hints for different types of workloads. It will allow defining exact set of tuned and kernel arguments that should be applied on top of the node. |
3.1.2. .spec.cpu
- Description
- CPU defines a set of CPU related parameters.
- Type
-
object
- Required
-
isolated
-
reserved
-
Property | Type | Description |
---|---|---|
|
| BalanceIsolated toggles whether or not the Isolated CPU set is eligible for load balancing work loads. When this option is set to "false", the Isolated CPU set will be static, meaning workloads have to explicitly assign each thread to a specific cpu in order to work across multiple CPUs. Setting this to "true" allows workloads to be balanced across CPUs. Setting this to "false" offers the most predictable performance for guaranteed workloads, but it offloads the complexity of cpu load balancing to the application. Defaults to "true" |
|
| Isolated defines a set of CPUs that will be used to give to application threads the most execution time possible, which means removing as many extraneous tasks off a CPU as possible. It is important to notice the CPU manager can choose any CPU to run the workload except the reserved CPUs. In order to guarantee that your workload will run on the isolated CPU: 1. The union of reserved CPUs and isolated CPUs should include all online CPUs 2. The isolated CPUs field should be the complementary to reserved CPUs field |
|
| Offline defines a set of CPUs that will be unused and set offline |
|
| Reserved defines a set of CPUs that will not be used for any container workloads initiated by kubelet. |
|
| Shared defines a set of CPUs that will be shared among guaranteed workloads that needs additional cpus which are not exclusive, alongside the isolated, exclusive resources that are being used already by those workloads. |
3.1.3. .spec.hardwareTuning
- Description
- HardwareTuning defines a set of CPU frequencies for isolated and reserved cpus.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| IsolatedCpuFreq defines a minimum frequency to be set across isolated cpus |
|
| ReservedCpuFreq defines a maximum frequency to be set across reserved cpus |
3.1.4. .spec.hugepages
- Description
- HugePages defines a set of huge pages related parameters. It is possible to set huge pages with multiple size values at the same time. For example, hugepages can be set with 1G and 2M, both values will be set on the node by the Performance Profile Controller. It is important to notice that setting hugepages default size to 1G will remove all 2M related folders from the node and it will be impossible to configure 2M hugepages under the node.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| DefaultHugePagesSize defines huge pages default size under kernel boot parameters. |
|
| Pages defines huge pages that we want to allocate at boot time. |
|
| HugePage defines the number of allocated huge pages of the specific size. |
3.1.5. .spec.hugepages.pages
- Description
- Pages defines huge pages that we want to allocate at boot time.
- Type
-
array
3.1.6. .spec.hugepages.pages[]
- Description
- HugePage defines the number of allocated huge pages of the specific size.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| Count defines amount of huge pages, maps to the 'hugepages' kernel boot parameter. |
|
| Node defines the NUMA node where hugepages will be allocated, if not specified, pages will be allocated equally between NUMA nodes |
|
| Size defines huge page size, maps to the 'hugepagesz' kernel boot parameter. |
3.1.7. .spec.net
- Description
- Net defines a set of network related features
- Type
-
object
Property | Type | Description |
---|---|---|
|
| Devices contains a list of network device representations that will be set with a netqueue count equal to CPU.Reserved . If no devices are specified then the default is all devices. |
|
| Device defines a way to represent a network device in several options: device name, vendor ID, model ID, PCI path and MAC address |
|
| UserLevelNetworking when enabled - sets either all or specified network devices queue size to the amount of reserved CPUs. Defaults to "false". |
3.1.8. .spec.net.devices
- Description
- Devices contains a list of network device representations that will be set with a netqueue count equal to CPU.Reserved . If no devices are specified then the default is all devices.
- Type
-
array
3.1.9. .spec.net.devices[]
- Description
- Device defines a way to represent a network device in several options: device name, vendor ID, model ID, PCI path and MAC address
- Type
-
object
Property | Type | Description |
---|---|---|
|
| Network device ID (model) represnted as a 16 bit hexmadecimal number. |
|
| Network device name to be matched. It uses a syntax of shell-style wildcards which are either positive or negative. |
|
| Network device vendor ID represnted as a 16 bit Hexmadecimal number. |
3.1.10. .spec.numa
- Description
- NUMA defines options related to topology aware affinities
- Type
-
object
Property | Type | Description |
---|---|---|
|
| Name of the policy applied when TopologyManager is enabled Operator defaults to "best-effort" |
3.1.11. .spec.realTimeKernel
- Description
- RealTimeKernel defines a set of real time kernel related parameters. RT kernel won’t be installed when not set.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| Enabled defines if the real time kernel packages should be installed. Defaults to "false" |
3.1.12. .spec.workloadHints
- Description
- WorkloadHints defines hints for different types of workloads. It will allow defining exact set of tuned and kernel arguments that should be applied on top of the node.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| HighPowerConsumption defines if the node should be configured in high power consumption mode. The flag will affect the power consumption but will improve the CPUs latency. Defaults to false. |
|
| MixedCpus enables the mixed-cpu-node-plugin on the node. Defaults to false. |
|
| PerPodPowerManagement defines if the node should be configured in per pod power management. PerPodPowerManagement and HighPowerConsumption hints can not be enabled together. Defaults to false. |
|
| RealTime defines if the node should be configured for the real time workload. Defaults to true. |
3.1.13. .status
- Description
- PerformanceProfileStatus defines the observed state of PerformanceProfile.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| Conditions represents the latest available observations of current state. |
|
| Condition represents the state of the operator’s reconciliation functionality. |
|
| RuntimeClass contains the name of the RuntimeClass resource created by the operator. |
|
| Tuned points to the Tuned custom resource object that contains the tuning values generated by this operator. |
3.1.14. .status.conditions
- Description
- Conditions represents the latest available observations of current state.
- Type
-
array
3.1.15. .status.conditions[]
- Description
- Condition represents the state of the operator’s reconciliation functionality.
- Type
-
object
- Required
-
status
-
type
-
Property | Type | Description |
---|---|---|
|
| |
|
| |
|
| |
|
| |
|
| |
|
| ConditionType is the state of the operator’s reconciliation functionality. |
3.2. API endpoints
The following API endpoints are available:
/apis/performance.openshift.io/v2/performanceprofiles
-
DELETE
: delete collection of PerformanceProfile -
GET
: list objects of kind PerformanceProfile -
POST
: create a PerformanceProfile
-
/apis/performance.openshift.io/v2/performanceprofiles/{name}
-
DELETE
: delete a PerformanceProfile -
GET
: read the specified PerformanceProfile -
PATCH
: partially update the specified PerformanceProfile -
PUT
: replace the specified PerformanceProfile
-
/apis/performance.openshift.io/v2/performanceprofiles/{name}/status
-
GET
: read status of the specified PerformanceProfile -
PATCH
: partially update status of the specified PerformanceProfile -
PUT
: replace status of the specified PerformanceProfile
-
3.2.1. /apis/performance.openshift.io/v2/performanceprofiles
- HTTP method
-
DELETE
- Description
- delete collection of PerformanceProfile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- list objects of kind PerformanceProfile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
POST
- Description
- create a PerformanceProfile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
3.2.2. /apis/performance.openshift.io/v2/performanceprofiles/{name}
Parameter | Type | Description |
---|---|---|
|
| name of the PerformanceProfile |
- HTTP method
-
DELETE
- Description
- delete a PerformanceProfile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- read the specified PerformanceProfile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PATCH
- Description
- partially update the specified PerformanceProfile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PUT
- Description
- replace the specified PerformanceProfile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
3.2.3. /apis/performance.openshift.io/v2/performanceprofiles/{name}/status
Parameter | Type | Description |
---|---|---|
|
| name of the PerformanceProfile |
- HTTP method
-
GET
- Description
- read status of the specified PerformanceProfile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PATCH
- Description
- partially update status of the specified PerformanceProfile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PUT
- Description
- replace status of the specified PerformanceProfile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
Chapter 4. Profile [tuned.openshift.io/v1]
- Description
- Profile is a specification for a Profile resource.
- Type
-
object
4.1. Specification
Property | Type | Description |
---|---|---|
|
| APIVersion 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| Kind 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| |
|
| ProfileStatus is the status for a Profile resource; the status is for internal use only and its fields may be changed/removed in the future. |
4.1.1. .spec
- Description
- Type
-
object
- Required
-
config
-
Property | Type | Description |
---|---|---|
|
| |
|
| Tuned profiles. |
|
| A Tuned profile. |
4.1.2. .spec.config
- Description
- Type
-
object
- Required
-
tunedProfile
-
Property | Type | Description |
---|---|---|
|
| option to debug TuneD daemon execution |
|
| Name of the cloud provider as taken from the Node providerID: <ProviderName>://<ProviderSpecificNodeID> |
|
| Global configuration for the TuneD daemon as defined in tuned-main.conf |
|
| TuneD profile to apply |
4.1.3. .spec.config.tunedConfig
- Description
- Global configuration for the TuneD daemon as defined in tuned-main.conf
- Type
-
object
Property | Type | Description |
---|---|---|
|
| turn reapply_sysctl functionality on/off for the TuneD daemon: true/false |
4.1.4. .spec.profile
- Description
- Tuned profiles.
- Type
-
array
4.1.5. .spec.profile[]
- Description
- A Tuned profile.
- Type
-
object
- Required
-
data
-
name
-
Property | Type | Description |
---|---|---|
|
| Specification of the Tuned profile to be consumed by the Tuned daemon. |
|
| Name of the Tuned profile to be used in the recommend section. |
4.1.6. .status
- Description
- ProfileStatus is the status for a Profile resource; the status is for internal use only and its fields may be changed/removed in the future.
- Type
-
object
- Required
-
tunedProfile
-
Property | Type | Description |
---|---|---|
|
| conditions represents the state of the per-node Profile application |
|
| ProfileStatusCondition represents a partial state of the per-node Profile application. |
|
| the current profile in use by the Tuned daemon |
4.1.7. .status.conditions
- Description
- conditions represents the state of the per-node Profile application
- Type
-
array
4.1.8. .status.conditions[]
- Description
- ProfileStatusCondition represents a partial state of the per-node Profile application.
- Type
-
object
- Required
-
lastTransitionTime
-
status
-
type
-
Property | Type | Description |
---|---|---|
|
| lastTransitionTime is the time of the last update to the current status property. |
|
| message provides additional information about the current condition. This is only to be consumed by humans. |
|
| reason is the CamelCase reason for the condition’s current status. |
|
| status of the condition, one of True, False, Unknown. |
|
| type specifies the aspect reported by this condition. |
4.2. API endpoints
The following API endpoints are available:
/apis/tuned.openshift.io/v1/profiles
-
GET
: list objects of kind Profile
-
/apis/tuned.openshift.io/v1/namespaces/{namespace}/profiles
-
DELETE
: delete collection of Profile -
GET
: list objects of kind Profile -
POST
: create a Profile
-
/apis/tuned.openshift.io/v1/namespaces/{namespace}/profiles/{name}
-
DELETE
: delete a Profile -
GET
: read the specified Profile -
PATCH
: partially update the specified Profile -
PUT
: replace the specified Profile
-
/apis/tuned.openshift.io/v1/namespaces/{namespace}/profiles/{name}/status
-
GET
: read status of the specified Profile -
PATCH
: partially update status of the specified Profile -
PUT
: replace status of the specified Profile
-
4.2.1. /apis/tuned.openshift.io/v1/profiles
- HTTP method
-
GET
- Description
- list objects of kind Profile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
4.2.2. /apis/tuned.openshift.io/v1/namespaces/{namespace}/profiles
- HTTP method
-
DELETE
- Description
- delete collection of Profile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- list objects of kind Profile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
POST
- Description
- create a Profile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
4.2.3. /apis/tuned.openshift.io/v1/namespaces/{namespace}/profiles/{name}
Parameter | Type | Description |
---|---|---|
|
| name of the Profile |
- HTTP method
-
DELETE
- Description
- delete a Profile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- read the specified Profile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PATCH
- Description
- partially update the specified Profile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PUT
- Description
- replace the specified Profile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
4.2.4. /apis/tuned.openshift.io/v1/namespaces/{namespace}/profiles/{name}/status
Parameter | Type | Description |
---|---|---|
|
| name of the Profile |
- HTTP method
-
GET
- Description
- read status of the specified Profile
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PATCH
- Description
- partially update status of the specified Profile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PUT
- Description
- replace status of the specified Profile
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
Chapter 5. RuntimeClass [node.k8s.io/v1]
- Description
- 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/
- Type
-
object
- Required
-
handler
-
5.1. Specification
Property | Type | Description |
---|---|---|
|
| APIVersion 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| handler specifies the underlying runtime and configuration that the CRI implementation will use to handle pods of this class. The possible values are specific to the node & CRI configuration. It is assumed that all handlers are available on every node, and handlers of the same name are equivalent on every node. For example, a handler called "runc" might specify that the runc OCI runtime (using native Linux containers) will be used to run the containers in a pod. The Handler must be lowercase, conform to the DNS Label (RFC 1123) requirements, and is immutable. |
|
| Kind 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| Overhead structure represents the resource overhead associated with running a pod. |
|
| Scheduling specifies the scheduling constraints for nodes supporting a RuntimeClass. |
5.1.1. .overhead
- Description
- Overhead structure represents the resource overhead associated with running a pod.
- Type
-
object
Property | Type | Description |
---|---|---|
| podFixed represents the fixed resource overhead associated with running a pod. |
5.1.2. .scheduling
- Description
- Scheduling specifies the scheduling constraints for nodes supporting a RuntimeClass.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| nodeSelector lists labels that must be present on nodes that support this RuntimeClass. Pods using this RuntimeClass can only be scheduled to a node matched by this selector. The RuntimeClass nodeSelector is merged with a pod’s existing nodeSelector. Any conflicts will cause the pod to be rejected in admission. |
| tolerations are appended (excluding duplicates) to pods running with this RuntimeClass during admission, effectively unioning the set of nodes tolerated by the pod and the RuntimeClass. |
5.2. API endpoints
The following API endpoints are available:
/apis/node.k8s.io/v1/runtimeclasses
-
DELETE
: delete collection of RuntimeClass -
GET
: list or watch objects of kind RuntimeClass -
POST
: create a RuntimeClass
-
/apis/node.k8s.io/v1/watch/runtimeclasses
-
GET
: watch individual changes to a list of RuntimeClass. deprecated: use the 'watch' parameter with a list operation instead.
-
/apis/node.k8s.io/v1/runtimeclasses/{name}
-
DELETE
: delete a RuntimeClass -
GET
: read the specified RuntimeClass -
PATCH
: partially update the specified RuntimeClass -
PUT
: replace the specified RuntimeClass
-
/apis/node.k8s.io/v1/watch/runtimeclasses/{name}
-
GET
: watch changes to an object of kind RuntimeClass. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.
-
5.2.1. /apis/node.k8s.io/v1/runtimeclasses
- HTTP method
-
DELETE
- Description
- delete collection of RuntimeClass
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- list or watch objects of kind RuntimeClass
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
POST
- Description
- create a RuntimeClass
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
5.2.2. /apis/node.k8s.io/v1/watch/runtimeclasses
- HTTP method
-
GET
- Description
- watch individual changes to a list of RuntimeClass. deprecated: use the 'watch' parameter with a list operation instead.
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
5.2.3. /apis/node.k8s.io/v1/runtimeclasses/{name}
Parameter | Type | Description |
---|---|---|
|
| name of the RuntimeClass |
- HTTP method
-
DELETE
- Description
- delete a RuntimeClass
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- read the specified RuntimeClass
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PATCH
- Description
- partially update the specified RuntimeClass
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
- HTTP method
-
PUT
- Description
- replace the specified RuntimeClass
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |
5.2.4. /apis/node.k8s.io/v1/watch/runtimeclasses/{name}
Parameter | Type | Description |
---|---|---|
|
| name of the RuntimeClass |
- HTTP method
-
GET
- Description
- watch changes to an object of kind RuntimeClass. deprecated: use the 'watch' parameter with a list operation instead, filtered to a single item with the 'fieldSelector' parameter.
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
Chapter 6. Tuned [tuned.openshift.io/v1]
- Description
- Tuned is a collection of rules that allows cluster-wide deployment of node-level sysctls and more flexibility to add custom tuning specified by user needs. These rules are translated and passed to all containerized Tuned daemons running in the cluster in the format that the daemons understand. The responsibility for applying the node-level tuning then lies with the containerized Tuned daemons. More info: https://github.com/openshift/cluster-node-tuning-operator
- Type
-
object
6.1. Specification
Property | Type | Description |
---|---|---|
|
| APIVersion 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
| Kind 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: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
| Standard object’s metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
| spec is the specification of the desired behavior of Tuned. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status |
|
| TunedStatus is the status for a Tuned resource. |
6.1.1. .spec
- Description
- spec is the specification of the desired behavior of Tuned. More info: https://git.k8s.io/community/contributors/devel/api-conventions.md#spec-and-status
- Type
-
object
Property | Type | Description |
---|---|---|
|
| managementState indicates whether the registry instance represented by this config instance is under operator management or not. Valid values are Force, Managed, Unmanaged, and Removed. |
|
| Tuned profiles. |
|
| A Tuned profile. |
|
| Selection logic for all Tuned profiles. |
|
| Selection logic for a single Tuned profile. |
6.1.2. .spec.profile
- Description
- Tuned profiles.
- Type
-
array
6.1.3. .spec.profile[]
- Description
- A Tuned profile.
- Type
-
object
- Required
-
data
-
name
-
Property | Type | Description |
---|---|---|
|
| Specification of the Tuned profile to be consumed by the Tuned daemon. |
|
| Name of the Tuned profile to be used in the recommend section. |
6.1.4. .spec.recommend
- Description
- Selection logic for all Tuned profiles.
- Type
-
array
6.1.5. .spec.recommend[]
- Description
- Selection logic for a single Tuned profile.
- Type
-
object
- Required
-
priority
-
profile
-
Property | Type | Description |
---|---|---|
|
| MachineConfigLabels specifies the labels for a MachineConfig. The MachineConfig is created automatically to apply additional host settings (e.g. kernel boot parameters) profile 'Profile' needs and can only be applied by creating a MachineConfig. This involves finding all MachineConfigPools with machineConfigSelector matching the MachineConfigLabels and setting the profile 'Profile' on all nodes that match the MachineConfigPools' nodeSelectors. |
|
| Rules governing application of a Tuned profile connected by logical OR operator. |
|
| Rules governing application of a Tuned profile. |
|
| Optional operand configuration. |
|
| Tuned profile priority. Highest priority is 0. |
|
| Name of the Tuned profile to recommend. |
6.1.6. .spec.recommend[].match
- Description
- Rules governing application of a Tuned profile connected by logical OR operator.
- Type
-
array
6.1.7. .spec.recommend[].match[]
- Description
- Rules governing application of a Tuned profile.
- Type
-
object
- Required
-
label
-
Property | Type | Description |
---|---|---|
|
| Node or Pod label name. |
|
| Additional rules governing application of the tuned profile connected by logical AND operator. |
|
| Match type: [node/pod]. If omitted, "node" is assumed. |
|
| Node or Pod label value. If omitted, the presence of label name is enough to match. |
6.1.8. .spec.recommend[].operand
- Description
- Optional operand configuration.
- Type
-
object
Property | Type | Description |
---|---|---|
|
| turn debugging on/off for the TuneD daemon: true/false (default is false) |
|
| Global configuration for the TuneD daemon as defined in tuned-main.conf |
6.1.9. .spec.recommend[].operand.tunedConfig
- Description
- Global configuration for the TuneD daemon as defined in tuned-main.conf
- Type
-
object
Property | Type | Description |
---|---|---|
|
| turn reapply_sysctl functionality on/off for the TuneD daemon: true/false |
6.1.10. .status
- Description
- TunedStatus is the status for a Tuned resource.
- Type
-
object
6.2. API endpoints
The following API endpoints are available:
/apis/tuned.openshift.io/v1/tuneds
-
GET
: list objects of kind Tuned
-
/apis/tuned.openshift.io/v1/namespaces/{namespace}/tuneds
-
DELETE
: delete collection of Tuned -
GET
: list objects of kind Tuned -
POST
: create a Tuned
-
/apis/tuned.openshift.io/v1/namespaces/{namespace}/tuneds/{name}
-
DELETE
: delete a Tuned -
GET
: read the specified Tuned -
PATCH
: partially update the specified Tuned -
PUT
: replace the specified Tuned
-
6.2.1. /apis/tuned.openshift.io/v1/tuneds
- HTTP method
-
GET
- Description
- list objects of kind Tuned
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
6.2.2. /apis/tuned.openshift.io/v1/namespaces/{namespace}/tuneds
- HTTP method
-
DELETE
- Description
- delete collection of Tuned
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- list objects of kind Tuned
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
POST
- Description
- create a Tuned
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
6.2.3. /apis/tuned.openshift.io/v1/namespaces/{namespace}/tuneds/{name}
Parameter | Type | Description |
---|---|---|
|
| name of the Tuned |
- HTTP method
-
DELETE
- Description
- delete a Tuned
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
HTTP code | Reponse body |
---|---|
200 - OK |
|
202 - Accepted |
|
401 - Unauthorized | Empty |
- HTTP method
-
GET
- Description
- read the specified Tuned
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PATCH
- Description
- partially update the specified Tuned
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
HTTP code | Reponse body |
---|---|
200 - OK |
|
401 - Unauthorized | Empty |
- HTTP method
-
PUT
- Description
- replace the specified Tuned
Parameter | Type | Description |
---|---|---|
|
| 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 are: - All: all dry run stages will be processed |
|
| fieldValidation instructs the server on how to handle objects in the request (POST/PUT/PATCH) containing unknown or duplicate fields. Valid values are: - Ignore: This will ignore any unknown fields that are silently dropped from the object, and will ignore all but the last duplicate field that the decoder encounters. This is the default behavior prior to v1.23. - Warn: This will send a warning via the standard warning response header for each unknown field that is dropped from the object, and for each duplicate field that is encountered. The request will still succeed if there are no other errors, and will only persist the last of any duplicate fields. This is the default in v1.23+ - Strict: This will fail the request with a BadRequest error if any unknown fields would be dropped from the object, or if any duplicate fields are present. The error returned from the server will contain all unknown and duplicate fields encountered. |
Parameter | Type | Description |
---|---|---|
|
|
HTTP code | Reponse body |
---|---|
200 - OK |
|
201 - Created |
|
401 - Unauthorized | Empty |