事件

事件是集群中某处的事件报告。

apiVersion: events.k8s.io/v1

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

事件

事件是集群中某处的事件报告。它通常表示系统中的某些状态更改。事件的保留时间有限,触发器和消息可能会随着时间的推移而演变。事件消费者不应依赖于具有特定原因的事件的时间,反映一致的底层触发器,或具有该原因的事件的持续存在。事件应被视为信息性、尽力而为的补充数据。


  • apiVersion: events.k8s.io/v1

  • kind: Event

  • metadata (ObjectMeta)

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

  • eventTime (MicroTime), required

    eventTime 是首次观察到此事件的时间。这是必需的。

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

  • action (string)

    action 是针对相关对象采取或失败的操作。它是机器可读的。此字段对于新事件不能为空,并且最多可以包含 128 个字符。

  • deprecatedCount (int32)

    deprecatedCount 是保证与 core.v1 Event 类型向后兼容的弃用字段。

  • deprecatedFirstTimestamp (Time)

    deprecatedFirstTimestamp 是保证与 core.v1 Event 类型向后兼容的弃用字段。

    Time 是围绕 time.Time 的包装器,它支持对 YAML 和 JSON 的正确编组。包装器是为时间包提供的许多工厂方法提供的。

  • deprecatedLastTimestamp (Time)

    deprecatedLastTimestamp 是保证与 core.v1 Event 类型向后兼容的弃用字段。

    Time 是围绕 time.Time 的包装器,它支持对 YAML 和 JSON 的正确编组。包装器是为时间包提供的许多工厂方法提供的。

  • 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 是针对更复杂操作的可选辅助对象。例如,当相关对象触发相关对象的创建或删除时。

  • reportingController (string)

    reportingController 是发出此事件的控制器的名称,例如 kubernetes.io/kubelet。此字段对于新事件不能为空。

  • reportingInstance (string)

    reportingInstance 是控制器实例的 ID,例如 kubelet-xyzf。此字段对于新事件不能为空,并且最多可以包含 128 个字符。

  • series (EventSeries)

    series 是有关此事件表示的事件系列的数据,或者如果它是单例事件,则为 nil。

    EventSeries 包含有关事件系列的信息,即持续发生一段时间的事情。事件系列的更新频率取决于事件报告器。“k8s.io/client-go/tools/events/event_broadcaster.go”中的默认事件报告器显示了此结构如何在心跳时更新,并可以指导自定义报告器实现。

    • series.count (int32), required

      count 是此系列中到最后一次心跳时间的发生次数。

    • series.lastObservedTime (MicroTime), required

      lastObservedTime 是在最后一次心跳之前从该系列中看到最后一个事件的时间。

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

  • type (string)

    type 是此事件的类型(正常、警告),将来可能会添加新类型。它是机器可读的。此字段对于新事件不能为空。

EventList

EventList 是事件对象列表。


操作


get 读取指定的事件

HTTP 请求

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

参数

  • name (in path): string, required

    事件的名称

  • namespace (in path): string, required

    命名空间

  • pretty (in query): string

    漂亮

响应

200 (Event): OK

401: 未授权

list 列出或观察 Event 类型的对象

HTTP 请求

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

参数

响应

200 (EventList): OK

401: 未授权

list 列出或观察 Event 类型的对象

HTTP 请求

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

参数

响应

200 (EventList): OK

401: 未授权

create 创建一个事件

HTTP 请求

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

参数

响应

200 (Event): OK

201 (Event): Created

202 (Event): Accepted

401: 未授权

update 替换指定的事件

HTTP 请求

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

参数

响应

200 (Event): OK

201 (Event): Created

401: 未授权

patch 部分更新指定的事件

HTTP 请求

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

参数

响应

200 (Event): OK

201 (Event): Created

401: 未授权

delete 删除事件

HTTP 请求

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

参数

响应

200 (Status): OK

202 (Status): Accepted

401: 未授权

deletecollection 删除 Event 集合

HTTP 请求

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

参数

响应

200 (Status): OK

401: 未授权

此页面是自动生成的。

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

上次修改时间为 2023 年 4 月 3 日,太平洋标准时间上午 8:22:API Ref 多页面 v1.27 (7b39e9a9ec)