删除别名 （预览版 REST API）

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

重要

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

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

删除别名 操作从 Azure AI 搜索服务中删除别名。

DELETE https://[service name].search.windows.net/aliases/[alias name]?api-version=[api-version]      
  Content-Type: application/json  
  api-key: [admin key]  

如果尝试删除当前映射到别名的索引，该操作将失败并显示 400（错误请求）和一条错误消息，指出映射到该索引的别名（es）必须被删除或映射到其他索引，然后才能删除索引。

URI 参数

参数	描述
服务名称	必填。 将此设置为搜索服务的唯一用户定义的名称。
别名	必填。 请求 URI 指定要删除的别名的名称。
api-version	必填。 有关更多版本，请参阅 API 版本。

请求标头

下表描述了必需的和可选的请求标头。

领域	描述
Content-Type	必填。 将此设置为 application/json
api-key	如果使用 Azure 角色，并且请求中提供了持有者令牌，则为可选，否则需要密钥。 api-key 是唯一的系统生成的字符串，用于对搜索服务的请求进行身份验证。 删除请求必须包含设置为管理密钥的 api-key 标头（而不是查询密钥）。 有关详细信息，请参阅 使用密钥身份验证 连接到 Azure AI 搜索。

请求正文

没有。

响应

状态代码：为成功的响应返回 204 无内容。

另请参阅

• 在 Azure AI 搜索 中创建索引别名