{"record":{"id":"b335af45f3fe9c13","repo":"apache/hadoop","slug":"bandwidth-should-not-exceed-maximum-limit-bytes","errorCode":null,"errorMessage":"Bandwidth should not exceed maximum limit {} bytes per second","messagePattern":"Bandwidth should not exceed maximum limit (.+?) bytes per second","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/NameNodeRpcServer.java","lineNumber":1494,"sourceCode":"\n    String[] files = new String[fbs.size()];\n    int i = 0;\n    for(FSNamesystem.CorruptFileBlockInfo fb: fbs) {\n      files[i++] = fb.path;\n    }\n    return new CorruptFileBlocks(files, cookieTab[0]);\n  }\n\n  /**\n   * Tell all datanodes to use a new, non-persistent bandwidth value for\n   * dfs.datanode.balance.bandwidthPerSec.\n   * @param bandwidth Balancer bandwidth in bytes per second for all datanodes.\n   * @throws IOException\n   */\n  @Override // ClientProtocol\n  public void setBalancerBandwidth(long bandwidth) throws IOException {\n    if (bandwidth > HdfsServerConstants.MAX_BANDWIDTH_PER_DATANODE) {\n      throw new IllegalArgumentException(\n          \"Bandwidth should not exceed maximum limit \"\n              + HdfsServerConstants.MAX_BANDWIDTH_PER_DATANODE\n              + \" bytes per second\");\n    }\n    checkNNStartup();\n    namesystem.setBalancerBandwidth(bandwidth);\n  }\n  \n  @Override // ClientProtocol\n  public ContentSummary getContentSummary(String path) throws IOException {\n    checkNNStartup();\n    return namesystem.getContentSummary(path);\n  }\n\n  @Override // ClientProtocol\n  public QuotaUsage getQuotaUsage(String path) throws IOException {\n    checkNNStartup();\n    return namesystem.getQuotaUsage(path);","sourceCodeStart":1476,"sourceCodeEnd":1512,"githubUrl":"https://github.com/apache/hadoop/blob/2add9630210752f88ceb1bb74eb65e37bf41da8e/hadoop-hdfs-project/hadoop-hdfs/src/main/java/org/apache/hadoop/hdfs/server/namenode/NameNodeRpcServer.java#L1476-L1512","documentation":"Error \"Bandwidth should not exceed maximum limit {} bytes per second\" thrown in apache/hadoop.","triggerScenarios":"setBalancerBandwidth is called with a value exceeding the configured maximum limit.","commonSituations":"Running 'hdfs dfsadmin -setBalancerBandwidth' with a value above the allowed cap.","solutions":["Set the balancer bandwidth at or below the maximum configured via dfs.balancer.max-bandwidth / dfs.datanode.balance.bandwidthPerSec."],"exampleFix":null,"handlingStrategy":null,"validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2add9630210752f88ceb1bb74eb65e37bf41da8e","analyzedAt":"2026-08-22T19:55:07.957Z","schemaVersion":2},"datasetVersion":"2026-08-22T20:17:22.307Z"}