Database support for delegating IP Pools for Oxide internal use

common/src/api/external/http_pagination.rs

@@ -382,6 +382,15 @@ pub enum PaginatedBy<'a> {
     Name(DataPageParams<'a, Name>),
 }
 
+impl<'a> PaginatedBy<'a> {
+    pub fn limit(&self) -> NonZeroU32 {
+        match self {
+            PaginatedBy::Id(inner) => inner.limit,
+            PaginatedBy::Name(inner) => inner.limit,
+        }
+    }
+}
+
 impl<T: Clone + Debug + DeserializeOwned + JsonSchema + PartialEq + Serialize>
     ScanParams for ScanByNameOrId<T>
 {

nexus/db-model/src/ip_pool.rs

@@ -77,7 +77,9 @@ impl From<IpVersion> for shared::IpVersion {
 /// IP pools can be external or internal. External IP pools can be associated
 /// with a silo or project so that instance IP allocation draws from that pool
 /// instead of a system pool.
-#[derive(Queryable, Insertable, Selectable, Clone, Debug, Resource)]
+#[derive(
+    Queryable, Insertable, Selectable, Clone, Debug, Resource, PartialEq,
+)]
 #[diesel(table_name = ip_pool)]
 pub struct IpPool {
     #[diesel(embed)]
@@ -89,9 +91,15 @@ pub struct IpPool {
     /// Child resource generation number, for optimistic concurrency control of
     /// the contained ranges.
     pub rcgen: i64,
+
+    /// True if the IP Pool has been delegated for Oxide use.
+    pub is_delegated: bool,
 }
 
 impl IpPool {
+    /// Create a new IP Pool.
+    ///
+    /// The pool is not delegated to Oxide.
     pub fn new(
         pool_identity: &external::IdentityMetadataCreateParams,
         ip_version: IpVersion,
@@ -103,15 +111,38 @@ impl IpPool {
             ),
             ip_version,
             rcgen: 0,
+            is_delegated: false,
+        }
+    }
+
+    /// Create a new pool delegated for Oxide's internal use.
+    pub fn new_delegated(
+        pool_identity: &external::IdentityMetadataCreateParams,
+        ip_version: IpVersion,
+    ) -> Self {
+        Self {
+            identity: IpPoolIdentity::new(
+                Uuid::new_v4(),
+                pool_identity.clone(),
+            ),
+            ip_version,
+            rcgen: 0,
+            is_delegated: true,
         }
     }
 
+    /// Create a new IPv4 IP Pool.
+    ///
+    /// The pool is not delegated to Oxide.
     pub fn new_v4(
         pool_identity: &external::IdentityMetadataCreateParams,
     ) -> Self {
         Self::new(pool_identity, IpVersion::V4)
     }
 
+    /// Create a new IPv6 IP Pool.
+    ///
+    /// The pool is not delegated to Oxide.
     pub fn new_v6(
         pool_identity: &external::IdentityMetadataCreateParams,
     ) -> Self {

nexus/db-model/src/schema_versions.rs

@@ -16,7 +16,7 @@ use std::{collections::BTreeMap, sync::LazyLock};
 ///
 /// This must be updated when you change the database schema.  Refer to
 /// schema/crdb/README.adoc in the root of this repository for details.
-pub const SCHEMA_VERSION: Version = Version::new(195, 0, 0);
+pub const SCHEMA_VERSION: Version = Version::new(196, 0, 0);
 
 /// List of all past database schema versions, in *reverse* order
 ///
@@ -28,6 +28,7 @@ static KNOWN_VERSIONS: LazyLock<Vec<KnownVersion>> = LazyLock::new(|| {
         // |  leaving the first copy as an example for the next person.
         // v
         // KnownVersion::new(next_int, "unique-dirname-with-the-sql-files"),
+        KnownVersion::new(196, "add-ip-pool-is-delegated-column"),
         KnownVersion::new(195, "tuf-pruned-index"),
         KnownVersion::new(194, "tuf-pruned"),
         KnownVersion::new(193, "nexus-lockstep-port"),