节点 [undefined/v1] - 节点 API | API 参考 | OpenShift 容器平台 4.17

描述: 节点是 Kubernetes 中的工作节点。每个节点在缓存中（即在 etcd 中）都有一个唯一的标识符。
类型: 对象

规格

属性类型描述

属性	类型	描述
`apiVersion`	`字符串`	APIVersion 定义了对象的此表示的版本化模式。服务器应将识别的模式转换为最新的内部值，并可能拒绝无法识别的值。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources
`kind`	`字符串`	Kind 是一个字符串值，表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。不能更新。采用驼峰命名法。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds
`metadata`	`ObjectMeta`	标准对象的元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
`spec`	`对象`	NodeSpec 描述了创建节点时使用的属性。
`status`	`对象`	NodeStatus 是有关节点当前状态的信息。

apiVersion

字符串

APIVersion 定义了对象的此表示的版本化模式。服务器应将识别的模式转换为最新的内部值，并可能拒绝无法识别的值。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

kind

字符串

Kind 是一个字符串值，表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。不能更新。采用驼峰命名法。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

标准对象的元数据。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

spec

对象

NodeSpec 描述了创建节点时使用的属性。

status

对象

NodeStatus 是有关节点当前状态的信息。

.spec

描述: NodeSpec 描述了创建节点时使用的属性。
类型: 对象

属性类型描述

属性	类型	描述
`configSource`	`对象`	NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用
`externalID`	`字符串`	已弃用。并非所有 kubelet 都将设置此字段。1.13 后删除此字段，请参阅：https://issues.k8s.io/61966
`podCIDR`	`字符串`	PodCIDR 表示分配给节点的 Pod IP 范围。
`podCIDRs`	`数组（字符串）`	podCIDRs 表示分配给节点的 IP 范围，供该节点上的 Pod 使用。如果指定此字段，则第 0 个条目必须与 podCIDR 字段匹配。它最多可以包含 IPv4 和 IPv6 各一个值。
`providerID`	`字符串`	云提供商分配给节点的 ID，格式为：<ProviderName>://<ProviderSpecificNodeID>
`taints`	`数组`	如果指定，则为节点的污点。
`taints[]`	`对象`	附加此污点的节点对任何不宽容此污点的 Pod 具有“影响”。
`unschedulable`	`布尔值`	Unschedulable 控制新 Pod 的节点可调度性。默认情况下，节点是可调度的。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#manual-node-administration

configSource

对象

NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用

externalID

字符串

已弃用。并非所有 kubelet 都将设置此字段。1.13 后删除此字段，请参阅：https://issues.k8s.io/61966

podCIDR

字符串

PodCIDR 表示分配给节点的 Pod IP 范围。

podCIDRs

数组（字符串）

podCIDRs 表示分配给节点的 IP 范围，供该节点上的 Pod 使用。如果指定此字段，则第 0 个条目必须与 podCIDR 字段匹配。它最多可以包含 IPv4 和 IPv6 各一个值。

providerID

字符串

云提供商分配给节点的 ID，格式为：<ProviderName>://<ProviderSpecificNodeID>

taints

数组

如果指定，则为节点的污点。

taints[]

对象

附加此污点的节点对任何不宽容此污点的 Pod 具有“影响”。

unschedulable

布尔值

Unschedulable 控制新 Pod 的节点可调度性。默认情况下，节点是可调度的。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#manual-node-administration

.spec.configSource

描述: NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用
类型: 对象

属性类型描述

属性	类型	描述
`configMap`	`对象`	ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

configMap

对象

ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

.spec.configSource.configMap

描述

ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

类型

对象

必需

namespace
name
kubeletConfigKey

属性类型描述

属性	类型	描述
`kubeletConfigKey`	`字符串`	KubeletConfigKey 声明引用的 ConfigMap 的哪个键对应于 KubeletConfiguration 结构。此字段在所有情况下都是必需的。
`name`	`字符串`	Name 是引用的 ConfigMap 的 metadata.name。此字段在所有情况下都是必需的。
`namespace`	`字符串`	Namespace 是引用的 ConfigMap 的 metadata.namespace。此字段在所有情况下都是必需的。
`resourceVersion`	`字符串`	ResourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。
`uid`	`字符串`	UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

