manta-server 2.0.0-beta.61

Manta HTTP server — single API that proxies to CSM / Ochami backends.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116

//! Hardware inventory queries.

use axum::{Json, extract::Query, http::StatusCode, response::IntoResponse};

use super::{ErrorResponse, RequestCtx, SiteHeader, to_handler_error};
use crate::service;

// ---------------------------------------------------------------------------
// GET /api/v1/groups/hardware (canonical) and /hardware-clusters (deprecated)
// ---------------------------------------------------------------------------

pub use manta_shared::types::api::queries::{
  HardwareClusterQuery, HardwareNodesListQuery,
};

/// GET /groups/hardware — summarize hardware components per node for a group.
#[utoipa::path(get, path = "/groups/hardware", tag = "groups",
  params(HardwareClusterQuery, SiteHeader),
  security(("bearerAuth" = [])),
  responses(
    // Response wraps NodeSummary from manta-backend-dispatcher (third-party,
    // no ToSchema) — kept as Value until upstream derives it.
    (status = 200, description = "Hardware summary for group nodes", body = serde_json::Value),
    (status = 401, description = "Unauthorized",                      body = ErrorResponse),
    (status = 500, description = "Internal error",                    body = ErrorResponse),
  )
)]
#[tracing::instrument(skip_all)]
pub async fn get_groups_hardware(
  ctx: RequestCtx,
  Query(q): Query<HardwareClusterQuery>,
) -> Result<impl IntoResponse, (StatusCode, Json<ErrorResponse>)> {
  let infra = ctx.infra();

  let params = service::hardware::GetHardwareClusterParams {
    group_name: q.hsm_group,
    settings_hsm_group_name: None,
  };

  let result =
    service::hardware::get_hardware_cluster(&infra, &ctx.token, &params)
      .await
      .map_err(to_handler_error)?;

  Ok(Json(serde_json::json!({
    "hsm_group_name": result.hsm_group_name,
    "node_summaries": result.node_summaries,
  })))
}

/// DEPRECATED alias for `GET /groups/hardware`. Logs a server-side
/// warning and delegates to the canonical handler. Old path kept for
/// one release.
#[utoipa::path(get, path = "/hardware-clusters", tag = "hardware",
  params(HardwareClusterQuery, SiteHeader),
  security(("bearerAuth" = [])),
  responses(
    // Alias for the canonical handler — same NodeSummary third-party
    // shape, kept as Value for the same reason.
    (status = 200, description = "[DEPRECATED] use /groups/hardware — hardware summary for group nodes", body = serde_json::Value),
    (status = 401, description = "Unauthorized",                                                          body = ErrorResponse),
    (status = 500, description = "Internal error",                                                        body = ErrorResponse),
  )
)]
#[tracing::instrument(skip_all)]
pub async fn get_hardware_clusters_deprecated(
  ctx: RequestCtx,
  q: Query<HardwareClusterQuery>,
) -> Result<impl IntoResponse, (StatusCode, Json<ErrorResponse>)> {
  tracing::warn!(
    "deprecated endpoint: GET /hardware-clusters — use /groups/hardware instead"
  );
  get_groups_hardware(ctx, q).await
}

// ---------------------------------------------------------------------------
// GET /api/v1/hardware-nodes-list
// ---------------------------------------------------------------------------

/// GET /hardware-nodes-list — hardware details for an explicit list of xnames.
#[utoipa::path(get, path = "/hardware-nodes-list", tag = "hardware",
  params(HardwareNodesListQuery, SiteHeader),
  security(("bearerAuth" = [])),
  responses(
    // Response wraps NodeSummary from manta-backend-dispatcher (third-party,
    // no ToSchema) — kept as Value until upstream derives it.
    (status = 200, description = "Hardware details for specified nodes", body = serde_json::Value),
    (status = 400, description = "Bad request",                          body = ErrorResponse),
    (status = 401, description = "Unauthorized",                         body = ErrorResponse),
    (status = 500, description = "Internal error",                       body = ErrorResponse),
  )
)]
#[tracing::instrument(skip_all)]
pub async fn get_hardware_nodes_list(
  ctx: RequestCtx,
  Query(q): Query<HardwareNodesListQuery>,
) -> Result<impl IntoResponse, (StatusCode, Json<ErrorResponse>)> {
  let infra = ctx.infra();

  let params = service::hardware::GetHardwareNodesListParams {
    host_expression: q.xnames,
  };

  let result =
    service::hardware::get_hardware_nodes_list(&infra, &ctx.token, &params)
      .await
      .map_err(to_handler_error)?;

  Ok(Json(serde_json::json!({
    "node_summaries": result.node_summaries,
  })))
}

// ===========================================================================
// WRITE ENDPOINTS
// ===========================================================================