[CONF] Apache Solr Reference Guide > Collections API

["Cassandra Targett (Confluence)" <co...@apache.org>]

Space: Apache Solr Reference Guide (https://cwiki.apache.org/confluence/display/solr)
Page: Collections API (https://cwiki.apache.org/confluence/display/solr/Collections+API)
Comment: https://cwiki.apache.org/confluence/display/solr/Collections+API?focusedCommentId=33296193#comment-33296193

Comment added by Cassandra Targett:
---------------------------------------------------------------------

Here are some suggested changes for 4.4 to update this page for DELETESHARD action:

1. In section "API Entry Points", under SPLITSHARD, add:

{noformat}
{{/admin/collections?action=DELETESHARD}}: [delete|#api7] an inactive shard
{noformat}

2. Add a new section, right after "Split a Shard" (you should be able to copy/paste the below):

{noformat}
{anchor:api7}

h2. Delete a Shard

Deleting a shard will unload all replicas of the shard and remove them from {{clusterstate.json}}. It will only remove shards that are inactive, or which have no range given for custom sharding.

{{/admin/collections?action=DELETESHARD&shard=_shardID_&collection=_name_}}

h4. {bgcolor:#FEECC4}{*}Input{*}{bgcolor}

*Query Parameters*

|| Key || Type || Required || Description ||
| collection | string | Yes | The name of the collection that includes the shard to be split. |
| shard | string | Yes | The name of the shard to be split. |

h4. {bgcolor:#FEECC4}{*}Output{*}{bgcolor}

*Output Content*

The output will include the status of the request. If the status is anything other than "success", an error message will explain why the request failed.

h4. {bgcolor:#FEECC4}{*}Examples{*}{bgcolor}

*Input*
Delete 'shard1' of the "anotherCollection" collection.

{code:borderStyle=solid|borderColor=#666666}
http://10.0.1.6:8983/solr/admin/collections?action=DELETESHARD&collection=anotherCollection&shard=shard1
{code}

*Output*

{code:borderStyle=solid|borderColor=#666666}
<response>
   <lst name="responseHeader">
      <int name="status">0</int>
      <int name="QTime">558</int>
   </lst>
   <lst name="success">
      <lst name="10.0.1.4:8983_solr">
         <lst name="responseHeader">
            <int name="status">0</int>
            <int name="QTime">27</int>
         </lst>
      </lst>
   </lst>
</response>
{code}

{noformat}



Stop watching space: https://cwiki.apache.org/confluence/users/removespacenotification.action?spaceKey=solr
Change email notification preferences: https://cwiki.apache.org/confluence/users/editmyemailsettings.action