blob: 18e3d0182e06d51f7fae1fddc05ae4c833293102 [file] [log] [blame]
Matteo Scandoloa4285862020-12-01 18:10:10 -08001/*
2Copyright The Kubernetes Authors.
3
4Licensed under the Apache License, Version 2.0 (the "License");
5you may not use this file except in compliance with the License.
6You may obtain a copy of the License at
7
8 http://www.apache.org/licenses/LICENSE-2.0
9
10Unless required by applicable law or agreed to in writing, software
11distributed under the License is distributed on an "AS IS" BASIS,
12WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13See the License for the specific language governing permissions and
14limitations under the License.
15*/
16
17
18// This file was autogenerated by go-to-protobuf. Do not edit it manually!
19
20syntax = 'proto2';
21
22package k8s.io.api.events.v1;
23
24import "k8s.io/api/core/v1/generated.proto";
25import "k8s.io/apimachinery/pkg/apis/meta/v1/generated.proto";
26import "k8s.io/apimachinery/pkg/runtime/generated.proto";
27import "k8s.io/apimachinery/pkg/runtime/schema/generated.proto";
28
29// Package-wide variables from generator "generated".
30option go_package = "v1";
31
32// Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system.
33message Event {
34 // +optional
35 optional k8s.io.apimachinery.pkg.apis.meta.v1.ObjectMeta metadata = 1;
36
37 // eventTime is the time when this Event was first observed. It is required.
38 optional k8s.io.apimachinery.pkg.apis.meta.v1.MicroTime eventTime = 2;
39
40 // series is data about the Event series this event represents or nil if it's a singleton Event.
41 // +optional
42 optional EventSeries series = 3;
43
44 // reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`.
45 // This field cannot be empty for new Events.
46 // +optional
47 optional string reportingController = 4;
48
49 // reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`.
50 // This field cannot be empty for new Events and it can have at most 128 characters.
51 // +optional
52 optional string reportingInstance = 5;
53
54 // action is what action was taken/failed regarding to the regarding object. It is machine-readable.
55 // This field can have at most 128 characters.
56 // +optional
57 optional string action = 6;
58
59 // reason is why the action was taken. It is human-readable.
60 // This field can have at most 128 characters.
61 // +optional
62 optional string reason = 7;
63
64 // regarding contains the object this Event is about. In most cases it's an Object reporting controller
65 // implements, e.g. ReplicaSetController implements ReplicaSets and this event is emitted because
66 // it acts on some changes in a ReplicaSet object.
67 // +optional
68 optional k8s.io.api.core.v1.ObjectReference regarding = 8;
69
70 // related is the optional secondary object for more complex actions. E.g. when regarding object triggers
71 // a creation or deletion of related object.
72 // +optional
73 optional k8s.io.api.core.v1.ObjectReference related = 9;
74
75 // note is a human-readable description of the status of this operation.
76 // Maximal length of the note is 1kB, but libraries should be prepared to
77 // handle values up to 64kB.
78 // +optional
79 optional string note = 10;
80
81 // type is the type of this event (Normal, Warning), new types could be added in the future.
82 // It is machine-readable.
83 // +optional
84 optional string type = 11;
85
86 // deprecatedSource is the deprecated field assuring backward compatibility with core.v1 Event type.
87 // +optional
88 optional k8s.io.api.core.v1.EventSource deprecatedSource = 12;
89
90 // deprecatedFirstTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type.
91 // +optional
92 optional k8s.io.apimachinery.pkg.apis.meta.v1.Time deprecatedFirstTimestamp = 13;
93
94 // deprecatedLastTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type.
95 // +optional
96 optional k8s.io.apimachinery.pkg.apis.meta.v1.Time deprecatedLastTimestamp = 14;
97
98 // deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type.
99 // +optional
100 optional int32 deprecatedCount = 15;
101}
102
103// EventList is a list of Event objects.
104message EventList {
105 // Standard list metadata.
106 // More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
107 // +optional
108 optional k8s.io.apimachinery.pkg.apis.meta.v1.ListMeta metadata = 1;
109
110 // items is a list of schema objects.
111 repeated Event items = 2;
112}
113
114// EventSeries contain information on series of events, i.e. thing that was/is happening
115// continuously for some time. How often to update the EventSeries is up to the event reporters.
116// The default event reporter in "k8s.io/client-go/tools/events/event_broadcaster.go" shows
117// how this struct is updated on heartbeats and can guide customized reporter implementations.
118message EventSeries {
119 // count is the number of occurrences in this series up to the last heartbeat time.
120 optional int32 count = 1;
121
122 // lastObservedTime is the time when last Event from the series was seen before last heartbeat.
123 optional k8s.io.apimachinery.pkg.apis.meta.v1.MicroTime lastObservedTime = 2;
124}
125