{"record":{"id":"7842f85cfe2923f4","repo":"hashicorp/nomad","slug":"s-q","errorCode":null,"errorMessage":"%s %q","messagePattern":"%s %q","errorType":"exception","errorClass":"ErrUnknownAllocationPrefix","httpStatus":null,"severity":"error","filePath":"nomad/structs/errors.go","lineNumber":137,"sourceCode":"// the given node.\nfunc IsErrNoNodeConn(err error) bool {\n\treturn err != nil && strings.Contains(err.Error(), errNoNodeConn)\n}\n\n// IsErrUnknownMethod returns whether the error is due to the operation not\n// being allowed due to lack of permissions.\nfunc IsErrUnknownMethod(err error) bool {\n\treturn err != nil && strings.Contains(err.Error(), errUnknownMethod)\n}\n\nfunc IsErrRPCCoded(err error) bool {\n\treturn err != nil && strings.HasPrefix(err.Error(), errRPCCodedErrorPrefix)\n}\n\n// NewErrUnknownAllocation returns a new error caused by the allocation being\n// unknown.\nfunc NewErrUnknownAllocation(allocID string) error {\n\treturn fmt.Errorf(\"%s %q\", ErrUnknownAllocationPrefix, allocID)\n}\n\n// NewErrUnknownNode returns a new error caused by the node being unknown.\nfunc NewErrUnknownNode(nodeID string) error {\n\treturn fmt.Errorf(\"%s %q\", ErrUnknownNodePrefix, nodeID)\n}\n\n// NewErrUnknownJob returns a new error caused by the job being unknown.\nfunc NewErrUnknownJob(jobID string) error {\n\treturn fmt.Errorf(\"%s %q\", ErrUnknownJobPrefix, jobID)\n}\n\n// NewErrUnknownEvaluation returns a new error caused by the evaluation being\n// unknown.\nfunc NewErrUnknownEvaluation(evaluationID string) error {\n\treturn fmt.Errorf(\"%s %q\", ErrUnknownEvaluationPrefix, evaluationID)\n}\n","sourceCodeStart":119,"sourceCodeEnd":155,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/nomad/structs/errors.go#L119-L155","documentation":"NewErrUnknownAllocation builds the sentinel-style error signaling that the client does not know the referenced allocation (e.g. it is not running on that node); RPC/streaming handlers use it so callers can distinguish unknown allocs via IsErrUnknownAllocation.","triggerScenarios":"Thrown at nomad/structs/errors.go:137 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify the allocation ID exists and is assigned to the targeted client","Refresh allocation state from the server before retrying","Treat as non-retryable for that client and clean up stale references"],"exampleFix":null,"handlingStrategy":"validation","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"}