Standardize administrative state using AdminState enum across resources

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

api/core/v1alpha1/vlan_types.go

@@ -37,21 +37,10 @@ type VLANSpec struct {
 
 	// AdminState indicates whether the VLAN is administratively active or inactive/suspended.
 	// +optional
-	// +kubebuilder:default=Active
-	AdminState VLANState `json:"adminState"`
+	// +kubebuilder:default=Up
+	AdminState AdminState `json:"adminState,omitempty"`
 }
 
-// VLANState represents the administrative state of the VLAN.
-// +kubebuilder:validation:Enum=Active;Suspended
-type VLANState string
-
-const (
-	// VLANStateActive indicates that the VLAN is administratively active.
-	VLANStateActive VLANState = "Active"
-	// VLANStateSuspended indicates that the VLAN is administratively inactive/suspended.
-	VLANStateSuspended VLANState = "Suspended"
-)
-
 // VLANStatus defines the observed state of VLAN.
 type VLANStatus struct {
 	// The conditions are a list of status objects that describe the state of the VLAN.

charts/network-operator/templates/crd/networking.metal.ironcore.dev_bgp.yaml

@@ -228,6 +228,14 @@ spec:
                         type: object
                     type: object
                 type: object
+              adminState:
+                default: Up
+                description: AdminState indicates whether this BGP router is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               asNumber:
                 anyOf:
                 - type: integer

charts/network-operator/templates/crd/networking.metal.ironcore.dev_bgppeers.yaml

@@ -165,6 +165,15 @@ spec:
                         type: string
                     type: object
                 type: object
+              adminState:
+                default: Up
+                description: |-
+                  AdminState indicates whether this BGP peer is administratively up or down.
+                  When Down, the BGP session with this peer is administratively shut down.
+                enum:
+                - Up
+                - Down
+                type: string
               asNumber:
                 anyOf:
                 - type: integer

charts/network-operator/templates/crd/networking.metal.ironcore.dev_dns.yaml

@@ -57,6 +57,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether DNS is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

charts/network-operator/templates/crd/networking.metal.ironcore.dev_isis.yaml

@@ -71,6 +71,14 @@ spec:
                 minItems: 1
                 type: array
                 x-kubernetes-list-type: set
+              adminState:
+                default: Up
+                description: AdminState indicates whether the ISIS instance is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

charts/network-operator/templates/crd/networking.metal.ironcore.dev_ntp.yaml

@@ -57,6 +57,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether NTP is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

charts/network-operator/templates/crd/networking.metal.ironcore.dev_ospf.yaml

@@ -75,6 +75,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether the OSPF instance is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

charts/network-operator/templates/crd/networking.metal.ironcore.dev_pim.yaml

@@ -57,6 +57,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether the PIM instance is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

charts/network-operator/templates/crd/networking.metal.ironcore.dev_vlans.yaml

@@ -72,12 +72,12 @@ spec:
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
               adminState:
-                default: Active
+                default: Up
                 description: AdminState indicates whether the VLAN is administratively
                   active or inactive/suspended.
                 enum:
-                - Active
-                - Suspended
+                - Up
+                - Down
                 type: string
               deviceRef:
                 description: |-

charts/network-operator/templates/crd/nx.cisco.networking.metal.ironcore.dev_bordergateways.yaml

@@ -59,6 +59,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether the BorderGateway instance
+                  is administratively up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               bgpPeerRefs:
                 description: |-
                   BGPPeerRefs is a list of BGP peers that are part of the border gateway configuration.

config/crd/bases/networking.metal.ironcore.dev_bgp.yaml

@@ -222,6 +222,14 @@ spec:
                         type: object
                     type: object
                 type: object
+              adminState:
+                default: Up
+                description: AdminState indicates whether this BGP router is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               asNumber:
                 anyOf:
                 - type: integer

config/crd/bases/networking.metal.ironcore.dev_bgppeers.yaml

@@ -159,6 +159,15 @@ spec:
                         type: string
                     type: object
                 type: object
+              adminState:
+                default: Up
+                description: |-
+                  AdminState indicates whether this BGP peer is administratively up or down.
+                  When Down, the BGP session with this peer is administratively shut down.
+                enum:
+                - Up
+                - Down
+                type: string
               asNumber:
                 anyOf:
                 - type: integer

config/crd/bases/networking.metal.ironcore.dev_dns.yaml

@@ -51,6 +51,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether DNS is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

config/crd/bases/networking.metal.ironcore.dev_isis.yaml

@@ -65,6 +65,14 @@ spec:
                 minItems: 1
                 type: array
                 x-kubernetes-list-type: set
+              adminState:
+                default: Up
+                description: AdminState indicates whether the ISIS instance is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

config/crd/bases/networking.metal.ironcore.dev_ntp.yaml

@@ -51,6 +51,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether NTP is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

config/crd/bases/networking.metal.ironcore.dev_ospf.yaml

@@ -69,6 +69,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether the OSPF instance is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.

config/crd/bases/networking.metal.ironcore.dev_pim.yaml

@@ -51,6 +51,14 @@ spec:
               Specification of the desired state of the resource.
               More info: https://git.k8s.io/community/contributors/devel/sig-architecture/api-conventions.md#spec-and-status
             properties:
+              adminState:
+                default: Up
+                description: AdminState indicates whether the PIM instance is administratively
+                  up or down.
+                enum:
+                - Up
+                - Down
+                type: string
               deviceRef:
                 description: |-
                   DeviceName is the name of the Device this object belongs to. The Device object must exist in the same namespace.