你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
Azure AI 搜索) (HTTP 状态代码
本页介绍使用 Azure AI 搜索 API 时经常返回的 HTTP 状态代码。
常见的 HTTP 状态代码
| 代码 | 说明 |
|---|---|
| 200 正常 | GET、PUT 或 POST 成功。 为成功的响应返回。 在编制索引期间，此代码指示所有项都已持久存储，并且将开始编制索引。 索引在后台运行，并在索引操作完成后几秒钟内使新文档可查询和可搜索。 |
| 201 Created | PUT 或 POST 成功。 已成功创建或更新对象。 |
| 204 已接受 | PUT 或 POST 成功。 已成功上载索引或文档。 |
| 207 多种状态 | PUT 或 POST 部分成功。 某些文档成功，但至少有一个失败。 |
| 400 错误的请求 | 当请求 URI、标头或正文中存在错误时返回。 响应正文包含一条错误消息，说明具体问题是什么。 |
| 403 禁止访问 | 传递了无效的 api-key 时返回。 |
| 404 未找到 | 当服务器上不存在资源时返回。 如果要管理或查询索引，检查语法并验证是否已正确指定索引名称。 |
| 不支持 405 方法 | 当请求指定可识别但不支持的方法时返回。 如果要查询索引，该请求的表述包括终结点、索引集合和索引，文档集合和搜索方法 (https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2020-06-30 例如，) 。 |
| 409 冲突 | 在写入操作发生冲突时返回。 当两个进程尝试同时更新同一文档时，资源更新或索引编制期间，将返回此错误。 Azure AI 搜索为资源更新提供并发管理。 有关详细信息，请参阅 如何在 Azure AI 搜索中管理并发。 |
| 412 前提失败 | 当 If-Match 或 If-None-Match 标头的条件的计算结果为 false 时返回。 与在发送索引定义、索引器或数据源的 HTTP 请求时使用 乐观并发控制 相关联。 |
| 429 请求次数过多 | 如果在尝试创建索引时发生此错误，则表示已具有定价层允许的最大索引数。 存储在 Azure AI 搜索中的索引计数在Azure 门户上的搜索服务仪表板可见。 若要按名称查看索引，请选择“ 索引” 磁贴。 或者，还可以使用“列出索引”操作按名称获取 索引列表 。 有关详细信息，请参阅列出索引。 如果在文档上传过程中发生此错误，则表示已超出每个索引的文档数的配额。 必须创建新索引或升级以提高容量限制。 |
| 499 客户端已关闭请求 | 此错误永远不会在响应中返回，但可能会在 搜索流量分析和 Azure Monitor 记录的日志条目中看到它。 它指示客户端在服务返回响应之前关闭了连接。 当 Azure AI 搜索检测到服务端代码未请求的取消，或者客户端不再存在时，将记录 499 错误。 |
| 502 错误的网关 | 当你在连接中输入 HTTP 而不是 HTTPS 时，将发生此错误。 |
| 503 服务不可用 | 此错误表示系统负载过重，当前无法处理请求。 重要： 在这种情况下，我们强烈建议客户端代码退后等待，然后再重试。 这可以给系统一些时间来恢复，增加今后请求成功的可能性。 快速重试请求只会延长这种情况持续的时间。 有关限制以及如何防止这种情况的详细信息，请参阅 分析性能 。 |
| 504：网关超时 | Azure AI 搜索侦听 HTTPS 端口 443。 如果搜索服务 URL 包含 HTTP 而不是 HTTPS，则返回 504 状态代码。 |