ObjectMeta

ObjectMeta 是所有持久化资源都必须拥有的元数据,它包含了所有用户必须创建的对象。

import "k8s.io/apimachinery/pkg/apis/meta/v1"

ObjectMeta 是所有持久化资源都必须拥有的元数据,它包含了所有用户必须创建的对象。


系统

  • finalizers ([]string)

    Set: 合并时将保留唯一值

    在对象从注册表中删除之前必须为空。每个条目都是负责清理此列表的组件的标识符。如果对象的 deletionTimestamp 非空,则此列表中的条目只能被移除。Finalizers 可以按任何顺序处理和移除。不强制执行顺序,因为这会引入卡住 finalizers 的重大风险。finalizers 是一个共享字段,任何有权限的参与者都可以重新排序它。如果 finalizer 列表按顺序处理,那么可能会出现这种情况:负责列表中第一个 finalizer 的组件正在等待由负责列表中稍后 finalizer 的组件产生的信号(字段值、外部系统或其他),从而导致死锁。没有强制的顺序,finalizers 可以自由地相互排序,并且不受列表中顺序更改的影响。

  • managedFields ([]ManagedFieldsEntry)

    原子性:在合并期间将被替换

    ManagedFields 将工作流 ID 和版本映射到由该工作流管理的字段集。这主要用于内部管理,用户通常不需要设置或理解此字段。工作流可以是用户的名称、控制器的名称,或者是特定应用路径的名称,如“ci-cd”。字段集始终是工作流在修改对象时使用的版本。

    ManagedFieldsEntry 是一个工作流 ID、一个 FieldSet 以及该 FieldSet 适用的资源的组版本。

    • managedFields.apiVersion (string)

      APIVersion 定义了此字段集适用的资源的版本。格式为“group/version”,就像顶级的 APIVersion 字段一样。跟踪字段集的版本是必要的,因为它无法自动转换。

    • managedFields.fieldsType (string)

      FieldsType 是不同字段格式和版本的区分符。目前只有一个可能的值:“FieldsV1”。

    • managedFields.fieldsV1 (FieldsV1)

      FieldsV1 包含第一个 JSON 版本格式,如“FieldsV1”类型中所述。

      *FieldsV1 以 JSON 格式存储一组字段,数据结构类似于 Trie。

      每个键要么是 '.',表示字段本身,并且始终映射到一个空集,要么是一个表示子字段或项的字符串。该字符串遵循以下四种格式之一:'f', 其中是结构体中字段的名称,或映射中的键。 'v', 其中是列表项的确切 JSON 格式值。 'i', 其中是列表中一项的位置。 'k', 其中是列表项的键字段与其唯一值的映射。如果一个键映射到一个空的 Fields 值,则该键表示的字段是该集合的一部分。

      确切格式定义在 sigs.k8s.io/structured-merge-diff*

    • managedFields.manager (string)

      Manager 是管理这些字段的工作流的标识符。

    • managedFields.operation (string)

      Operation 是导致创建此 ManagedFieldsEntry 的操作类型。此字段的唯一有效值为“Apply”和“Update”。

    • managedFields.subresource (string)

      Subresource 是用于更新该对象的子资源的名称,如果对象是通过主资源更新的,则为空字符串。此字段的值用于区分不同的管理器,即使它们共享相同的名称。例如,状态更新将与使用相同管理器名称的常规更新区分开。请注意,APIVersion 字段与 Subresource 字段无关,它始终对应于主资源的版本。

    • managedFields.time (Time)

      Time 是添加 ManagedFields 条目的时间戳。如果添加了字段、管理器更改了任何拥有的字段值或删除了字段,时间戳也会更新。当条目中的字段被移除时,时间戳不会更新,因为另一个管理器接管了它。

      Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

  • ownerReferences ([]OwnerReference)

    Patch 策略:按键 uid 合并

    Map:合并期间将保留键 uid 上的唯一值

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

    OwnerReference 包含足够的信息,让您识别拥有对象。拥有对象必须与依赖对象位于同一命名空间内,或者为集群范围,因此没有命名空间字段。

只读

  • creationTimestamp (Time)

    CreationTimestamp 是一个时间戳,表示服务器创建此对象的时间。不保证在不同操作之间按发生顺序设置。客户端可能无法设置此值。它以 RFC3339 格式表示,并且是 UTC 时间。

    由系统填充。只读。列表为 Null。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

    Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

  • deletionGracePeriodSeconds (int64)

    允许此对象在被从系统中移除之前优雅终止的秒数。仅在设置了 deletionTimestamp 时设置。只能缩短。只读。

  • deletionTimestamp (Time)

    DeletionTimestamp 是此资源将被删除的 RFC 3339 日期和时间。此字段由服务器在用户请求优雅删除时设置,客户端不能直接设置。一旦 finalizers 列表为空,资源预计将在此字段的时间之后被删除(不再可见于资源列表,并且无法按名称访问)。只要 finalizers 列表包含条目,删除就会被阻止。一旦设置了 deletionTimestamp,此值就不能被取消设置或设置为更远的未来,尽管它可以被缩短,或者资源可能会在此时间之前被删除。例如,用户可能请求在 30 秒内删除一个 pod。Kubelet 将通过向 pod 中的容器发送优雅终止信号来响应。在这 30 秒之后,Kubelet 将向容器发送硬终止信号(SIGKILL),并在清理完成后,从 API 中移除 pod。在网络分区的情况下,此对象可能在此时间戳之后仍然存在,直到管理员或自动化进程能够确定资源已完全终止。如果未设置,则表示尚未请求对象的优雅删除。

    由系统在收到优雅删除请求时填充。只读。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

    Time 是 time.Time 的一个包装器,支持正确地编组到 YAML 和 JSON。提供了 time 包提供的许多工厂方法的包装器。

  • generation (int64)

    表示所需状态特定代数的一个序列号。由系统填充。只读。

  • resourceVersion (字符串)

    一个不透明值,表示此对象的内部版本,客户端可以使用它来确定对象何时已更改。可用于乐观并发、更改检测以及资源或资源集的 watch 操作。客户端必须将这些值视为不透明,并将其 unmodified 返回给服务器。它们可能只对特定资源或资源集有效。

    由系统填充。只读。客户端必须将值视为不透明。更多信息: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency

  • selfLink (string)

    已弃用:selfLink 是一个旧的只读字段,不再由系统填充。

  • uid (string)

    UID 是此对象的时空唯一值。它通常由服务器在成功创建资源时生成,并且不允许在 PUT 操作中更改。

    由系统填充。只读。更多信息: https://kubernetes.ac.cn/docs/concepts/overview/working-with-objects/names#uids

本页面是自动生成的。

如果你打算报告此页面存在的问题,请在问题描述中提及此页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。

上次修改时间:2024 年 8 月 24 日太平洋标准时间晚上 10:29:更新 v1.31 的生成的 API 参考 (890b36a496)