feat(backup): support cancelRestore operation

Deprecate WeaviateBackupClient#cancel method, as it
is now ambiguous

Author: bevzzz

src/main/java/io/weaviate/client6/v1/api/backup/CancelBackupRestoreRequest.java

@@ -0,0 +1,14 @@
+package io.weaviate.client6.v1.api.backup;
+
+import java.util.Collections;
+
+import io.weaviate.client6.v1.internal.rest.Endpoint;
+import io.weaviate.client6.v1.internal.rest.SimpleEndpoint;
+
+public record CancelBackupRestoreRequest(String backupId, String backend) {
+
+  public static Endpoint<CancelBackupRestoreRequest, Void> _ENDPOINT = SimpleEndpoint.sideEffect(
+      request -> "DELETE",
+      request -> "/backups/" + request.backend + "/" + request.backupId + "/restore",
+      request -> Collections.emptyMap());
+}

src/main/java/io/weaviate/client6/v1/api/backup/WeaviateBackupClient.java

@@ -179,18 +179,49 @@ public List<Backup> list(String backend, Function<ListBackupsRequest.Builder, Ob
   /**
    * Cancel in-progress backup.
    *
-   * <p>
-   * This method cannot be called cancel backup restore.
-   *
    * @param backupId Backup ID.
    * @param backend  Backup storage backend.
    * @throws WeaviateApiException in case the server returned with an
    *                              error status code.
    * @throws IOException          in case the request was not sent successfully
    *                              due to a malformed request, a networking error
    *                              or the server being unavailable.
+   * @deprecated This method forwards to {@link #cancelCreate}. Prefer using the
+   *             latter, as it is less ambiguous.
    */
+  @Deprecated
   public void cancel(String backupId, String backend) throws IOException {
+    cancelCreate(backupId, backend);
+  }
+
+  /**
+   * Cancel in-progress backup creation.
+   *
+   * @param backupId Backup ID.
+   * @param backend  Backup storage backend.
+   * @throws WeaviateApiException in case the server returned with an
+   *                              error status code.
+   * @throws IOException          in case the request was not sent successfully
+   *                              due to a malformed request, a networking error
+   *                              or the server being unavailable.
+   */
+  public void cancelCreate(String backupId, String backend) throws IOException {
     this.restTransport.performRequest(new CancelBackupRequest(backupId, backend), CancelBackupRequest._ENDPOINT);
   }
+
+  /**
+   * Cancel in-progress backup restore.
+   *
+   * @param backupId Backup ID.
+   * @param backend  Backup storage backend.
+   * @throws WeaviateApiException in case the server returned with an
+   *                              error status code.
+   * @throws IOException          in case the request was not sent successfully
+   *                              due to a malformed request, a networking error
+   *                              or the server being unavailable.
+   */
+  public void cancelRestore(String backupId, String backend) throws IOException {
+    this.restTransport.performRequest(new CancelBackupRestoreRequest(backupId, backend),
+        CancelBackupRestoreRequest._ENDPOINT);
+  }
 }

src/main/java/io/weaviate/client6/v1/api/backup/WeaviateBackupClientAsync.java

@@ -124,16 +124,37 @@ public CompletableFuture<List<Backup>> list(String backend,
   }
 
   /**
-   * Cancel in-progress backup.
-   *
-   * <p>
-   * This method cannot be called cancel backup restore.
+   * Cancel in-progress backup creation.
    *
    * @param backupId Backup ID.
    * @param backend  Backup storage backend.
+   * @deprecated This method forwards to {@link #cancelCreate}. Prefer using the
+   *             latter, as it is less ambiguous.
    */
+  @Deprecated
   public CompletableFuture<Void> cancel(String backupId, String backend) {
+    return cancelCreate(backupId, backend);
+  }
+
+  /**
+   * Cancel in-progress backup creation.
+   *
+   * @param backupId Backup ID.
+   * @param backend  Backup storage backend.
+   */
+  public CompletableFuture<Void> cancelCreate(String backupId, String backend) {
     return this.restTransport.performRequestAsync(new CancelBackupRequest(backupId, backend),
         CancelBackupRequest._ENDPOINT);
   }
+
+  /**
+   * Cancel in-progress backup restore.
+   *
+   * @param backupId Backup ID.
+   * @param backend  Backup storage backend.
+   */
+  public CompletableFuture<Void> cancelRestore(String backupId, String backend) {
+    return this.restTransport.performRequestAsync(new CancelBackupRestoreRequest(backupId, backend),
+        CancelBackupRestoreRequest._ENDPOINT);
+  }
 }