You are viewing a plain text version of this content. The canonical link for it is here.
Posted to issues@solr.apache.org by "ASF subversion and git services (Jira)" <ji...@apache.org> on 2023/05/10 12:57:00 UTC

[jira] [Commented] (SOLR-16392) Cosmetic improvements and migration to JAX-RS (shard, replica, and replicaprop CRUD APIs)

    [ https://issues.apache.org/jira/browse/SOLR-16392?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17721341#comment-17721341 ] 

ASF subversion and git services commented on SOLR-16392:
--------------------------------------------------------

Commit a93a25b94fb6520da040b1d3ef0ccd2d1534ce78 in solr's branch refs/heads/main from Jason Gerlowski
[ https://gitbox.apache.org/repos/asf?p=solr.git;h=a93a25b94fb ]

SOLR-16392: Tweak v2 deletereplica to be more REST-ful (#1594)

This commit tweaks the v2 binding for our "delete replica" API to be more
intuitive for users.  Delete replica functionality now lives at:
  - `DELETE /api/collections/cName/shards/sName/replicas/rName`
  - `DELETE /api/collections/cName/shards/sName/replicas?count=3`
  - `PUT /api/collections/cName/scale {"count": 3"}

depending on whether users want to delete a single replica by name,
multiple replicas from a single shard, or multiple replicas from all shards
respectively.  These v2 APIs are experimental and currently subject to
change.

This commit also switches them (and a similar deleteshard API) over to
using JAX-RS.

> Cosmetic improvements and migration to JAX-RS (shard, replica, and replicaprop CRUD APIs)
> -----------------------------------------------------------------------------------------
>
>                 Key: SOLR-16392
>                 URL: https://issues.apache.org/jira/browse/SOLR-16392
>             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: 7h 50m
>  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 shard, replica and replica-prop CRUD APIs, as described in the spreadsheet linked above.  For convenience and ease of tracking, these APIs are summarized in the table below:
> *Cosmetic Changes and JAX-RS Conversion*
> ||API Name||Original Form||Desired Form||Status||Volunteer||
> |Create Shard|POST /api/collections/collName/shards \{create: \{...\}\}|POST /api/collections/collName/shards \{...\}|Open|N/A|
> |Create Replica|POST /api/collections/collName/shards \{"add-replica": \{...\}\}|POST /api/collections/collName/shards/shardName/replicas \{...\}|Open|N/A|
> *JAX-RS Conversion Only*
> ||API Name||Endpoint Format||Status||Volunteer||
> |Delete Shard|DELETE /api/collections/collName/shards/shardName|Open|N/A|
> |Delete Replica|DELETE /api/collections/collName/shards/shard1/repName|Open|N/A|



--
This message was sent by Atlassian Jira
(v8.20.10#820010)

---------------------------------------------------------------------
To unsubscribe, e-mail: issues-unsubscribe@solr.apache.org
For additional commands, e-mail: issues-help@solr.apache.org