{"record":{"id":"bfebd54b7b15869f","repo":"googleapis/mcp-toolbox","slug":"range-q-has-a-bad-suffix-length","errorCode":null,"errorMessage":"range %q has a bad suffix length","messagePattern":"range %q has a bad suffix length","errorType":"validation","errorClass":null,"httpStatus":null,"severity":"error","filePath":"internal/tools/cloudstorage/cloudstoragereadobject/cloudstoragereadobject.go","lineNumber":184,"sourceCode":"\t}\n\tspec = strings.TrimPrefix(spec, \"bytes=\")\n\n\tdash := strings.IndexByte(spec, '-')\n\tif dash < 0 {\n\t\treturn 0, 0, fmt.Errorf(\"range %q is missing '-'\", rangeSpec)\n\t}\n\n\tstartStr := spec[:dash]\n\tendStr := spec[dash+1:]\n\n\tswitch {\n\tcase startStr == \"\" && endStr == \"\":\n\t\treturn 0, 0, fmt.Errorf(\"range %q requires at least one bound\", rangeSpec)\n\n\tcase startStr == \"\":\n\t\tn, parseErr := strconv.ParseInt(endStr, 10, 64)\n\t\tif parseErr != nil || n <= 0 {\n\t\t\treturn 0, 0, fmt.Errorf(\"range %q has a bad suffix length\", rangeSpec)\n\t\t}\n\t\treturn -n, -1, nil\n\n\tcase endStr == \"\":\n\t\tstart, parseErr := strconv.ParseInt(startStr, 10, 64)\n\t\tif parseErr != nil || start < 0 {\n\t\t\treturn 0, 0, fmt.Errorf(\"range %q has a bad start\", rangeSpec)\n\t\t}\n\t\treturn start, -1, nil\n\n\tdefault:\n\t\tstart, parseErr := strconv.ParseInt(startStr, 10, 64)\n\t\tif parseErr != nil || start < 0 {\n\t\t\treturn 0, 0, fmt.Errorf(\"range %q has a bad start\", rangeSpec)\n\t\t}\n\t\tend, parseErr := strconv.ParseInt(endStr, 10, 64)\n\t\tif parseErr != nil || end < start {\n\t\t\treturn 0, 0, fmt.Errorf(\"range %q has a bad end\", rangeSpec)","sourceCodeStart":166,"sourceCodeEnd":202,"githubUrl":"https://github.com/googleapis/mcp-toolbox/blob/8cc6e09de2ad7b8bffc77751799585a1401a48eb/internal/tools/cloudstorage/cloudstoragereadobject/cloudstoragereadobject.go#L166-L202","documentation":"Range-parser guard for the suffix form 'bytes=-N': N is not a parseable integer or is <= 0, so the 'last N bytes' request is meaningless.","triggerScenarios":"Thrown at internal/tools/cloudstorage/cloudstoragereadobject/cloudstoragereadobject.go:184 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a positive integer suffix length, e.g. 'bytes=-512'","Use an explicit start-based range if the tail length is not what you want"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"8cc6e09de2ad7b8bffc77751799585a1401a48eb","analyzedAt":"2026-09-05T01:10:36.887Z","contentChangedAt":"2026-09-05T01:10:36.887Z","schemaVersion":2},"datasetVersion":"2026-09-08T10:18:20.063Z"}