v1beta1

package
v0.36.0 Latest Latest
Warning

This package is not in the latest version of its module.

Go to latest
Published: Apr 22, 2026 License: Apache-2.0 Imports: 7 Imported by: 18

Documentation

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type EventApplyConfiguration

type EventApplyConfiguration struct {
	v1.TypeMetaApplyConfiguration `json:",inline"`
	// Standard object's metadata.
	// More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#metadata
	*v1.ObjectMetaApplyConfiguration `json:"metadata,omitempty"`
	// eventTime is the time when this Event was first observed. It is required.
	EventTime *metav1.MicroTime `json:"eventTime,omitempty"`
	// series is data about the Event series this event represents or nil if it's a singleton Event.
	Series *EventSeriesApplyConfiguration `json:"series,omitempty"`
	// reportingController is the name of the controller that emitted this Event, e.g. `kubernetes.io/kubelet`.
	// This field cannot be empty for new Events.
	ReportingController *string `json:"reportingController,omitempty"`
	// 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.
	ReportingInstance *string `json:"reportingInstance,omitempty"`
	// action is what action was taken/failed regarding to the regarding object. It is machine-readable.
	// This field can have at most 128 characters.
	Action *string `json:"action,omitempty"`
	// reason is why the action was taken. It is human-readable.
	// This field can have at most 128 characters.
	Reason *string `json:"reason,omitempty"`
	// 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.
	Regarding *corev1.ObjectReferenceApplyConfiguration `json:"regarding,omitempty"`
	// related is the optional secondary object for more complex actions. E.g. when regarding object triggers
	// a creation or deletion of related object.
	Related *corev1.ObjectReferenceApplyConfiguration `json:"related,omitempty"`
	// 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.
	Note *string `json:"note,omitempty"`
	// type is the type of this event (Normal, Warning), new types could be added in the future.
	// It is machine-readable.
	Type *string `json:"type,omitempty"`
	// deprecatedSource is the deprecated field assuring backward compatibility with core.v1 Event type.
	DeprecatedSource *corev1.EventSourceApplyConfiguration `json:"deprecatedSource,omitempty"`
	// deprecatedFirstTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type.
	DeprecatedFirstTimestamp *metav1.Time `json:"deprecatedFirstTimestamp,omitempty"`
	// deprecatedLastTimestamp is the deprecated field assuring backward compatibility with core.v1 Event type.
	DeprecatedLastTimestamp *metav1.Time `json:"deprecatedLastTimestamp,omitempty"`
	// deprecatedCount is the deprecated field assuring backward compatibility with core.v1 Event type.
	DeprecatedCount *int32 `json:"deprecatedCount,omitempty"`
}

EventApplyConfiguration represents a declarative configuration of the Event type for use with apply.

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.

func Event

func Event(name, namespace string) *EventApplyConfiguration

Event constructs a declarative configuration of the Event type for use with apply.

func ExtractEvent

func ExtractEvent(event *eventsv1beta1.Event, fieldManager string) (*EventApplyConfiguration, error)

ExtractEvent extracts the applied configuration owned by fieldManager from event. If no managedFields are found in event for fieldManager, a EventApplyConfiguration is returned with only the Name, Namespace (if applicable), APIVersion and Kind populated. It is possible that no managed fields were found for because other field managers have taken ownership of all the fields previously owned by fieldManager, or because the fieldManager never owned fields any fields. event must be a unmodified Event API object that was retrieved from the Kubernetes API. ExtractEvent provides a way to perform a extract/modify-in-place/apply workflow. Note that an extracted apply configuration will contain fewer fields than what the fieldManager previously applied if another fieldManager has updated or force applied any of the previously applied fields.

func ExtractEventFrom added in v0.35.0

func ExtractEventFrom(event *eventsv1beta1.Event, fieldManager string, subresource string) (*EventApplyConfiguration, error)

ExtractEventFrom extracts the applied configuration owned by fieldManager from event for the specified subresource. Pass an empty string for subresource to extract the main resource. Common subresources include "status", "scale", etc. event must be a unmodified Event API object that was retrieved from the Kubernetes API. ExtractEventFrom provides a way to perform a extract/modify-in-place/apply workflow. Note that an extracted apply configuration will contain fewer fields than what the fieldManager previously applied if another fieldManager has updated or force applied any of the previously applied fields.

