事件
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 是首次观察到此事件的时间。这是必需的。
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 类型向后兼容的弃用字段。
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”中的默认事件报告器显示了此结构如何在心跳时更新,并可以指导自定义报告器实现。
type (string)
type 是此事件的类型(正常、警告),将来可能会添加新类型。它是机器可读的。此字段对于新事件不能为空。
EventList
EventList 是事件对象列表。
apiVersion: events.k8s.io/v1
kind: EventList
metadata (ListMeta)
标准列表元数据。更多信息:https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
items ([]Event), required
items 是模式对象列表。
操作
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
参数
namespace (in path): string, required
allowWatchBookmarks (in query): boolean
continue (in query): string
fieldSelector (in query): string
labelSelector (in query): string
limit (in query): integer
pretty (in query): string
resourceVersion (in query): string
resourceVersionMatch (in query): string
sendInitialEvents (in query): boolean
timeoutSeconds (in query): integer
watch (in query): boolean
响应
200 (EventList): OK
401: 未授权
list
列出或观察 Event 类型的对象
HTTP 请求
GET /apis/events.k8s.io/v1/events
参数
allowWatchBookmarks (in query): boolean
continue (in query): string
fieldSelector (in query): string
labelSelector (in query): string
limit (in query): integer
pretty (in query): string
resourceVersion (in query): string
resourceVersionMatch (in query): string
sendInitialEvents (in query): boolean
timeoutSeconds (in query): integer
watch (in query): boolean
响应
200 (EventList): OK
401: 未授权
create
创建一个事件
HTTP 请求
POST /apis/events.k8s.io/v1/namespaces/{namespace}/events
参数
namespace (in path): string, required
body: Event, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
pretty (in query): string
响应
200 (Event): OK
201 (Event): Created
202 (Event): Accepted
401: 未授权
update
替换指定的事件
HTTP 请求
PUT /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
参数
name (in path): string, required
事件的名称
namespace (in path): string, required
body: Event, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
pretty (in query): string
响应
200 (Event): OK
201 (Event): Created
401: 未授权
patch
部分更新指定的事件
HTTP 请求
PATCH /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
参数
name (in path): string, required
事件的名称
namespace (in path): string, required
body: Patch, required
dryRun (in query): string
fieldManager (in query): string
fieldValidation (in query): string
force (in query): boolean
pretty (in query): string
响应
200 (Event): OK
201 (Event): Created
401: 未授权
delete
删除事件
HTTP 请求
DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events/{name}
参数
name (in path): string, required
事件的名称
namespace (in path): string, required
body: DeleteOptions
dryRun (in query): string
gracePeriodSeconds (in query): integer
pretty (in query): string
propagationPolicy (in query): string
响应
200 (Status): OK
202 (Status): Accepted
401: 未授权
deletecollection
删除 Event 集合
HTTP 请求
DELETE /apis/events.k8s.io/v1/namespaces/{namespace}/events
参数
namespace (in path): string, required
body: DeleteOptions
continue (in query): string
dryRun (in query): string
fieldSelector (in query): string
gracePeriodSeconds (in query): integer
labelSelector (in query): string
limit (in query): integer
pretty (in query): string
propagationPolicy (in query): string
resourceVersion (in query): string
resourceVersionMatch (in query): string
sendInitialEvents (in query): boolean
timeoutSeconds (in query): integer
响应
200 (Status): OK
401: 未授权
此页面是自动生成的。
如果您打算报告此页面的问题,请在您的问题描述中提及该页面是自动生成的。修复可能需要在 Kubernetes 项目的其他地方进行。