MachineSet [machine.openshift.io/v1beta1]

deletePolicy

字符串

DeletePolicy定义缩容时用于识别要删除的节点的策略。默认为“Random”。有效值为“Random”、“Newest”、“Oldest”

minReadySeconds

整数

MinReadySeconds是新创建的机器应处于就绪状态的最小秒数。默认为0（机器一旦就绪即可视为可用）

replicas

整数

Replicas是所需副本的数量。这是一个指针，用于区分显式零和未指定。默认为1。

selector

对象

Selector是对应匹配副本数量的机器的标签查询。为了被此MachineSet控制，必须匹配的标签键和值。它必须与机器模板的标签匹配。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/labels/#label-selectors

template

对象

Template是描述如果检测到副本不足将创建的机器的对象。

matchExpressions

数组

matchExpressions是标签选择器需求的列表。这些需求是ANDed。

matchExpressions[]

对象

标签选择器需求是一个包含值、键和将键和值关联起来的操作符的选择器。

matchLabels

对象（字符串）

matchLabels是{key,value}对的映射。matchLabels映射中的单个{key,value}等效于matchExpressions的一个元素，其key字段为“key”，操作符为“In”，而values数组仅包含“value”。这些需求是ANDed。

key

字符串

key是选择器应用到的标签键。

operator

字符串

operator表示键与一组值的关系。有效操作符为In、NotIn、Exists和DoesNotExist。

values

数组（字符串）

values是一个字符串值的数组。如果操作符是In或NotIn，则values数组必须是非空的。如果操作符是Exists或DoesNotExist，则values数组必须为空。此数组在策略性合并补丁期间被替换。

metadata

对象

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

spec

对象

机器所需行为的规范。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status

annotations

对象（字符串）

Annotations是一个与资源一起存储的非结构化键值对映射，外部工具可以使用它来存储和检索任意元数据。它们不可查询，并且在修改对象时应予以保留。更多信息：https://kubernetes.ac.cn/docs/user-guide/annotations

generateName

字符串

GenerateName是一个可选的前缀，服务器使用它来生成唯一名称，**仅当**未提供Name字段时才使用。如果使用此字段，则返回给客户端的名称将与传入的名称不同。此值还将与一个唯一的后缀组合。提供的值具有与Name字段相同的验证规则，并且可能会根据使值在服务器上唯一所需的尾缀长度而被截断。如果指定此字段并且生成的名称已存在，则服务器**不会**返回409 - 相反，它将返回201 Created或500，并带有Reason ServerTimeout，指示在分配的时间内找不到唯一的名称，客户端应重试（可选地在Retry-After标头中指示的时间之后）。仅在未指定Name时应用。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

labels

对象（字符串）

字符串键值对的映射，可用于组织和分类（范围和选择）对象。可能与复制控制器和服务的选取器匹配。更多信息：https://kubernetes.ac.cn/docs/user-guide/labels

name

字符串

Name在命名空间内必须唯一。创建资源时是必需的，尽管某些资源可能允许客户端请求自动生成合适的名称。Name主要用于创建幂等性和配置定义。不能更新。更多信息：https://kubernetes.ac.cn/docs/user-guide/identifiers#names

namespace

字符串

Namespace定义了每个名称必须唯一的空间。空命名空间等效于“default”命名空间，“default”是规范表示。并非所有对象都需要限定到命名空间 - 这些对象的此字段的值将为空。必须是DNS_LABEL。不能更新。更多信息：https://kubernetes.ac.cn/docs/user-guide/namespaces

ownerReferences

数组

此对象所依赖的对象列表。如果列表中的所有对象都被删除，则此对象将被垃圾收集。如果此对象由控制器管理，则此列表中的一个条目将指向此控制器，并将controller字段设置为true。不能有多于一个管理控制器。

ownerReferences[]

对象

OwnerReference包含足够的信息，让您可以识别拥有对象。拥有对象必须与被依赖对象位于相同的命名空间中，或者必须是集群范围的，因此没有命名空间字段。

apiVersion

字符串

引用的API版本。

blockOwnerDeletion

boolean

如果为true，并且所有者具有“foregroundDeletion”终结器，则在删除此引用之前，无法从键值存储中删除所有者。有关垃圾收集器如何与此字段交互并强制执行前台删除，请参见https://kubernetes.ac.cn/docs/concepts/architecture/garbage-collection/#foreground-deletion。默认为false。要设置此字段，用户需要所有者的“delete”权限，否则将返回422（不可处理的实体）。

controller

boolean

如果为true，则此引用指向管理控制器。

kind

字符串

引用的Kind。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的Name。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names#names

uid

字符串

引用的UID。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names#uids

lifecycleHooks

对象

LifecycleHooks允许用户在机器生命周期的某些预定义点暂停机器上的操作。

metadata

对象

ObjectMeta将自动填充创建的节点。使用它来指示在创建节点时应使用哪些标签、注释、名称前缀等。

providerID

字符串

