12.9. MachineSet [machine.openshift.io/v1beta1]


描述
MachineSet 确保指定的机器副本在任何给定时间都在运行。
类型
对象

12.9.1. 规格

Expand
属性类型描述

apiVersion

字符串

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

kind

字符串

kind 是一个字符串值,代表此对象所代表的 REST 资源。服务器可以从客户端向其提交请求的端点推断。无法更新。采用驼峰拼写法 (CamelCase)。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta_v2

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

spec

对象

MachineSetSpec 定义 MachineSet 的所需状态

status

对象

MachineSetStatus 定义 MachineSet 的观察状态

12.9.1.1. .spec

描述
MachineSetSpec 定义 MachineSet 的所需状态
类型
对象
必填
  • selector
Expand
属性类型描述

deletePolicy

字符串

DeletePolicy 定义用于识别在缩减时要删除的节点的策略。默认为 "Random"。有效值为 "Random, "Newest", "Oldest"

minReadySeconds

整数

MinReadySeconds 是新创建的机器应就绪的最小秒数。默认值为 0 (计算机在就绪后立即可用)

replicas

整数

replicas 是所需副本数。这是一个指针来区分显式零和未指定。默认值为 1。

selector

对象

选择器是机器的标签查询,它应该与副本数匹配。标签键和值必须匹配,才能由此 MachineSet 控制。它必须与机器模板的标签匹配。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors

模板

对象

模板是描述在检测到副本不足时要创建的机器的对象。

12.9.1.2. .spec.selector

描述
选择器是机器的标签查询,它应该与副本数匹配。标签键和值必须匹配,才能由此 MachineSet 控制。它必须与机器模板的标签匹配。更多信息: https://kubernetes.io/docs/concepts/overview/working-with-objects/labels/#label-selectors
类型
对象
Expand
属性类型描述

matchExpressions

array

matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。

matchExpressions[]

对象

标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。

matchLabels

对象(字符串)

matchLabels 是 {key,value} 对的映射。MatchLabels 映射中的单个 {key,value} 等同于 matchExpressions 的一个元素,其 key 字段是 "key",运算符是 "In",值数组仅包含 "value"。要求的逻辑关系是 AND。

12.9.1.3. .spec.selector.matchExpressions

描述
matchExpressions 是标签选择器要求列表。要求的逻辑关系是 AND。
类型
array

12.9.1.4. .spec.selector.matchExpressions[]

描述
标签选择器要求是一个选择器,其中包含与键和值相关的值、键和值。
类型
对象
必填
  • key
  • operator
Expand
属性类型描述

key

字符串

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

operator

字符串

运算符代表一个键与一组值的关系。有效的运算符是 In、NotIn、Exists 和 DoesNotExist。

数组(字符串)

值是字符串值的数组。如果运算符是 In 或 NotIn,则值数组必须是非空的。如果运算符是 Exists 或 DoesNotExist,则值数组必须为空。这个数组会在策略性合并补丁中被替换。

12.9.1.5. .spec.template

描述
模板是描述在检测到副本不足时要创建的机器的对象。
类型
对象
Expand
属性类型描述

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

12.9.1.6. .spec.template.metadata

描述
标准对象元数据。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
类型
对象
Expand
属性类型描述

annotations

对象(字符串)

注解是一个无结构的键值映射,与资源存储,可通过外部工具设置来存储和检索任意元数据。它们不可查询,应在修改对象时保留。更多信息: http://kubernetes.io/docs/user-guide/annotations

generateName

字符串

generateName 是一个可选前缀,服务器使用,用于生成唯一名称,只提供 Name 字段。如果使用此字段,则返回到客户端的名称将与传递的名称不同。这个值也会与唯一的后缀结合使用。提供的值与 Name 字段具有相同的验证规则,并可能根据在服务器中使值的唯一后缀的长度截断。如果指定了此字段,且存在生成的名称,服务器将不会返回 409 - 相反,它将返回 201 Created 或 500,表示一个唯一名称无法在分配的时间内找到,客户端应重试(可选)仅在没有指定 Name 时才应用。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

