別名作業 (預覽 REST API)

適用于：2023-07-01-Preview、2021-04-30-Preview

重要

2023-07-01-Preview (沒有變更) 。

2021-04-30-Preview 新增 API。

在 Azure AI 搜尋服務中，索引別名是搜尋索引的次要名稱。您可以建立對應至搜尋索引的別名，並在您參考索引名稱的位置以此取代別名名稱。如果您需要變更應用程式所指向的索引，這可讓您彈性。您可以只更新別名的對應，而不是更新應用程式程式碼中索引名稱的參考。

您可以透過 HTTP 要求在 Azure AI 搜尋服務中建立和管理別名， (POST、GET、PUT、DELETE) 對指定的別名資源。別名是服務等級資源，與搜尋索引分開維護。建立搜尋索引之後，您可以建立對應至該搜尋索引的別名。

注意

您只能搭配文件作業來使用別名，或藉此取得及更新索引定義。別名無法用來刪除索引、無法與分析文字 API 搭配使用，而且不能作為索引子上的 targetIndexName。

範例

下列範例示範如何建立對應至現有搜尋索引的別名。

POST /aliases?api-version=2023-07-01-Preview
{   
  "name" : "my-alias",  
  "indexes" : ["my-index"]
}