kubeletConfigKey

字符串

KubeletConfigKey 声明引用的 ConfigMap 的哪个键对应于 KubeletConfiguration 结构。此字段在所有情况下都是必需的。

name

字符串

Name 是引用的 ConfigMap 的 metadata.name。此字段在所有情况下都是必需的。

namespace

字符串

Namespace 是引用的 ConfigMap 的 metadata.namespace。此字段在所有情况下都是必需的。

resourceVersion

字符串

ResourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

uid

字符串

UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

.spec.taints

描述: 如果指定，则为节点的污点。
类型: 数组

.spec.taints[]

描述

附加此污点的节点对任何不宽容此污点的 Pod 具有“影响”。

类型

对象

必需

key
effect

属性类型描述

属性	类型	描述
`effect`	`字符串`	必填。污点对不兼容该污点的 Pod 的影响。有效的 effect 值为 NoSchedule、PreferNoSchedule 和 NoExecute。可能的枚举值：- `"NoExecute"` 驱逐任何不兼容该污点且仍在运行的 Pod。当前由 NodeController 强制执行。- `"NoSchedule"` 除非 Pod 兼容该污点，否则不允许新的 Pod 调度到节点上，但允许所有未经调度程序提交给 Kubelet 的 Pod 启动，并允许所有已运行的 Pod 继续运行。由调度程序强制执行。- `"PreferNoSchedule"` 类似于 TaintEffectNoSchedule，但调度程序尝试避免将新的 Pod 调度到节点上，而不是完全禁止将新的 Pod 调度到节点上。由调度程序强制执行。
`key`	`字符串`	必填。要应用于节点的污点键。
`timeAdded`	`时间`	TimeAdded 表示添加污点的时间。仅为 NoExecute 污点写入。
`value`	`字符串`	与污点键对应的污点值。

effect

字符串

必填。污点对不兼容该污点的 Pod 的影响。有效的 effect 值为 NoSchedule、PreferNoSchedule 和 NoExecute。

可能的枚举值：- "NoExecute" 驱逐任何不兼容该污点且仍在运行的 Pod。当前由 NodeController 强制执行。- "NoSchedule" 除非 Pod 兼容该污点，否则不允许新的 Pod 调度到节点上，但允许所有未经调度程序提交给 Kubelet 的 Pod 启动，并允许所有已运行的 Pod 继续运行。由调度程序强制执行。- "PreferNoSchedule" 类似于 TaintEffectNoSchedule，但调度程序尝试避免将新的 Pod 调度到节点上，而不是完全禁止将新的 Pod 调度到节点上。由调度程序强制执行。

key

字符串

必填。要应用于节点的污点键。

timeAdded

时间

TimeAdded 表示添加污点的时间。仅为 NoExecute 污点写入。

value

字符串

与污点键对应的污点值。

.status

描述: NodeStatus 是有关节点当前状态的信息。
类型: 对象

属性类型描述

