你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
(Azure AI 搜索 REST API) 删除索引
删除索引操作会从 Azure AI 搜索服务永久删除索引及其内容。 此操作是最终操作,没有恢复选项。 请确保你拥有索引定义代码、数据引入代码的主控副本以及外部数据源的备份,以防需要重新生成。
DELETE https://[service name].search.windows.net/indexes/[index name]?api-version=[api-version]
Content-Type: application/json
api-key: [admin key]
如果尝试删除当前映射到 别名的索引,该操作将失败,并显示 400 (错误的请求) 和错误消息,指出映射到该索引的别名 (es) 必须先删除或映射到其他索引,然后才能删除索引。
URI 参数
参数 | 说明 |
---|---|
服务名称 | 必需。 将其设置为搜索服务的唯一用户定义名称。 |
索引名称 | 必需。 请求 URI 指定要删除的索引的名称。 |
api-version | 必需。 当前稳定版本为 api-version=2020-06-30 。 有关更多 版本,请参阅 API 版本。 |
请求标头
下表介绍必需和可选的请求标头。
字段 | 说明 |
---|---|
Content-Type | 必需。 将其设置为 application/json |
api-key | 如果使用的是 Azure 角色 ,并且请求中提供了持有者令牌,则为可选,否则需要密钥。 api-key 是系统生成的唯一字符串,用于对搜索服务的请求进行身份验证。 删除请求必须包含 api-key 设置为管理密钥 (的标头,而不是) 查询密钥。 有关详细信息 ,请参阅使用密钥身份验证连接到 Azure AI 搜索 。 |
请求正文
无。
响应
对于成功的响应,返回“状态代码:204 无内容”。