labels

对象(字符串)

可用于组织和分类(范围和选择)对象的字符串键和值映射。可能与复制控制器和服务选择器匹配。更多信息: http://kubernetes.io/docs/user-guide/labels

name

字符串

名称在命名空间中必须是唯一的。在创建资源时是必需的,但有些资源可能允许客户端自动请求生成适当名称。名称主要用于创建 idempotence 和配置定义。无法更新。更多信息: http://kubernetes.io/docs/user-guide/identifiers#names

namespace

字符串

命名空间定义每个名称中的空间必须是唯一的。空命名空间等同于 "default" 命名空间,但 "default" 是规范表示。不是所有对象都需要限定到命名空间 - 这些对象的此字段值为空。必须是 DNS_LABEL。无法更新。更多信息: http://kubernetes.io/docs/user-guide/namespaces

ownerReferences

array

由此对象依赖的对象列表。如果列表中删除列表中的 ALL 对象,则会收集此对象。如果此对象由控制器管理,则此列表中的条目将指向此控制器,并将 controller 字段设置为 true。不能有多个管理控制器。

ownerReferences[]

对象

OwnerReference 包含足够信息,供您识别自己的对象。拥有的对象必须与依赖项处于相同命名空间中,或是集群范围的,因此没有命名空间字段。

12.9.1.7. .spec.template.metadata.ownerReferences

描述
由此对象依赖的对象列表。如果列表中删除列表中的 ALL 对象,则会收集此对象。如果此对象由控制器管理,则此列表中的条目将指向此控制器,并将 controller 字段设置为 true。不能有多个管理控制器。
类型
array

12.9.1.8. .spec.template.metadata.ownerReferences[]

描述
OwnerReference 包含足够信息,供您识别自己的对象。拥有的对象必须与依赖项处于相同命名空间中,或是集群范围的,因此没有命名空间字段。
类型
对象
必填
  • apiVersion
  • kind
  • name
  • uid
Expand
属性类型描述

apiVersion

字符串

引用的 API 版本。

blockOwnerDeletion

布尔值

如果为 true,如果所有者有"foregroundDeletion"终结器,则无法从键值存储中删除所有者,直到删除了此引用。默认为false。要设置此字段,用户需要"删除"所有者的权限,否则将返回 422 (不可处理实体)。

controller

布尔值

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

kind

字符串

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

name

字符串

引用的名称。更多信息: http://kubernetes.io/docs/user-guide/identifiers#names

uid

字符串

引用的 UID。更多信息: http://kubernetes.io/docs/user-guide/identifiers#uids

12.9.1.9. .spec.template.spec

描述
机器所需行为的规格。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
类型
对象
Expand
属性类型描述

metadata

对象

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

providerID

字符串

providerID 是供应商提供的机器的标识 ID。此字段必须与与这个机器对应的节点对象中看到的供应商 ID 匹配。cluster-api 的更高级别消费者需要此字段。用例示例是集群自动扩展,并将 cluster-api 作为 provider。自动缩放器中的清理逻辑将机器与节点进行比较,以查找供应商上无法注册为 Kubernetes 节点的机器。使用 cluster-api 作为自动扩展的通用树外供应商,自动扩展需要此字段才能使用机器列表的供应商视图。从 k8s apiserver 查询另一个节点列表,然后进行一个比较来查找未注册的机器并标记为删除。此字段将由操作者设置,并由像自动扩展等更高级别的实体使用,这些实体将与 cluster-api 作为通用提供程序进行交流。

providerSpec

对象

ProviderSpec 详情要在节点创建过程中使用的供应商特定配置。

污点(taint)

array

要以附加方式应用到相应节点的污点列表。此列表不会覆盖会持续由其他实体添加到节点的任何其他污点。这些污点应主动协调,例如,如果您要求机器控制器应用污点,然后手动删除机器控制器将返回污点,但没有删除机器控制器移除任何污点

taints[]

对象

此污点的节点附加到不容许 Taint 的 pod 上具有 "effect" 的节点。

