OpenShift 文档正在迁移，很快将只在 docs.redhat.com（所有 Red Hat 产品文档的中心）提供。立即体验 新的文档体验。
  1. 文档
    2. history bug_report picture_as_pdf
×

事件 [events.k8s.io/v1]

描述

事件是集群中某个位置发生的事件报告。它通常表示系统中的某些状态变化。事件的保留时间有限，触发器和消息可能会随着时间的推移而发生变化。事件使用者不应依赖具有给定原因的事件的时机反映一致的基础触发器，也不应依赖具有该原因的事件的持续存在。事件应被视为信息性的、尽力而为的补充数据。

类型

对象

必需

  • eventTime

规格

属性 类型 描述

action

字符串

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

apiVersion

字符串

APIVersion 定义了对象的此表示的版本化模式。服务器应将识别的模式转换为最新的内部值，并可能拒绝无法识别的值。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources

deprecatedCount

整数

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

deprecatedFirstTimestamp

时间

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

deprecatedLastTimestamp

时间

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

deprecatedSource

EventSource

deprecatedSource 是确保与 core.v1 Event 类型向后兼容的已弃用字段。

eventTime

MicroTime

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

kind

字符串

Kind 是一个字符串值，表示此对象表示的 REST 资源。服务器可以从客户端提交请求的端点推断出这一点。无法更新。使用驼峰命名法。更多信息：https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds

metadata

ObjectMeta

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

note

字符串

note 字段是对该操作状态的人类可读描述。note 的最大长度为 1kB，但库应该能够处理高达 64kB 的值。

reason (原因)

字符串

reason 字段说明了采取该操作的原因。它是人类可读的。对于新的事件，此字段不能为空，并且最多可以包含 128 个字符。

regarding (关于)

ObjectReference (对象引用)

regarding 字段包含此事件相关的对象。在大多数情况下，它是报告控制器实现的对象，例如 ReplicaSetController 实现 ReplicaSet，并且由于它对 ReplicaSet 对象的一些更改采取了行动而发出了此事件。

related (相关)

ObjectReference (对象引用)

related 字段是可选的次要对象，用于更复杂的操作。例如，当 regarding 对象触发相关对象的创建或删除时。

reportingController (报告控制器)

字符串

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

reportingInstance (报告实例)

字符串

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

series (系列)

对象

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

type (类型)

字符串

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

.series

描述

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

类型

对象

必需

  • count (计数)

  • lastObservedTime (最后观察时间)

属性 类型 描述

count (计数)

整数

count 字段是直到最后一次心跳时间为止，此系列中事件发生的次数。

lastObservedTime (最后观察时间)

MicroTime

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

API 端点

提供以下 API 端点：

  • /apis/events.k8s.io/v1/events

    • GET：列出或监视 Event 类型的对象

  • /apis/events.k8s.io/v1/watch/events

    • GET：监视 Event 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。

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

    • DELETE：删除 Event 集合

    • GET：列出或监视 Event 类型的对象

    • POST：创建 Event

  • /apis/events.k8s.io/v1/watch/namespaces/{namespace}/events

    • GET：监视 Event 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。

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

    • DELETE：删除 Event

    • GET：读取指定的 Event

    • PATCH：部分更新指定的 Event

    • PUT：替换指定的 Event

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

    • GET：监视 Event 类型的对象的更改。已弃用：请改用列表操作中的“watch”参数，并使用“fieldSelector”参数将其过滤为单个项目。

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

HTTP 方法

GET

描述

列出或监视 Event 类型的对象

表 1. HTTP 响应
HTTP 代码 响应正文

200 - OK

EventList 模式

401 - 未授权

空

/apis/events.k8s.io/v1/watch/events

HTTP 方法

GET

描述

监视 Event 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。

表 2. HTTP 响应
HTTP 代码 响应正文

200 - OK

WatchEvent 模式

401 - 未授权

空

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

HTTP 方法

DELETE

描述

删除 Event 集合

表 3. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段
表 4. HTTP 响应
HTTP 代码 响应正文

200 - OK

Status 模式

401 - 未授权

空
HTTP 方法

GET

描述

列出或监视 Event 类型的对象

表 5. HTTP 响应
HTTP 代码 响应正文

200 - OK

EventList 模式

401 - 未授权

空
HTTP 方法

POST

描述

创建 Event

表 6. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被静默删除的对象的未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。
表 7. 主体参数
参数 类型 描述

body

Event 模式
表 8. HTTP 响应
HTTP 代码 响应正文

200 - OK

Event 模式

201 - 已创建

Event 模式

202 - 已接受

Event 模式

401 - 未授权

空

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

HTTP 方法

GET

描述

监视 Event 列表的单个更改。已弃用：请改用列表操作中的“watch”参数。

表 9. HTTP 响应
HTTP 代码 响应正文

200 - OK

WatchEvent 模式

401 - 未授权

空

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

表 10. 全局路径参数
参数 类型 描述

name

字符串

Event 的名称
HTTP 方法

DELETE

描述

删除 Event

表 11. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段
表 12. HTTP 响应
HTTP 代码 响应正文

200 - OK

Status 模式

202 - 已接受

Status 模式

401 - 未授权

空
HTTP 方法

GET

描述

读取指定的 Event

表 13. HTTP 响应
HTTP 代码 响应正文

200 - OK

Event 模式

401 - 未授权

空
HTTP 方法

PATCH

描述

部分更新指定的 Event

表 14. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被静默删除的对象的未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。
表 15. HTTP 响应
HTTP 代码 响应正文

200 - OK

Event 模式

201 - 已创建

Event 模式

401 - 未授权

空
HTTP 方法

PUT

描述

替换指定的 Event

表 16. 查询参数
参数 类型 描述

dryRun

字符串

如果存在，则表示不应持久化修改。无效或无法识别的 dryRun 指令将导致错误响应，并且不会进一步处理请求。有效值为：- All：将处理所有 dry run 阶段

fieldValidation

字符串

fieldValidation 指示服务器如何处理请求 (POST/PUT/PATCH) 中包含未知或重复字段的对象。有效值为：- Ignore：这将忽略任何被静默删除的对象的未知字段，并将忽略解码器遇到的除最后一个重复字段之外的所有重复字段。这是 v1.23 之前的默认行为。- Warn：这将通过标准警告响应标头为每个从对象中删除的未知字段和遇到的每个重复字段发送警告。如果没有任何其他错误，请求仍将成功，并且只会保留任何重复字段中的最后一个。这是 v1.23+ 的默认值 - Strict：如果任何未知字段将从对象中删除，或者存在任何重复字段，这将使请求失败并返回 BadRequest 错误。服务器返回的错误将包含遇到的所有未知和重复字段。
表 17. 主体参数
参数 类型 描述

body

Event 模式
表 18. HTTP 响应
HTTP 代码 响应正文

200 - OK

Event 模式

201 - 已创建

Event 模式

401 - 未授权

空

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

表 19. 全局路径参数
参数 类型 描述

name

字符串

Event 的名称
HTTP 方法

GET

描述

监视 Event 类型的对象的更改。已弃用：请改用列表操作中的“watch”参数，并使用“fieldSelector”参数将其过滤为单个项目。

表 20. HTTP 响应
HTTP 代码 响应正文

200 - OK

WatchEvent 模式

401 - 未授权

空