func (*EventApplyConfiguration) GetAPIVersion added in v0.34.0

func (b *EventApplyConfiguration) GetAPIVersion() *string

GetAPIVersion retrieves the value of the APIVersion field in the declarative configuration.

func (*EventApplyConfiguration) GetKind added in v0.34.0

func (b *EventApplyConfiguration) GetKind() *string

GetKind retrieves the value of the Kind field in the declarative configuration.

func (*EventApplyConfiguration) GetName added in v0.31.0

func (b *EventApplyConfiguration) GetName() *string

GetName retrieves the value of the Name field in the declarative configuration.

func (*EventApplyConfiguration) GetNamespace added in v0.34.0

func (b *EventApplyConfiguration) GetNamespace() *string

GetNamespace retrieves the value of the Namespace field in the declarative configuration.

func (EventApplyConfiguration) IsApplyConfiguration added in v0.34.0

func (b EventApplyConfiguration) IsApplyConfiguration()

func (*EventApplyConfiguration) WithAPIVersion

func (b *EventApplyConfiguration) WithAPIVersion(value string) *EventApplyConfiguration

WithAPIVersion sets the APIVersion field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the APIVersion field is set to the value of the last call.

func (*EventApplyConfiguration) WithAction

WithAction sets the Action field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Action field is set to the value of the last call.

func (*EventApplyConfiguration) WithAnnotations

func (b *EventApplyConfiguration) WithAnnotations(entries map[string]string) *EventApplyConfiguration

WithAnnotations puts the entries into the Annotations field in the declarative configuration and returns the receiver, so that objects can be build by chaining "With" function invocations. If called multiple times, the entries provided by each call will be put on the Annotations field, overwriting an existing map entries in Annotations field with the same key.

func (*EventApplyConfiguration) WithCreationTimestamp

func (b *EventApplyConfiguration) WithCreationTimestamp(value metav1.Time) *EventApplyConfiguration

WithCreationTimestamp sets the CreationTimestamp field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the CreationTimestamp field is set to the value of the last call.

func (*EventApplyConfiguration) WithDeletionGracePeriodSeconds

func (b *EventApplyConfiguration) WithDeletionGracePeriodSeconds(value int64) *EventApplyConfiguration

WithDeletionGracePeriodSeconds sets the DeletionGracePeriodSeconds field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the DeletionGracePeriodSeconds field is set to the value of the last call.

func (*EventApplyConfiguration) WithDeletionTimestamp

func (b *EventApplyConfiguration) WithDeletionTimestamp(value metav1.Time) *EventApplyConfiguration

WithDeletionTimestamp sets the DeletionTimestamp field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the DeletionTimestamp field is set to the value of the last call.

func (*EventApplyConfiguration) WithDeprecatedCount

func (b *EventApplyConfiguration) WithDeprecatedCount(value int32) *EventApplyConfiguration

WithDeprecatedCount sets the DeprecatedCount field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the DeprecatedCount field is set to the value of the last call.

func (*EventApplyConfiguration) WithDeprecatedFirstTimestamp

func (b *EventApplyConfiguration) WithDeprecatedFirstTimestamp(value metav1.Time) *EventApplyConfiguration

WithDeprecatedFirstTimestamp sets the DeprecatedFirstTimestamp field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the DeprecatedFirstTimestamp field is set to the value of the last call.

func (*EventApplyConfiguration) WithDeprecatedLastTimestamp

func (b *EventApplyConfiguration) WithDeprecatedLastTimestamp(value metav1.Time) *EventApplyConfiguration

WithDeprecatedLastTimestamp sets the DeprecatedLastTimestamp field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the DeprecatedLastTimestamp field is set to the value of the last call.

func (*EventApplyConfiguration) WithDeprecatedSource

WithDeprecatedSource sets the DeprecatedSource field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the DeprecatedSource field is set to the value of the last call.

func (*EventApplyConfiguration) WithEventTime

WithEventTime sets the EventTime field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the EventTime field is set to the value of the last call.

func (*EventApplyConfiguration) WithFinalizers

func (b *EventApplyConfiguration) WithFinalizers(values ...string) *EventApplyConfiguration

WithFinalizers adds the given value to the Finalizers field in the declarative configuration and returns the receiver, so that objects can be build by chaining "With" function invocations. If called multiple times, values provided by each call will be appended to the Finalizers field.