12.9.1.10. .spec.template.spec.metadata

描述
ObjectMeta 将自动填充创建的节点。使用它来指明在创建节点时应使用哪些标签、注解、名称前缀等。
类型
对象
Expand
属性类型描述

annotations

对象(字符串)

注解是一个无结构的键值映射,与资源存储,可通过外部工具设置来存储和检索任意元数据。它们不可查询,应在修改对象时保留。更多信息: http://kubernetes.io/docs/user-guide/annotations

generateName

字符串

generateName 是一个可选前缀,服务器使用,用于生成唯一名称,只提供 Name 字段。如果使用此字段,则返回到客户端的名称将与传递的名称不同。这个值也会与唯一的后缀结合使用。提供的值与 Name 字段具有相同的验证规则,并可能根据在服务器中使值的唯一后缀的长度截断。如果指定了此字段,且存在生成的名称,服务器将不会返回 409 - 相反,它将返回 201 Created 或 500,表示一个唯一名称无法在分配的时间内找到,客户端应重试(可选)仅在没有指定 Name 时才应用。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency

labels

对象(字符串)

可用于组织和分类(范围和选择)对象的字符串键和值映射。可能与复制控制器和服务选择器匹配。更多信息: http://kubernetes.io/docs/user-guide/labels

name

字符串

名称在命名空间中必须是唯一的。在创建资源时是必需的,但有些资源可能允许客户端自动请求生成适当名称。名称主要用于创建 idempotence 和配置定义。无法更新。更多信息: http://kubernetes.io/docs/user-guide/identifiers#names

namespace

字符串

命名空间定义每个名称中的空间必须是唯一的。空命名空间等同于 "default" 命名空间,但 "default" 是规范表示。不是所有对象都需要限定到命名空间 - 这些对象的此字段值为空。必须是 DNS_LABEL。无法更新。更多信息: http://kubernetes.io/docs/user-guide/namespaces

ownerReferences

array

由此对象依赖的对象列表。如果列表中删除列表中的 ALL 对象,则会收集此对象。如果此对象由控制器管理,则此列表中的条目将指向此控制器,并将 controller 字段设置为 true。不能有多个管理控制器。

ownerReferences[]

对象

OwnerReference 包含足够信息,供您识别自己的对象。拥有的对象必须与依赖项处于相同命名空间中,或是集群范围的,因此没有命名空间字段。

12.9.1.11. .spec.template.spec.metadata.ownerReferences

描述
由此对象依赖的对象列表。如果列表中删除列表中的 ALL 对象,则会收集此对象。如果此对象由控制器管理,则此列表中的条目将指向此控制器,并将 controller 字段设置为 true。不能有多个管理控制器。
类型
array

12.9.1.12. .spec.template.spec.metadata.ownerReferences[]

描述
OwnerReference 包含足够信息,供您识别自己的对象。拥有的对象必须与依赖项处于相同命名空间中,或是集群范围的,因此没有命名空间字段。
类型
对象
必填
  • apiVersion
  • kind
  • name
  • uid
Expand
属性类型描述

apiVersion

字符串

引用的 API 版本。

blockOwnerDeletion

布尔值

如果为 true,如果所有者有"foregroundDeletion"终结器,则无法从键值存储中删除所有者,直到删除了此引用。默认为false。要设置此字段,用户需要"删除"所有者的权限,否则将返回 422 (不可处理实体)。

controller

布尔值

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

kind

字符串

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

name

字符串

引用的名称。更多信息: http://kubernetes.io/docs/user-guide/identifiers#names

uid

字符串

引用的 UID。更多信息: http://kubernetes.io/docs/user-guide/identifiers#uids

12.9.1.13. .spec.template.spec.providerSpec

描述
ProviderSpec 详情要在节点创建过程中使用的供应商特定配置。
类型
对象
Expand
属性类型描述

value

``

value 是资源配置的内联序列化表示。建议供应商维护自己的版本化的 API 类型,这些类型应该从此字段序列化/反序列化,以转至组件配置。

