1.126. io.k8s.apimachinery.pkg.apis.meta.v1.ObjectMeta schema
- 描述
- ObjectMeta 是所有持久性资源必须具有的元数据，其中包含用户必须创建的所有对象。
- 类型
-
对象
模式
| 属性 | 类型 | 描述 |
|---|---|---|
|
|
| annotations 是一个无结构的键值映射，它存储有资源，可通过外部工具存储和检索任意元数据。它们不可查询，应在修改对象时保留。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/annotations |
|
| creationTimestamp 是一个代表创建此对象时服务器时间的时间戳。无法保证在单独的操作之间按顺序设置。客户端可能无法设置这个值。它以 RFC3339 格式表示，并以 UTC 表示。 由系统填充。只读。null 用于列表.更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| 此对象允许在从系统中删除系统前安全终止的秒数。仅在设置了 deletionTimestamp 时设置。只能缩短。只读。 |
|
| deletionTimestamp 是 RFC 3339 日期和时间，此资源将被删除。当用户请求安全删除时，服务器会设置此字段，且客户端不能直接设置此字段。应该在此字段中的时间后删除资源（不再从资源列表可见，且不能通过名称访问），一旦终结器列表为空。只要 finalizers 列表包含项，删除就会被阻断。设置 deletionTimestamp 后，此值可能无法在将来设置，或者进一步设置，但可能会缩短资源，或者在此时间之前可能会删除资源。例如，用户可以请求 pod 在 30 秒内被删除。Kubelet 将通过向 pod 中的容器发送安全终止信号来响应。30 秒后，Kubelet 将向容器发送硬终止信号(SIGKILL)，并在清理后从 API 中删除 pod。在网络分区存在时，此对象可能在此时间戳后仍然存在，直到管理员或自动进程可以确定资源完全终止为止。如果没有设置，则不请求对对象进行安全删除。 当请求安全删除时，系统填充。只读。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata | |
|
|
| 在从 registry 中删除对象前，必须为空。每个条目都是负责组件的标识符，它将从列表中删除该条目。如果对象的 deleteTimestamp不是nil，则只能删除此列表中的条目。终结器可能会以任何顺序处理和删除。顺序不是强制性的，因为它引入了卡住的终结器风险。终结器是一个共享字段，任何权限的操作者都可以重新排序。如果终结器列表按顺序处理，则这可能会导致一个情况，负责列表中的第一个终结器的组件正在等待一个信号（字段值、外部系统或其他）由处理列表中终结器生成的组件，从而导致死锁。如果没有强制的排序终结器，则本身可以自由排序，且不会受到列表中更改的影响。 |
|
|
| generateName 是一个可选前缀，服务器使用它来生成唯一的名称 IF，即未提供 Name 字段。如果使用此字段，返回到客户端的名称将与传递的名称不同。这个值也会与唯一的后缀合并。provided 值的验证规则与 Name 字段相同，并可能由使值在服务器上唯一要求的后缀长度截断。 如果指定了此字段并且存在生成的名称，服务器将返回 409。 仅在未指定 Name 时应用。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#idempotency |
|
|
| 代表特定生成所需状态的序列号。由系统填充。只读。 |
|
|
| 可用于组织和分类（范围和选择）对象的字符串键和值映射。可能与复制控制器和服务选择器匹配。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/labels |
|
|
| managedFields 将 workflow-id 和 version 映射到由该工作流管理的一组字段。这主要适用于内部内务处理，用户通常不需要设置或理解此字段。工作流可以是用户名、控制器的名称，也可以是特定应用路径的名称，如 "ci-cd"。组字段始终位于修改对象时使用的工作流的版本中。 |
|
|
| 名称在命名空间中必须是唯一的。创建资源时需要一些资源，但有些资源可能会允许客户端自动请求生成适当名称。name 主要用于创建 idempotence 和配置定义。无法更新。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names#names |
|
|
| namespace 定义每个名称必须是唯一的的空间。空命名空间等同于 "default" 命名空间，但 "default" 是规范表示。不是所有对象都必须限定到命名空间 - 这些对象的这个字段的值为空。 必须是 DNS_LABEL。无法更新。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/namespaces |
|
|
| 此对象依赖的对象列表。如果列表中删除列表中的 all 对象，则会收集此对象。如果此对象由控制器管理，则此列表中的一个条目将指向此控制器，controller 字段设为 true。不能有多个管理控制器。 |
|
|
| 代表此对象的内部版本的不透明值，供客户端用来决定对象何时更改。可用于最佳并发、更改检测以及对资源或一组资源的监视操作。客户端必须将这些值视为不透明，并将未修改的返回给服务器。它们可能仅对特定资源或一组资源有效。 由系统填充。只读。值必须被客户端 和 视为不透明。更多信息： https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#concurrency-control-and-consistency |
|
|
| deprecated: selfLink 是一个旧的只读字段，不再由系统填充。 |
|
|
| UID 是此对象的时间和空间值的唯一值。它通常由服务器在成功创建资源时生成，不允许更改 PUT 操作。 由系统填充。只读。更多信息： https://kubernetes.io/docs/concepts/overview/working-with-objects/names#uids |