ProviderID是由提供者提供的机器的标识ID。此字段必须与在对应于此机器的节点对象上看到的提供者ID匹配。此字段由集群API的高级使用者需要。例如，使用集群API作为提供者的集群自动缩放器。自动缩放器中的清理逻辑比较机器和节点以找出无法注册为Kubernetes节点的提供者处的机器。使用集群API作为自动缩放器的通用树外提供者，自动缩放器需要此字段才能拥有机器列表的提供者视图。从k8s apiserver查询节点的另一个列表，然后进行比较以找出未注册的机器并将其标记为删除。此字段将由执行器设置，并由诸如将与集群API作为通用提供者交互的自动缩放器之类的更高级别的实体使用。

providerSpec

对象

ProviderSpec详细说明了在节点创建期间使用的特定于提供程序的配置。

taints

数组

将以累加方式应用于相应节点的污点的列表。此列表不会覆盖其他实体持续添加到节点的任何其他污点。这些污点应该积极协调（例如，如果您要求机器控制器应用污点，然后手动删除污点，机器控制器会将其放回），但不让机器控制器删除任何污点。

taints[]

对象

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

preDrain

数组

PreDrain钩子阻止机器被排空。这也阻止了进一步的生命周期事件，例如终止。

preDrain[]

对象

LifecycleHook表示生命周期钩子的单个实例。

preTerminate

数组

PreTerminate钩子阻止机器被终止。PreTerminate钩子在机器被排空后执行。

preTerminate[]

对象

LifecycleHook表示生命周期钩子的单个实例。

name

字符串

名称定义了生命周期钩子的唯一名称。名称应唯一且具有描述性，理想情况下为 1-3 个单词，使用驼峰式命名法，或者可以使用命名空间，例如 foo.example.com/CamelCase。名称必须唯一，并且只能由单个实体管理。

owner

字符串

Owner 定义生命周期钩子的所有者。这应该具有足够的描述性，以便用户可以识别谁/什么负责阻止生命周期。这可以是控制器的名称（例如 clusteroperator/etcd）或管理钩子的管理员。

name

字符串

名称定义了生命周期钩子的唯一名称。名称应唯一且具有描述性，理想情况下为 1-3 个单词，使用驼峰式命名法，或者可以使用命名空间，例如 foo.example.com/CamelCase。名称必须唯一，并且只能由单个实体管理。

owner

字符串

Owner 定义生命周期钩子的所有者。这应该具有足够的描述性，以便用户可以识别谁/什么负责阻止生命周期。这可以是控制器的名称（例如 clusteroperator/etcd）或管理钩子的管理员。

annotations

对象（字符串）

Annotations是一个与资源一起存储的非结构化键值对映射，外部工具可以使用它来存储和检索任意元数据。它们不可查询，并且在修改对象时应予以保留。更多信息：https://kubernetes.ac.cn/docs/user-guide/annotations

generateName

字符串

GenerateName是一个可选的前缀，服务器使用它来生成唯一名称，**仅当**未提供Name字段时才使用。如果使用此字段，则返回给客户端的名称将与传入的名称不同。此值还将与一个唯一的后缀组合。提供的值具有与Name字段相同的验证规则，并且可能会根据使值在服务器上唯一所需的尾缀长度而被截断。如果指定此字段并且生成的名称已存在，则服务器**不会**返回409 - 相反，它将返回201 Created或500，并带有Reason ServerTimeout，指示在分配的时间内找不到唯一的名称，客户端应重试（可选地在Retry-After标头中指示的时间之后）。仅在未指定Name时应用。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

labels

对象（字符串）

字符串键值对的映射，可用于组织和分类（范围和选择）对象。可能与复制控制器和服务的选取器匹配。更多信息：https://kubernetes.ac.cn/docs/user-guide/labels

name

字符串

Name在命名空间内必须唯一。创建资源时是必需的，尽管某些资源可能允许客户端请求自动生成合适的名称。Name主要用于创建幂等性和配置定义。不能更新。更多信息：https://kubernetes.ac.cn/docs/user-guide/identifiers#names

namespace

字符串

Namespace定义了每个名称必须唯一的空间。空命名空间等效于“default”命名空间，“default”是规范表示。并非所有对象都需要限定到命名空间 - 这些对象的此字段的值将为空。必须是DNS_LABEL。不能更新。更多信息：https://kubernetes.ac.cn/docs/user-guide/namespaces

ownerReferences

数组

此对象所依赖的对象列表。如果列表中的所有对象都被删除，则此对象将被垃圾收集。如果此对象由控制器管理，则此列表中的一个条目将指向此控制器，并将controller字段设置为true。不能有多于一个管理控制器。

ownerReferences[]

对象

OwnerReference包含足够的信息，让您可以识别拥有对象。拥有对象必须与被依赖对象位于相同的命名空间中，或者必须是集群范围的，因此没有命名空间字段。

apiVersion

字符串

引用的API版本。

blockOwnerDeletion

boolean

