Event

Event 是叢集中某處事件的報告。

apiVersion: events.k8s.io/v1

import "k8s.io/api/events/v1"

Event

Event 是叢集中某處事件的報告。它通常表示系統中的某些狀態變更。事件的保留時間有限，觸發器和訊息可能會隨時間演變。事件消費者不應依賴具有給定 Reason 的事件的時序來反映一致的基礎觸發器，或具有該 Reason 的事件的持續存在。事件應被視為資訊性、盡力而為、補充資料。

  • apiVersion: events.k8s.io/v1

  • kind: Event

  • metadata (ObjectMeta)

    標準物件的中繼資料。更多資訊：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata

  • eventTime (MicroTime), 必填

    eventTime 是首次觀察到此事件的時間。這是必填欄位。

    MicroTime 是具有微秒級精度的 Time 版本。

  • action (string)

    action 是針對 regarding 物件採取的/失敗的動作。它是機器可讀的。對於新事件，此欄位不能為空，且最多可包含 128 個字元。

  • deprecatedCount (int32)

    deprecatedCount 是已棄用的欄位，確保與 core.v1 Event 類型向後相容。

  • deprecatedFirstTimestamp (Time)

    deprecatedFirstTimestamp 是已棄用的欄位，確保與 core.v1 Event 類型向後相容。

    Time 是 time.Time 的包裝函式，支援正確封送至 YAML 和 JSON。為 time 套件提供的許多工廠方法提供包裝函式。

  • deprecatedLastTimestamp (Time)

    deprecatedLastTimestamp 是已棄用的欄位，確保與 core.v1 Event 類型向後相容。

    Time 是 time.Time 的包裝函式，支援正確封送至 YAML 和 JSON。為 time 套件提供的許多工廠方法提供包裝函式。

  • deprecatedSource (EventSource)

    deprecatedSource 是已棄用的欄位，確保與 core.v1 Event 類型向後相容。

    EventSource 包含事件的資訊。

    • deprecatedSource.component (string)

      產生事件的元件。

    • deprecatedSource.host (string)

      產生事件的節點名稱。

  • note (string)

    note 是此操作狀態的人工可讀描述。註解的最大長度為 1kB，但程式庫應準備好處理高達 64kB 的值。

  • reason (string)

    reason 是採取動作的原因。它是人工可讀的。對於新事件，此欄位不能為空，且最多可包含 128 個字元。

  • regarding (ObjectReference)

    regarding 包含此事件相關的物件。在大多數情況下，它是報告控制器實作的物件，例如 ReplicaSetController 實作 ReplicaSets，且此事件的發出是因為它作用於 ReplicaSet 物件中的某些變更。

  • related (ObjectReference)

    related 是更複雜動作的選用次要物件。例如，當 regarding 物件觸發相關物件的建立或刪除時。

  • reportingController (string)

    reportingController 是發出此事件的控制器的名稱，例如 kubernetes.io/kubelet。對於新事件，此欄位不能為空。

  • reportingInstance (string)

    reportingInstance 是控制器執行個體的 ID，例如 kubelet-xyzf。對於新事件，此欄位不能為空，且最多可包含 128 個字元。

  • series (EventSeries)

    series 是此事件代表的 Event series 的資料，如果它是 singleton Event，則為 nil。

    EventSeries 包含關於事件序列的資訊，即在一段時間內持續發生/正在發生的事情。更新 EventSeries 的頻率取決於事件報告程式。「k8s.io/client-go/tools/events/event_broadcaster.go」中的預設事件報告程式顯示此結構如何在心跳訊號上更新，並且可以引導自訂報告程式實作。

    • series.count (int32), 必填

      count 是此序列中發生次數，直到上次心跳時間。

    • series.lastObservedTime (MicroTime), 必填

      lastObservedTime 是上次心跳訊號之前看到序列中最後一個事件的時間。

      MicroTime 是具有微秒級精度的 Time 版本。

  • type (string)

    type 是此事件的類型 (Normal、Warning)，未來可能會新增類型。它是機器可讀的。對於新事件，此欄位不能為空。

EventList

EventList 是 Event 物件的清單。

操作

get 讀取指定的 Event

HTTP 請求

GET /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}

參數

  • name (in path)：字串，必填

    Event 的名稱

  • namespace (in path)：字串，必填

    命名空間

  • pretty (in query)：字串

    pretty

回應

200 (Event)：OK

401：未經授權

list 列出或監看 Event 類型的物件

HTTP 請求

GET /apis/events.k8s.io/v1/namespaces/{namespace}/events

參數

回應

200 (EventList): 成功

401：未經授權

list 列出或監看 Event 類型的物件

HTTP 請求

GET /apis/events.k8s.io/v1/events

參數

回應

200 (EventList): 成功

401：未經授權

create 建立 Event

HTTP 請求

POST /apis/events.k8s.io/v1/namespaces/{namespace}/events

參數

回應

200 (Event)：OK

201 (Event): 已建立

202 (Event): 已接受

401：未經授權

update 取代指定的 Event

HTTP 請求

PUT /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}

參數

回應

200 (Event)：OK

201 (Event): 已建立

401：未經授權

patch 部分更新指定的 Event

HTTP 請求

PATCH /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}

參數

回應

200 (Event)：OK

201 (Event): 已建立

401：未經授權

delete 刪除 Event

HTTP 請求

DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}

參數

回應

200 (Status): 成功

202 (Status): 已接受

401：未經授權

deletecollection 刪除 Event 集合

HTTP 請求

DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events

參數

回應

200 (Status): 成功

401：未經授權

此頁面為自動產生。

如果您計劃回報此頁面的問題，請在您的問題描述中提及此頁面為自動產生。此問題的修正可能需要在 Kubernetes 專案的其他地方進行。

上次修改時間為 2024 年 8 月 28 日下午 6:01 PST：更新 v1.31 (8ba98c79c1) 的自動產生 API 參考文件