WIP: placeholder to keep PR open

Author: Levon Tarver

nexus/src/internal_api/http_entrypoints.rs

@@ -34,6 +34,7 @@ use nexus_types::internal_api::params::SwitchPutResponse;
 use nexus_types::internal_api::views::to_list;
 use nexus_types::internal_api::views::BackgroundTask;
 use nexus_types::internal_api::views::Saga;
+use nexus_types::internal_api::views::SwitchPortSettings;
 use omicron_common::api::external::http_pagination::data_page_params_for;
 use omicron_common::api::external::http_pagination::PaginatedById;
 use omicron_common::api::external::http_pagination::ScanById;
@@ -606,6 +607,37 @@ async fn ipv4_nat_changeset(
     apictx.internal_latencies.instrument_dropshot_handler(&rqctx, handler).await
 }
 
+/// Fetch Port Settings
+///
+#[endpoint {
+   method = GET,
+    path = "/networking/switch-port-settings"
+}]
+async fn list_switch_port_settings(
+    rqctx: RequestContext<Arc<ServerContext>>,
+    query_params: Query<PaginatedById>,
+) -> Result<HttpResponseOk<ResultsPage<SwitchPortSettings>>, HttpError> {
+    let apictx = rqctx.context();
+    let handler = async {
+        let nexus = &apictx.nexus;
+        let query = query_params.into_inner();
+        let opctx = crate::context::op_context_for_internal_api(&rqctx).await;
+        let pagparams = data_page_params_for(&rqctx, &query)?;
+
+        // TODO: if we follow the same approach of dendrite calling up to get
+        // changes instead of nexus pushing changes down, how do we differentiate
+        // dendrite of switch 1 from dendrite of switch 2? The caller could
+        // provide such information via a query parameter. This would require
+        // dendrite to know which switch slot it is managing (it could get this
+        // information // from `mgs`). On the other hand, Nexus already knows
+        // which dendrite is which
+
+        // If we differentiate based on
+        todo!()
+    };
+    apictx.internal_latencies.instrument_dropshot_handler(&rqctx, handler).await
+}
+
 // APIs for managing blueprints
 //
 // These are not (yet) intended for use by any other programs.  Eventually, we

nexus/types/src/internal_api/views.rs

@@ -15,6 +15,12 @@ use steno::SagaResultErr;
 use steno::UndoActionError;
 use uuid::Uuid;
 
+use omicron_common::api::external::{
+    LldpServiceConfig, SwitchInterfaceConfig, SwitchPortAddressConfig,
+    SwitchPortConfig, SwitchPortLinkConfig, SwitchPortRouteConfig,
+    SwitchPortSettings, SwitchPortSettingsGroups, SwitchVlanInterfaceConfig,
+};
+
 pub async fn to_list<T, U>(object_stream: ObjectStream<T>) -> Vec<U>
 where
     T: Into<U>,
@@ -296,3 +302,35 @@ pub struct LastResultCompleted {
     /// arbitrary datum emitted by the background task
     pub details: serde_json::Value,
 }
+
+/// This structure contains a subset of port settings needed for synchronizing
+/// switch port configurations in `dendrite` via the internal api
+#[derive(Clone, Debug, Deserialize, JsonSchema, Serialize, PartialEq)]
+pub struct SwitchPortSettings {
+    /// The primary switch port settings handle.
+    pub settings: SwitchPortSettings,
+
+    /// Switch port settings included from other switch port settings groups.
+    pub groups: Vec<SwitchPortSettingsGroups>,
+
+    /// Layer 1 physical port settings.
+    pub port: SwitchPortConfig,
+
+    /// Layer 2 link settings.
+    pub links: Vec<SwitchPortLinkConfig>,
+
+    /// Link-layer discovery protocol (LLDP) settings.
+    pub link_lldp: Vec<LldpServiceConfig>,
+
+    /// Layer 3 interface settings.
+    pub interfaces: Vec<SwitchInterfaceConfig>,
+
+    /// Vlan interface settings.
+    pub vlan_interfaces: Vec<SwitchVlanInterfaceConfig>,
+
+    /// IP route settings.
+    pub routes: Vec<SwitchPortRouteConfig>,
+
+    /// Layer 3 IP address settings.
+    pub addresses: Vec<SwitchPortAddressConfig>,
+}