{"record":{"id":"91693c32bfe5ca5f","repo":"hashicorp/nomad","slug":"nodedownerr","errorCode":"NodeDownErr","errorMessage":"node down","messagePattern":"node down","errorType":"error_code","errorClass":null,"httpStatus":null,"severity":"error","filePath":"api/allocations.go","lineNumber":19,"sourceCode":"// Copyright IBM Corp. 2015, 2026\n// SPDX-License-Identifier: MPL-2.0\n\npackage api\n\nimport (\n\t\"context\"\n\t\"errors\"\n\t\"io\"\n\t\"slices\"\n\t\"sort\"\n\t\"strings\"\n\t\"time\"\n)\n\nvar (\n\t// NodeDownErr marks an operation as not able to complete since the node is\n\t// down.\n\tNodeDownErr = errors.New(\"node down\")\n)\n\nconst (\n\tAllocDesiredStatusRun   = \"run\"   // Allocation should run\n\tAllocDesiredStatusStop  = \"stop\"  // Allocation should stop\n\tAllocDesiredStatusEvict = \"evict\" // Allocation should stop, and was evicted\n)\n\nconst (\n\tAllocClientStatusPending  = \"pending\"\n\tAllocClientStatusRunning  = \"running\"\n\tAllocClientStatusComplete = \"complete\"\n\tAllocClientStatusFailed   = \"failed\"\n\tAllocClientStatusLost     = \"lost\"\n\tAllocClientStatusUnknown  = \"unknown\"\n)\n\nconst (","sourceCodeStart":1,"sourceCodeEnd":37,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/api/allocations.go#L1-L37","documentation":"Sentinel error returned by the Nomad API client when GetNodeClientWithTimeout cannot obtain an HTTP client because the target Nomad node is down or unreachable; signals the operation cannot be completed against that node.","triggerScenarios":"Thrown at api/allocations.go:19 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Check the node's health via nomad node status and restart/reconnect the Nomad agent on that node","Retry the operation once the node is back in the 'ready' state","Route exec/alloc operations to a different healthy node if applicable"],"exampleFix":null,"handlingStrategy":"try-catch","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"482b49bf1aec006f089bcfc7e632d8f6ac303e5e","analyzedAt":"2026-09-04T07:54:14.808Z","contentChangedAt":"2026-09-04T07:54:14.808Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}