属性	类型	描述
`addresses`	`数组`	可访问节点的地址列表。如果可用，则从云提供商查询。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#addresses 注意：此字段声明为可合并的，但合并键不够唯一，这会在合并时导致数据损坏。调用者应改用完整的替换补丁。有关示例，请参阅 https://pr.k8s.io/79391。使用者应假设地址在 Node 的生命周期内可能会发生变化。但是，在某些情况下可能无法做到这一点，例如 Pod 在其自身状态中继承 Node 的地址或向下 API (status.hostIP) 的使用者。
`addresses[]`	`对象`	NodeAddress 包含节点地址的信息。
`allocatable`	`对象 (Quantity)`	Allocatable 表示可用于调度的节点资源。默认为 Capacity。
`capacity`	`对象 (Quantity)`	Capacity 表示节点的总资源。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#capacity
`conditions`	`数组`	Conditions 是当前观察到的节点条件的数组。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#condition
`conditions[]`	`对象`	NodeCondition 包含节点的条件信息。
`config`	`对象`	NodeConfigStatus 描述 Node.Spec.ConfigSource 分配的配置的状态。
`daemonEndpoints`	`对象`	NodeDaemonEndpoints 列出了在 Node 上运行的守护程序打开的端口。
`images`	`数组`	此节点上的容器镜像列表
`images[]`	`对象`	描述一个容器镜像
`nodeInfo`	`对象`	NodeSystemInfo 是一组用于唯一标识节点的 ID/UUID。
`phase`	`字符串`	NodePhase 是最近观察到的节点生命周期阶段。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#phase 此字段从未填充，现在已弃用。可能的枚举值：- `"Pending"` 表示节点已由系统创建/添加，但尚未配置。- `"Running"` 表示节点已配置并运行 Kubernetes 组件。- `"Terminated"` 表示节点已从集群中移除。
`runtimeHandlers`	`数组`	可用的运行时处理程序。
`runtimeHandlers[]`	`对象`	NodeRuntimeHandler 是一组运行时处理程序信息。
`volumesAttached`	`数组`	附加到节点的卷列表。
`volumesAttached[]`	`对象`	AttachedVolume 描述附加到节点的卷
`volumesInUse`	`数组（字符串）`	节点正在使用（已挂载）的可附加卷列表。

addresses

数组

可访问节点的地址列表。如果可用，则从云提供商查询。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#addresses 注意：此字段声明为可合并的，但合并键不够唯一，这会在合并时导致数据损坏。调用者应改用完整的替换补丁。有关示例，请参阅 https://pr.k8s.io/79391。使用者应假设地址在 Node 的生命周期内可能会发生变化。但是，在某些情况下可能无法做到这一点，例如 Pod 在其自身状态中继承 Node 的地址或向下 API (status.hostIP) 的使用者。

addresses[]

对象

NodeAddress 包含节点地址的信息。

allocatable

对象 (Quantity)

Allocatable 表示可用于调度的节点资源。默认为 Capacity。

capacity

对象 (Quantity)

Capacity 表示节点的总资源。更多信息：https://kubernetes.ac.cn/docs/concepts/storage/persistent-volumes#capacity

conditions

数组

Conditions 是当前观察到的节点条件的数组。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#condition

conditions[]

对象

NodeCondition 包含节点的条件信息。

config

对象

NodeConfigStatus 描述 Node.Spec.ConfigSource 分配的配置的状态。

daemonEndpoints

对象

NodeDaemonEndpoints 列出了在 Node 上运行的守护程序打开的端口。

images

数组

此节点上的容器镜像列表

images[]

对象

描述一个容器镜像

nodeInfo

对象

NodeSystemInfo 是一组用于唯一标识节点的 ID/UUID。

phase

字符串

NodePhase 是最近观察到的节点生命周期阶段。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#phase 此字段从未填充，现在已弃用。

可能的枚举值：- "Pending" 表示节点已由系统创建/添加，但尚未配置。- "Running" 表示节点已配置并运行 Kubernetes 组件。- "Terminated" 表示节点已从集群中移除。

runtimeHandlers

数组

可用的运行时处理程序。

runtimeHandlers[]

对象

NodeRuntimeHandler 是一组运行时处理程序信息。

volumesAttached

数组

附加到节点的卷列表。

volumesAttached[]

对象

AttachedVolume 描述附加到节点的卷

volumesInUse

数组（字符串）

节点正在使用（已挂载）的可附加卷列表。

.status.addresses

描述: 可访问节点的地址列表。如果可用，则从云提供商查询。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#addresses 注意：此字段声明为可合并的，但合并键不够唯一，这会在合并时导致数据损坏。调用者应改用完整的替换补丁。有关示例，请参阅 https://pr.k8s.io/79391。使用者应假设地址在 Node 的生命周期内可能会发生变化。但是，在某些情况下可能无法做到这一点，例如 Pod 在其自身状态中继承 Node 的地址或向下 API (status.hostIP) 的使用者。
类型: 数组

