{"record":{"id":"34a91f7bf3bec9f1","repo":"jenkinsci/jenkins","slug":"no-such-node-nodename","errorCode":null,"errorMessage":"No such node '{nodeName}'","messagePattern":"No such node '(.+?)'","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"core/src/main/java/hudson/cli/handlers/NodeOptionHandler.java","lineNumber":57,"sourceCode":" *\n * @author ogondza\n * @since 1.526\n */\n@OptionHandlerExtension\npublic class NodeOptionHandler extends OptionHandler<Node> {\n\n    public NodeOptionHandler(CmdLineParser parser, OptionDef option, Setter<Node> setter) {\n\n        super(parser, option, setter);\n    }\n\n    @Override\n    public int parseArguments(Parameters params) throws CmdLineException {\n\n        String nodeName = params.getParameter(0);\n\n        final Node node = Jenkins.get().getNode(nodeName);\n        if (node == null) throw new IllegalArgumentException(\"No such node '\" + nodeName + \"'\");\n\n        setter.addValue(node);\n        return 1;\n    }\n\n    @Override\n    public String getDefaultMetaVariable() {\n\n        return \"NODE\";\n    }\n}\n","sourceCodeStart":39,"sourceCodeEnd":69,"githubUrl":"https://github.com/jenkinsci/jenkins/blob/2e228ff40b14dbc8b14ffbc6edf0e4383cf744fc/core/src/main/java/hudson/cli/handlers/NodeOptionHandler.java#L39-L69","documentation":"IllegalArgumentException from the args4j NodeOptionHandler during option parsing when Jenkins.get().getNode(nodeName) returns null. Unlike the item handler, this offers no 'did you mean' suggestion.","triggerScenarios":"Any CLI command taking a NODE option with a name that is not a registered Jenkins node.","commonSituations":"Typo in node name; node deleted; referencing the built-in node by a name other than the empty string/'built-in'.","solutions":["List nodes (`Jenkins.get().getNodes()` or the CLI node listing) and copy the exact name.","For the built-in/controller node use the built-in name, not an agent name.","Recreate the node if it was removed."],"exampleFix":null,"handlingStrategy":"validation","validationCode":"if (Jenkins.get().getNode(nodeName) == null) {\n    throw new IllegalArgumentException(\"No such node: \" + nodeName);\n}","typeGuard":null,"tryCatchPattern":"catch (IllegalArgumentException e) { /* unknown node name */ }","preventionTips":["Look up nodes via Jenkins.get().getNodes() before use.","Remember the built-in node is not an agent name."],"tags":["cli","node","not-found"],"backgroundTag":null,"analyzedSha":"2e228ff40b14dbc8b14ffbc6edf0e4383cf744fc","analyzedAt":"2026-08-14T07:07:15.274Z","schemaVersion":2},"datasetVersion":"2026-08-14T10:17:34.591Z"}