{"record":{"id":"9c56167e68fb05fc","repo":"apache/pulsar","slug":"bucket-cannot-be-empty-for-driver-offload","errorCode":null,"errorMessage":"Bucket cannot be empty for ${driver} offload","messagePattern":"Bucket cannot be empty for (.+?) offload","errorType":"validation","errorClass":"IllegalArgumentException","httpStatus":null,"severity":"error","filePath":"tiered-storage/jcloud/src/main/java/org/apache/bookkeeper/mledger/offload/jcloud/provider/JCloudBlobStoreProvider.java","lineNumber":295,"sourceCode":"    }\n\n    public String getDriver() {\n        return driver;\n    }\n\n    public ProviderMetadata getProviderMetadata() {\n        return providerMetadata;\n    }\n\n    // Constants for reuse across AWS, GCS, and Azure, etc.\n    static final ConfigValidation VALIDATION = (TieredStorageConfiguration config) -> {\n        if (Strings.isNullOrEmpty(config.getRegion()) && Strings.isNullOrEmpty(config.getServiceEndpoint())) {\n            throw new IllegalArgumentException(\n                \"Either Region or ServiceEndpoint must specified for \" + config.getDriver() + \" offload\");\n        }\n\n        if (Strings.isNullOrEmpty(config.getBucket())) {\n            throw new IllegalArgumentException(\n                \"Bucket cannot be empty for \" + config.getDriver() + \" offload\");\n        }\n\n        if (config.getMaxBlockSizeInBytes() < (5 * 1024 * 1024)) {\n            throw new IllegalArgumentException(\n                \"ManagedLedgerOffloadMaxBlockSizeInBytes cannot be less than 5MB for \"\n                + config.getDriver() + \" offload\");\n        }\n    };\n\n    static final BlobStoreBuilder BLOB_STORE_BUILDER = (TieredStorageConfiguration config) -> {\n        ContextBuilder contextBuilder = ContextBuilder.newBuilder(config.getProviderMetadata());\n        ShadedJCloudsUtils.addStandardModules(contextBuilder);\n        contextBuilder.overrides(config.getOverrides());\n\n        if (StringUtils.isNotEmpty(config.getServiceEndpoint())) {\n            contextBuilder.endpoint(config.getServiceEndpoint());\n        }","sourceCodeStart":277,"sourceCodeEnd":313,"githubUrl":"https://github.com/apache/pulsar/blob/820761864ed8e2a7d2e52dd9763ad2ae117c1395/tiered-storage/jcloud/src/main/java/org/apache/bookkeeper/mledger/offload/jcloud/provider/JCloudBlobStoreProvider.java#L277-L313","documentation":"Shared tiered-storage config validation (the VALIDATION lambda used by AWS/GCS/Azure drivers): the managedLedgerOffloadBucket setting is null or empty, so offloaded ledger blocks have no destination container; the bucket configuration key for the named driver is the faulty input.","triggerScenarios":"Thrown at tiered-storage/jcloud/src/main/java/org/apache/bookkeeper/mledger/offload/jcloud/provider/JCloudBlobStoreProvider.java:295 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set managedLedgerOffloadBucket to an existing bucket/container name"],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"820761864ed8e2a7d2e52dd9763ad2ae117c1395","analyzedAt":"2026-09-06T00:14:20.138Z","contentChangedAt":"2026-09-06T00:14:20.138Z","schemaVersion":2},"datasetVersion":"2026-09-14T00:17:10.932Z"}