红帽全球峰会16.2. Node [v1]
- 描述
- 节点是 Kubernetes 中的 worker 节点。每个节点在缓存中都有一个唯一标识符（例如在 etcd 中）。
- 类型
-
对象
16.2.1. 规格
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| APIVersion 定义对象的这个表示法的版本化的 schema。服务器应该将识别的模式转换为最新的内部值，并可拒绝未识别的值。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources |
|
|
| kind 是一个字符串值，代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds |
|
| 标准对象元数据。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| nodeSpec 描述了使用创建节点的属性。 |
|
|
| NodeStatus 是节点当前状态的信息。 |
16.2.1.1. .spec
- 描述
- nodeSpec 描述了使用创建节点的属性。
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| NodeConfigSource 指定节点配置的来源。只有一个子字段（不包括元数据）必须是 non-nil。此 API 从 1.22 开始已弃用 |
|
|
| 已弃用。并非所有 kubelet 将设置此字段。1.13 后删除字段，请参见： https://issues.k8s.io/61966 |
|
|
| PodCIDR 代表分配给节点的 pod IP 范围。 |
|
|
| podCIDRs 代表分配给节点的 IP 范围，供该节点上的 Pod 使用。如果指定了此字段，则 0th 条目必须与 podCIDR 字段匹配。它最多可为每个 IPv4 和 IPv6 包含 1 值。 |
|
|
| 云供应商分配的节点 ID，格式为： <ProviderName>://<ProviderSpecificNodeID> |
|
|
| 如果指定，节点的污点。 |
|
|
| 此污点的节点附加到不容许 Taint 的 pod 上具有 "effect" 的节点。 |
|
|
| 不可调度控制新 pod 的节点调度性。默认情况下，节点可以调度。更多信息： https://kubernetes.io/docs/concepts/nodes/node/#manual-node-administration |
16.2.1.2. .spec.configSource
- 描述
- NodeConfigSource 指定节点配置的来源。只有一个子字段（不包括元数据）必须是 non-nil。此 API 从 1.22 开始已弃用
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| ConfigMapNodeConfigSource 包含将 ConfigMap 引用为节点的配置源的信息。此 API 从 1.22 开始已弃用： https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration |
16.2.1.3. .spec.configSource.configMap
- 描述
- ConfigMapNodeConfigSource 包含将 ConfigMap 引用为节点的配置源的信息。此 API 从 1.22 开始已弃用： https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration
- 类型
-
对象 - 必填
-
namespace -
name -
kubeletConfigKey
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| KubeletConfigKey 声明引用 ConfigMap 的键对应于 KubeletConfiguration 结构，在所有情况下都需要此字段。 |
|
|
| name 是引用的 ConfigMap 的 metadata.name。所有情况下都需要此字段。 |
|
|
| namespace 是引用的 ConfigMap 的 metadata.namespace。所有情况下都需要此字段。 |
|
|
| resourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中被禁止，在 Node.Status 中是必需的。 |
|
|
| UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中被禁止，在 Node.Status 中是必需的。 |
16.2.1.4. .spec.taints
- 描述
- 如果指定，节点的污点。
- 类型
-
array
16.2.1.5. .spec.taints[]
- 描述
- 此污点的节点附加到不容许 Taint 的 pod 上具有 "effect" 的节点。
- 类型
-
对象 - 必填
-
key -
effect
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 必需。污点对不容许污点的 pod 的影响。有效效果为 NoSchedule、PreferNoSchedule 和 NoExecute。 |
|
|
| 必需。要应用到节点的污点键。 |
|
| TimeAdded 代表添加污点的时间。它只适用于 NoExecute 污点。 | |
|
|
| 与污点键对应的污点值。 |
16.2.1.6. .status
- 描述
- NodeStatus 是节点当前状态的信息。
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 节点可访问的地址列表。从云供应商查询（如果可用）。更多信息： https://kubernetes.io/docs/concepts/nodes/node/#addresses 注意：此字段声明为可合并，但合并密钥并不是唯一的，这可能会在合并时造成数据崩溃。调用者应使用全重替换补丁。例如，请参阅 http://pr.k8s.io/79391。 |
|
|
| NodeAddress 包含节点地址的信息。 |
|
| allocatable 代表可用于调度的节点的资源。默认为 Capacity。 | |
|
| Capacity 代表节点的总资源。更多信息： https://kubernetes.io/docs/concepts/storage/persistent-volumes#capacity | |
|
|
| 条件是当前观察到的节点条件的数组。更多信息： https://kubernetes.io/docs/concepts/nodes/node/#condition |
|
|
| NodeCondition 包含节点的条件信息。 |
|
|
| NodeConfigStatus 描述了 Node.Spec.ConfigSource 分配的配置状态。 |
|
|
| NodeDaemonEndpoints 列出由节点上运行的守护进程打开的端口。 |
|
|
| 此节点上的容器镜像列表 |
|
|
| 描述容器镜像 |
|
|
| NodeSystemInfo 是一组 ids/uuids，用于唯一标识节点。 |
|
|
| NodePhase 是节点最近观察到的生命周期阶段。更多信息： https://kubernetes.io/docs/concepts/nodes/node/#phase 字段永不填充，现在已弃用。 |
|
|
| 附加到节点的卷列表。 |
|
|
| AttachedVolume 描述了附加到节点的卷 |
|
|
| 节点使用的可附加卷列表（挂载）。 |
16.2.1.7. .status.addresses
- 描述
- 节点可访问的地址列表。从云供应商查询（如果可用）。更多信息： https://kubernetes.io/docs/concepts/nodes/node/#addresses 注意：此字段声明为可合并，但合并密钥并不是唯一的，这可能会在合并时造成数据崩溃。调用者应使用全重替换补丁。例如，请参阅 http://pr.k8s.io/79391。
- 类型
-
array
16.2.1.8. .status.addresses[]
- 描述
- NodeAddress 包含节点地址的信息。
- 类型
-
对象 - 必填
-
type -
address
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 节点地址。 |
|
|
| 节点数类型、主机名、ExternalIP 或 InternalIP 之一。 |
16.2.1.9. .status.conditions
- 描述
- 条件是当前观察到的节点条件的数组。更多信息： https://kubernetes.io/docs/concepts/nodes/node/#condition
- 类型
-
array
16.2.1.10. .status.conditions[]
- 描述
- NodeCondition 包含节点的条件信息。
- 类型
-
对象 - 必填
-
type -
status
-
16.2.1.11. .status.config
- 描述
- NodeConfigStatus 描述了 Node.Spec.ConfigSource 分配的配置状态。
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| NodeConfigSource 指定节点配置的来源。只有一个子字段（不包括元数据）必须是 non-nil。此 API 从 1.22 开始已弃用 |
|
|
| NodeConfigSource 指定节点配置的来源。只有一个子字段（不包括元数据）必须是 non-nil。此 API 从 1.22 开始已弃用 |
|
|
| Error 描述了将 Spec.ConfigSource 协调到 Active 配置的问题。可能会出现错误，例如，尝试将 Spec.ConfigSource 检查点到本地分配记录，尝试检查点与 Spec.ConfigSource 关联的有效负载，尝试加载或验证分配配置等。同步配置时在不同点上可能会出现错误。之前的错误（如下载或检查点错误）不会导致回滚到 LastKnownGood，并可能会在 Kubelet 重试之间解决。后续错误（例如加载或验证检查点的配置）将导致回滚到 LastKnownGood。在后者的情况下，通常可以通过修复 Spec.ConfigSource 中分配的配置来解决错误。您可以通过在 Kubelet 日志中搜索错误消息来查找用于调试的额外信息。error 是错误状态的人类可读描述；机器可以检查 Error 是否为空，但不应依赖于 Kubelet 版本之间的 Error 文本的稳定性。 |
|
|
| NodeConfigSource 指定节点配置的来源。只有一个子字段（不包括元数据）必须是 non-nil。此 API 从 1.22 开始已弃用 |
16.2.1.12. .status.config.active
- 描述
- NodeConfigSource 指定节点配置的来源。只有一个子字段（不包括元数据）必须是 non-nil。此 API 从 1.22 开始已弃用
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| ConfigMapNodeConfigSource 包含将 ConfigMap 引用为节点的配置源的信息。此 API 从 1.22 开始已弃用： https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration |
16.2.1.13. .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 声明引用 ConfigMap 的键对应于 KubeletConfiguration 结构，在所有情况下都需要此字段。 |
|
|
| name 是引用的 ConfigMap 的 metadata.name。所有情况下都需要此字段。 |
|
|
| namespace 是引用的 ConfigMap 的 metadata.namespace。所有情况下都需要此字段。 |
|
|
| resourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中被禁止，在 Node.Status 中是必需的。 |
|
|
| UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中被禁止，在 Node.Status 中是必需的。 |
16.2.1.14. .status.config.assigned
- 描述
- NodeConfigSource 指定节点配置的来源。只有一个子字段（不包括元数据）必须是 non-nil。此 API 从 1.22 开始已弃用
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| ConfigMapNodeConfigSource 包含将 ConfigMap 引用为节点的配置源的信息。此 API 从 1.22 开始已弃用： https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration |
16.2.1.15. .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 声明引用 ConfigMap 的键对应于 KubeletConfiguration 结构，在所有情况下都需要此字段。 |
|
|
| name 是引用的 ConfigMap 的 metadata.name。所有情况下都需要此字段。 |
|
|
| namespace 是引用的 ConfigMap 的 metadata.namespace。所有情况下都需要此字段。 |
|
|
| resourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中被禁止，在 Node.Status 中是必需的。 |
|
|
| UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中被禁止，在 Node.Status 中是必需的。 |
16.2.1.16. .status.config.lastKnownGood
- 描述
- NodeConfigSource 指定节点配置的来源。只有一个子字段（不包括元数据）必须是 non-nil。此 API 从 1.22 开始已弃用
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| ConfigMapNodeConfigSource 包含将 ConfigMap 引用为节点的配置源的信息。此 API 从 1.22 开始已弃用： https://git.k8s.io/enhancements/keps/sig-node/281-dynamic-kubelet-configuration |
16.2.1.17. .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 声明引用 ConfigMap 的键对应于 KubeletConfiguration 结构，在所有情况下都需要此字段。 |
|
|
| name 是引用的 ConfigMap 的 metadata.name。所有情况下都需要此字段。 |
|
|
| namespace 是引用的 ConfigMap 的 metadata.namespace。所有情况下都需要此字段。 |
|
|
| resourceVersion 是引用的 ConfigMap 的 metadata.ResourceVersion。此字段在 Node.Spec 中被禁止，在 Node.Status 中是必需的。 |
|
|
| UID 是引用的 ConfigMap 的 metadata.UID。此字段在 Node.Spec 中被禁止，在 Node.Status 中是必需的。 |
16.2.1.18. .status.daemonEndpoints
- 描述
- NodeDaemonEndpoints 列出由节点上运行的守护进程打开的端口。
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| DaemonEndpoint 包含有关单个守护进程端点的信息。 |
16.2.1.19. .status.daemonEndpoints.kubeletEndpoint
- 描述
- DaemonEndpoint 包含有关单个守护进程端点的信息。
- 类型
-
对象 - 必填
-
端口
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 给定端点的端口号。 |
16.2.1.20. .status.images
- 描述
- 此节点上的容器镜像列表
- 类型
-
array
16.2.1.21. .status.images[]
- 描述
- 描述容器镜像
- 类型
-
对象
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 已知此镜像的名称。例如 ["k8s.gcr.io/hyperkube:v1.0.7", "dockerhub.io/google_containers/hyperkube:v1.0.7"] |
|
|
| 镜像的大小（以字节为单位）。 |
16.2.1.22. .status.nodeInfo
- 描述
- NodeSystemInfo 是一组 ids/uuids，用于唯一标识节点。
- 类型
-
对象 - 必填
-
machineID -
systemUUID -
bootID -
kernelVersion -
osImage -
containerRuntimeVersion -
kubeletVersion -
kubeProxyVersion -
operatingSystem -
架构
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| 节点报告的构架 |
|
|
| 节点报告的引导 ID。 |
|
|
| 节点通过运行时远程 API 报告的 containerruntime 版本（如 docker://1.5.0）。 |
|
|
| 节点从 'uname -r' 报告的内核版本（如 3.16.0-0.bpo.4-amd64）。 |
|
|
| 节点报告的 kubeProxy 版本。 |
|
|
| 节点报告的 kubelet 版本。 |
|
|
| 节点报告的 MachineID。对于集群中的唯一机器标识，这是首选的。从 man (5) machine-id 了解更多信息： http://man7.org/linux/man-pages/man5/machine-id.5.html |
|
|
| 节点报告的操作系统 |
|
|
| 节点从 /etc/os-release 报告的操作系统镜像（如 Debian GNU/Linux 7 (wheezy)）。 |
|
|
| 节点报告的 SystemUUID。对于唯一机器标识 MachineID，这是首选的。此字段特定于红帽主机 https://access.redhat.com/documentation/zh-cn/red_hat_subscription_management/1/html/rhsm/uuid |
16.2.1.23. .status.volumesAttached
- 描述
- 附加到节点的卷列表。
- 类型
-
array
16.2.1.24. .status.volumesAttached[]
- 描述
- AttachedVolume 描述了附加到节点的卷
- 类型
-
对象 - 必填
-
name -
devicePath
-
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| DevicePath 代表卷应该可用的设备路径 |
|
|
| 附加卷的名称 |
16.2.2. API 端点
可用的 API 端点如下：
/api/v1/nodes-
DELETE：删除节点的集合 -
GET：列出或监视类型为 Node 的对象 -
POST：创建节点
-
/api/v1/watch/nodes-
GET: 观察对 Node 列表的各个更改。已弃用：改为使用 'watch' 参数和列表操作。
-
/api/v1/nodes/{name}-
DELETE：删除节点 -
GET：读取指定的节点 -
PATCH：部分更新指定节点 -
PUT：替换指定的节点
-
/api/v1/watch/nodes/{name}-
GET: 观察对类型为 Node 的对象的更改。已弃用：使用带有列表操作的 'watch' 参数，而是过滤到带有 'fieldSelector' 参数的单个项目。
-
/api/v1/nodes/{name}/status-
GET：指定节点的读取状态 -
PATCH：部分更新指定节点的状态 -
PUT: 替换指定节点的状态
-
16.2.2.1. /api/v1/nodes
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果 'true'，则输出被用户友善。 |
- HTTP 方法
-
DELETE - 描述
- 删除节点集合
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。 当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。 |
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。 |
|
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。 |
|
|
| 弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。 |
|
|
| 是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
| list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
GET - 描述
- 列出或监视类型为节点的对象
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。 当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。 |
|
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
| list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。 |
|
|
| 观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
POST - 描述
- 创建节点
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
16.2.2.2. /api/v1/watch/nodes
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。 当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。 |
|
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。 |
|
|
| 如果 'true'，则输出被用户友善。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
| list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。 |
|
|
| 观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET - 描述
- 观察对 Node 列表的各个更改。已弃用：改为使用 'watch' 参数以及 list 操作。
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
16.2.2.3. /api/v1/nodes/{name}
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 节点的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果 'true'，则输出被用户友善。 |
- HTTP 方法
-
DELETE - 描述
- 删除节点
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| 应该删除对象前的持续时间（以秒为单位）。值必须是非负整数。值零表示立即删除。如果这个值是 nil，则使用指定类型的默认宽限期。如果没有指定，则默认为每个对象值。零表示立即删除。 |
|
|
| 弃用：请使用 PropagationPolicy，此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false，"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy，但不能同时设置两者。 |
|
|
| 是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置，但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为： 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系； 'Foreground' - 一个删除前台所有依赖的级联策略。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
- HTTP 方法
-
GET - 描述
- 读取指定节点
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 部分更新指定节点
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。 |
|
|
| 强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
- HTTP 方法
-
PUT - 描述
- 替换指定的节点
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
16.2.2.4. /api/v1/watch/nodes/{name}
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 节点的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签，由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回，也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视，则忽略此字段。 |
|
|
| 从服务器检索更多结果时，应设置 continue 选项。由于这个值是定义的服务器，因此客户端只能使用之前查询结果中的 continue 值，并带有相同的查询参数（除 continue 值除外），因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效，无论是因为过期时间（通常为 5 到十五分钟）还是服务器上的配置更改，服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表，它必须在没有 continue 字段的情况下重启其列表。否则，客户端可能会发送另一个列表请求，并带有 410 错误收到的令牌，服务器将通过从下一个密钥开始的列表进行响应，但从最新的快照（从最后一个列表结果中不一致） - 在第一个列表请求后创建、修改或删除的对象将包含在响应中，只要其密钥在"next key"后。 当 watch 为 true 时，不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视，而不丢失任何修改。 |
|
|
| 用于限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 通过标签限制返回的对象列表的选择器。默认为任何内容。 |
|
|
| 限制是列表调用要返回的最大响应数。如果存在更多项目，服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值，以检索下一个结果集。在过滤所有请求的对象时，设置限制可能会返回比请求的项目数量少（最多为零项），客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数，并将返回所有可用的结果。如果指定了限制，并且 continue 字段为空，客户端可能会假设没有更多可用的结果。如果 watch 为 true，则不支持此字段。 服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说，在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照，并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象，则返回第一次列表结果时存在的对象版本。 |
|
|
| 如果 'true'，则输出被用户友善。 |
|
|
| resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions 默认为未设置 |
|
|
| resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions。 默认为未设置 |
|
|
| list/watch 调用的超时。这限制了调用的时间，无论任何活动或不活跃。 |
|
|
| 观察对描述的资源的更改，并将其作为添加、更新和删除通知流返回。指定 resourceVersion。 |
- HTTP 方法
-
GET - 描述
- 观察对类型为 Node 的对象的更改。已弃用：使用带有列表操作的 'watch' 参数，而是过滤到带有 'fieldSelector' 参数的单个项目。
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
16.2.2.5. /api/v1/nodes/{name}/status
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 节点的名称 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 如果 'true'，则输出被用户友善。 |
- HTTP 方法
-
GET - 描述
- 指定节点的读取状态
| HTTP 代码 | 响应正文 |
|---|---|
| 200 - OK |
|
| 401 - Unauthorized | 空 |
- HTTP 方法
-
PATCH - 描述
- 指定节点的部分更新状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。应用请求(application/apply-patch)需要此字段，但对于非应用补丁类型(JsonPatch、MergePatch、OptMergePatch)是可选的。 |
|
|
| 强制将"强制"应用请求。这意味着用户会重新清空由其他人员拥有的冲突字段。对于非应用补丁请求，必须取消设置 force 标志。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
- HTTP 方法
-
PUT - 描述
- 替换指定节点的状态
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
| 出现时，表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应，且请求不会被进一步处理。有效值为： - All: 所有预演阶段都将被处理 |
|
|
| fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长，且仅包含可打印的字符，如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。 |
| 参数 | 类型 | 描述 |
|---|---|---|
|
|
|
'%20d='M201.5%20305.5c-13.8%200-24.9-11.1-24.9-24.6%200-13.8%2011.1-24.9%2024.9-24.9%2013.6%200%2024.6%2011.1%2024.6%2024.9%200%2013.6-11.1%2024.6-24.6%2024.6zM504%20256c0%20137-111%20248-248%20248S8%20393%208%20256%20119%208%20256%208s248%20111%20248%20248zm-132.3-41.2c-9.4%200-17.7%203.9-23.8%2010-22.4-15.5-52.6-25.5-86.1-26.6l17.4-78.3%2055.4%2012.5c0%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.3%2024.9-24.9s-11.1-24.9-24.9-24.9c-9.7%200-18%205.8-22.1%2013.8l-61.2-13.6c-3-.8-6.1%201.4-6.9%204.4l-19.1%2086.4c-33.2%201.4-63.1%2011.3-85.5%2026.8-6.1-6.4-14.7-10.2-24.1-10.2-34.9%200-46.3%2046.9-14.4%2062.8-1.1%205-1.7%2010.2-1.7%2015.5%200%2052.6%2059.2%2095.2%20132%2095.2%2073.1%200%20132.3-42.6%20132.3-95.2%200-5.3-.6-10.8-1.9-15.8%2031.3-16%2019.8-62.5-14.9-62.5zM302.8%20331c-18.2%2018.2-76.1%2017.9-93.6%200-2.2-2.2-6.1-2.2-8.3%200-2.5%202.5-2.5%206.4%200%208.6%2022.8%2022.8%2087.3%2022.8%20110.2%200%202.5-2.2%202.5-6.1%200-8.6-2.2-2.2-6.1-2.2-8.3%200zm7.7-75c-13.6%200-24.6%2011.1-24.6%2024.9%200%2013.6%2011.1%2024.6%2024.6%2024.6%2013.8%200%2024.9-11.1%2024.9-24.6%200-13.8-11-24.9-24.9-24.9z'/%3e%3c/svg%3e){kind=small}