{"record":{"id":"9b99e5d08f671034","repo":"apache/pulsar","slug":"either-region-or-serviceendpoint-must-specified-fo","errorCode":null,"errorMessage":"Either Region or ServiceEndpoint must specified for ${driver} offload","messagePattern":"Either Region or ServiceEndpoint must specified 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":290,"sourceCode":"    private ProviderMetadata providerMetadata;\n\n    JCloudBlobStoreProvider(String s, ProviderMetadata providerMetadata) {\n        this.driver = s;\n        this.providerMetadata = providerMetadata;\n    }\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);","sourceCodeStart":272,"sourceCodeEnd":308,"githubUrl":"https://github.com/apache/pulsar/blob/820761864ed8e2a7d2e52dd9763ad2ae117c1395/tiered-storage/jcloud/src/main/java/org/apache/bookkeeper/mledger/offload/jcloud/provider/JCloudBlobStoreProvider.java#L272-L308","documentation":"Shared tiered-storage config validation (the VALIDATION lambda used by AWS/GCS/Azure drivers): neither managedLedgerOffloadRegion nor managedLedgerOffloadServiceEndpoint is set, leaving jclouds with no target region or endpoint; at least one must be configured for the named driver.","triggerScenarios":"Thrown at tiered-storage/jcloud/src/main/java/org/apache/bookkeeper/mledger/offload/jcloud/provider/JCloudBlobStoreProvider.java:290 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Set managedLedgerOffloadServiceEndpoint or managedLedgerOffloadRegion"],"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-14T05:17:10.506Z"}