.status.addresses[]

描述

NodeAddress 包含节点地址的信息。

类型

对象

必需

type
address

属性类型描述

属性	类型	描述
`address`	`字符串`	节点地址。
`type`	`字符串`	节点地址类型，Hostname、ExternalIP 或 InternalIP 之一。

address

字符串

节点地址。

type

字符串

节点地址类型，Hostname、ExternalIP 或 InternalIP 之一。

.status.conditions

描述: Conditions 是当前观察到的节点条件的数组。更多信息：https://kubernetes.ac.cn/docs/concepts/nodes/node/#condition
类型: 数组

.status.conditions[]

描述

NodeCondition 包含节点的条件信息。

类型

对象

必需

type
status

属性类型描述

属性	类型	描述
`lastHeartbeatTime`	`时间`	我们上次获取给定条件更新的时间。
`lastTransitionTime`	`时间`	条件从一种状态转换到另一种状态的最后时间。
`message`	`字符串`	指示上次转换详细信息的人类可读消息。
`reason`	`字符串`	条件上次转换的（简短）原因。
`status`	`字符串`	条件的状态，True、False、Unknown 之一。
`type`	`字符串`	节点条件的类型。

lastHeartbeatTime

时间

我们上次获取给定条件更新的时间。

lastTransitionTime

时间

条件从一种状态转换到另一种状态的最后时间。

message

字符串

指示上次转换详细信息的人类可读消息。

reason

字符串

条件上次转换的（简短）原因。

status

字符串

条件的状态，True、False、Unknown 之一。

type

字符串

节点条件的类型。

.status.config

描述: NodeConfigStatus 描述 Node.Spec.ConfigSource 分配的配置的状态。
类型: 对象

属性类型描述

属性	类型	描述
`active`	`对象`	NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用
`assigned`	`对象`	NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用
`error`	`字符串`	Error 描述了将 Spec.ConfigSource 与 Active 配置协调时出现的任何问题。例如，尝试将 Spec.ConfigSource 检查点到本地 Assigned 记录，尝试检查点与 Spec.ConfigSource 关联的有效负载，尝试加载或验证 Assigned 配置等时可能会出现错误。错误可能在同步配置的不同点出现。较早的错误（例如下载或检查点错误）不会导致回滚到 LastKnownGood，并且可能会在 Kubelet 重试中解决。较晚的错误（例如加载或验证检查点配置）将导致回滚到 LastKnownGood。在后一种情况下，通常可以通过修复 Spec.ConfigSource 中分配的配置来解决错误。您可以通过在 Kubelet 日志中搜索错误消息来查找其他调试信息。Error 是错误状态的人类可读描述；机器可以检查 Error 是否为空，但不应依赖于 Kubelet 版本之间的 Error 文本的稳定性。
`lastKnownGood`	`对象`	NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用

active

对象

NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用

assigned

对象

NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用

error

字符串

Error 描述了将 Spec.ConfigSource 与 Active 配置协调时出现的任何问题。例如，尝试将 Spec.ConfigSource 检查点到本地 Assigned 记录，尝试检查点与 Spec.ConfigSource 关联的有效负载，尝试加载或验证 Assigned 配置等时可能会出现错误。错误可能在同步配置的不同点出现。较早的错误（例如下载或检查点错误）不会导致回滚到 LastKnownGood，并且可能会在 Kubelet 重试中解决。较晚的错误（例如加载或验证检查点配置）将导致回滚到 LastKnownGood。在后一种情况下，通常可以通过修复 Spec.ConfigSource 中分配的配置来解决错误。您可以通过在 Kubelet 日志中搜索错误消息来查找其他调试信息。Error 是错误状态的人类可读描述；机器可以检查 Error 是否为空，但不应依赖于 Kubelet 版本之间的 Error 文本的稳定性。

lastKnownGood

对象

NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用

.status.config.active

描述: NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用
类型: 对象

属性类型描述

属性	类型	描述
`configMap`	`对象`	ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

configMap

对象

ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

.status.config.active.configMap