12.9.1.14. .spec.template.spec.taints

描述
要以附加方式应用到相应节点的污点列表。此列表不会覆盖会持续由其他实体添加到节点的任何其他污点。这些污点应主动协调,例如,如果您要求机器控制器应用污点,然后手动删除机器控制器将返回污点,但没有删除机器控制器移除任何污点
类型
array

12.9.1.15. .spec.template.spec.taints[]

描述
此污点的节点附加到不容许 Taint 的 pod 上具有 "effect" 的节点。
类型
对象
必填
  • effect
  • key
Expand
属性类型描述

effect

字符串

必需。污点对不容许污点的 pod 的影响。有效效果为 NoSchedule、PreferNoSchedule 和 NoExecute。

key

字符串

必需。要应用到节点的污点键。

timeAdded

字符串

TimeAdded 代表添加污点的时间。它只适用于 NoExecute 污点。

value

字符串

与污点键对应的污点值。

12.9.1.16. .status

描述
MachineSetStatus 定义 MachineSet 的观察状态
类型
对象
必填
  • replicas
Expand
属性类型描述

availableReplicas

整数

此 MachineSet 的可用副本数量(至少可用于 minReadySeconds)。

errorMessage

字符串

 

errorReason

字符串

如果终端问题协调副本,则将设置 ErrorReason 和 ErrorMessage。ErrorReason 将填充一个适合机器解释的 succinct 值,而 ErrorMessage 将包含适合日志记录和人消耗的更多详细字符串。不应为传输错误设置,控制器在一段时间内自动修复(如服务中断),而是表示 MachineTemplate 的 spec 或机器控制器配置的基本错误,需要手动干预。终端错误的示例是 spec 中的设置无效组合、机器控制器不支持的值,或者负责机器控制器本身被严重错误配置。任何在 Machine 协调过程中发生的临时错误都可以作为事件添加到 MachineSet 对象中,并在控制器的输出中记录。

fullyLabeledReplicas

整数

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

observedGeneration

整数

observedGeneration 反映了最近观察到的 MachineSet 的生成。

readyReplicas

整数

此 MachineSet 的就绪副本数。在创建节点时,机器被视为就绪,且被视为"Ready"。

replicas

整数

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

12.9.2. API 端点

可用的 API 端点如下:

  • /apis/machine.openshift.io/v1beta1/machinesets

    • GET: 列出 MachineSet 类型的对象
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets

    • DELETE :删除 MachineSet 的集合
    • GET: 列出 MachineSet 类型的对象
    • POST :创建 MachineSet
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}

    • DELETE :删除 MachineSet
    • GET :读取指定的 MachineSet
    • PATCH :部分更新指定的 MachineSet
    • PUT :替换指定的 MachineSet
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/scale

    • GET :指定 MachineSet 的读取扩展
    • PATCH :部分更新指定 MachineSet 的扩展
    • PUT :替换指定 MachineSet 的规模
  • /apis/machine.openshift.io/v1beta1/namespaces/{namespace}/machinesets/{name}/status

    • GET :指定 MachineSet 的读取状态
    • PATCH :部分更新指定 MachineSet 的状态
    • PUT: 替换指定 MachineSet 的状态

12.9.2.1. /apis/machine.openshift.io/v1beta1/machinesets

Expand
表 12.214. 全局查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

pretty

字符串

如果 'true',则输出被用户友善。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

HTTP 方法
GET
描述
列出 MachineSet 类型的对象
Expand
表 12.215. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSetList schema

401 - Unauthorized

Expand
表 12.216. 全局路径参数
参数类型描述

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 12.217. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除 MachineSet 集合
Expand
表 12.218. 查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand
表 12.219. HTTP 响应
HTTP 代码响应正文

200 - OK

Status_v2 模式

401 - Unauthorized

HTTP 方法
GET
描述
列出 MachineSet 类型的对象
Expand
表 12.220. 查询参数
参数类型描述

allowWatchBookmarks

布尔值