如果为true，并且所有者具有“foregroundDeletion”终结器，则在删除此引用之前，无法从键值存储中删除所有者。有关垃圾收集器如何与此字段交互并强制执行前台删除，请参见https://kubernetes.ac.cn/docs/concepts/architecture/garbage-collection/#foreground-deletion。默认为false。要设置此字段，用户需要所有者的“delete”权限，否则将返回422（不可处理的实体）。

controller

boolean

如果为true，则此引用指向管理控制器。

kind

字符串

引用的Kind。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

name

字符串

引用的Name。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names#names

uid

字符串

引用的UID。更多信息：https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names#uids

value

``

Value 是资源配置的内联序列化表示。建议提供者维护他们自己的版本化 API 类型，这些类型应该从此字段序列化/反序列化，类似于组件配置。

effect

字符串

必填。对不耐受污点的 Pod 的污点影响。有效的 effect 为 NoSchedule、PreferNoSchedule 和 NoExecute。

key

字符串

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

timeAdded

字符串

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

value

字符串

与污点键对应的污点值。

availableReplicas

整数

此 MachineSet 可用副本（至少准备 minReadySeconds）的数量。

conditions

数组

Conditions 定义 MachineSet 的当前状态

conditions[]

对象

Condition 定义对 Machine API 资源操作状态的观察。

errorMessage

字符串

errorReason

字符串

如果在协调副本时出现终端问题，则会设置 ErrorReason 和 ErrorMessage。ErrorReason 将填充一个简洁的值，适合机器解释，而 ErrorMessage 将包含一个更详细的字符串，适合日志记录和人工查看。这些字段不应设置为控制器面临的预期会随着时间推移自动修复的瞬态错误（例如服务中断），而应指示 MachineTemplate 的规范或机器控制器配置存在根本性错误，并且需要人工干预。终端错误的示例包括规范中设置的无效组合、机器控制器不支持的值或负责的机器控制器本身严重配置错误。在协调机器期间发生的任何瞬态错误都可以作为事件添加到 MachineSet 对象和/或记录在控制器的输出中。

fullyLabeledReplicas

整数

具有与 MachineSet 的机器模板标签匹配的标签的副本数量。

observedGeneration

整数

ObservedGeneration 反映最近观察到的 MachineSet 的 generation。

readyReplicas

整数

此 MachineSet 的就绪副本数。当节点已创建并处于“就绪”状态时，机器被认为已就绪。

replicas

整数

Replicas 是最近观察到的副本数。

lastTransitionTime

字符串

条件从一种状态转换到另一种状态的最后时间。这应该是底层条件发生变化的时间。如果不知道，则可以使用 API 字段更改的时间。

message

字符串

指示有关转换详细信息的人类可读消息。此字段可能为空。

reason

字符串

条件上次转换的驼峰式原因。特定 API 可以选择是否将此字段视为保证的 API。此字段不能为空。

severity

字符串

Severity 提供 Reason 代码的明确分类，因此用户或机器可以立即理解当前情况并采取相应措施。只有在 Status=False 时才必须设置 Severity 字段。

status

字符串

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

type

字符串

条件的类型，驼峰式命名法或 foo.example.com/CamelCase。许多 .condition.type 值在资源中是一致的，如 Available，但由于任意条件可能很有用（参见 .node.status.conditions），因此消除冲突的能力很重要。

200 - OK

MachineSetList 模式

401 - 未授权

空

200 - OK

Status 模式

401 - 未授权

空

200 - OK

MachineSetList 模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为从对象中删除的每个未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

body

MachineSet 模式

200 - OK

MachineSet 模式

201 - 已创建

MachineSet 模式

202 - 已接受

MachineSet 模式

401 - 未授权

空

name

字符串

机器集名称

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

200 - OK

Status 模式

202 - 已接受

Status 模式

401 - 未授权

空

200 - OK

MachineSet 模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为从对象中删除的每个未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

200 - OK

MachineSet 模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为从对象中删除的每个未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

body

MachineSet 模式

200 - OK

MachineSet 模式

201 - 已创建

MachineSet 模式

401 - 未授权

空

name

字符串

机器集名称

200 - OK

Scale 模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为从对象中删除的每个未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

200 - OK

Scale 模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为从对象中删除的每个未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

body

Scale 模式

200 - OK

Scale 模式

201 - 已创建

Scale 模式

401 - 未授权

空

name

字符串

机器集名称

200 - OK

MachineSet 模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为从对象中删除的每个未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

200 - OK

MachineSet 模式

401 - 未授权

空

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略从对象中静默删除的任何未知字段，并将忽略解码器遇到的最后一个重复字段以外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为从对象中删除的每个未知字段以及遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍然会成功，并且只会持久化任何重复字段中的最后一个。这是 v1.23+ 中的默认值 - Strict：如果从对象中删除任何未知字段，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。

body

MachineSet 模式

200 - OK

MachineSet 模式

201 - 已创建

MachineSet 模式

401 - 未授权

空