[SOLR-16479] Support for `repository` parameter in v2 api for restores

• Type: Improvement
• Status: Resolved
• Priority: Major
• Resolution: Fixed
• Affects Version/s: 8.11.2
• Component/s: Backup/Restore, v2 API
• Labels: Backup/Restore V2
• Assignee: Unassigned
• Reporter: Josh Souza
• Created: 19/Oct/22 21:01
• Updated: 09/Sep/24 15:06
• Resolved: 09/Sep/24 15:06

Description

The v1 API for restoring from backups (https://solr.apache.org/guide/solr/latest/deployment-guide/collection-management.html#restore )

includes the optional parameter `repository`, which can be utilized to trigger restores from a particular backup repository. However, the v2 api, located at `api/collections?command=restore-collection`, does not include this parameter.

While I assume most use-cases have 0-1 backup repositories configured, in the situation where you have configured multiple repositories, the v2 api will only permit restoring from the first one configured. (An example situation where this may arise is during a migration from one storage backend to another, or when restoring from a source that is different from where you will want backups to go in the future)

This is a gap in functionality between the API versions, and I assume most tooling continues to utilize the v1 API at this point, but for full interoperability between the versions, and to support users migrating off of the v1 API, this parameter will need to be exposed.