Support dynamic backup location

[bevzzz]

This PR extends sync/async clients to accept bucket and path parameters in backup operations.

As query parameters: create status, restore status, cancel.
As request body parameters: create, restore.

How is this tested?

New tests case in BackupTestSuite. It's only limitation is that it doesn't verify that the bucket was set correctly, because bucket is irrelevant for "filesystem" backend, which we use in the tests.

We do pass this parameter in all requests.

[orca-security-eu]

Orca Security Scan Summary

Status	Check	Issues by priority
Passed	Infrastructure as Code	0   0   0   0	View in Orca
Passed	Secrets	0   0   0   0	View in Orca
Passed	Vulnerabilities	0   0   0   0	View in Orca

[bevzzz]

@antas-marcin atm I am using this pattern for adding query parameters to the request:

String path = String.format("/backups/%s/%s/restore", UrlEncoder.encodePathParam(backend), UrlEncoder.encodePathParam(backupId));
try {
  path = new URIBuilder(path)
    .addParameter("bucket", bucket)
    .addParameter("path", this.path)
    .toString();
} catch (URISyntaxException e) {
}
return sendRequest(path, ...)

Here, if adding these parameters fails we would send the request without them. "It should never happen in practice" is the underlying assumption here and it's true as long as the initial path is a valid URI. Which is an assumption that we make in other places as well.

Still, I think that maybe we should throw a RuntimeException in the catch-block here, so that the users are made aware that the request they wanted to send could not be sent. WDYT?

---

UPD: moved away from using URIBuilder, so this isn't an issue anymore.

[weaviate-git-bot]

Great to see you again! Thanks for the contribution.

beep boop - the Weaviate bot 👋🤖

PS:
Are you already a member of the Weaviate Slack channel?

[orca-security-eu]

Orca Security Scan Summary

Status	Check	Issues by priority
Passed	Infrastructure as Code	0   0   0   0	View in Orca
Passed	SAST	0   0   0   0	View in Orca
Passed	Secrets	0   0   0   0	View in Orca
Passed	Vulnerabilities	0   0   0   0	View in Orca