你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。
本页介绍使用 Azure AI 搜索 API 时经常返回的 HTTP 状态代码。
常见的 HTTP 状态代码
| 代码 | 说明 |
|---|---|
| 200 正常 | GET、PUT 或 POST 上的成功。 为成功的响应返回。 |
| 201 已创建 | 在 PUT 或 POST 上成功。 已成功创建对象。 |
| 202 接受 | 在 PUT 或 POST 上成功。 对于运行索引器请求，将返回此状态代码。 |
| 204 无内容 | 在 PUT 或 POST 上成功。 更新成功，但响应中没有要返回的信息。 |
| 207 多状态 | PUT 或 POST 的部分成功。 某些文档成功，但至少有一个失败。 |
| 400 错误的请求 | 当请求 URI、标头或正文中出现错误时返回。 响应正文包含一条错误消息，说明具体问题是什么。 |
| 401 未授权 | 缺少凭据时返回。 如果使用基于角色的访问控制，则你或搜索服务缺少角色分配。 有关访问 Azure AI 搜索时出现的问题，请参阅 使用角色连接到 Azure AI 搜索。 有关与其他资源的搜索连接的详细信息，请参阅 配置搜索服务以使用托管标识进行连接。 |
| 403 禁止 | 授权失败时返回。 |
| 404 未找到 | 当服务器上不存在资源时返回。 |
| 405 方法不受支持 | 当服务识别不受支持的方法时返回。 如果要查询索引，则请求的表述包括终结点、索引集合和索引，以及文档集合和搜索方法（例如）。 https://mydemosvc.search.windows.net/indexes/mydemoidx/docs/search?api-version=2024-07-01 |
| 409 冲突 | 写入作冲突时返回。 当两个进程尝试同时更新同一文档时，会为资源更新返回此状态代码，或在编制索引期间返回。 Azure AI 搜索为资源更新提供并发管理。 有关详细信息，请参阅 如何在 Azure AI 搜索中管理并发。 |
| 412 前提条件不满足 | 当 If-Match 或 If-None-Match 标头的条件计算结果为 false 时返回。 与在发送索引定义、索引器、技能集或数据源的 HTTP 请求时使用 乐观并发控制 相关联。 |
| 429 请求次数过多 | 如果在创建对象期间获取此状态代码，则表示服务层允许 的最大对象数 。 如果在活动索引上收到此错误代码，则通常意味着存储不足。 接近 存储限制时，服务可以进入在删除某些文档之前无法添加或更新的状态。 有关详细信息，请参阅 “规划和管理容量 ”（如果需要更多存储）或 更新内容 （如果要通过删除文档释放空间）。 |
| 499 客户端关闭请求 | 此状态代码永远不会在响应中返回，但你可能会在 搜索流量分析和 Azure Monitor 记录的日志条目中看到它。 它指示客户端在服务返回响应之前关闭了连接。 当 Azure AI 搜索检测到服务端代码未请求的取消，或者客户端不再存在时，将记录 499。 |
| 502 错误网关 | 在连接中输入 HTTP 而不是 HTTPS 时，会出现此状态代码。 |
| 503 服务不可用 | 此状态代码表示系统负载过大，无法处理请求。 缓解措施包括向任何重试逻辑添加等待时间或增加容量。 较新的服务自动具有更多的存储和计算能力。 有关性能优化的详细信息，请参阅 分析 Azure AI 搜索中的性能。 |
| 504：网关超时 | Azure AI 搜索侦听 HTTPS 端口 443。 如果搜索服务 URL 包含 HTTP 而不是 HTTPS，则返回 504 状态代码。 |