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 是针对所涉及对象所采取/失败的动作。它是机器可读的。对于新事件，此字段不能为空，且最多可包含 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 是对该操作状态的人类可读描述。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 是此事件所代表的事件系列的数据，如果是单例事件，则为 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}

Parameters

  • name (在路径中): string, 必需

    Event 的名称

  • namespace (在路径中): string, 必需

    命名空间

  • pretty (在查询中): string

    pretty

响应

200 (Event): 成功

401: 未授权

list 列出或监视 Event 类型的对象

HTTP 请求

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

Parameters

响应

200 (EventList): 成功

401: 未授权

list 列出或监视 Event 类型的对象

HTTP 请求

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

Parameters

响应

200 (EventList): 成功

401: 未授权

create 创建一个 Event

HTTP 请求

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

Parameters

响应

200 (Event): 成功

201 (Event): 已创建

202 (Event): 已接受

401: 未授权

update 替换指定的 Event

HTTP 请求

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

Parameters

  • name (在路径中): string, 必需

    Event 的名称

  • namespace (在路径中): string, 必需

    命名空间

  • body: Event, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • pretty (在查询中): string

    pretty

响应

200 (Event): 成功

201 (Event): 已创建

401: 未授权

patch 部分更新指定的 Event

HTTP 请求

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

Parameters

  • name (在路径中): string, 必需

    Event 的名称

  • namespace (在路径中): string, 必需

    命名空间

  • body: Patch, 必需

  • dryRun (在查询中): string

    dryRun

  • fieldManager (在查询中): string

    fieldManager

  • fieldValidation (在查询中): string

    fieldValidation

  • force (in query): boolean

    force

  • pretty (在查询中): string

    pretty

响应

200 (Event): 成功

201 (Event): 已创建

401: 未授权

delete 删除一个 Event

HTTP 请求

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

Parameters

响应

200 (Status): 确定

202 (Status): 已接受

401: 未授权

deletecollection 删除 Event 集合

HTTP 请求

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

Parameters

响应

200 (Status): 确定

401: 未授权


上次修改时间：2025 年 4 月 9 日下午 6:36 PST：更新 v1.32 的 API 参考文档 (a3b579d035)

本页面是自动生成的。

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