influxdata/influxdb · info · CatalogError

idempotent no-op

Error message

idempotent no-op

What it means

Signal that a requested operation was a no-op because the desired state already holds. It is not a failure of the operation's effect; the catalog returns it so callers can distinguish 'nothing changed' from a real state change. Callers can usually treat it as success.

Solutions

1. Treat IdempotentNoOp as success and continue; the desired state already holds.
2. Make reconciliation logic match on this variant and skip error propagation.
3. If you expected a change, inspect the node's current state to confirm prior success.

Example fix

// before
let _ = catalog.stop_node(node_id).await?;
// after
match catalog.stop_node(node_id).await {
    Ok(_) | Err(CatalogError::IdempotentNoOp) => {}, // already stopped
    Err(e) => return Err(e.into()),
}

match result {
    Ok(_) | Err(CatalogError::IdempotentNoOp) => Ok(()),
    Err(e) => Err(e.into()),
}

When it happens

Trigger: Issuing a lifecycle transition (stop, unregister, mode change) on a node that is already in the target state; replaying an already-applied request.

Common situations: Idempotent retry after a network timeout where the first request actually succeeded; declarative/orchestrator reconcilers re-asserting desired state.

Understand the failure class

Background: "Invalid state transition" errors: "status must be X, actually Y", "already rejected/charging/uninstalled", "cannot ... while running" — what they mean when a library rejects your call — this error's family across 31 libraries.

Related errors

• node ' ' has compact mode and cannot be removed
• tried to stop a node
• {0}
• Adding a new database would exceed limit of
• attempted to create a resource that already exists

AI-assisted analysis of influxdata/influxdb@06200ef96b (2026-09-19). Data as JSON: /api/errors/33f2453a76175772. Report an issue: GitHub.

Appendix: source

Thrown at influxdb3_catalog/src/error.rs:323

        current_state: &'static str,
    },

    #[error("node '{node_id}' has compact mode and cannot be removed")]
    NodeModeNotRemovable { node_id: Arc<str> },

    #[error("invalid stop ack for node '{node_id}' (current state: {current_state})")]
    InvalidStopAck {
        node_id: Arc<str>,
        current_state: &'static str,
    },

    #[error("invalid unregister for node '{node_id}' (current state: {current_state})")]
    InvalidUnregister {
        node_id: Arc<str>,
        current_state: &'static str,
    },

    #[error("idempotent no-op")]
    IdempotentNoOp,

    #[error("cannot delete operator token")]
    CannotDeleteOperatorToken,

    #[error(
        "cannot change the configured generation duration for level {level}; \
        attempted to set to {attempted:#} but its already set to {existing:#}"
    )]
    CannotChangeGenerationDuration {
        level: u8,
        existing: Duration,
        attempted: Duration,
    },

    #[error("cannot add column {name} because it already exists with type {existing}")]
    DuplicateColumn {
        name: Arc<str>,

View on GitHub (pinned to 06200ef96b)