描述

ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

类型

对象

必需

namespace
name
kubeletConfigKey

属性类型描述

属性	类型	描述
`kubeletConfigKey`	`字符串`	KubeletConfigKey 声明引用的 ConfigMap 的哪个键对应于 KubeletConfiguration 结构。此字段在所有情况下都是必需的。
`name`	`字符串`	Name 是引用的 ConfigMap 的 metadata.name。此字段在所有情况下都是必需的。
`namespace`	`字符串`	Namespace 是引用的 ConfigMap 的 metadata.namespace。此字段在所有情况下都是必需的。
`resourceVersion`	`字符串`	ResourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。
`uid`	`字符串`	UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

kubeletConfigKey

字符串

KubeletConfigKey 声明引用的 ConfigMap 的哪个键对应于 KubeletConfiguration 结构。此字段在所有情况下都是必需的。

name

字符串

Name 是引用的 ConfigMap 的 metadata.name。此字段在所有情况下都是必需的。

namespace

字符串

Namespace 是引用的 ConfigMap 的 metadata.namespace。此字段在所有情况下都是必需的。

resourceVersion

字符串

ResourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

uid

字符串

UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

.status.config.assigned

描述: NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用
类型: 对象

属性类型描述

属性	类型	描述
`configMap`	`对象`	ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

configMap

对象

ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

.status.config.assigned.configMap

描述

ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

类型

对象

必需

namespace
name
kubeletConfigKey

属性类型描述

属性	类型	描述
`kubeletConfigKey`	`字符串`	KubeletConfigKey 声明引用的 ConfigMap 的哪个键对应于 KubeletConfiguration 结构。此字段在所有情况下都是必需的。
`name`	`字符串`	Name 是引用的 ConfigMap 的 metadata.name。此字段在所有情况下都是必需的。
`namespace`	`字符串`	Namespace 是引用的 ConfigMap 的 metadata.namespace。此字段在所有情况下都是必需的。
`resourceVersion`	`字符串`	ResourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。
`uid`	`字符串`	UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

kubeletConfigKey

字符串

KubeletConfigKey 声明引用的 ConfigMap 的哪个键对应于 KubeletConfiguration 结构。此字段在所有情况下都是必需的。

name

字符串

Name 是引用的 ConfigMap 的 metadata.name。此字段在所有情况下都是必需的。

namespace

字符串

Namespace 是引用的 ConfigMap 的 metadata.namespace。此字段在所有情况下都是必需的。

resourceVersion

字符串

ResourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

uid

字符串

UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

.status.config.lastKnownGood

描述: NodeConfigSource 指定节点配置的来源。必须只有一个子字段（不包括元数据）非空。此 API 自 1.22 版起已弃用
类型: 对象

属性类型描述

属性	类型	描述
`configMap`	`对象`	ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

configMap

对象

ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

.status.config.lastKnownGood.configMap

描述

ConfigMapNodeConfigSource 包含将 ConfigMap 作为节点配置源引用的信息。此 API 自 1.22 版起已弃用：https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration

类型

对象

必需

namespace
name
kubeletConfigKey

属性类型描述

属性	类型	描述
`kubeletConfigKey`	`字符串`	KubeletConfigKey 声明引用的 ConfigMap 的哪个键对应于 KubeletConfiguration 结构。此字段在所有情况下都是必需的。
`name`	`字符串`	Name 是引用的 ConfigMap 的 metadata.name。此字段在所有情况下都是必需的。
`namespace`	`字符串`	Namespace 是引用的 ConfigMap 的 metadata.namespace。此字段在所有情况下都是必需的。
`resourceVersion`	`字符串`	ResourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。
`uid`	`字符串`	UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

kubeletConfigKey

字符串

KubeletConfigKey 声明引用的 ConfigMap 的哪个键对应于 KubeletConfiguration 结构。此字段在所有情况下都是必需的。

name

字符串

Name 是引用的 ConfigMap 的 metadata.name。此字段在所有情况下都是必需的。

namespace

字符串