func (*EventApplyConfiguration) WithGenerateName

func (b *EventApplyConfiguration) WithGenerateName(value string) *EventApplyConfiguration

WithGenerateName sets the GenerateName field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the GenerateName field is set to the value of the last call.

func (*EventApplyConfiguration) WithGeneration

func (b *EventApplyConfiguration) WithGeneration(value int64) *EventApplyConfiguration

WithGeneration sets the Generation field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Generation field is set to the value of the last call.

func (*EventApplyConfiguration) WithKind

WithKind sets the Kind field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Kind field is set to the value of the last call.

func (*EventApplyConfiguration) WithLabels

func (b *EventApplyConfiguration) WithLabels(entries map[string]string) *EventApplyConfiguration

WithLabels puts the entries into the Labels field in the declarative configuration and returns the receiver, so that objects can be build by chaining "With" function invocations. If called multiple times, the entries provided by each call will be put on the Labels field, overwriting an existing map entries in Labels field with the same key.

func (*EventApplyConfiguration) WithName

WithName sets the Name field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Name field is set to the value of the last call.

func (*EventApplyConfiguration) WithNamespace

func (b *EventApplyConfiguration) WithNamespace(value string) *EventApplyConfiguration

WithNamespace sets the Namespace field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Namespace field is set to the value of the last call.

func (*EventApplyConfiguration) WithNote

WithNote sets the Note field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Note field is set to the value of the last call.

func (*EventApplyConfiguration) WithOwnerReferences

WithOwnerReferences adds the given value to the OwnerReferences field in the declarative configuration and returns the receiver, so that objects can be build by chaining "With" function invocations. If called multiple times, values provided by each call will be appended to the OwnerReferences field.

func (*EventApplyConfiguration) WithReason

WithReason sets the Reason field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Reason field is set to the value of the last call.

func (*EventApplyConfiguration) WithRegarding

WithRegarding sets the Regarding field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Regarding field is set to the value of the last call.

func (*EventApplyConfiguration) WithRelated

WithRelated sets the Related field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Related field is set to the value of the last call.

func (*EventApplyConfiguration) WithReportingController

func (b *EventApplyConfiguration) WithReportingController(value string) *EventApplyConfiguration

WithReportingController sets the ReportingController field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the ReportingController field is set to the value of the last call.

func (*EventApplyConfiguration) WithReportingInstance

func (b *EventApplyConfiguration) WithReportingInstance(value string) *EventApplyConfiguration

WithReportingInstance sets the ReportingInstance field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the ReportingInstance field is set to the value of the last call.

func (*EventApplyConfiguration) WithResourceVersion

func (b *EventApplyConfiguration) WithResourceVersion(value string) *EventApplyConfiguration

WithResourceVersion sets the ResourceVersion field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the ResourceVersion field is set to the value of the last call.

func (*EventApplyConfiguration) WithSeries

WithSeries sets the Series field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Series field is set to the value of the last call.

func (*EventApplyConfiguration) WithType

WithType sets the Type field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Type field is set to the value of the last call.

func (*EventApplyConfiguration) WithUID

WithUID sets the UID field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the UID field is set to the value of the last call.

type EventSeriesApplyConfiguration

type EventSeriesApplyConfiguration struct {
	// count is the number of occurrences in this series up to the last heartbeat time.
	Count *int32 `json:"count,omitempty"`
	// lastObservedTime is the time when last Event from the series was seen before last heartbeat.
	LastObservedTime *v1.MicroTime `json:"lastObservedTime,omitempty"`
}

EventSeriesApplyConfiguration represents a declarative configuration of the EventSeries type for use with apply.

EventSeries contain information on series of events, i.e. thing that was/is happening continuously for some time.

func EventSeries

func EventSeries() *EventSeriesApplyConfiguration

EventSeriesApplyConfiguration constructs a declarative configuration of the EventSeries type for use with apply.

func (*EventSeriesApplyConfiguration) WithCount

WithCount sets the Count field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the Count field is set to the value of the last call.

func (*EventSeriesApplyConfiguration) WithLastObservedTime

WithLastObservedTime sets the LastObservedTime field in the declarative configuration to the given value and returns the receiver, so that objects can be built by chaining "With" function invocations. If called multiple times, the LastObservedTime field is set to the value of the last call.

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL