你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

别名操作（预览版 REST API）

适用于：2023-07-01-Preview。此版本不再受支持。将立即升级到较新版本。

重要

2023-07-01-Preview（无更改）。

2021-04-30-Preview 添加了 API。

在 Azure AI 搜索中，索引别名是搜索索引的辅助名称。可以创建映射到搜索索引的别名，并在引用索引名称的位置替换别名。如果需要更改应用程序指向的索引，这样可以灵活地操作。只需更新别名的映射，即可更新对应用程序代码中的索引名称的引用。

可以通过 HTTP 请求（POST、GET、PUT、DELETE）针对给定的别名资源在 Azure AI 搜索服务中创建和管理别名。别名是服务级别资源，独立于搜索索引进行维护。创建搜索索引后，可以创建映射到该搜索索引的别名。

注意

只能将别名用于文档操作或获取和更新索引定义。别名不能用于删除索引，不能与分析文本 API 一起使用，也不能用作索引器的 targetIndexName。

例

以下示例演示如何创建映射到现有搜索索引的别名。

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