Struct ClusterJoinResponse 

pub struct ClusterJoinResponse {
    pub node_id: String,
    pub raft_node_id: u64,
    pub overlay_ip: String,
    pub slice_cidr: String,
    pub peers: Vec<ClusterPeer>,
    pub role: String,
    pub node_jwt: Option<String>,
    pub wrapped_dek: Option<Vec<u8>>,
    pub dek_generation: Option<u64>,
    pub join_secret: Option<String>,
    pub warnings: Option<Vec<String>>,
}

Response body for POST /api/v1/cluster/join.

Fields

node_id: String

Assigned node UUID

raft_node_id: u64

Assigned Raft node ID (monotonic u64)

overlay_ip: String

Assigned overlay IP for the new node

slice_cidr: String

Per-node slice CIDR assigned by the leader (e.g. “10.200.42.0/28”). Empty string if the leader is not slice-aware yet.

peers: Vec<ClusterPeer>

Existing peers in the cluster

role: String

Role assigned to this node: “voter” or “learner”

node_jwt: Option<String>

Node JWT minted by the leader for this joiner — roles: ["node"], node_id set. Used to authenticate inter-node calls separately from any user identity. None on legacy responses.

wrapped_dek: Option<Vec<u8>>

Sealed-box-wrapped copy of the cluster DEK addressed to the joiner’s secrets_pubkey. The joiner unwraps with its node X25519 private key and holds the DEK in zeroized memory. None on legacy responses or when the joiner did not provide a secrets_pubkey.

dek_generation: Option<u64>

Cluster DEK generation that wrapped_dek was sealed under. Lets the joiner detect rotation drift if it re-joins after a revocation rotated the cluster DEK. None when wrapped_dek is None.

join_secret: Option<String>

Cluster-wide HMAC join secret. Returned to authenticated joiners so they can derive the same internal RPC bearer as the leader. None on legacy responses from older leaders.

warnings: Option<Vec<String>>

Server-side advisory warnings to surface to the operator/CLI.

Examples: “your token format is deprecated and will be removed in release X.Y”, “consider rotating the signing key, last rotated N days ago”. Present-but-empty means “no warnings”; serialized as null (skip-if-none) when there are none.

Trait Implementations

impl Clone for ClusterJoinResponse

fn clone(&self) -> ClusterJoinResponse

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl ComposeSchema for ClusterJoinResponse

fn compose(generics: Vec<RefOr<Schema>>) -> RefOr<Schema>

impl Debug for ClusterJoinResponse

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Serialize for ClusterJoinResponse

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl ToSchema for ClusterJoinResponse

fn name() -> Cow<'static, str>

Return name of the schema.

fn schemas(schemas: &mut Vec<(String, RefOr<Schema>)>)

Implement reference utoipa::openapi::schema::Schemas for this type.