[
https://issues.apache.org/jira/browse/SOLR-16394?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17723183#comment-17723183
]
ASF subversion and git services commented on SOLR-16394:
--------------------------------------------------------
Commit e8ac46eb782ed492b34be4c02cbdf553bfb92963 in solr's branch
refs/heads/main from Jason Gerlowski
[ https://gitbox.apache.org/repos/asf?p=solr.git;h=e8ac46eb782 ]
SOLR-16394: Tweak backup listing, deletion to be more REST-ful (#1639)
This commit tweaks the v2 bindings for our "delete" and "list backups" APIs to
be
more intuitive for users. DELETEBACKUP now has two v2 bindings: one to delete
backups by ID (`DELETE /api/backups/backupName/versions/<id>`), and one to
delete all but the most recent 'N' backups
(`DELETE /api/backups/backupName/versions?retainLatest=<N>`).
Backup listing is now available at `GET /api/backups/backupName/versions`
> Cosmetic improvements and migration to JAX-RS (snapshot, backup APIs)
> ---------------------------------------------------------------------
>
> Key: SOLR-16394
> URL: https://issues.apache.org/jira/browse/SOLR-16394
> Project: Solr
> Issue Type: Sub-task
> Components: v2 API
> Affects Versions: main (10.0)
> Reporter: Jason Gerlowski
> Assignee: Jason Gerlowski
> Priority: Major
> Labels: newdev
> Time Spent: 1h 10m
> Remaining Estimate: 0h
>
> As mentioned on SOLR-15781, the v2 API currently has an experimental
> designation, and the community has expressed an interest in using this period
> to update our v2 endpoints to be more REST-ful and consistent. The current
> plan is to follow the specific changes laid out in [this
> spreadsheet|https://docs.google.com/spreadsheets/d/1HAoBBFPpSiT8mJmgNZKkZAPwfCfPvlc08m5jz3fQBpA/edit?usp=sharing],
> though of course nothing there is set in stone and there are still warts to
> be worked out.
> While we're touching the code for these endpoints, we should also convert
> them to JAX-RS framework definitions. (This was initially tracked as a
> separate effort - see SOLR-16370 - but the edit that were required ended up
> overlapping so significantly with the "cosmetic" improvements here that in
> practice it almost always makes sense to do the two together.)
> This ticket plans to tackle making the changes required for Solr's snapshot
> and backup APIs, as described in the spreadsheet linked above. For
> convenience and ease of tracking, these APIs are summarized in the table
> below:
> ||API Name||Original Form||Desired Form||Status||Volunteer||
> |List Backups|POST /api/collections/backups \{list-backups: \{...\}\}|GET
> /api/backups/backupName/versions?location=asdf|Open|N/A|
> |-Create Backup-|-POST /api/collections \{backup-collection: \{...\}\}-|-POST
> /api/collections/collectionName/backups/backupName/versions
> \{...\}-|-Finished-|-Jason-|
> |Delete Backup (by ID)|POST /api/collections/backups \{delete-backups:
> \{...\}\}|DELETE /api/backups/backupName/versions/123?location=asdf|Open|N/A|
> |Delete All Backups (Except Most Recent 'N')|POST /api/collections/backups
> \{delete-backups: \{...\}\}|DELETE
> /api/backups/backupName/versions?maxUnused=7&...|Open|N/A|
> |Garbage Collect Unused Backup Files|POST /api/collections/backups
> \{delete-backups: \{...\}\}|DELETE
> /api/backups/backupName/versions?purgeUnused=true&...|Open|N/A|
> |-Restore Collection Backup-|-POST /api/collections \{restore-collection:
> \{...\}\}-|-POST /api/backups/backupName/restore \{...\}-|-Finished-|-Jason-|
--
This message was sent by Atlassian Jira
(v8.20.10#820010)
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