allowWatchBookmarks请求类型为“BOOKMARK”的监视事件。没有实现书签的服务器可能会忽略这个标志和书签,由服务器自由裁量发送。客户端不应假设书签在任何特定间隔返回,也不会假定服务器在会话期间发送任何 BOOKMARK 事件。如果这不是监视,则忽略此字段。

继续

字符串

从服务器检索更多结果时,应设置 continue 选项。由于这个值是定义的服务器,因此客户端只能使用之前查询结果中的 continue 值,并带有相同的查询参数(除 continue 值除外),因此服务器可能会拒绝它无法识别的值。如果指定的 continue 值不再有效,无论是因为过期时间(通常为 5 到十五分钟)还是服务器上的配置更改,服务器将会与继续令牌一起响应 410 ResourceExpired 错误。如果客户端需要一致的列表,它必须在没有 continue 字段的情况下重启其列表。否则,客户端可能会发送另一个列表请求,并带有 410 错误收到的令牌,服务器将通过从下一个密钥开始的列表进行响应,但从最新的快照(从最后一个列表结果中不一致) - 在第一个列表请求后创建、修改或删除的对象将包含在响应中,只要其密钥在"next key"后。

当 watch 为 true 时,不支持此字段。客户端可以从服务器返回的最后一个 resourceVersion 值启动监视,而不丢失任何修改。

fieldSelector

字符串

用于限制返回的对象列表的选择器。默认为任何内容。

labelSelector

字符串

通过标签限制返回的对象列表的选择器。默认为任何内容。

limit

整数

限制是列表调用要返回的最大响应数。如果存在更多项目,服务器会将列表元数据上的"continue"字段设置为可用于同一初始查询的值,以检索下一个结果集。在过滤所有请求的对象时,设置限制可能会返回比请求的项目数量少(最多为零项),客户端应只使用 continue 字段的存在来确定是否有更多结果可用。服务器可以选择不支持限制参数,并将返回所有可用的结果。如果指定了限制,并且 continue 字段为空,客户端可能会假设没有更多可用的结果。如果 watch 为 true,则不支持此字段。

服务器保证在使用 continue 时返回的对象与在没有限制的情况下发出单个列表调用相同 - 也就是说,在发出第一个请求后不会创建、修改或删除对象。这有时被称为一致的快照,并确保使用限制的客户端接收一个非常大的结果较小的块可以确保它们看到所有可能的对象。如果在块列出期间更新对象,则返回第一次列表结果时存在的对象版本。

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

resourceVersionMatch

字符串

resourceVersionMatch 决定 resourceVersion 如何应用到列出调用。强烈建议您为设置了 resourceVersion 的列表调用设置 resourceVersionMatch。详情请参阅 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

timeoutSeconds

整数

list/watch 调用的超时。这限制了调用的时间,无论任何活动或不活跃。

watch

布尔值

观察对描述的资源的更改,并将其作为添加、更新和删除通知流返回。指定 resourceVersion。

Expand
表 12.221. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSetList schema

401 - Unauthorized

HTTP 方法
POST
描述
创建 MachineSet
Expand
表 12.222. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 12.223. 主体参数
参数类型描述

正文(body)

MachineSet schema

 
Expand
表 12.224. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSet schema

201 - Created

MachineSet schema

202 - Accepted

MachineSet schema

401 - Unauthorized

Expand
表 12.225. 全局路径参数
参数类型描述

name

字符串

MachineSet 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 12.226. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
DELETE
描述
删除 MachineSet
Expand
表 12.227. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

gracePeriodSeconds

整数

应该删除对象前的持续时间(以秒为单位)。值必须是非负整数。值零表示立即删除。如果这个值是 nil,则使用指定类型的默认宽限期。如果没有指定,则默认为每个对象值。零表示立即删除。

orphanDependents

布尔值

弃用:请使用 PropagationPolicy,此字段将在 1.7 中被弃用。应该依赖的对象被孤立。如果为 true/false,"orphan"终结器将从对象的终结器列表添加到/删除。可以设置此字段或 PropagationPolicy,但不能同时设置两者。

propagationPolicy

字符串