Namespace 是引用的 ConfigMap 的 metadata.namespace。此字段在所有情况下都是必需的。

resourceVersion

字符串

ResourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

uid

字符串

UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中禁止使用，在 Node.Status 中是必需的。

.status.daemonEndpoints

描述: NodeDaemonEndpoints 列出了在 Node 上运行的守护程序打开的端口。
类型: 对象

属性类型描述

属性	类型	描述
`kubeletEndpoint`	`对象`	DaemonEndpoint 包含有关单个守护程序端点的信息。

kubeletEndpoint

对象

DaemonEndpoint 包含有关单个守护程序端点的信息。

.status.daemonEndpoints.kubeletEndpoint

描述

DaemonEndpoint 包含有关单个守护程序端点的信息。

类型

对象

必需

Port

属性类型描述

属性	类型	描述
`Port`	`整数`	给定端点的端口号。

Port

整数

给定端点的端口号。

.status.images

描述: 此节点上的容器镜像列表
类型: 数组

.status.images[]

描述: 描述一个容器镜像
类型: 对象

属性类型描述

属性	类型	描述
`names`	`数组（字符串）`	此镜像已知的名称。例如 ["kubernetes.example/hyperkube:v1.0.7"，"cloud-vendor.registry.example/cloud-vendor/hyperkube:v1.0.7"]
`sizeBytes`	`整数`	镜像的大小（以字节为单位）。

names

数组（字符串）

此镜像已知的名称。例如 ["kubernetes.example/hyperkube:v1.0.7"，"cloud-vendor.registry.example/cloud-vendor/hyperkube:v1.0.7"]

sizeBytes

整数

镜像的大小（以字节为单位）。

.status.nodeInfo

描述

NodeSystemInfo 是一组用于唯一标识节点的 ID/UUID。

类型

对象

必需

machineID
systemUUID
bootID
kernelVersion
osImage
containerRuntimeVersion
kubeletVersion
kubeProxyVersion
operatingSystem
architecture

属性类型描述

属性	类型	描述
`architecture`	`字符串`	节点报告的架构
`bootID`	`字符串`	节点报告的 Boot ID。
`containerRuntimeVersion`	`字符串`	节点通过运行时远程 API 报告的 ContainerRuntime 版本（例如 containerd://1.4.2）。
`kernelVersion`	`字符串`	节点从“uname -r”报告的内核版本（例如 3.16.0-0.bpo.4-amd64）。
`kubeProxyVersion`	`字符串`	节点报告的 KubeProxy 版本。
`kubeletVersion`	`字符串`	节点报告的 Kubelet 版本。
`machineID`	`字符串`	节点报告的 MachineID。对于集群中的唯一机器标识，首选此字段。从 man(5) machine-id 了解更多信息：http://man7.org/linux/man-pages/man5/machine-id.5.html
`operatingSystem`	`字符串`	节点报告的操作系统
`osImage`	`字符串`	节点从 /etc/os-release 报告的 OS 镜像（例如 Debian GNU/Linux 7 (wheezy)）。
`systemUUID`	`字符串`	节点报告的 SystemUUID。对于唯一的机器标识，首选 MachineID。此字段特定于 Red Hat 主机 https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/rhsm/uuid

architecture

字符串

节点报告的架构

bootID

字符串

节点报告的 Boot ID。

containerRuntimeVersion

字符串

节点通过运行时远程 API 报告的 ContainerRuntime 版本（例如 containerd://1.4.2）。

kernelVersion

字符串

节点从“uname -r”报告的内核版本（例如 3.16.0-0.bpo.4-amd64）。

kubeProxyVersion

字符串

节点报告的 KubeProxy 版本。

kubeletVersion

字符串

节点报告的 Kubelet 版本。

machineID

字符串

节点报告的 MachineID。对于集群中的唯一机器标识，首选此字段。从 man(5) machine-id 了解更多信息：http://man7.org/linux/man-pages/man5/machine-id.5.html

operatingSystem

字符串

节点报告的操作系统

osImage

字符串

节点从 /etc/os-release 报告的 OS 镜像（例如 Debian GNU/Linux 7 (wheezy)）。

