{"record":{"id":"9614c964eb5dd3c8","repo":"hashicorp/nomad","slug":"no-such-allocation-on-client-or-allocation-not-el","errorCode":null,"errorMessage":"No such allocation on client, or allocation not eligible for GC","messagePattern":"No such allocation on client, or allocation not eligible for GC","errorType":"exception","errorClass":"ErrPermissionDenied-path (returns plain error)","httpStatus":null,"severity":"error","filePath":"client/alloc_endpoint.go","lineNumber":71,"sourceCode":"\tdefer metrics.MeasureSince([]string{\"client\", \"allocations\", \"garbage_collect\"}, time.Now())\n\n\talloc, err := a.c.GetAlloc(args.AllocID)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\t// Check namespace submit job permission.\n\tif aclObj, err := a.c.ResolveToken(args.AuthToken); err != nil {\n\t\treturn err\n\t} else if !aclObj.AllowNsOpAnyOf(alloc.Namespace,\n\t\tacl.NamespaceCapabilitySubmitJob,\n\t\tacl.NamespaceCapabilityGCAllocation,\n\t) {\n\t\treturn nstructs.ErrPermissionDenied\n\t}\n\n\tif !a.c.CollectAllocation(args.AllocID) {\n\t\treturn fmt.Errorf(\"No such allocation on client, or allocation not eligible for GC\")\n\t}\n\n\treturn nil\n}\n\n// Signal is used to send a signal to an allocation's tasks on a client.\nfunc (a *Allocations) Signal(args *nstructs.AllocSignalRequest, reply *nstructs.GenericResponse) error {\n\tdefer metrics.MeasureSince([]string{\"client\", \"allocations\", \"signal\"}, time.Now())\n\n\talloc, err := a.c.GetAlloc(args.AllocID)\n\tif err != nil {\n\t\treturn err\n\t}\n\n\t// Check namespace alloc-lifecycle permission.\n\tif aclObj, err := a.c.ResolveToken(args.AuthToken); err != nil {\n\t\treturn err\n\t} else if !aclObj.AllowNsOp(alloc.Namespace, acl.NamespaceCapabilityAllocLifecycle) {","sourceCodeStart":53,"sourceCodeEnd":89,"githubUrl":"https://github.com/hashicorp/nomad/blob/482b49bf1aec006f089bcfc7e632d8f6ac303e5e/client/alloc_endpoint.go#L53-L89","documentation":"Sentinel error from the client's GarbageCollect RPC handler: CollectAllocation returned false, meaning the allocation ID does not exist on this client or the allocation is in a state (e.g. still running or not terminal) that makes it ineligible for garbage collection.","triggerScenarios":"Thrown at client/alloc_endpoint.go:71 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Verify the allocation ID is correct and was placed on this client node","Wait until the allocation is terminal/finished before forcing GC","List allocations on the node to confirm the ID exists locally","Retry GC after the allocation's GC eligibility window passes"],"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"}