是否以及是否执行垃圾回收。此字段或 OrphanDependents 可以设置,但不能同时设置两者。默认策略由 metadata.finalizers 和特定于资源的默认策略中设置的现有终结器决定。可接受的值为: 'Orphan' - 孤立依赖; 'Background' - 允许垃圾收集器在后台删除依赖的依赖关系; 'Foreground' - 一个删除前台所有依赖的级联策略。

Expand
表 12.228. 主体参数
参数类型描述

正文(body)

DeleteOptions_v2 schema

 
Expand
表 12.229. HTTP 响应
HTTP 代码响应正文

200 - OK

Status_v2 模式

202 - Accepted

Status_v2 模式

401 - Unauthorized

HTTP 方法
GET
描述
读取指定的 MachineSet
Expand
表 12.230. 查询参数
参数类型描述

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

Expand
表 12.231. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSet schema

401 - Unauthorized

HTTP 方法
PATCH
描述
部分更新指定的 MachineSet
Expand
表 12.232. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 12.233. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 12.234. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSet schema

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定的 MachineSet
Expand
表 12.235. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 12.236. 主体参数
参数类型描述

正文(body)

MachineSet schema

 
Expand
表 12.237. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSet schema

201 - Created

MachineSet schema

401 - Unauthorized

Expand
表 12.238. 全局路径参数
参数类型描述

name

字符串

MachineSet 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 12.239. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定 MachineSet 的读取扩展
Expand
表 12.240. 查询参数
参数类型描述

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

Expand
表 12.241. HTTP 响应
HTTP 代码响应正文

200 - OK

Scale_v2 模式

401 - Unauthorized

HTTP 方法
PATCH
描述
指定 MachineSet 的部分更新扩展
Expand
表 12.242. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 12.243. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 12.244. HTTP 响应
HTTP 代码响应正文

200 - OK

Scale_v2 模式

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定 MachineSet 的扩展
Expand
表 12.245. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 12.246. 主体参数
参数类型描述

正文(body)

Scale_v2 模式

 
Expand
表 12.247. HTTP 响应
HTTP 代码响应正文

200 - OK

Scale_v2 模式

201 - Created

Scale_v2 模式

401 - Unauthorized

Expand
表 12.248. 全局路径参数
参数类型描述

name

字符串

MachineSet 的名称

namespace

字符串

对象名称和身份验证范围,如团队和项目

Expand
表 12.249. 全局查询参数
参数类型描述

pretty

字符串

如果 'true',则输出被用户友善。

HTTP 方法
GET
描述
指定 MachineSet 的读取状态
Expand
表 12.250. 查询参数
参数类型描述

resourceVersion

字符串

resourceVersion 对可能给请求提供服务的资源版本设置一个约束。详情请查看 https://kubernetes.io/docs/reference/using-api/api-concepts/#resource-versions

默认为未设置

Expand
表 12.251. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSet schema

401 - Unauthorized

HTTP 方法
PATCH
描述
指定 MachineSet 的部分更新状态
Expand
表 12.252. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 12.253. 主体参数
参数类型描述

正文(body)

Patch 模式

 
Expand
表 12.254. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSet schema

401 - Unauthorized

HTTP 方法
PUT
描述
替换指定 MachineSet 的状态
Expand
表 12.255. 查询参数
参数类型描述

dryRun

字符串

出现时,表示不应保留修改。无效的或未被识别的 dryRun 指令将导致错误响应,且请求不会被进一步处理。有效值为: - All: 所有预演阶段都将被处理

fieldManager

字符串

fieldmanager 是与进行这些更改的参与者或实体相关联的名称。该值必须小于或是 128 个字符长,且仅包含可打印的字符,如 https://golang.org/pkg/unicode/#IsPrint 所定义的那样。

Expand
表 12.256. 主体参数
参数类型描述

正文(body)

MachineSet schema

 
Expand
表 12.257. HTTP 响应
HTTP 代码响应正文

200 - OK

MachineSet schema

201 - Created

MachineSet schema

401 - Unauthorized

返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat