rc_core/admin/
cluster.rs

1//! Cluster management type definitions
2//!
3//! This module contains data structures for cluster management operations
4//! including server information, disk status, and heal operations.
5
6use serde::{Deserialize, Serialize};
7use std::collections::{BTreeMap, HashMap};
8
9/// Server information representing a RustFS node
10#[derive(Debug, Clone, Serialize, Deserialize, Default)]
11#[serde(rename_all = "camelCase")]
12pub struct ServerInfo {
13    /// Server state (online, offline, initializing)
14    #[serde(default)]
15    pub state: String,
16
17    /// Server endpoint URL
18    #[serde(default)]
19    pub endpoint: String,
20
21    /// Connection scheme (http/https)
22    #[serde(default)]
23    pub scheme: String,
24
25    /// Uptime in seconds
26    #[serde(default)]
27    pub uptime: u64,
28
29    /// Server version
30    #[serde(default)]
31    pub version: String,
32
33    /// Git commit ID
34    #[serde(default, rename = "commitID")]
35    pub commit_id: String,
36
37    /// Network interfaces
38    #[serde(default)]
39    pub network: HashMap<String, String>,
40
41    /// Attached drives
42    #[serde(default, rename = "drives")]
43    pub disks: Vec<DiskInfo>,
44
45    /// Pool number
46    #[serde(default, rename = "poolNumber")]
47    pub pool_number: i32,
48
49    /// Memory statistics
50    #[serde(default, rename = "mem_stats")]
51    pub mem_stats: MemStats,
52}
53
54/// Disk information
55#[derive(Debug, Clone, Serialize, Deserialize, Default)]
56#[serde(rename_all = "camelCase")]
57pub struct DiskInfo {
58    /// Disk endpoint
59    #[serde(default)]
60    pub endpoint: String,
61
62    /// Whether this is a root disk
63    #[serde(default, rename = "rootDisk")]
64    pub root_disk: bool,
65
66    /// Drive path
67    #[serde(default, rename = "path")]
68    pub drive_path: String,
69
70    /// Whether healing is in progress
71    #[serde(default)]
72    pub healing: bool,
73
74    /// Whether scanning is in progress
75    #[serde(default)]
76    pub scanning: bool,
77
78    /// Disk state (online, offline)
79    #[serde(default)]
80    pub state: String,
81
82    /// Disk UUID
83    #[serde(default)]
84    pub uuid: String,
85
86    /// Total space in bytes
87    #[serde(default, rename = "totalspace")]
88    pub total_space: u64,
89
90    /// Used space in bytes
91    #[serde(default, rename = "usedspace")]
92    pub used_space: u64,
93
94    /// Available space in bytes
95    #[serde(default, rename = "availspace")]
96    pub available_space: u64,
97
98    /// Pool index
99    #[serde(default, alias = "pool_index")]
100    pub pool_index: i32,
101
102    /// Set index
103    #[serde(default, alias = "set_index")]
104    pub set_index: i32,
105
106    /// Disk index within set
107    #[serde(default, alias = "disk_index")]
108    pub disk_index: i32,
109
110    /// Healing info if disk is being healed
111    #[serde(default, skip_serializing_if = "Option::is_none")]
112    pub heal_info: Option<HealingDiskInfo>,
113}
114
115/// Healing disk information
116#[derive(Debug, Clone, Serialize, Deserialize, Default)]
117#[serde(rename_all = "camelCase")]
118pub struct HealingDiskInfo {
119    /// Heal ID
120    #[serde(default)]
121    pub id: String,
122
123    /// Heal session ID
124    #[serde(default)]
125    pub heal_id: String,
126
127    /// Pool index
128    #[serde(default)]
129    pub pool_index: Option<usize>,
130
131    /// Set index
132    #[serde(default)]
133    pub set_index: Option<usize>,
134
135    /// Disk index
136    #[serde(default)]
137    pub disk_index: Option<usize>,
138
139    /// Endpoint being healed
140    #[serde(default)]
141    pub endpoint: String,
142
143    /// Path being healed
144    #[serde(default)]
145    pub path: String,
146
147    /// Objects total count
148    #[serde(default)]
149    pub objects_total_count: u64,
150
151    /// Objects total size
152    #[serde(default)]
153    pub objects_total_size: u64,
154
155    /// Items healed count
156    #[serde(default)]
157    pub items_healed: u64,
158
159    /// Items failed count
160    #[serde(default)]
161    pub items_failed: u64,
162
163    /// Bytes done
164    #[serde(default)]
165    pub bytes_done: u64,
166
167    /// Whether healing is finished
168    #[serde(default)]
169    pub finished: bool,
170
171    /// Current bucket being healed
172    #[serde(default)]
173    pub bucket: String,
174
175    /// Current object being healed
176    #[serde(default)]
177    pub object: String,
178}
179
180/// Memory statistics
181#[derive(Debug, Clone, Serialize, Deserialize, Default)]
182pub struct MemStats {
183    /// Current allocated memory
184    #[serde(default)]
185    pub alloc: u64,
186
187    /// Total allocated memory over lifetime
188    #[serde(default)]
189    pub total_alloc: u64,
190
191    /// Heap allocated memory
192    #[serde(default)]
193    pub heap_alloc: u64,
194}
195
196/// Storage backend type
197#[derive(Debug, Clone, Serialize, Deserialize, Default)]
198#[serde(rename_all = "lowercase")]
199pub enum BackendType {
200    /// Filesystem backend (single drive)
201    #[default]
202    #[serde(rename = "FS")]
203    Fs,
204    /// Erasure coding backend (distributed)
205    #[serde(rename = "Erasure")]
206    Erasure,
207}
208
209impl std::fmt::Display for BackendType {
210    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
211        match self {
212            BackendType::Fs => write!(f, "FS"),
213            BackendType::Erasure => write!(f, "Erasure"),
214        }
215    }
216}
217
218/// Backend information
219#[derive(Debug, Clone, Serialize, Deserialize, Default)]
220#[serde(rename_all = "camelCase")]
221pub struct BackendInfo {
222    /// Backend type
223    #[serde(default, rename = "backendType")]
224    pub backend_type: BackendType,
225
226    /// Number of online disks
227    #[serde(default, rename = "onlineDisks")]
228    pub online_disks: usize,
229
230    /// Number of offline disks
231    #[serde(default, rename = "offlineDisks")]
232    pub offline_disks: usize,
233
234    /// Standard storage class parity
235    #[serde(default, rename = "standardSCParity")]
236    pub standard_sc_parity: Option<usize>,
237
238    /// Reduced redundancy storage class parity
239    #[serde(default, rename = "rrSCParity")]
240    pub rr_sc_parity: Option<usize>,
241
242    /// Total erasure sets
243    #[serde(default, rename = "totalSets")]
244    pub total_sets: Vec<usize>,
245
246    /// Drives per erasure set
247    #[serde(default, rename = "totalDrivesPerSet")]
248    pub drives_per_set: Vec<usize>,
249}
250
251/// Cluster usage statistics
252#[derive(Debug, Clone, Serialize, Deserialize, Default)]
253pub struct UsageInfo {
254    /// Total storage size in bytes
255    #[serde(default)]
256    pub size: u64,
257
258    /// Error message if any
259    #[serde(default, skip_serializing_if = "Option::is_none")]
260    pub error: Option<String>,
261}
262
263/// Bucket count information
264#[derive(Debug, Clone, Serialize, Deserialize, Default)]
265pub struct BucketsInfo {
266    /// Number of buckets
267    #[serde(default)]
268    pub count: u64,
269
270    /// Error message if any
271    #[serde(default, skip_serializing_if = "Option::is_none")]
272    pub error: Option<String>,
273}
274
275/// Object count information
276#[derive(Debug, Clone, Serialize, Deserialize, Default)]
277pub struct ObjectsInfo {
278    /// Number of objects
279    #[serde(default)]
280    pub count: u64,
281
282    /// Error message if any
283    #[serde(default, skip_serializing_if = "Option::is_none")]
284    pub error: Option<String>,
285}
286
287/// Pool erasure set metrics returned by cluster information.
288#[derive(Debug, Clone, Serialize, Deserialize, Default)]
289#[serde(rename_all = "camelCase")]
290pub struct PoolErasureSetInfo {
291    /// Erasure set ID within the pool.
292    #[serde(default)]
293    pub id: i32,
294
295    /// Raw used capacity in bytes.
296    #[serde(default, rename = "rawUsage")]
297    pub raw_usage: u64,
298
299    /// Raw total capacity in bytes.
300    #[serde(default, rename = "rawCapacity")]
301    pub raw_capacity: u64,
302
303    /// Object data usage in bytes.
304    #[serde(default)]
305    pub usage: u64,
306
307    /// Number of objects in the set.
308    #[serde(default, rename = "objectsCount")]
309    pub objects_count: u64,
310
311    /// Number of versions in the set.
312    #[serde(default, rename = "versionsCount")]
313    pub versions_count: u64,
314
315    /// Number of delete markers in the set.
316    #[serde(default, rename = "deleteMarkersCount")]
317    pub delete_markers_count: u64,
318
319    /// Number of healing disks in the set.
320    #[serde(default, rename = "healDisks")]
321    pub heal_disks: i32,
322}
323
324/// Complete cluster information response
325#[derive(Debug, Clone, Serialize, Deserialize, Default)]
326#[serde(rename_all = "camelCase")]
327pub struct ClusterInfo {
328    /// Deployment mode (distributed, standalone)
329    #[serde(default)]
330    pub mode: Option<String>,
331
332    /// Domain names
333    #[serde(default)]
334    pub domain: Option<Vec<String>>,
335
336    /// Region
337    #[serde(default)]
338    pub region: Option<String>,
339
340    /// Deployment ID
341    #[serde(default, rename = "deploymentID")]
342    pub deployment_id: Option<String>,
343
344    /// Bucket information
345    #[serde(default)]
346    pub buckets: Option<BucketsInfo>,
347
348    /// Object information
349    #[serde(default)]
350    pub objects: Option<ObjectsInfo>,
351
352    /// Storage usage
353    #[serde(default)]
354    pub usage: Option<UsageInfo>,
355
356    /// Backend information
357    #[serde(default)]
358    pub backend: Option<BackendInfo>,
359
360    /// Server information
361    #[serde(default)]
362    pub servers: Option<Vec<ServerInfo>>,
363
364    /// Pool metrics keyed by pool and erasure set index.
365    #[serde(default)]
366    pub pools: Option<BTreeMap<i32, BTreeMap<i32, PoolErasureSetInfo>>>,
367}
368
369impl ClusterInfo {
370    /// Get the total number of online disks across all servers
371    pub fn online_disks(&self) -> usize {
372        self.servers
373            .as_ref()
374            .map(|servers| {
375                servers
376                    .iter()
377                    .flat_map(|s| &s.disks)
378                    .filter(|d| d.state == "online" || d.state == "ok")
379                    .count()
380            })
381            .unwrap_or(0)
382    }
383
384    /// Get the total number of offline disks across all servers
385    pub fn offline_disks(&self) -> usize {
386        self.servers
387            .as_ref()
388            .map(|servers| {
389                servers
390                    .iter()
391                    .flat_map(|s| &s.disks)
392                    .filter(|d| d.state == "offline")
393                    .count()
394            })
395            .unwrap_or(0)
396    }
397
398    /// Get total storage capacity in bytes
399    pub fn total_capacity(&self) -> u64 {
400        self.servers
401            .as_ref()
402            .map(|servers| {
403                servers
404                    .iter()
405                    .flat_map(|s| &s.disks)
406                    .map(|d| d.total_space)
407                    .sum()
408            })
409            .unwrap_or(0)
410    }
411
412    /// Get used storage in bytes
413    pub fn used_capacity(&self) -> u64 {
414        self.servers
415            .as_ref()
416            .map(|servers| {
417                servers
418                    .iter()
419                    .flat_map(|s| &s.disks)
420                    .map(|d| d.used_space)
421                    .sum()
422            })
423            .unwrap_or(0)
424    }
425}
426
427/// Heal operation mode
428#[derive(Debug, Clone, Copy, PartialEq, Eq, Serialize, Deserialize, Default)]
429#[serde(rename_all = "lowercase")]
430pub enum HealScanMode {
431    /// Normal scan (default)
432    #[default]
433    Normal,
434    /// Deep scan (slower but more thorough)
435    Deep,
436}
437
438impl std::fmt::Display for HealScanMode {
439    fn fmt(&self, f: &mut std::fmt::Formatter<'_>) -> std::fmt::Result {
440        match self {
441            HealScanMode::Normal => write!(f, "normal"),
442            HealScanMode::Deep => write!(f, "deep"),
443        }
444    }
445}
446
447impl std::str::FromStr for HealScanMode {
448    type Err = String;
449
450    fn from_str(s: &str) -> Result<Self, Self::Err> {
451        match s.to_lowercase().as_str() {
452            "normal" => Ok(HealScanMode::Normal),
453            "deep" => Ok(HealScanMode::Deep),
454            _ => Err(format!("Invalid heal scan mode: {s}")),
455        }
456    }
457}
458
459/// Request to start a heal operation
460#[derive(Debug, Clone, Serialize, Deserialize, Default)]
461#[serde(rename_all = "camelCase")]
462pub struct HealStartRequest {
463    /// Bucket to heal (empty for all buckets)
464    #[serde(default, skip_serializing_if = "Option::is_none")]
465    pub bucket: Option<String>,
466
467    /// Object prefix to heal
468    #[serde(default, skip_serializing_if = "Option::is_none")]
469    pub prefix: Option<String>,
470
471    /// Scan mode
472    #[serde(default)]
473    pub scan_mode: HealScanMode,
474
475    /// Whether to remove dangling objects
476    #[serde(default)]
477    pub remove: bool,
478
479    /// Whether to recreate missing data
480    #[serde(default)]
481    pub recreate: bool,
482
483    /// Dry run mode (don't actually heal)
484    #[serde(default)]
485    pub dry_run: bool,
486}
487
488/// Information about a single heal drive
489#[derive(Debug, Clone, Serialize, Deserialize, Default)]
490pub struct HealDriveInfo {
491    /// Drive UUID
492    #[serde(default)]
493    pub uuid: String,
494
495    /// Drive endpoint
496    #[serde(default)]
497    pub endpoint: String,
498
499    /// Drive state
500    #[serde(default)]
501    pub state: String,
502}
503
504/// Result of a heal operation on a single item
505#[derive(Debug, Clone, Serialize, Deserialize, Default)]
506#[serde(rename_all = "camelCase")]
507pub struct HealResultItem {
508    /// Result index
509    #[serde(default, rename = "resultId")]
510    pub result_index: usize,
511
512    /// Type of item healed (bucket, object, metadata)
513    #[serde(default, rename = "type")]
514    pub item_type: String,
515
516    /// Bucket name
517    #[serde(default)]
518    pub bucket: String,
519
520    /// Object key
521    #[serde(default)]
522    pub object: String,
523
524    /// Version ID
525    #[serde(default, rename = "versionId")]
526    pub version_id: String,
527
528    /// Detail message
529    #[serde(default)]
530    pub detail: String,
531
532    /// Number of parity blocks
533    #[serde(default, rename = "parityBlocks")]
534    pub parity_blocks: usize,
535
536    /// Number of data blocks
537    #[serde(default, rename = "dataBlocks")]
538    pub data_blocks: usize,
539
540    /// Object size
541    #[serde(default, rename = "objectSize")]
542    pub object_size: u64,
543
544    /// Drive info before healing
545    #[serde(default)]
546    pub before: HealDriveInfos,
547
548    /// Drive info after healing
549    #[serde(default)]
550    pub after: HealDriveInfos,
551}
552
553/// Collection of heal drive infos
554#[derive(Debug, Clone, Serialize, Deserialize, Default)]
555pub struct HealDriveInfos {
556    /// Drive information
557    #[serde(default)]
558    pub drives: Vec<HealDriveInfo>,
559}
560
561/// Status of a heal operation
562#[derive(Debug, Clone, Serialize, Deserialize, Default)]
563#[serde(rename_all = "camelCase")]
564pub struct HealStatus {
565    /// Heal ID
566    #[serde(default)]
567    pub heal_id: String,
568
569    /// Whether healing is in progress
570    #[serde(default)]
571    pub healing: bool,
572
573    /// Current bucket being healed
574    #[serde(default)]
575    pub bucket: String,
576
577    /// Current object being healed
578    #[serde(default)]
579    pub object: String,
580
581    /// Number of items scanned
582    #[serde(default)]
583    pub items_scanned: u64,
584
585    /// Number of items healed
586    #[serde(default)]
587    pub items_healed: u64,
588
589    /// Number of items failed
590    #[serde(default)]
591    pub items_failed: u64,
592
593    /// Bytes scanned
594    #[serde(default)]
595    pub bytes_scanned: u64,
596
597    /// Bytes healed
598    #[serde(default)]
599    pub bytes_healed: u64,
600
601    /// Start time
602    #[serde(default)]
603    pub started: Option<String>,
604
605    /// Last update time
606    #[serde(default)]
607    pub last_update: Option<String>,
608}
609
610/// Request targeting a storage pool by command line or numeric ID.
611#[derive(Debug, Clone, Serialize, Deserialize, Default)]
612#[serde(rename_all = "camelCase")]
613pub struct PoolTarget {
614    /// Pool command line, or zero-based pool ID when `by_id` is true.
615    pub pool: String,
616
617    /// Interpret `pool` as a zero-based pool ID.
618    #[serde(default)]
619    pub by_id: bool,
620}
621
622/// Status of a server pool.
623#[derive(Debug, Clone, Serialize, Deserialize, Default)]
624pub struct PoolStatus {
625    /// Zero-based pool ID.
626    #[serde(default)]
627    pub id: usize,
628
629    /// Pool command line used by the server process.
630    #[serde(default, rename = "cmdline")]
631    pub cmd_line: String,
632
633    /// Last pool metadata update timestamp.
634    #[serde(default, rename = "lastUpdate")]
635    pub last_update: String,
636
637    /// Decommission status and progress for this pool.
638    #[serde(default, rename = "decommissionInfo")]
639    pub decommission: Option<PoolDecommissionInfo>,
640}
641
642/// Decommission state and progress for a server pool.
643#[derive(Debug, Clone, Serialize, Deserialize, Default)]
644pub struct PoolDecommissionInfo {
645    /// Decommission start timestamp.
646    #[serde(default, rename = "startTime")]
647    pub start_time: Option<String>,
648
649    /// Free bytes when decommission started.
650    #[serde(default, rename = "startSize")]
651    pub start_size: u64,
652
653    /// Total pool size in bytes.
654    #[serde(default, rename = "totalSize")]
655    pub total_size: u64,
656
657    /// Current free size in bytes.
658    #[serde(default, rename = "currentSize")]
659    pub current_size: u64,
660
661    /// Whether decommission completed.
662    #[serde(default)]
663    pub complete: bool,
664
665    /// Whether decommission failed.
666    #[serde(default)]
667    pub failed: bool,
668
669    /// Whether decommission was canceled.
670    #[serde(default)]
671    pub canceled: bool,
672
673    /// Number of successfully decommissioned objects.
674    #[serde(default, rename = "objectsDecommissioned")]
675    pub objects_decommissioned: u64,
676
677    /// Number of objects that failed to decommission.
678    #[serde(default, rename = "objectsDecommissionedFailed")]
679    pub objects_decommissioned_failed: u64,
680
681    /// Bytes successfully moved off the pool.
682    #[serde(default, rename = "bytesDecommissioned")]
683    pub bytes_decommissioned: u64,
684
685    /// Bytes that failed to move off the pool.
686    #[serde(default, rename = "bytesDecommissionedFailed")]
687    pub bytes_decommissioned_failed: u64,
688}
689
690/// Response from starting a rebalance operation.
691#[derive(Debug, Clone, Serialize, Deserialize, Default)]
692pub struct RebalanceStartResult {
693    /// Rebalance operation ID.
694    #[serde(default)]
695    pub id: String,
696}
697
698/// Cluster-wide rebalance status.
699#[derive(Debug, Clone, Serialize, Deserialize, Default)]
700pub struct RebalanceStatus {
701    /// Rebalance operation ID.
702    #[serde(default)]
703    pub id: String,
704
705    /// Per-pool rebalance status.
706    #[serde(default)]
707    pub pools: Vec<RebalancePoolStatus>,
708
709    /// Timestamp when rebalance was stopped.
710    #[serde(default, rename = "stoppedAt")]
711    pub stopped_at: Option<String>,
712}
713
714/// Rebalance status for a single pool.
715#[derive(Debug, Clone, Serialize, Deserialize, Default)]
716pub struct RebalancePoolStatus {
717    /// Zero-based pool ID.
718    #[serde(default)]
719    pub id: usize,
720
721    /// Rebalance status for this pool.
722    #[serde(default)]
723    pub status: String,
724
725    /// Used capacity ratio in the range 0.0..=1.0.
726    #[serde(default)]
727    pub used: f64,
728
729    /// Last rebalance error, if any.
730    #[serde(default, rename = "lastError")]
731    pub last_error: Option<String>,
732
733    /// Rebalance progress, if this pool is active.
734    #[serde(default)]
735    pub progress: Option<RebalancePoolProgress>,
736}
737
738/// Rebalance progress for a single pool.
739#[derive(Debug, Clone, Serialize, Deserialize, Default)]
740pub struct RebalancePoolProgress {
741    /// Number of objects moved.
742    #[serde(default, rename = "objects")]
743    pub num_objects: u64,
744
745    /// Number of object versions moved.
746    #[serde(default, rename = "versions")]
747    pub num_versions: u64,
748
749    /// Number of bytes moved.
750    #[serde(default)]
751    pub bytes: u64,
752
753    /// Number of buckets remaining.
754    #[serde(default, rename = "remainingBuckets")]
755    pub remaining_buckets: usize,
756
757    /// Current bucket.
758    #[serde(default)]
759    pub bucket: String,
760
761    /// Current object.
762    #[serde(default)]
763    pub object: String,
764
765    /// Elapsed seconds.
766    #[serde(default)]
767    pub elapsed: u64,
768
769    /// Estimated seconds remaining.
770    #[serde(default)]
771    pub eta: u64,
772}
773
774#[cfg(test)]
775mod tests {
776    use super::*;
777
778    #[test]
779    fn test_backend_type_display() {
780        assert_eq!(BackendType::Fs.to_string(), "FS");
781        assert_eq!(BackendType::Erasure.to_string(), "Erasure");
782    }
783
784    #[test]
785    fn test_heal_scan_mode_display() {
786        assert_eq!(HealScanMode::Normal.to_string(), "normal");
787        assert_eq!(HealScanMode::Deep.to_string(), "deep");
788    }
789
790    #[test]
791    fn test_heal_scan_mode_from_str() {
792        assert_eq!(
793            "normal".parse::<HealScanMode>().unwrap(),
794            HealScanMode::Normal
795        );
796        assert_eq!("deep".parse::<HealScanMode>().unwrap(), HealScanMode::Deep);
797        assert!("invalid".parse::<HealScanMode>().is_err());
798    }
799
800    #[test]
801    fn test_cluster_info_default() {
802        let info = ClusterInfo::default();
803        assert!(info.mode.is_none());
804        assert!(info.servers.is_none());
805        assert_eq!(info.online_disks(), 0);
806        assert_eq!(info.offline_disks(), 0);
807    }
808
809    #[test]
810    fn test_cluster_info_disk_counts() {
811        let info = ClusterInfo {
812            servers: Some(vec![ServerInfo {
813                disks: vec![
814                    DiskInfo {
815                        state: "online".to_string(),
816                        ..Default::default()
817                    },
818                    DiskInfo {
819                        state: "online".to_string(),
820                        ..Default::default()
821                    },
822                    DiskInfo {
823                        state: "offline".to_string(),
824                        ..Default::default()
825                    },
826                ],
827                ..Default::default()
828            }]),
829            ..Default::default()
830        };
831
832        assert_eq!(info.online_disks(), 2);
833        assert_eq!(info.offline_disks(), 1);
834    }
835
836    #[test]
837    fn test_cluster_info_capacity() {
838        let info = ClusterInfo {
839            servers: Some(vec![ServerInfo {
840                disks: vec![
841                    DiskInfo {
842                        total_space: 1000,
843                        used_space: 300,
844                        ..Default::default()
845                    },
846                    DiskInfo {
847                        total_space: 2000,
848                        used_space: 500,
849                        ..Default::default()
850                    },
851                ],
852                ..Default::default()
853            }]),
854            ..Default::default()
855        };
856
857        assert_eq!(info.total_capacity(), 3000);
858        assert_eq!(info.used_capacity(), 800);
859    }
860
861    #[test]
862    fn test_disk_info_default() {
863        let disk = DiskInfo::default();
864        assert!(disk.endpoint.is_empty());
865        assert!(!disk.healing);
866        assert!(!disk.scanning);
867        assert_eq!(disk.total_space, 0);
868    }
869
870    #[test]
871    fn test_disk_info_deserializes_snake_case_location_indexes() {
872        let json = r#"{"pool_index":1,"set_index":2,"disk_index":3}"#;
873
874        let disk: DiskInfo = serde_json::from_str(json).unwrap();
875
876        assert_eq!(disk.pool_index, 1);
877        assert_eq!(disk.set_index, 2);
878        assert_eq!(disk.disk_index, 3);
879    }
880
881    #[test]
882    fn test_server_info_default() {
883        let server = ServerInfo::default();
884        assert!(server.state.is_empty());
885        assert!(server.endpoint.is_empty());
886        assert_eq!(server.uptime, 0);
887    }
888
889    #[test]
890    fn test_heal_start_request_default() {
891        let req = HealStartRequest::default();
892        assert!(req.bucket.is_none());
893        assert!(req.prefix.is_none());
894        assert_eq!(req.scan_mode, HealScanMode::Normal);
895        assert!(!req.remove);
896        assert!(!req.dry_run);
897    }
898
899    #[test]
900    fn test_heal_status_default() {
901        let status = HealStatus::default();
902        assert!(status.heal_id.is_empty());
903        assert!(!status.healing);
904        assert_eq!(status.items_scanned, 0);
905    }
906
907    #[test]
908    fn test_pool_status_deserialization() {
909        let json = r#"{"id":1,"cmdline":"/data/pool1/disk{1...4}","lastUpdate":"2026-05-06T00:00:00Z","decommissionInfo":{"startTime":"2026-05-06T00:00:01Z","startSize":100,"totalSize":1000,"currentSize":600,"complete":false,"failed":false,"canceled":false,"objectsDecommissioned":2,"objectsDecommissionedFailed":1,"bytesDecommissioned":128,"bytesDecommissionedFailed":64}}"#;
910
911        let status: PoolStatus = serde_json::from_str(json).unwrap();
912
913        assert_eq!(status.id, 1);
914        assert_eq!(status.cmd_line, "/data/pool1/disk{1...4}");
915        let info = status.decommission.expect("decommission info exists");
916        assert_eq!(info.objects_decommissioned, 2);
917        assert_eq!(info.bytes_decommissioned_failed, 64);
918    }
919
920    #[test]
921    fn test_rebalance_status_deserialization() {
922        let json = r#"{"id":"rebalance-1","pools":[{"id":0,"status":"Started","used":0.5,"lastError":null,"progress":{"objects":3,"versions":4,"bytes":1024,"remainingBuckets":2,"bucket":"bucket","object":"object","elapsed":10,"eta":20}}],"stoppedAt":null}"#;
923
924        let status: RebalanceStatus = serde_json::from_str(json).unwrap();
925
926        assert_eq!(status.id, "rebalance-1");
927        assert_eq!(status.pools.len(), 1);
928        assert_eq!(status.pools[0].used, 0.5);
929        let progress = status.pools[0]
930            .progress
931            .as_ref()
932            .expect("progress should exist");
933        assert_eq!(progress.num_objects, 3);
934        assert_eq!(progress.remaining_buckets, 2);
935    }
936
937    #[test]
938    fn test_serialization() {
939        let info = ClusterInfo {
940            mode: Some("distributed".to_string()),
941            deployment_id: Some("test-123".to_string()),
942            ..Default::default()
943        };
944
945        let json = serde_json::to_string(&info).unwrap();
946        assert!(json.contains("distributed"));
947        assert!(json.contains("test-123"));
948
949        let deserialized: ClusterInfo = serde_json::from_str(&json).unwrap();
950        assert_eq!(deserialized.mode, Some("distributed".to_string()));
951    }
952}
rc_core/admin/cluster.rs

rc_core/admin/
cluster.rs
