{"record":{"id":"3b86b35ac7560c8b","repo":"apache/flink","slug":"a-savepoint-cannot-be-taken-through-the-job-client","errorCode":null,"errorMessage":"A savepoint cannot be taken through the Job Client when in Web Submission.","messagePattern":"A savepoint cannot be taken through the Job Client when in Web Submission\\.","errorType":"exception","errorClass":"FlinkRuntimeException","httpStatus":null,"severity":"error","filePath":"flink-clients/src/main/java/org/apache/flink/client/deployment/application/WebSubmissionJobClient.java","lineNumber":80,"sourceCode":"    @Override\n    public CompletableFuture<Void> cancel() {\n        throw new FlinkRuntimeException(\n                \"Cancelling the job is not supported by the Job Client when in Web Submission.\");\n    }\n\n    @Override\n    public CompletableFuture<String> stopWithSavepoint(\n            boolean advanceToEndOfEventTime,\n            @Nullable String savepointDirectory,\n            SavepointFormatType formatType) {\n        throw new FlinkRuntimeException(\n                \"Stop with Savepoint is not supported by the Job Client when in Web Submission.\");\n    }\n\n    @Override\n    public CompletableFuture<String> triggerSavepoint(\n            @Nullable String savepointDirectory, SavepointFormatType formatType) {\n        throw new FlinkRuntimeException(\n                \"A savepoint cannot be taken through the Job Client when in Web Submission.\");\n    }\n\n    @Override\n    public CompletableFuture<Map<String, Object>> getAccumulators() {\n        throw new FlinkRuntimeException(\n                \"The Accumulators cannot be fetched through the Job Client when in Web Submission.\");\n    }\n\n    @Override\n    public CompletableFuture<JobExecutionResult> getJobExecutionResult() {\n        throw new FlinkRuntimeException(\n                \"The Job Result cannot be fetched through the Job Client when in Web Submission.\");\n    }\n}\n","sourceCodeStart":62,"sourceCodeEnd":96,"githubUrl":"https://github.com/apache/flink/blob/2f3c205e9266cb30240eb7f4fdab15cad629a70f/flink-clients/src/main/java/org/apache/flink/client/deployment/application/WebSubmissionJobClient.java#L62-L96","documentation":"WebSubmissionJobClient's savepoint-related methods unconditionally throw FlinkRuntimeException: after a web (REST) submission the client possesses only the JobID and no cluster connection, so it cannot trigger a savepoint. This is a sentinel guard indicating the operation is structurally unavailable in web submission mode, not a transient failure.","triggerScenarios":"Triggered at runtime when the operation fails because: A savepoint cannot be taken through the Job Client when in Web Submission.","commonSituations":"Commonly caused by misconfiguration, missing dependencies or files, unsupported types or operations, or invalid user input leading to: A savepoint cannot be taken through the Job Client when in Web Submission.","solutions":["Address the cause reported by the error message: A savepoint cannot be taken through the Job Client when in Web Submission.","Verify the inputs, configuration values, and classpath/dependency setup related to this operation, then retry."],"exampleFix":"Correct the condition described (\"A savepoint cannot be taken through the Job Client when in Web Submission.\") and rerun the job or command.","handlingStrategy":"type-guard","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"2f3c205e9266cb30240eb7f4fdab15cad629a70f","analyzedAt":"2026-08-14T08:48:24.518Z","contentChangedAt":"2026-08-14T08:48:24.518Z","schemaVersion":2},"datasetVersion":"2026-09-23T08:17:48.524Z"}