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.club.tw/docs/concepts/overview/working-with-objects/names#uids

本頁面是自動生成的。

如果你打算報告此頁面存在的問題，請在問題描述中提及此頁面是自動生成的。修復可能需要在 Kubernetes 專案的其他地方進行。

上次修改時間：2024 年 8 月 24 日太平洋標準時間晚上 10:29：更新 v1.31 的生成的 API 參考 (890b36a496)