Standardize administrative state using AdminState enum across resources

This patch harmonizes the API for setting a administrative state on
resources using the AdminState enumeration and introduces this field for
protocols (BGP, OSPF, ISIS, PIM) and system level services (NTP, DNS).

Author: felix-kaestner

api/cisco/nx/v1alpha1/bordergateway_types.go

@@ -17,6 +17,11 @@ type BorderGatewaySpec struct {
 	// +kubebuilder:validation:XValidation:rule="self == oldSelf",message="DeviceRef is immutable"
 	DeviceRef v1alpha1.LocalObjectReference `json:"deviceRef"`
 
+	// AdminState indicates whether the BorderGateway instance is administratively up or down.
+	// +optional
+	// +kubebuilder:default=Up
+	AdminState v1alpha1.AdminState `json:"adminState,omitempty"`
+
 	// MultisiteID is the identifier for the multisite border gateway.
 	// +required
 	// +kubebuilder:validation:Minimum=1

api/core/v1alpha1/bgp_peer_types.go

@@ -21,6 +21,12 @@ type BGPPeerSpec struct {
 	// +optional
 	ProviderConfigRef *TypedLocalObjectReference `json:"providerConfigRef,omitempty"`
 
+	// AdminState indicates whether this BGP peer is administratively up or down.
+	// When Down, the BGP session with this peer is administratively shut down.
+	// +optional
+	// +kubebuilder:default=Up
+	AdminState AdminState `json:"adminState,omitempty"`
+
 	// Address is the IPv4 address of the BGP peer.
 	// +required
 	// +kubebuilder:validation:Format=ipv4

api/core/v1alpha1/bgp_types.go

@@ -21,6 +21,11 @@ type BGPSpec struct {
 	// +optional
 	ProviderConfigRef *TypedLocalObjectReference `json:"providerConfigRef,omitempty"`
 
+	// AdminState indicates whether this BGP router is administratively up or down.
+	// +optional
+	// +kubebuilder:default=Up
+	AdminState AdminState `json:"adminState,omitempty"`
+
 	// ASNumber is the autonomous system number (ASN) for the BGP router.
 	// Supports both plain format (1-4294967295) and dotted notation (1-65535.0-65535) as per RFC 5396.
 	// +required

api/core/v1alpha1/dns_types.go

@@ -20,6 +20,11 @@ type DNSSpec struct {
 	// +optional
 	ProviderConfigRef *TypedLocalObjectReference `json:"providerConfigRef,omitempty"`
 
+	// AdminState indicates whether DNS is administratively up or down.
+	// +optional
+	// +kubebuilder:default=Up
+	AdminState AdminState `json:"adminState,omitempty"`
+
 	// Default domain name that the device uses to complete unqualified hostnames.
 	// +required
 	// +kubebuilder:validation:MinLength=1

api/core/v1alpha1/interface_types.go

@@ -95,14 +95,16 @@ type InterfaceSpec struct {
 	BFD *BFD `json:"bfd,omitempty"`
 }
 
-// AdminState represents the administrative state of the interface.
+// AdminState represents the administrative state of a resource.
+// This type is used across multiple resources including interfaces, protocols (BGP, OSPF, ISIS, PIM),
+// and system services (NTP, DNS) to indicate whether these are administratively enabled or disabled.
 // +kubebuilder:validation:Enum=Up;Down
 type AdminState string
 
 const (
-	// AdminStateUp indicates that the interface is administratively set up.
+	// AdminStateUp indicates that the resource is administratively enabled.
 	AdminStateUp AdminState = "Up"
-	// AdminStateDown indicates that the interface is administratively set down.
+	// AdminStateDown indicates that the resource is administratively disabled.
 	AdminStateDown AdminState = "Down"
 )
 

api/core/v1alpha1/isis_types.go

@@ -20,6 +20,11 @@ type ISISSpec struct {
 	// +optional
 	ProviderConfigRef *TypedLocalObjectReference `json:"providerConfigRef,omitempty"`
 
+	// AdminState indicates whether the ISIS instance is administratively up or down.
+	// +optional
+	// +kubebuilder:default=Up
+	AdminState AdminState `json:"adminState,omitempty"`
+
 	// Instance is the name of the ISIS instance.
 	// +required
 	// +kubebuilder:validation:MinLength=1

api/core/v1alpha1/ntp_types.go

@@ -20,6 +20,11 @@ type NTPSpec struct {
 	// +optional
 	ProviderConfigRef *TypedLocalObjectReference `json:"providerConfigRef,omitempty"`
 
+	// AdminState indicates whether NTP is administratively up or down.
+	// +optional
+	// +kubebuilder:default=Up
+	AdminState AdminState `json:"adminState,omitempty"`
+
 	// Source interface for all NTP traffic.
 	// +required
 	// +kubebuilder:validation:MinLength=1

api/core/v1alpha1/ospf_types.go

@@ -20,6 +20,11 @@ type OSPFSpec struct {
 	// +optional
 	ProviderConfigRef *TypedLocalObjectReference `json:"providerConfigRef,omitempty"`
 
+	// AdminState indicates whether the OSPF instance is administratively up or down.
+	// +optional
+	// +kubebuilder:default=Up
+	AdminState AdminState `json:"adminState,omitempty"`
+
 	// Instance is the process tag of the OSPF instance.
 	// +required
 	// +kubebuilder:validation:MinLength=1

api/core/v1alpha1/pim_types.go

@@ -20,6 +20,11 @@ type PIMSpec struct {
 	// +optional
 	ProviderConfigRef *TypedLocalObjectReference `json:"providerConfigRef,omitempty"`
 
+	// AdminState indicates whether the PIM instance is administratively up or down.
+	// +optional
+	// +kubebuilder:default=Up
+	AdminState AdminState `json:"adminState,omitempty"`
+
 	// RendezvousPoints defines the list of rendezvous points for sparse mode multicast.
 	// +optional
 	// +listType=map

api/core/v1alpha1/ref_types.go

@@ -1,5 +1,6 @@
 // SPDX-FileCopyrightText: 2025 SAP SE or an SAP affiliate company and IronCore contributors
 // SPDX-License-Identifier: Apache-2.0
+
 package v1alpha1
 
 // LocalObjectReference contains enough information to locate a