systemUUID

字符串

节点报告的 SystemUUID。对于唯一的机器标识，首选 MachineID。此字段特定于 Red Hat 主机 https://access.redhat.com/documentation/en-us/red_hat_subscription_management/1/html/rhsm/uuid

.status.runtimeHandlers

描述: 可用的运行时处理程序。
类型: 数组

.status.runtimeHandlers[]

描述: NodeRuntimeHandler 是一组运行时处理程序信息。
类型: 对象

属性类型描述

属性	类型	描述
`特性`	`对象`	NodeRuntimeHandlerFeatures是一组运行时特性。
`name`	`字符串`	运行时处理程序名称。默认运行时处理程序为空。

特性

对象

NodeRuntimeHandlerFeatures是一组运行时特性。

name

字符串

运行时处理程序名称。默认运行时处理程序为空。

.status.runtimeHandlers[].features

描述: NodeRuntimeHandlerFeatures是一组运行时特性。
类型: 对象

属性类型描述

属性	类型	描述
`递归只读挂载`	`布尔值`	如果运行时处理程序支持RecursiveReadOnlyMounts，则RecursiveReadOnlyMounts设置为true。

递归只读挂载

布尔值

如果运行时处理程序支持RecursiveReadOnlyMounts，则RecursiveReadOnlyMounts设置为true。

.status.volumesAttached

描述: 附加到节点的卷列表。
类型: 数组

.status.volumesAttached[]

描述

AttachedVolume 描述附加到节点的卷

类型

对象

必需

name
设备路径

属性类型描述

属性	类型	描述
`设备路径`	`字符串`	DevicePath表示卷应可用的设备路径。
`name`	`字符串`	已挂载卷的名称

设备路径

字符串

DevicePath表示卷应可用的设备路径。

name

字符串

已挂载卷的名称

API端点

提供以下API端点：

/api/v1/nodes
- DELETE：删除Node集合
- GET：列出或监视Node类型的对象
- POST：创建一个Node
/api/v1/watch/nodes
- GET：监视Node列表的单个更改。已弃用：改用列表操作中的“watch”参数。
/api/v1/nodes/{name}
- DELETE：删除一个Node
- GET：读取指定的Node
- PATCH：部分更新指定的Node
- PUT：替换指定的Node
/api/v1/watch/nodes/{name}
- GET：监视Node类型对象的更改。已弃用：改用列表操作中的“watch”参数，并使用“fieldSelector”参数过滤为单个项目。
/api/v1/nodes/{name}/status
- GET：读取指定的Node的状态
- PATCH：部分更新指定的Node的状态
- PUT：替换指定的Node的状态

/api/v1/nodes

HTTP方法: DELETE
描述: 删除Node集合

表1. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

表2. HTTP响应
HTTP代码	响应体
200 - OK	`Status`模式
401 - 未授权	空

HTTP方法: GET
描述: 列出或监视Node类型的对象

表3. HTTP响应
HTTP代码	响应体
200 - OK	`NodeList`模式
401 - 未授权	空

HTTP方法: POST
描述: 创建一个Node

表4. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段
`fieldValidation`	`字符串`	fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是v1.23之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会持久化任何重复字段中的最后一个。这是v1.23+中的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，这将使用BadRequest错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表5. 请求体参数
参数	类型	描述
`body`	`Node`模式

表6. HTTP响应
HTTP代码	响应体
200 - OK	`Node`模式
201 - 已创建	`Node`模式
202 - 已接受	`Node`模式
401 - 未授权	空

/api/v1/watch/nodes

HTTP方法: GET
描述: 监视Node列表的单个更改。已弃用：改用列表操作中的“watch”参数。

表7. HTTP响应
HTTP代码	响应体
200 - OK	`WatchEvent`模式
401 - 未授权	空

/api/v1/nodes/{name}

表8. 全局路径参数
参数	类型	描述
`name`	`字符串`	Node的名称

HTTP方法: DELETE
描述: 删除一个Node

表9. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段

表10. HTTP响应
HTTP代码	响应体
200 - OK	`Status`模式
202 - 已接受	`Status`模式
401 - 未授权	空

HTTP方法: GET
描述: 读取指定的Node

表11. HTTP响应
HTTP代码	响应体
200 - OK	`Node`模式
401 - 未授权	空

HTTP方法: PATCH
描述: 部分更新指定的Node

表12. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段
`fieldValidation`	`字符串`	fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是v1.23之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会持久化任何重复字段中的最后一个。这是v1.23+中的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，这将使用BadRequest错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表13. HTTP响应
HTTP代码	响应体
200 - OK	`Node`模式
201 - 已创建	`Node`模式
401 - 未授权	空

HTTP方法: PUT
描述: 替换指定的Node

表14. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段
`fieldValidation`	`字符串`	fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是v1.23之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会持久化任何重复字段中的最后一个。这是v1.23+中的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，这将使用BadRequest错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表15. 请求体参数
参数	类型	描述
`body`	`Node`模式

表16. HTTP响应
HTTP代码	响应体
200 - OK	`Node`模式
201 - 已创建	`Node`模式
401 - 未授权	空

/api/v1/watch/nodes/{name}

表17. 全局路径参数
参数	类型	描述
`name`	`字符串`	Node的名称

HTTP方法: GET
描述: 监视Node类型对象的更改。已弃用：改用列表操作中的“watch”参数，并使用“fieldSelector”参数过滤为单个项目。

表18. HTTP响应
HTTP代码	响应体
200 - OK	`WatchEvent`模式
401 - 未授权	空

/api/v1/nodes/{name}/status

表19. 全局路径参数
参数	类型	描述
`name`	`字符串`	Node的名称

HTTP方法: GET
描述: 读取指定的Node的状态

表20. HTTP响应
HTTP代码	响应体
200 - OK	`Node`模式
401 - 未授权	空

HTTP方法: PATCH
描述: 部分更新指定的Node的状态

表21. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段
`fieldValidation`	`字符串`	fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是v1.23之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会持久化任何重复字段中的最后一个。这是v1.23+中的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，这将使用BadRequest错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表22. HTTP响应
HTTP代码	响应体
200 - OK	`Node`模式
201 - 已创建	`Node`模式
401 - 未授权	空

HTTP方法: PUT
描述: 替换指定的Node的状态

表23. 查询参数
参数	类型	描述
`dryRun`	`字符串`	如果存在，则表示不应持久化修改。无效或无法识别的dryRun指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有dry run阶段
`fieldValidation`	`字符串`	fieldValidation指示服务器如何处理请求(POST/PUT/PATCH)中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是v1.23之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会持久化任何重复字段中的最后一个。这是v1.23+中的默认值 - Strict：如果任何未知字段将从对象中删除，或者如果存在任何重复字段，这将使用BadRequest错误使请求失败。服务器返回的错误将包含遇到的所有未知和重复字段。

表24. 请求体参数
参数	类型	描述
`body`	`Node`模式

表25. HTTP响应
HTTP代码	响应体
200 - OK	`Node`模式
201 - 已创建	`Node`模式
401 - 未授权	空

节点 [v1]

规格

.spec

.spec.configSource

.spec.configSource.configMap

.spec.taints

.spec.taints[]

.status

.status.addresses

.status.addresses[]

.status.conditions

.status.conditions[]

.status.config

.status.config.active

.status.config.active.configMap

.status.config.assigned

.status.config.assigned.configMap

.status.config.lastKnownGood

.status.config.lastKnownGood.configMap

.status.daemonEndpoints

.status.daemonEndpoints.kubeletEndpoint

.status.images

.status.images[]

.status.nodeInfo

.status.runtimeHandlers

.status.runtimeHandlers[]

.status.runtimeHandlers[].features

.status.volumesAttached

.status.volumesAttached[]

API端点

/api/v1/nodes

/api/v1/watch/nodes

/api/v1/nodes/{name}

/api/v1/watch/nodes/{name}

/api/v1/nodes/{name}/status