ConfigSets API使您可以創(chuàng)建、刪除和以其他方式管理ConfigSets。

要將使用此API創(chuàng)建的ConfigSet用作集合的配置，請(qǐng)使用Collections API。

此API只能與在SolrCloud模式下運(yùn)行的Solr一起使用。如果您沒(méi)有在SolrCloud模式下運(yùn)行Solr，但仍希望使用共享配置，請(qǐng)參閱配置集。

配置API入口點(diǎn)

所有API調(diào)用的基本URL是http://<hostname>:<port>/solr。

• /admin/configs?action=CREATE：根據(jù)現(xiàn)有的ConfigSet創(chuàng)建一個(gè)ConfigSet
• /admin/configs?action=DELETE：刪除一個(gè)ConfigSet
• /admin/configs?action=LIST：列出所有ConfigSets
• /admin/configs?action=UPLOAD：上傳一個(gè)ConfigSet

創(chuàng)建一個(gè)ConfigSet

/admin/configs?action=CREATE&name=name&baseConfigSet=baseConfigSet

根據(jù)現(xiàn)有的ConfigSet創(chuàng)建一個(gè)ConfigSet。

創(chuàng)建ConfigSet參數(shù)

創(chuàng)建ConfigSet時(shí)支持以下參數(shù)。

• name
  

  要?jiǎng)?chuàng)建的ConfigSet。該參數(shù)是必需的。

• baseConfigSet
  

  將ConfigSet復(fù)制為基礎(chǔ)。該參數(shù)是必需的。

• configSetProp.name = value
  

  從基地的任何ConfigSet屬性覆蓋。

創(chuàng)建ConfigSet響應(yīng)

ConfigSet響應(yīng)將包括請(qǐng)求的狀態(tài)。如果狀態(tài)不是“success”，則會(huì)顯示錯(cuò)誤消息，說(shuō)明請(qǐng)求失敗的原因。

創(chuàng)建配置集示例

配置集示例的輸入

創(chuàng)建一個(gè)名為'myConfigSet'的ConfigSet，它基于'predefinedTemplate'ConfigSet，將不可變屬性重寫(xiě)為false。

http://localhost:8983/solr/admin/configs?action=CREATE&name=myConfigSet&baseConfigSet=predefinedTemplate&configSetProp.immutable=false

該配置集的輸出

<response>
  <lst name="responseHeader">
    <int name="status">0</int>
    <int name="QTime">323</int>
  </lst>
</response>

刪除配置集

/admin/configs?action=DELETE&name=name

刪除配置集

刪除ConfigSet參數(shù)

• name
  

  要?jiǎng)h除的ConfigSet。該參數(shù)是必需的。

刪除ConfigSet響應(yīng)

輸出將包含請(qǐng)求的狀態(tài)。如果狀態(tài)不是“success”，則會(huì)顯示錯(cuò)誤消息，說(shuō)明請(qǐng)求失敗的原因。

刪除配置集示例

輸入如下：

刪除配置集'myConfigSet'

http://localhost:8983/solr/admin/configs?action=DELETE&name=myConfigSet

輸出如下：

<response>
  <lst name="responseHeader">
    <int name="status">0</int>
    <int name="QTime">170</int>
  </lst>
</response>

列出配置集

/admin/configs?action=LIST

獲取群集中ConfigSet的名稱(chēng)。

列出配置集示例

輸入如下：

http://localhost:8983/solr/admin/configs?action=LIST

得到輸出：

{
  "responseHeader":{
    "status":0,
    "QTime":203},
  "configSets":["myConfigSet1",
    "myConfig2"]}

上傳一個(gè)配置集

/admin/configs?action=UPLOAD&name=name

上傳一個(gè)ConfigSet，作為一個(gè)壓縮文件發(fā)送。請(qǐng)注意，如果啟用了身份驗(yàn)證，并且該上傳操作作為已驗(yàn)證的請(qǐng)求執(zhí)行，則會(huì)以“trusted”模式上傳ConfigSet。沒(méi)有身份驗(yàn)證，ConfigSet以“untrusted”模式上傳。使用“untrusted”的ConfigSet創(chuàng)建集合時(shí)，以下功能將不起作用：

• 不會(huì)初始化RunExecutableListener，如果在ConfigSet中指定的話(huà)。
• DataImportHandler的ScriptTransformer不會(huì)初始化，如果在ConfigSet中指定的話(huà)。
• XSLT變換器（tr參數(shù)）不能在請(qǐng)求處理時(shí)使用。
• 如果在ConfigSet中指定，StatelessScriptUpdateProcessor不會(huì)初始化。

上傳ConfigSet參數(shù)

• name
  

  上傳完成后要?jiǎng)?chuàng)建的ConfigSet。該參數(shù)是必需的。

請(qǐng)求的主體應(yīng)該包含一個(gè)壓縮配置集。

上傳ConfigSet響應(yīng)

輸出將包含請(qǐng)求的狀態(tài)。如果狀態(tài)不是“success”，則會(huì)顯示錯(cuò)誤消息，說(shuō)明請(qǐng)求失敗的原因。

上傳ConfigSet示例

從壓縮文件myconfigset.zip創(chuàng)建一個(gè)名為“myConfigSet”的配置集。該壓縮文件必須從conf目錄中創(chuàng)建（即solrconfig.xml必須是zip文件中的頂層條目）。這里是一個(gè)關(guān)于如何創(chuàng)建zip文件并上傳的例子。

$ (cd solr/server/solr/configsets/sample_techproducts_configs/conf && zip -r - *) > myconfigset.zip

$ curl -X POST --header "Content-Type:application/octet-stream" --data-binary @myconfigset.zip "http://localhost:8983/solr/admin/configs?action=UPLOAD&name=myConfigSet"

使用unix管道可以實(shí)現(xiàn)同樣的效果，不需要?jiǎng)?chuàng)建一個(gè)中間的zip文件，如下所示：

$ (cd server/solr/configsets/sample_techproducts_configs/conf && zip -r - *) | curl -X POST --header "Content-Type:application/octet-stream" --data-binary @- "http://localhost:8983/solr/admin/configs?action=UPLOAD&name=myConfigSet"