jenkinsci/jenkins · error · IllegalArgumentException

No such agent "{0}" exists. Did you mean "{1}"?

Error message

No such agent "{0}" exists. Did you mean "{1}"?

What it means

Error "No such agent "{0}" exists. Did you mean "{1}"?" thrown in jenkinsci/jenkins.

Source

Thrown at core/src/main/java/hudson/cli/DisconnectNodeCommand.java:79

        boolean errorOccurred = false;
        final Jenkins jenkins = Jenkins.get();

        final HashSet<String> hs = new HashSet<>(nodes);

        List<String> names = null;

        for (String node_s : hs) {
            Computer computer;

            try {
                computer = jenkins.getComputer(node_s);

                if (computer == null) {
                    if (names == null) {
                        names = ComputerSet.getComputerNames();
                    }
                    String adv = EditDistance.findNearest(node_s, names);
                    throw new IllegalArgumentException(adv == null ?
                            hudson.model.Messages.Computer_NoSuchSlaveExistsWithoutAdvice(node_s) :
                            hudson.model.Messages.Computer_NoSuchSlaveExists(node_s, adv));
                }

                computer.cliDisconnect(cause);
            } catch (Exception e) {
                if (hs.size() == 1) {
                    throw e;
                }

                stderr.println(node_s + ": " + e.getMessage());
                errorOccurred = true;
                continue;
            }
        }

        if (errorOccurred) {
            throw new AbortException(CLI_LISTPARAM_SUMMARY_ERROR_TEXT);

View on GitHub (pinned to 2e228ff40b)

Solutions

1. Use the suggested agent name shown in the error message.
2. Run 'list-nodes' to confirm the exact agent name before retrying.

When it happens

Trigger: Raised when the disconnect-node CLI command is given an agent name that does not exist, but a similarly named agent does; the suggestion is shown to help correct the typo.

Common situations: See trigger scenarios.

AI-assisted analysis of jenkinsci/jenkins@2e228ff40b (2026-08-14). Data as JSON: /api/errors/d9c9b050c0c9c18b. Report an issue: GitHub.