github.com/pulumi/pulumi-kubernetes/sdk/v3@v3.30.2/go/kubernetes/events/v1/event.go (about) 1 // Code generated by pulumigen DO NOT EDIT. 2 // *** WARNING: Do not edit by hand unless you're certain you know what you are doing! *** 3 4 package v1 5 6 import ( 7 "context" 8 "reflect" 9 10 "errors" 11 corev1 "github.com/pulumi/pulumi-kubernetes/sdk/v3/go/kubernetes/core/v1" 12 metav1 "github.com/pulumi/pulumi-kubernetes/sdk/v3/go/kubernetes/meta/v1" 13 "github.com/pulumi/pulumi/sdk/v3/go/pulumi" 14 ) 15 16 // Event is a report of an event somewhere in the cluster. It generally denotes some state change in the system. Events have a limited retention time and triggers and messages may evolve with time. Event consumers should not rely on the timing of an event with a given Reason reflecting a consistent underlying trigger, or the continued existence of events with that Reason. Events should be treated as informative, best-effort, supplemental data. 17 type Event struct { 18 pulumi.CustomResourceState 19 20 // action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field cannot be empty for new Events and it can have at most 128 characters. 21 Action pulumi.StringPtrOutput `pulumi:"action"` 22 // APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources 23 ApiVersion pulumi.StringPtrOutput `pulumi:"apiVersion"` 24 // deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type. 25 DeprecatedCount pulumi.IntPtrOutput `pulumi:"deprecatedCount"` 26 // deprecatedFirstTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type. 27 DeprecatedFirstTimestamp pulumi.StringPtrOutput `pulumi:"deprecatedFirstTimestamp"` 28 // deprecatedLastTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type. 29 DeprecatedLastTimestamp pulumi.StringPtrOutput `pulumi:"deprecatedLastTimestamp"` 30 // deprecatedSource is the deprecated field assuring backward compatibility with core.v1 Event type. 31 DeprecatedSource corev1.EventSourcePtrOutput `pulumi:"deprecatedSource"` 32 // eventTime is the time when this Event was first observed. It is required. 33 EventTime pulumi.StringOutput `pulumi:"eventTime"` 34 // Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 35 Kind pulumi.StringPtrOutput `pulumi:"kind"` 36 // Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 37 Metadata metav1.ObjectMetaPtrOutput `pulumi:"metadata"` 38 // note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB. 39 Note pulumi.StringPtrOutput `pulumi:"note"` 40 // reason is why the action was taken. It is human-readable. This field cannot be empty for new Events and it can have at most 128 characters. 41 Reason pulumi.StringPtrOutput `pulumi:"reason"` 42 // regarding contains the object this Event is about. In most cases it's an Object reporting controller implements, e.g. ReplicaSetController implements ReplicaSets and this event is emitted because it acts on some changes in a ReplicaSet object. 43 Regarding corev1.ObjectReferencePtrOutput `pulumi:"regarding"` 44 // related is the optional secondary object for more complex actions. E.g. when regarding object triggers a creation or deletion of related object. 45 Related corev1.ObjectReferencePtrOutput `pulumi:"related"` 46 // reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`. This field cannot be empty for new Events. 47 ReportingController pulumi.StringPtrOutput `pulumi:"reportingController"` 48 // reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters. 49 ReportingInstance pulumi.StringPtrOutput `pulumi:"reportingInstance"` 50 // series is data about the Event series this event represents or nil if it's a singleton Event. 51 Series EventSeriesPtrOutput `pulumi:"series"` 52 // type is the type of this event (Normal, Warning), new types could be added in the future. It is machine-readable. This field cannot be empty for new Events. 53 Type pulumi.StringPtrOutput `pulumi:"type"` 54 } 55 56 // NewEvent registers a new resource with the given unique name, arguments, and options. 57 func NewEvent(ctx *pulumi.Context, 58 name string, args *EventArgs, opts ...pulumi.ResourceOption) (*Event, error) { 59 if args == nil { 60 return nil, errors.New("missing one or more required arguments") 61 } 62 63 if args.EventTime == nil { 64 return nil, errors.New("invalid value for required argument 'EventTime'") 65 } 66 args.ApiVersion = pulumi.StringPtr("events.k8s.io/v1") 67 args.Kind = pulumi.StringPtr("Event") 68 aliases := pulumi.Aliases([]pulumi.Alias{ 69 { 70 Type: pulumi.String("kubernetes:core/v1:Event"), 71 }, 72 { 73 Type: pulumi.String("kubernetes:events.k8s.io/v1beta1:Event"), 74 }, 75 }) 76 opts = append(opts, aliases) 77 var resource Event 78 err := ctx.RegisterResource("kubernetes:events.k8s.io/v1:Event", name, args, &resource, opts...) 79 if err != nil { 80 return nil, err 81 } 82 return &resource, nil 83 } 84 85 // GetEvent gets an existing Event resource's state with the given name, ID, and optional 86 // state properties that are used to uniquely qualify the lookup (nil if not required). 87 func GetEvent(ctx *pulumi.Context, 88 name string, id pulumi.IDInput, state *EventState, opts ...pulumi.ResourceOption) (*Event, error) { 89 var resource Event 90 err := ctx.ReadResource("kubernetes:events.k8s.io/v1:Event", name, id, state, &resource, opts...) 91 if err != nil { 92 return nil, err 93 } 94 return &resource, nil 95 } 96 97 // Input properties used for looking up and filtering Event resources. 98 type eventState struct { 99 } 100 101 type EventState struct { 102 } 103 104 func (EventState) ElementType() reflect.Type { 105 return reflect.TypeOf((*eventState)(nil)).Elem() 106 } 107 108 type eventArgs struct { 109 // action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field cannot be empty for new Events and it can have at most 128 characters. 110 Action *string `pulumi:"action"` 111 // APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources 112 ApiVersion *string `pulumi:"apiVersion"` 113 // deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type. 114 DeprecatedCount *int `pulumi:"deprecatedCount"` 115 // deprecatedFirstTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type. 116 DeprecatedFirstTimestamp *string `pulumi:"deprecatedFirstTimestamp"` 117 // deprecatedLastTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type. 118 DeprecatedLastTimestamp *string `pulumi:"deprecatedLastTimestamp"` 119 // deprecatedSource is the deprecated field assuring backward compatibility with core.v1 Event type. 120 DeprecatedSource *corev1.EventSource `pulumi:"deprecatedSource"` 121 // eventTime is the time when this Event was first observed. It is required. 122 EventTime string `pulumi:"eventTime"` 123 // Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 124 Kind *string `pulumi:"kind"` 125 // Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 126 Metadata *metav1.ObjectMeta `pulumi:"metadata"` 127 // note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB. 128 Note *string `pulumi:"note"` 129 // reason is why the action was taken. It is human-readable. This field cannot be empty for new Events and it can have at most 128 characters. 130 Reason *string `pulumi:"reason"` 131 // regarding contains the object this Event is about. In most cases it's an Object reporting controller implements, e.g. ReplicaSetController implements ReplicaSets and this event is emitted because it acts on some changes in a ReplicaSet object. 132 Regarding *corev1.ObjectReference `pulumi:"regarding"` 133 // related is the optional secondary object for more complex actions. E.g. when regarding object triggers a creation or deletion of related object. 134 Related *corev1.ObjectReference `pulumi:"related"` 135 // reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`. This field cannot be empty for new Events. 136 ReportingController *string `pulumi:"reportingController"` 137 // reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters. 138 ReportingInstance *string `pulumi:"reportingInstance"` 139 // series is data about the Event series this event represents or nil if it's a singleton Event. 140 Series *EventSeries `pulumi:"series"` 141 // type is the type of this event (Normal, Warning), new types could be added in the future. It is machine-readable. This field cannot be empty for new Events. 142 Type *string `pulumi:"type"` 143 } 144 145 // The set of arguments for constructing a Event resource. 146 type EventArgs struct { 147 // action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field cannot be empty for new Events and it can have at most 128 characters. 148 Action pulumi.StringPtrInput 149 // APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources 150 ApiVersion pulumi.StringPtrInput 151 // deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type. 152 DeprecatedCount pulumi.IntPtrInput 153 // deprecatedFirstTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type. 154 DeprecatedFirstTimestamp pulumi.StringPtrInput 155 // deprecatedLastTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type. 156 DeprecatedLastTimestamp pulumi.StringPtrInput 157 // deprecatedSource is the deprecated field assuring backward compatibility with core.v1 Event type. 158 DeprecatedSource corev1.EventSourcePtrInput 159 // eventTime is the time when this Event was first observed. It is required. 160 EventTime pulumi.StringInput 161 // Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 162 Kind pulumi.StringPtrInput 163 // Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 164 Metadata metav1.ObjectMetaPtrInput 165 // note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB. 166 Note pulumi.StringPtrInput 167 // reason is why the action was taken. It is human-readable. This field cannot be empty for new Events and it can have at most 128 characters. 168 Reason pulumi.StringPtrInput 169 // regarding contains the object this Event is about. In most cases it's an Object reporting controller implements, e.g. ReplicaSetController implements ReplicaSets and this event is emitted because it acts on some changes in a ReplicaSet object. 170 Regarding corev1.ObjectReferencePtrInput 171 // related is the optional secondary object for more complex actions. E.g. when regarding object triggers a creation or deletion of related object. 172 Related corev1.ObjectReferencePtrInput 173 // reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`. This field cannot be empty for new Events. 174 ReportingController pulumi.StringPtrInput 175 // reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters. 176 ReportingInstance pulumi.StringPtrInput 177 // series is data about the Event series this event represents or nil if it's a singleton Event. 178 Series EventSeriesPtrInput 179 // type is the type of this event (Normal, Warning), new types could be added in the future. It is machine-readable. This field cannot be empty for new Events. 180 Type pulumi.StringPtrInput 181 } 182 183 func (EventArgs) ElementType() reflect.Type { 184 return reflect.TypeOf((*eventArgs)(nil)).Elem() 185 } 186 187 type EventInput interface { 188 pulumi.Input 189 190 ToEventOutput() EventOutput 191 ToEventOutputWithContext(ctx context.Context) EventOutput 192 } 193 194 func (*Event) ElementType() reflect.Type { 195 return reflect.TypeOf((**Event)(nil)).Elem() 196 } 197 198 func (i *Event) ToEventOutput() EventOutput { 199 return i.ToEventOutputWithContext(context.Background()) 200 } 201 202 func (i *Event) ToEventOutputWithContext(ctx context.Context) EventOutput { 203 return pulumi.ToOutputWithContext(ctx, i).(EventOutput) 204 } 205 206 // EventArrayInput is an input type that accepts EventArray and EventArrayOutput values. 207 // You can construct a concrete instance of `EventArrayInput` via: 208 // 209 // EventArray{ EventArgs{...} } 210 type EventArrayInput interface { 211 pulumi.Input 212 213 ToEventArrayOutput() EventArrayOutput 214 ToEventArrayOutputWithContext(context.Context) EventArrayOutput 215 } 216 217 type EventArray []EventInput 218 219 func (EventArray) ElementType() reflect.Type { 220 return reflect.TypeOf((*[]*Event)(nil)).Elem() 221 } 222 223 func (i EventArray) ToEventArrayOutput() EventArrayOutput { 224 return i.ToEventArrayOutputWithContext(context.Background()) 225 } 226 227 func (i EventArray) ToEventArrayOutputWithContext(ctx context.Context) EventArrayOutput { 228 return pulumi.ToOutputWithContext(ctx, i).(EventArrayOutput) 229 } 230 231 // EventMapInput is an input type that accepts EventMap and EventMapOutput values. 232 // You can construct a concrete instance of `EventMapInput` via: 233 // 234 // EventMap{ "key": EventArgs{...} } 235 type EventMapInput interface { 236 pulumi.Input 237 238 ToEventMapOutput() EventMapOutput 239 ToEventMapOutputWithContext(context.Context) EventMapOutput 240 } 241 242 type EventMap map[string]EventInput 243 244 func (EventMap) ElementType() reflect.Type { 245 return reflect.TypeOf((*map[string]*Event)(nil)).Elem() 246 } 247 248 func (i EventMap) ToEventMapOutput() EventMapOutput { 249 return i.ToEventMapOutputWithContext(context.Background()) 250 } 251 252 func (i EventMap) ToEventMapOutputWithContext(ctx context.Context) EventMapOutput { 253 return pulumi.ToOutputWithContext(ctx, i).(EventMapOutput) 254 } 255 256 type EventOutput struct{ *pulumi.OutputState } 257 258 func (EventOutput) ElementType() reflect.Type { 259 return reflect.TypeOf((**Event)(nil)).Elem() 260 } 261 262 func (o EventOutput) ToEventOutput() EventOutput { 263 return o 264 } 265 266 func (o EventOutput) ToEventOutputWithContext(ctx context.Context) EventOutput { 267 return o 268 } 269 270 // action is what action was taken/failed regarding to the regarding object. It is machine-readable. This field cannot be empty for new Events and it can have at most 128 characters. 271 func (o EventOutput) Action() pulumi.StringPtrOutput { 272 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.Action }).(pulumi.StringPtrOutput) 273 } 274 275 // APIVersion defines the versioned schema of this representation of an object. Servers should convert recognized schemas to the latest internal value, and may reject unrecognized values. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#resources 276 func (o EventOutput) ApiVersion() pulumi.StringPtrOutput { 277 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.ApiVersion }).(pulumi.StringPtrOutput) 278 } 279 280 // deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type. 281 func (o EventOutput) DeprecatedCount() pulumi.IntPtrOutput { 282 return o.ApplyT(func(v *Event) pulumi.IntPtrOutput { return v.DeprecatedCount }).(pulumi.IntPtrOutput) 283 } 284 285 // deprecatedFirstTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type. 286 func (o EventOutput) DeprecatedFirstTimestamp() pulumi.StringPtrOutput { 287 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.DeprecatedFirstTimestamp }).(pulumi.StringPtrOutput) 288 } 289 290 // deprecatedLastTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type. 291 func (o EventOutput) DeprecatedLastTimestamp() pulumi.StringPtrOutput { 292 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.DeprecatedLastTimestamp }).(pulumi.StringPtrOutput) 293 } 294 295 // deprecatedSource is the deprecated field assuring backward compatibility with core.v1 Event type. 296 func (o EventOutput) DeprecatedSource() corev1.EventSourcePtrOutput { 297 return o.ApplyT(func(v *Event) corev1.EventSourcePtrOutput { return v.DeprecatedSource }).(corev1.EventSourcePtrOutput) 298 } 299 300 // eventTime is the time when this Event was first observed. It is required. 301 func (o EventOutput) EventTime() pulumi.StringOutput { 302 return o.ApplyT(func(v *Event) pulumi.StringOutput { return v.EventTime }).(pulumi.StringOutput) 303 } 304 305 // Kind is a string value representing the REST resource this object represents. Servers may infer this from the endpoint the client submits requests to. Cannot be updated. In CamelCase. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#types-kinds 306 func (o EventOutput) Kind() pulumi.StringPtrOutput { 307 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.Kind }).(pulumi.StringPtrOutput) 308 } 309 310 // Standard object's metadata. More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata 311 func (o EventOutput) Metadata() metav1.ObjectMetaPtrOutput { 312 return o.ApplyT(func(v *Event) metav1.ObjectMetaPtrOutput { return v.Metadata }).(metav1.ObjectMetaPtrOutput) 313 } 314 315 // note is a human-readable description of the status of this operation. Maximal length of the note is 1kB, but libraries should be prepared to handle values up to 64kB. 316 func (o EventOutput) Note() pulumi.StringPtrOutput { 317 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.Note }).(pulumi.StringPtrOutput) 318 } 319 320 // reason is why the action was taken. It is human-readable. This field cannot be empty for new Events and it can have at most 128 characters. 321 func (o EventOutput) Reason() pulumi.StringPtrOutput { 322 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.Reason }).(pulumi.StringPtrOutput) 323 } 324 325 // regarding contains the object this Event is about. In most cases it's an Object reporting controller implements, e.g. ReplicaSetController implements ReplicaSets and this event is emitted because it acts on some changes in a ReplicaSet object. 326 func (o EventOutput) Regarding() corev1.ObjectReferencePtrOutput { 327 return o.ApplyT(func(v *Event) corev1.ObjectReferencePtrOutput { return v.Regarding }).(corev1.ObjectReferencePtrOutput) 328 } 329 330 // related is the optional secondary object for more complex actions. E.g. when regarding object triggers a creation or deletion of related object. 331 func (o EventOutput) Related() corev1.ObjectReferencePtrOutput { 332 return o.ApplyT(func(v *Event) corev1.ObjectReferencePtrOutput { return v.Related }).(corev1.ObjectReferencePtrOutput) 333 } 334 335 // reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`. This field cannot be empty for new Events. 336 func (o EventOutput) ReportingController() pulumi.StringPtrOutput { 337 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.ReportingController }).(pulumi.StringPtrOutput) 338 } 339 340 // reportingInstance is the ID of the controller instance, e.g. `kubelet-xyzf`. This field cannot be empty for new Events and it can have at most 128 characters. 341 func (o EventOutput) ReportingInstance() pulumi.StringPtrOutput { 342 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.ReportingInstance }).(pulumi.StringPtrOutput) 343 } 344 345 // series is data about the Event series this event represents or nil if it's a singleton Event. 346 func (o EventOutput) Series() EventSeriesPtrOutput { 347 return o.ApplyT(func(v *Event) EventSeriesPtrOutput { return v.Series }).(EventSeriesPtrOutput) 348 } 349 350 // type is the type of this event (Normal, Warning), new types could be added in the future. It is machine-readable. This field cannot be empty for new Events. 351 func (o EventOutput) Type() pulumi.StringPtrOutput { 352 return o.ApplyT(func(v *Event) pulumi.StringPtrOutput { return v.Type }).(pulumi.StringPtrOutput) 353 } 354 355 type EventArrayOutput struct{ *pulumi.OutputState } 356 357 func (EventArrayOutput) ElementType() reflect.Type { 358 return reflect.TypeOf((*[]*Event)(nil)).Elem() 359 } 360 361 func (o EventArrayOutput) ToEventArrayOutput() EventArrayOutput { 362 return o 363 } 364 365 func (o EventArrayOutput) ToEventArrayOutputWithContext(ctx context.Context) EventArrayOutput { 366 return o 367 } 368 369 func (o EventArrayOutput) Index(i pulumi.IntInput) EventOutput { 370 return pulumi.All(o, i).ApplyT(func(vs []interface{}) *Event { 371 return vs[0].([]*Event)[vs[1].(int)] 372 }).(EventOutput) 373 } 374 375 type EventMapOutput struct{ *pulumi.OutputState } 376 377 func (EventMapOutput) ElementType() reflect.Type { 378 return reflect.TypeOf((*map[string]*Event)(nil)).Elem() 379 } 380 381 func (o EventMapOutput) ToEventMapOutput() EventMapOutput { 382 return o 383 } 384 385 func (o EventMapOutput) ToEventMapOutputWithContext(ctx context.Context) EventMapOutput { 386 return o 387 } 388 389 func (o EventMapOutput) MapIndex(k pulumi.StringInput) EventOutput { 390 return pulumi.All(o, k).ApplyT(func(vs []interface{}) *Event { 391 return vs[0].(map[string]*Event)[vs[1].(string)] 392 }).(EventOutput) 393 } 394 395 func init() { 396 pulumi.RegisterInputType(reflect.TypeOf((*EventInput)(nil)).Elem(), &Event{}) 397 pulumi.RegisterInputType(reflect.TypeOf((*EventArrayInput)(nil)).Elem(), EventArray{}) 398 pulumi.RegisterInputType(reflect.TypeOf((*EventMapInput)(nil)).Elem(), EventMap{}) 399 pulumi.RegisterOutputType(EventOutput{}) 400 pulumi.RegisterOutputType(EventArrayOutput{}) 401 pulumi.RegisterOutputType(EventMapOutput{}) 402 }